Difference between revisions of "NanoPi 2/zh"

From FriendlyELEC WiKi
Jump to: navigation, search
(updated by API)
(updated by API)
Line 173: Line 173:
 
* 一套USB键盘鼠标,同时连接还需要USB HUB (或选购串口转接板,要PC上进行操作)
 
* 一套USB键盘鼠标,同时连接还需要USB HUB (或选购串口转接板,要PC上进行操作)
 
* 一台电脑,需要联网,建议使用Ubuntu 16.04 64位系统
 
* 一台电脑,需要联网,建议使用Ubuntu 16.04 64位系统
===经测试使用的TF卡===
+
{{ResizeTFCardFS/zh|NanoPi2}}
制作启动NanoPi 2的TF卡时,建议Class10或以上的 8GB SDHC卡。以下是经友善之臂测试验证过的高速TF卡:
+
{{S5Pxx18HDMI/zh|NanoPi2|arch/arm/plat-s5p4418/nanopi2/lcds.c}}
*SanDisk闪迪 TF 8G Class10 Micro/SD 高速 TF卡:
+
{{S5Pxx18MofidyKernelCommandLineOnHostPC/zh|NanoPi2|sd-fuse_nanopi2}}
[[File:SanDisk MicroSD.png|frameless|100px|SanDisk MicroSD 8G]]
+
{{NanoPCStartToUse/zh|NanoPi2}}
*SanDisk闪迪 TF128G 至尊高速MicroSDXC TF 128G Class10 48MB/S:
+
{{FriendlyCoreGeneral/zh}}
[[File:SanDisk MicroSD-01.png|frameless|100px|SanDisk MicroSD 128G]]
+
{{FriendlyCoreS5Pxx18/zh}}
*川宇 8G手机内存卡 8GTF卡存储卡 C10高速class10 micro SD卡:
+
{{S5P4418Software/zh|NanoPi2}}
[[File:SanDisk MicroSD-02.png|frameless|100px|chuanyu MicroSD 8G]]
+
{{S5P4418ChangeLog/zh}}
 
+
===制作一张带运行系统的microSD卡===
+
====简易方法制作====
+
首先访问[http://wiki.friendlyarm.com/wiki/nanopi2/download/ 此处的下载地址]下载需要的固件文件:<br />
+
*您需要准备一张4G或以上容量的SDHC卡,该卡的已有数据将会被破坏,因此请先对SD卡上的数据进行备份。
+
友善团队特意为Smart4418开发板提供了Android 5.1和Android 4.4。Android 4.4是专门为企业用户定制的系统,支持4G模块、Ethernet设置。
+
 
+
 
+
::{| class="wikitable"
+
|-
+
|colspan=2|使用LCD或HDMI作来输出的用户,使用以下固件:
+
|-
+
|s5p4418-debian-sd4g-YYYYMMDD.img.zip      || Debian系统固件                 
+
|-
+
|s5p4418-android-sd4g-YYYYMMDD.img.zip      || Android5.1系统固件
+
|-
+
|s5p4418-kitkat-sd4g-YYYYMMDD.img.zip    ||  Android4.4系统固件 
+
|-
+
|s5p4418-ubuntu-core-qte-sd4g-YYYYMMDD.img.zip      || Ubuntu core系统固件,内置Qt-Embedded 4.8.6图形界面
+
|-
+
|colspan=2|单板运行的用户,使用以下固件: 
+
|-
+
|s5p4418-debian-wifiap-sd4g-YYYYMMDD.img.zip    || Debian系统固件(默认开启无线热点,可用VNC或SSH登录) 
+
|-
+
|colspan=2|烧写工具: 
+
|-
+
|win32diskimager.rar || Windows平台下的烧写工具,Linux系统可以用dd命令
+
|-
+
|}
+
 
+
*将固件和烧写工具分别解压,在Windows下插入SD卡(限4G及以上的卡),以管理员身份运行 win32diskimager 工具, 在win32diskimager工具的界面上, 选择你的SD卡盘符,选择你要烧写的系统固件,点击 Write 按钮烧写即可。
+
*当制作完成 SD 卡后,拔出 SD 卡插入 NanoPi 2 的 BOOT 卡槽,上电启动(注意,这里需要 5V/2A 的供电),你可以看到绿灯常亮,蓝灯闪烁,这时你已经成功启动 NanoPi2。<br />
+
 
+
====在Linux Desktop下通过脚本制作====
+
* 1) 将microSD插入Ubuntu的电脑,用以下命令查看你的SD卡设备名
+
<syntaxhighlight lang="bash">
+
dmesg | tail
+
</syntaxhighlight>
+
当dmesg输出类拟信息 sdc: sdc1 sdc2时,则表示SD卡对应的设备名为 /dev/sdc,也通过用命令cat /proc/partitions来查看。
+
 
+
*2) 下载Linux下的制作脚本
+
<syntaxhighlight lang="bash">
+
git clone https://github.com/friendlyarm/sd-fuse_nanopi2.git
+
cd sd-fuse_nanopi2
+
</syntaxhighlight>
+
 
+
*3) 以下是制作启动Android的SD卡的方法
+
<syntaxhighlight lang="bash">
+
su
+
./fusing.sh /dev/sdx
+
</syntaxhighlight>
+
(注:/dev/sdx请替换为实际的SD卡设备文件名) <br />
+
制作包中未包含Android和Debian的烧写文件,第一次使用时会提示需要下载,输入Y下载,N或10秒未输入则取消。
+
 
+
*4) 以下是制作启动Debian的SD卡的方法
+
<syntaxhighlight lang="bash">
+
./fusing.sh /dev/sdx debian
+
</syntaxhighlight>
+
 
+
====NanoPi 2 扩展TF卡分区====
+
* Debian/Ubuntu系统在启动的时候,会自动扩展SD卡分区,第一次开机时自动扩展分区和根文件系统。
+
* Android扩展分区,要在pc上执行下列操作:
+
<syntaxhighlight lang="bash">
+
sudo umount /dev/sdx?
+
sudo parted /dev/sdx unit % resizepart 4 100 resizepart 7 100 unit MB print
+
sudo resize2fs -f /dev/sdx7
+
</syntaxhighlight>
+
(注:/dev/sdx请替换为实际的SD卡设备文件名)
+
 
+
====关于LCD/HDMI分辨率====
+
系统启动时uboot会自动识别LCD,成功则会设置为该LCD的显示分辨率,失败则缺省会设置为HDMI 720P模式。<br />
+
如果要修改LCD的显示分辨率,可以直接修改内核中的文件 arch/arm/plat-s5p4418/nanopi2/lcds.c , 然后重新编译内核并更新即可。<br />
+
对于HDMI的显示模式,Android则是会通过EDID获得HDMI设备如电视机所支持的显示模式,然后自动选择一个合适的分辨率。如果使用的是Debian,则缺省是720P,可通过修改内核配置来切换为1080P。
+
 
+
===在电脑上修改SD卡上的系统===
+
如果你想在运行系统之前,先对系统做一些修改,可以参看本节内容,否则可以跳过本节。<br />
+
将制作好microSD卡插入一台运行Linux的电脑,可以挂载SD卡上的boot和rootfs等分区,对分区内容进行修改,通过在以下情况下你需要进行这些操作:<br />
+
1) 你想更改Kernel Command Line参数,则可以通过sd-fuse_nanopi2/tools目录下的fw_setenv工具来操作。<br />
+
查看当前的Command Line:
+
<syntaxhighlight lang="bash">
+
cd sd-fuse_nanopi2/tools
+
./fw_printenv /dev/sdc | grep bootargs
+
</syntaxhighlight>
+
目前的Android 5.1.1_r6启用了SELinux,缺省模式是enforcing,你可以通过Command Line来修改它,例如:
+
<syntaxhighlight lang="bash">
+
./fw_setenv /dev/sdc bootargs XXX androidboot.selinux=permissive
+
</syntaxhighlight>
+
即可修改为permissive模式,其中上面的XXX需要替换成原来的bootargs值。<br />
+
 
+
2) 更新内核 <br />
+
新版本的uboot在启动时如果识别到LCD,将读取SD卡boot分区的uImage,否则将读取uImage.hdmi。<br />
+
对于Android来说是同一个文件,因此直接使用新编译的uImage来替换SD卡boot分区下的文件即可。<br />
+
对于Debian来说,这2个文件是不相同的,使用新编译的支持LCD的uImage直接替换SD卡boot分区的文件,如果是支持HDMI的内核,则替换uImage.hdmi。<br />
+
 
+
===运行Android或Debian===
+
*将制作好microSD卡插入NanoPi2,连接HDMI,最后连接电源(5V 2A),NanoPi2会上电自动开机,看到板上的蓝色LED闪烁,这说明系统已经开始启动了,同时电视上也将能看到系统启动的画面。<br />
+
1)要在电视上进行操作,你需要连接USB鼠标和键盘;如果你选购了LCD配件,则可以直接使用LCD上面的触摸屏进行操作。<br />
+
2)如果您需要进行内核开发,你最好选购一个串口配件,连接了串口,则可以通过终端对NanoPi2进行操作。<br />
+
*以下是串口的接法,假如你已经拿到串口,则可直接串口供电,不需要再通过microUSB供电,接上串口,即可调试:
+
[[File:PSU-ONECOM.png|frameless|400px|PSU-ONECOM01]]
+
*如果提示输入密码,Debian的root用户的默认密码是两个字母fa。
+
 
+
===通过VNC和ssh登录Debian===
+
如果你是祼板运行系统(既没有连接LCD也没有连接HDMI),并且烧写了带 -wifiap.img 后辍的固件,你可以使用手机,或者有无线网卡的电脑连接到NanoPi2开放的 nanopi2-wifiap 无线热点(默认密码是123456789),连接成功后,无论是手机还是电脑,你可以到[http://www.realvnc.com/download/ 这里]下载并安装一个名为VNC Viewer的软件,用VNC连接到NanoPi2,NanoPi2在使用VNC时的连接地址和端口为:192.168.8.1:5901,默认密码为:fa123456,以下是在iPhone上用VNC登录NanoPi2的画面:<br />
+
[[File:iphone6-vnc-nanopi2.png|frameless|400px|VNC to NanoPi2]]
+
<br />
+
你也可以通过 ssh -l root 192.168.8.1 命令在终端上登录,默认的root用户密码是 fa。<br />
+
<br />
+
为了保证ssh的流畅,我们用以下命令关闭wifi的省电模式:
+
<syntaxhighlight lang="bash">
+
iwconfig wlan0 power off
+
</syntaxhighlight>
+
 
+
==Debian系统的使用==
+
===连接无线网络===
+
 
+
Debian系统使用[[Use NetworkManager to configure network settings|NetworkManager]]来管理网络。<br />
+
 
+
在Debian的桌面环境下,点击桌面任务栏右下角的网络图标,会弹出 NetworkManger 的菜单,列出当前的网络连接状态,如果有WiFi网络,会列出周边的无线热点,如下图所示:<br />
+
[[File:NetworkManagerIcon.png|frameless|400px|NetworkManagerIcon]]<br />
+
你可以点击菜单上的无线热点,即可连接到该热点,如果热点是加密的,会弹出密码输入框提示你输入密码。<br />
+
想进一步了解网络连接相关的内容,可参考这个页面:[[Use NetworkManager to configure network settings|NetworkManager]]。<br />
+
 
+
===配置Wi-Fi无线热点===
+
先执行以下命令,默认情况下如果系统中安装了NetworkManager,会提示你先卸载NetworkManager:<br />
+
<syntaxhighlight lang="bash">
+
sudo turn-wifi-into-apmode yes
+
</syntaxhighlight>
+
卸载NetworkManager完成后,按提示重启开发板。<br />
+
重启后,再执行上面的命令一次,这次会提示你输入WiFi热点的名称和密码,按提示操作即可。<br />
+
<br />
+
操作成功后,你可以在电脑上搜索并连接热点,然后通过192.168.8.1这个地址来登录开发板:
+
<syntaxhighlight lang="bash">
+
ssh root@192.168.8.1
+
</syntaxhighlight>
+
在提示输入密码时,输入预设的密码fa,即可登入。<br />
+
<br />
+
为了保证ssh的流畅,我们用以下命令关闭wifi的省电模式:
+
<syntaxhighlight lang="bash">
+
sudo iwconfig wlan0 power off
+
</syntaxhighlight>
+
WiFi工作模式可通过以下命令查询:<br />
+
<syntaxhighlight lang="bash">
+
sudo cat /sys/module/bcmdhd/parameters/op_mode
+
</syntaxhighlight>
+
输出为数字2则表示当前处于无线热点模式,要切换回普通的Station模式,输入如下命令:<br />
+
<syntaxhighlight lang="bash">
+
sudo turn-wifi-into-apmode no
+
</syntaxhighlight>
+
 
+
===使用蓝牙传输文件===
+
以传输文件到手机为例进行说明,首先,将你的手机蓝牙设置为可侦测状态,然后执行以下命令开始蓝牙搜索:<br />
+
<syntaxhighlight lang="bash">
+
hcitool scan
+
</syntaxhighlight>
+
<br />
+
搜索到设备时,结果举例如下:<br />
+
Scanning ...<br />
+
38:BC:1A:B1:7E:DD      MEIZU MX4<br />
+
<br />
+
这表示搜索到一台名为MEIZU MX4的手机,我们记下手机名称前面的MAC地址,然后用sdptool命令查看该手机支持的蓝牙服务:<br />
+
<syntaxhighlight lang="bash">
+
sdptool browse 38:BC:1A:B1:7E:DD
+
</syntaxhighlight>
+
注:上述命令中的MAC地址请替换成手机实际的<br /><br />
+
这个命令会详细列出手机蓝牙所支持的协议,我们需要关心的是一个名为 OBEX Object Push 的文件传输服务,以MEIZU MX4手机为例,其显示结果如下所示:<br />
+
Service Name: OBEX Object Push<br />
+
Service RecHandle: 0x1000b<br />
+
Service Class ID List:<br />
+
"OBEX Object Push" (0x1105)<br />
+
Protocol Descriptor List:<br />
+
"L2CAP" (0x0100)<br />
+
"RFCOMM" (0x0003)<br />
+
Channel: 25<br />
+
"OBEX" (0x0008)<br />
+
Profile Descriptor List:<br />
+
"OBEX Object Push" (0x1105)<br />
+
Version: 0x0100<br />
+
<br />
+
从上面的信息可以看到,这个手机的OBEX Object Push服务的所用的频道是25, 我们需要将它传递给ussp-push命令,最后发起文件传输请求的命令如下:
+
<syntaxhighlight lang="bash">
+
ussp-push 38:BC:1A:B1:7E:DD@25 example.jpg example.jpg
+
</syntaxhighlight>
+
注:上述命令中的MAC地址、频道和文件名请替换成实际的<br /><br />
+
执行上述命令后,请留意手机屏幕,正常情况下手机会弹出配对和接收文件的提示,确定后就开始文件传輪了。<br />
+
<br />
+
蓝牙常见问题:<br />
+
1) 开发板上找不到蓝牙设备, 可尝试用以下命令开启蓝牙:<br />
+
<syntaxhighlight lang="bash">
+
rfkill unblock 0
+
</syntaxhighlight>
+
2) 提示找不到相关命令,可尝试用以下命令安装相关软件:<br />
+
<syntaxhighlight lang="bash">
+
apt-get install bluetooth bluez obexftp openobex-apps python-gobject ussp-push
+
</syntaxhighlight>
+
 
+
===安装Debian软件包===
+
我们提供的是标准的Debian jessie系统,你可以使用apt-get等命令来安装软件包,如果板子是首次运行,需要先用以下命令更新软件包列表:
+
<syntaxhighlight lang="bash">
+
apt-get update
+
</syntaxhighlight>
+
然后就可以安装软件包了,例如要安装ftp服务器,使用以下命令:
+
<syntaxhighlight lang="bash">
+
apt-get install vsftpd
+
</syntaxhighlight>
+
如果软件包下载速度不理想,你可以编辑 /etc/apt/sources.list 更换一个更快的源服务器,这个网址[http://www.debian.org/mirror/list]有一份完整的源镜像服务器列表,注意要选用一个带armhf架构的。
+
 
+
===Debian系统HDMI或者3.5mm音频设备输出声音===
+
NanoPi 2 Debian系统默认接HDMI没有输出声音,因为系统缺省没安装声音部分的安装包。如希望HDMI设备输出声音,需要给系统安装上缺省的alsa包。<br />
+
首先,保证你的板子刷的是最新Debian固件,并且能连外网;<br />
+
启动板子后,执行以下步骤安装alsa包:
+
<syntaxhighlight lang="bash">
+
apt-get update
+
apt-get install libasound2
+
apt-get install alsa-base
+
apt-get install alsa-utils
+
</syntaxhighlight>
+
安装好需要的库后,拷贝一首 .wav 格式的音乐到NanoPi 2上,NanoPi 2接上HDMI,播放音乐:
+
<syntaxhighlight lang="bash">
+
aplay music.wav
+
</syntaxhighlight>
+
 
+
==如何编译系统==
+
 
+
===安装交叉编译器===
+
首先下载并解压编译器:
+
<syntaxhighlight lang="bash">
+
git clone https://github.com/friendlyarm/prebuilts.git
+
sudo mkdir -p /opt/FriendlyARM/toolchain
+
sudo tar xf prebuilts/gcc-x64/arm-cortexa9-linux-gnueabihf-4.9.3.tar.xz -C /opt/FriendlyARM/toolchain/
+
</syntaxhighlight>
+
 
+
然后将编译器的路径加入到PATH中,用vi编辑vi ~/.bashrc,在末尾加入以下内容:
+
<syntaxhighlight lang="bash">
+
export PATH=/opt/FriendlyARM/toolchain/4.9.3/bin:$PATH
+
export GCC_COLORS=auto
+
</syntaxhighlight>
+
 
+
执行一下~/.bashrc脚本让设置立即在当前shell窗口中生效,注意"."后面有个空格:
+
<syntaxhighlight lang="bash">
+
. ~/.bashrc
+
</syntaxhighlight>
+
 
+
这个编译器是64位的,不能在32位的Linux系统上运行,安装完成后,你可以快速的验证是否安装成功:
+
<syntaxhighlight lang="bash">
+
arm-linux-gcc -v
+
Using built-in specs.
+
COLLECT_GCC=arm-linux-gcc
+
COLLECT_LTO_WRAPPER=/opt/FriendlyARM/toolchain/4.9.3/libexec/gcc/arm-cortexa9-linux-gnueabihf/4.9.3/lto-wrapper
+
Target: arm-cortexa9-linux-gnueabihf
+
Configured with: /work/toolchain/build/src/gcc-4.9.3/configure --build=x86_64-build_pc-linux-gnu
+
--host=x86_64-build_pc-linux-gnu --target=arm-cortexa9-linux-gnueabihf --prefix=/opt/FriendlyARM/toolchain/4.9.3
+
--with-sysroot=/opt/FriendlyARM/toolchain/4.9.3/arm-cortexa9-linux-gnueabihf/sys-root --enable-languages=c,c++
+
--with-arch=armv7-a --with-tune=cortex-a9 --with-fpu=vfpv3 --with-float=hard
+
...
+
Thread model: posix
+
gcc version 4.9.3 (ctng-1.21.0-229g-FA)
+
</syntaxhighlight>
+
 
+
===编译U-Boot===
+
下载U-Boot源代码并编译,注意分支是nanopi2-lollipop-mr1:
+
<syntaxhighlight lang="bash">
+
git clone https://github.com/friendlyarm/uboot_nanopi2.git
+
cd uboot_nanopi2
+
git checkout nanopi2-lollipop-mr1
+
make s5p4418_nanopi2_config
+
make CROSS_COMPILE=arm-linux-
+
</syntaxhighlight>
+
 
+
编译成功结束后您将获得u-boot.bin,您可以通过fastboot来更新正在运行的NanoPi2板上SD的U-Boot,方法如下:<br />
+
1) 在电脑上先用命令 sudo apt-get install android-tools-fastboot 安装 fastboot 工具;<br />
+
2) 用串口配件连接NanoPi2和电脑,在上电启动的2秒内,在串口终端上按下回车,进入 u-boot 的命令行模式;<br />
+
3) 在u-boot 命令行模式下输入命令 fastboot 回车,进入 fastboot 模式;<br />
+
4) 用microUSB线连接NanoPi2和电脑,在电脑上输入以下命令烧写u-boot.bin:<br />
+
<syntaxhighlight lang="bash">
+
fastboot flash bootloader u-boot.bin
+
</syntaxhighlight>
+
<br />
+
注意:您不能直接使用dd来更新SD卡,否则有可能会导致无法正常启动。<br />
+
 
+
===准备mkimage===
+
编译内核需要用到U-Boot中的工具mkimage,因此,在编译内核uImage前,您需要保证您的主机环境可以成功运行它。<br />
+
你可以直接使用命令 sudo apt-get install u-boot-tools 来安装,也可以自己编译并安装:
+
<syntaxhighlight lang="bash">
+
cd uboot_nanopi2
+
make CROSS_COMPILE=arm-linux- tools
+
sudo mkdir -p /usr/local/sbin && sudo cp -v tools/mkimage /usr/local/sbin
+
</syntaxhighlight>
+
 
+
===编译Linux kernel===
+
====编译内核====
+
* 下载内核源代码
+
<syntaxhighlight lang="bash">
+
git clone https://github.com/friendlyarm/linux-3.4.y.git
+
cd linux-3.4.y
+
git checkout nanopi2-lollipop-mr1
+
</syntaxhighlight>
+
NanoPC-T2内核所属的分支是nanopi2-lollipop-mr1,在开始编译前先切换分支。
+
* 编译Android内核
+
<syntaxhighlight lang="bash">
+
make nanopi2_android_defconfig
+
touch .scmversion
+
make uImage
+
</syntaxhighlight>
+
* 编译Debian内核
+
<syntaxhighlight lang="bash">
+
make nanopi2_linux_defconfig
+
touch .scmversion
+
make uImage
+
</syntaxhighlight>
+
编译成功结束后,新生成的内核烧写文件为 arch/arm/boot/uImage,此内核支持LCD输出,用于替换掉SD卡boot分区下的uImage。<br />
+
如果要支持HDMI,则需要使用 nanopi2_linux_hdmi_defconfig, 具体如下:
+
<syntaxhighlight lang="bash">
+
make nanopi2_linux_hdmi_defconfig
+
touch .scmversion
+
make uImage
+
</syntaxhighlight>
+
使用新的uImage 替换SD卡boot分区下的uImage.hdmi 即可支持HDMI 720p,如果要支持1080p,则需要修改内核配置:
+
<syntaxhighlight lang="bash">
+
touch .scmversion
+
make nanopi2_linux_hdmi_defconfig
+
make menuconfig
+
  Device Drivers -->
+
    Graphics support -->
+
      Nexell Graphics -->
+
        [ ] LCD
+
        [*] HDMI
+
        (0)  Display In  [0=Display 0, 1=Display 1]
+
              Resolution (1920 * 1080p)  --->
+
make uImage
+
</syntaxhighlight>
+
* 编译Ubuntu Core内核
+
本部分的编译方法和编译Debian内核是相似的,只需要使用不同的2个内核配置即可。<br />
+
LCD 输出:
+
<syntaxhighlight lang="bash">
+
make nanopi2_core-qt_defconfig
+
</syntaxhighlight>
+
HDMI输出:
+
<syntaxhighlight lang="bash">
+
make nanopi2_core-qt_hdmi_defconfig
+
</syntaxhighlight>
+
选择自己需要的内核配置后,使用以下命令即可编译生成uImage。
+
<syntaxhighlight lang="bash">
+
touch .scmversion
+
make uImage
+
</syntaxhighlight>
+
 
+
====编译内核模块====
+
Android包含内核模块,位于system分区的 /lib/modules/ 下,如果您有新的内核模块或者内核配置有变化,则需要重新编译。 <br />
+
首先编译内核源代码中的模块:
+
<syntaxhighlight lang="bash">
+
cd linux-3.4.y
+
make CROSS_COMPILE=arm-linux- modules
+
</syntaxhighlight>
+
另外有2个内核模块的源代码位于Android源代码中,可使用以下命令来编译:
+
<syntaxhighlight lang="bash">
+
cd /opt/FriendlyARM/s5p4418/android
+
./vendor/friendly-arm/build/common/build-modules.sh
+
</syntaxhighlight>
+
其中 “/opt/FriendlyARM/s5p4418/android” 是指Android源代码的TOP目录,使用参数“-h”可查看帮助。<br />
+
编译成功结束后,会显示生成的内核模块。
+
 
+
===编译Android===
+
 
+
* 搭建编译环境
+
搭建编译Android的环境建议使用64位的Ubuntu 16.04,安装需要的包即可。
+
<syntaxhighlight lang="bash">
+
sudo apt-get install bison g++-multilib git gperf libxml2-utils make python-networkx zip
+
sudo apt-get install flex libncurses5-dev zlib1g-dev gawk minicom
+
</syntaxhighlight>
+
更多说明可查看 https://source.android.com/source/initializing.html 。
+
 
+
* 下载源代码(Android5.1)
+
Android源代码的下载需要使用repo,其安装和使用请查看 https://source.android.com/source/downloading.html 。
+
<syntaxhighlight lang="bash">
+
mkdir android && cd android
+
repo init -u https://github.com/friendlyarm/android_manifest.git -b nanopi2-lollipop-mr1
+
repo sync
+
</syntaxhighlight>
+
其中“android”是指工作目录。<br />
+
 
+
如果需要使用Android4.4源码的,则执行以下步骤
+
<syntaxhighlight lang="bash">
+
mkdir android && cd android
+
repo init -u https://github.com/friendlyarm/android_manifest.git -b nanopi2-kitkat
+
repo sync
+
</syntaxhighlight>
+
通过  -b  指定不同的分支即可
+
 
+
* 编译系统
+
<syntaxhighlight lang="bash">
+
source build/envsetup.sh
+
lunch aosp_nanopi2-userdebug
+
make -j8
+
</syntaxhighlight>
+
编译成功完成后,目录 out/target/product/nanopi2/ 下包含可用于烧写的image文件。
+
::{| class="wikitable"
+
|-
+
|filename    || partition || Description 
+
|-
+
|boot.img    || boot      || -
+
|-
+
|cache.img    || cache    || -
+
|-
+
|userdata.img || userdata  || -
+
|-
+
|system.img  || system    || -
+
|-
+
|partmap.txt  || -        || 分区描述文件
+
|-
+
|}
+
 
+
* 烧写到SD卡
+
如果是采用SD卡启动Android,可复制编译生成的image文件到sd-fuse_nanopi2/android/ 下,使用脚本即可烧到到SD卡,具体请查看[[#在Linux Desktop下通过脚本制作]]。
+
 
+
==扩展连接==
+
===NanoPi 2连接USB(FA-CAM202)200万摄像头模块===
+
*NanoPi 2使用Debian系统,假设你已接好LCD屏或者HDMI,进入系统后,点击左下角的菜单键“Other”-->xawtv9,打开USB Camera软件。进入“welcome  to  xawtv!”,选择OK即可进行拍照。
+
USB Camera模块的详情请查看[http://wiki.friendlyarm.com/wiki/index.php/Matrix_-_USB_Camera(FA-CAM202)/zh 点击查看]<br />
+
[[File:USB-camera-nanopi2.png|frameless|500px|USB camera]]
+
[[File:USB-camera-nanopi2-01.png|frameless|500px|USB camera-01]]
+
 
+
===NanoPi 2连接CMOS 500万摄像头模块===
+
CAM500A 500万摄像头模块的详情请查看[http://wiki.friendlyarm.com/wiki/index.php/Matrix_-_CAM500A/zh]<br/>
+
 
+
*NanoPi 2使用Android5.1系统,假设你已经接好LCD屏或者HDMI,进入系统后,直接点击“camera”图标,即可打开摄像头进行拍照。
+
 
+
[[File:CMOS-camera-nanopi2.png|frameless|500px|CMOS camera]]
+
 
+
*Debian/Ubuntu系统集成了命令行的摄像头示例程序nanocams,登录后输入以下命令即可预览40桢然后拍照保存为指定的文件。
+
<syntaxhighlight lang="bash">
+
sudo nanocams -p 1 -n 40 -c 4 -o IMG001.jpg
+
</syntaxhighlight>
+
更详细的命令行参数可执行命令“nanocams -h”。
+
如果要下载源代码,运行以下命令即可获得:
+
<syntaxhighlight lang="bash">
+
git clone https://github.com/friendlyarm/nexell_linux_platform.git
+
</syntaxhighlight>
+
 
+
===NanoPi 2接USB摄像头使用OpenCV===
+
* OpenCV的全称是Open Source Computer Vision Library,是一个跨平台的计算机视觉库。
+
* NanoPi 2跑Debian系统时,接USB Camera,可直接使用官方的OpenCV。<br>
+
1、以下介绍的是NanoPi 2用C++使用的OpenCV:
+
* 首先需要保证你的NanoPi 2能连外网,假如你有串口,直接串口登陆超级终端(或者ssh登陆)。进入系统后,输入用户名(root),密码(fa)登陆;
+
* 以下命令在超级终端执行:
+
<br>
+
<syntaxhighlight lang="bash">
+
apt-get update
+
apt-get install libcv-dev libopencv-dev
+
</syntaxhighlight>
+
 
+
2、NanoPi 2烧写Debian系统启动后,接上USB Camera,使用Debian系统自带的摄像头软件测试,确定摄像头能正常使用。<br>
+
3、通过终端执行命令,查看你的摄像头设备:
+
<syntaxhighlight lang="bash">
+
ls /dev/video*
+
</syntaxhighlight>
+
* 注:video9 是你的USB摄像头设备
+
 
+
4、opencv的测试代码(官方C++示例代码)在 /home/fa/Documents/opencv-demo, 使用以下命令即可编译:
+
<syntaxhighlight lang="bash">
+
cd /home/fa/Documents/opencv-demo
+
make
+
</syntaxhighlight>
+
编译成功后,得到可执行文件demo <br />
+
 
+
5、以下步骤需要在NanoPi 2上接上键盘执行:
+
<syntaxhighlight lang="bash">
+
./demo
+
</syntaxhighlight>
+
 
+
你便可以看到opencv已经用起来,如图:<br>
+
[[File:OpenCV-01.png|frameless|600px|OpenCV-01]]
+
 
+
===串口扩展GPS模块===
+
* Matrix-GPS是一款体积小巧,性能优越的GPS定位模块,适用于导航仪、四轴飞行器定位等应用场景。
+
* Matrix-GPS模块采用串口通讯,NanoPi 2上电进入系统后,在终端命令行执行以下命令,或者点击图标“xgps”,即可进行搜星定位功能。
+
<syntaxhighlight lang="bash">
+
$su - fa -c "DISPLAY=:0 xgps 127.0.0.1:9999"
+
</syntaxhighlight>
+
* 或者,在debian界面上打开终端 LXTerminal ,输入 xgps 回车也可以打开GPS功能。
+
串口扩展模块的详情请查看[http://wiki.friendlyarm.com/wiki/index.php/Matrix_-_GPS/zh 点击查看]<br />
+
参考下图连接模块Matrix-GPS和NanoPi 2:<br />
+
[[File:GPS_NanoPi 2.png|frameless|600px|GPS_NanoPi_2]]
+
 
+
连接说明:
+
{| class="wikitable"
+
|-
+
|Matrix-GPS || NanoPi 2     
+
|-
+
|RXD    || Pin8
+
|-
+
|TXD    || Pin10
+
|-
+
|5V    || Pin4
+
|-
+
|GND    || Pin6
+
|}
+
 
+
===NanoPi 2使用I2C通讯设备===
+
* Matrix - I2C LCD1602 Keypad由液晶显示屏模块LCD1602和IIC扩展模块MCP23017构成,同时集成5个可独立编程按键,使用这些按键可以控制接在板子上的外设模块或者控制LCD显示的字符。
+
* Matrix - I2C LCD1602 Keypad使用I2C通讯,达到节约IO资源和简化控制的目的。通过此模块,可更清楚的了解NanoPi 2使用I2C设备如何通讯。
+
Matrix - I2C LCD1602 Keypad IIC通讯模块的详情请查看[http://wiki.friendlyarm.com/wiki/index.php/Matrix_-_I2C_LCD1602_Keypad/zh 点击查看]<br />
+
参考下图连接模块Matrix-I2C_LCD1602_Keypad和NanoPi 2:<br>
+
[[File:matrix-i2c_lcd1602_keypad_nanopi 2.jpg|frameless|600px|matrix-i2c_lcd1602_keypad_nanopi 2]]
+
 
+
连接说明:
+
{| class="wikitable"
+
|-
+
|Matrix-I2C_LCD1602_Keypad || NanoPi 2     
+
|-
+
|SDA    || Pin3
+
|-
+
|SCL    || Pin5
+
|-
+
|5V    || Pin4
+
|-
+
|GND    || Pin6
+
|}
+
 
+
===NanoPi 2使用SPI通讯设备===
+
* Matrix-2'8_SPI_Key_TFT模块是一款2.8英寸的TFT 触摸LCD,模块采用ST7789S驱动IC和XPT2046电阻式触摸IC,屏幕分辨率为320*240,采用SPI控制接口,模块还包含3个独立按键,可根据需要自定义功能。
+
Matrix-2'8_SPI_Key_TFT SPI通讯模块的详情请查看[http://wiki.friendlyarm.com/wiki/index.php/Matrix_-_2%278_SPI_Key_TFT/zh 点击查看]<br />
+
参考下图连接模块Matrix-2'8_SPI_Key_TFT和NanoPi 2:<br>
+
[[File:Matrix-2'8_SPI_Key_TFT_nanopi2.jpg|frameless|600px|Matrix-2'8_SPI_Key_TFT_nanopi2]]
+
 
+
连接说明:
+
{| class="wikitable"
+
|-
+
|Matrix-2'8_SPI_Key_TFT || NanoPi 2
+
|-
+
|GND        || Pin6
+
|-
+
|5V        || Pin2
+
|-
+
|LED_EN    || Pin11
+
|-
+
|LCD_RESET  || Pin7
+
|-
+
|LCD_D/C    || Pin22
+
|-
+
|LCD_CS    || Pin24
+
|-
+
|SPICLK    || Pin23
+
|-
+
|SPIMOSI    || Pin19
+
|-
+
|SPIMISO    || Pin21
+
|-
+
|T_CS      || Pin26
+
|-
+
|T_IRQ      || Pin18
+
|-
+
|}
+
 
+
===支持LCD型号===
+
* Android
+
NanoPi 2跑Android系统目前支持的LCD型号为友善出品的:S430、S700、S702、HD700、HD702、HD101、X710电容屏。
+
 
+
* Debian
+
NanoPi 2跑Debian系统目前支持的LCD型号为友善出品的:S430、S700、S702、HD700、HD702、HD101、X710电容屏;<br />
+
支持的电阻屏为友善出品的:W35B、H43、P43、S70、Matrix - 2'8 SPI Key TFT 电阻屏。<br />
+
以上所有LCD屏的详细资料均可在维基首页查看:[http://wiki.friendlyarm.com/wiki/index.php/Main_Page#LCDModules LCDModules]
+
 
+
==在Android下访问硬件资源==
+
友善电子开发了一个名为libfriendlyarm-hardware.so的函数库,用于Android应用程序访问开发板上的硬件资源,该函数库基于Android-NDK技术开发,提供便利的硬件访问接口,开发者无需掌握过多的嵌入式知识便可使用,有效提高开发进度。<br /><br />
+
目前支持的硬件设备包括:
+
* Serial Port
+
* PWM
+
* EEPROM
+
* ADC
+
* LED
+
* LCD 1602 (I2C)
+
* OLED (SPI)
+
<br />
+
支持的接口包括:
+
* GPIO
+
* Serial Port
+
* I2C
+
* SPI
+
<br />
+
详情使用说明可参考以下网址:<br />
+
* 硬件库主页: http://wiki.friendlyarm.com/wiki/index.php/Android_Hardware_Access
+
* 示例源代码仓库: https://github.com/friendlyarm/AndroidHardwareAccess
+
* 中文API参考手册: https://github.com/friendlyarm/AndroidHardwareAccess/blob/master/友善电子Android硬件开发指南.pdf
+
 
+
==更多OS==
+
===FriendlyCore===
+
Ubuntu Core with Qt-Embedded,是一个没有X-windows环境,使用Qt-Embedded作为图形界面的轻量级Ubuntu系统,基于官方的Ubuntu core系统开发而成,非常适合于企业用户用作产品的基础OS。
+
 
+
本系统除了保留Ubuntu core的特性以外,还包括以下特性:
+
*支持电容和电阻触摸屏 (型号:S700, X710, S70)
+
*支持WiFi连接
+
*支持以太网连接
+
*支持蓝牙,已预装bluez等相关软件包
+
*支持音频播放
+
*等等
+
 
+
请访问此处 [http://wiki.friendlyarm.com/wiki/index.php/Ubuntu_Core_with_Qt-Embedded Ubuntu Core with Qt-Embedded] 了解详情。
+
 
+
===Ubuntu-Mate===
+
Ubuntu-Mate基于Ubuntu系统,使用的桌面环境是Mate-desktop,界面简洁易用,需配合LCD或者HDMI使用,可通过ssh登录。<br>
+
仅提供给进阶爱好者交流使用,不对该系统提供专业技术支持。<br>
+
* 访问此处[http://pan.baidu.com/s/1boiCWWJ 下载地址]下载系统固件。
+
* 将固件解压后,在Windows下使用友善官方提供 win32diskimager 工具烧写Ubuntu-Mate即可。
+
* 烧写完成后,将SD卡插入NanoPi 2,上电即可体验Ubuntu-Mate。
+
* 登录账号:root或fa ; 登录密码:fa
+
 
+
===Kali===
+
* 首先访问此处[http://pan.baidu.com/s/1o7i4846]的下载地址下载需要的固件文件;
+
* 准备大于8G的高速microSD卡(建议使用友善官方测试过的SD卡),并插入linux主机,通过命令sudo fdisk -l 查看该sd卡是哪个设备即/dev/sd*。
+
* 下载后把文件写到卡里,使用超级用户权限执行下列命令:
+
<syntaxhighlight lang="bash">
+
xzcat kali-2.0-nanopi2.img.xz | dd of=<YOURDEVICE> bs=1m
+
</syntaxhighlight>
+
* 烧写完成,将卡插入设备,上电即可开始体验Kali操作系统。
+
* 登录账号:root ; 登录密码:toor
+
 
+
说明:此文件系统是由Kali官方制作,我们仅提供下载链接供爱好者使用,不对此做技术支持。
+
 
+
===深度操作系统 15 ARM===
+
* 首先访问此处[http://cdimage.deepin.com/armhf/15/beta1.0/]的下载地址下载需要的固件;
+
* 用文件,解压得到16g.img是microSD卡镜像文件。
+
<syntaxhighlight lang="bash">
+
tar -xf deepin15_nanopi2_armhf_16g.tar.gz
+
</syntaxhighlight>
+
* 准备好不小于16G的microSD卡,并插入linux主机,通过命令sudo fdisk -l 查看该sd卡是哪个设备即/dev/sd*
+
* 将镜像用dd命令刻录到microSD卡,我们假设microSD卡是 /dev/sdc(请根据实际情况判断,千万不要选错设备),那么用如下命令:
+
<syntaxhighlight lang="bash">
+
sudo dd if=16g.img of=/dev/sdc
+
</syntaxhighlight>
+
 
+
(根据microSD卡的读写性能不同,烧写时间一般为40~60分钟)
+
 
+
* 烧写完成,将卡插入设备,上电即可开始体验deepin15操作系统
+
 
+
 
+
其他注意事项:
+
1.登陆用户名deepin密码deepin,root密码admin。<br>
+
 
+
2.烧写成功后,第一次启动,会有些配置文件产生,开机会比较慢。<br>
+
 
+
3.如果系统开启无线网络功能,开机会较慢,请耐心等待任务栏右下角声音和无线模块出现后再进行其他操作,后期会继续优化。<br>
+
 
+
<syntaxhighlight lang="bash">
+
    ARM版仓库:http://packages.deepin.com/armhf/
+
 
+
    NanoPi 2镜像:http://cdimage.deepin.com/armhf/15/beta1.0/
+
 
+
    NanoPi 2镜像使用方法:http://bbs.deepin.org/forum.php?mod=viewthread&tid=36670
+
 
+
    ARM移植讨论:http://bbs.deepin.org/
+
 
+
</syntaxhighlight>
+
 
+
说明:此文件系统是由深度操作系统官方制作,我们仅提供下载链接供爱好者使用,不对此做技术支持。
+
 
+
===Android-Remixos===
+
首先访问[http://pan.baidu.com/s/1qYCbqDu]下载固件;<br>
+
仅提供给进阶爱好者交流使用,不对该系统提供专业技术支持。<br>
+
* 用文件,解压得到镜像文件:
+
<syntaxhighlight lang="bash">
+
tar -xf nanopi2-android-remixos-sd4g.tar
+
</syntaxhighlight>
+
* 将固件解压后,在Windows下使用友善官方提供 win32diskimager 工具烧写Android-Remixos即可。
+
该系统支持HDMI输出,LCD显示,并且同时支持友善出品的所有4418系列开发板。
+
 
+
==源代码和固件下载链接==
+
* 烧写固件下载链接:[http://wiki.friendlyarm.com/wiki/nanopi2/download/]
+
* 源代码下载链接:[https://github.com/friendlyarm]
+
 
+
==NanoPi 2 使用Python==
+
* 通过Python控制Compact Kit[http://wiki.friendlyarm.com/wiki/index.php/Matrix_-_Compact_Kit/zh]
+
 
+
==FAQ==
+
* '''常见问题'''
+
::{| class="wikitable"
+
|-
+
|拿到NanoPi 2板子后,到哪里下载文件? || NanoPi 2有完整的维基教程,如何下载维基有更详细描述。   
+
|-
+
|板子上电之后,蓝色灯不亮? || 1、板子供电不足,NanoPi 2供电必须使用5V/2A的电源(强烈建议使用官方出的UBS线供电);<br />
+
2、 使用的启动卡不是高速卡,建议使用Class10或以上的 8GB SDHC卡;<br />
+
3、重新使用官方最新固件做一张启动的SD卡;<br />
+
4、联系原厂技术支持排除问题。
+
|-
+
|上电后板子蓝灯亮,不闪烁?  ||1、板子供电不足,NanoPi 2供电必须使用5V/2A的电源(强烈建议使用官方出的UBS线供电);<br />
+
2、 使用的启动卡不是高速卡,建议使用Class10或以上的 8GB SDHC卡。<br />
+
3、重新使用官方最新固件做一张启动的SD卡。
+
|-
+
|板子不接屏时蓝灯闪烁,通过串口能看到正常启动,接了屏之后屏没有显示或者一直重启无法进入操作界面? ||1、板子供电不足,NanoPi 2供电必须使用5V/2A的电源(强烈建议使用官方出的UBS线供电);<br />
+
2、检查屏的排线是否接好,检查排线的是否折坏了;<br />
+
3、如果有串口,建议通过串口线查看能否识别到屏的型号。
+
|-
+
|板子蓝灯闪烁,通过串口看到板子能看到正常启动,接带HDMI的电脑显示屏无法显示? ||1、建议使用原生的HDMI转DVI线;<br />
+
2、推荐使用HDMI接口的电视或显示器。
+
|-
+
|烧写Debian系统连接HDMI后,播放视频没声音?||Debian系统接HDMI播放视频暂时没有声音,缺省没安装声音部分的安装包。
+
|-
+
|烧写Android系统连接HDMI,无法通过系统调声音? ||Android系统暂时还不支持调节音量,可通过遥控器调节HDMI的音量。
+
|-
+
|NanoPi 2维基链接打不开?      ||由于维基服务器搭在国外,打不开的情况一般是你的网络被防火墙过滤掉了,建议改一下PC机的DNS再打开。
+
|-
+
|NanoPi 2源码下载时间太长? ||由于github服务器搭在国外,第一次下载时间会比较长,之后再次下载需要的时间就比较短了。
+
|-
+
|}
+
 
+
==资源链接==
+
===手册原理图及开发资料===
+
* SEC_Users_Manual_S5P4418_Users_Manual_Preliminary([http://wiki.friendlyarm.com/wiki/index.php/File:SEC_Users_Manual_S5P4418_Users_Manual_Preliminary_Ver.0.10.pdf])
+
* 原理图 ([http://wiki.friendlyarm.com/wiki/images/e/ec/NanoPi-2-1507-Schematic.pdf NanoPi-2-1507-Schematic.pdf])
+
* 尺寸图 ([http://wiki.friendlyarm.com/wiki/images/4/45/NanoPi-2-1507-Dimesions%28dxf%29.zip NanoPi-2-1507-Dimesions(dxf).zip])
+
* AP6212 Datasheet ([http://wiki.friendlyarm.com/wiki/images/5/57/AP6212_V1.1_09022014.pdf AP6212_V1.1_09022014.pdf])
+
* 器件位号图(底层) ([http://wiki.friendlyarm.com/wiki/images/9/94/NanoPi2-Component-bot.pdf NanoPi2-Component-bot.pdf])
+
* 器件位号图(顶层) ([http://wiki.friendlyarm.com/wiki/images/b/b9/NanoPi2-Component-top.pdf NanoPi2-Component-top.pdf])
+
===创客秘籍及开发教程===
+
* 《创客秘籍》[http://wiki.friendlyarm.com/wiki/index.php/File:%E5%88%9B%E5%AE%A2%E7%A7%98%E7%B1%8D.pdf 创客秘籍]
+
* 《创客秘籍-02》[http://pan.baidu.com/s/1hrDu9es 创客秘籍-02]
+
* 《创客秘籍-03》[http://wiki.friendlyarm.com/wiki/index.php/File:%E5%88%9B%E5%AE%A2%E7%A7%98%E7%B1%8D-03.pdf 创客秘籍-03]
+
* 模块介绍以及开发文档:
+
** [http://wiki.friendlyarm.com/wiki/index.php/Matrix_-_Button/zh 按键模块]
+
** [http://wiki.friendlyarm.com/wiki/index.php/Matrix_-_LED/zh LED模块]
+
** [http://wiki.friendlyarm.com/wiki/index.php/Matrix_-_Analog_to_Digital_Converter/zh 模数转换]
+
** [http://wiki.friendlyarm.com/wiki/index.php/Matrix_-_Relay/zh 继电器模块]
+
** [http://wiki.friendlyarm.com/wiki/index.php/Matrix_-_3-Axis_Digital_Accelerometer/zh 三轴重力加速度模块]
+
** [http://wiki.friendlyarm.com/wiki/index.php/Matrix_-_3-Axis_Digital_Compass/zh 三轴数字指南针模块]
+
** [http://wiki.friendlyarm.com/wiki/index.php/Matrix_-_Temperature_Sensor/zh 温度传感器模块]
+
** [http://wiki.friendlyarm.com/wiki/index.php/Matrix_-_Temperature_and_Humidity_Sensor/zh 温湿度传感器模块]
+
** [http://wiki.friendlyarm.com/wiki/index.php/Matrix_-_Buzzer/zh 蜂鸣器]
+
** [http://wiki.friendlyarm.com/wiki/index.php/Matrix_-_Joystick/zh 摇杆模块(Joystick)]
+
** [http://wiki.friendlyarm.com/wiki/index.php/Matrix_-_I2C_LCD1602_Keypad/zh I2C(PCF8574)+LCD1602]
+
** [http://wiki.friendlyarm.com/wiki/index.php/Matrix_-_Sound_Sensor/zh 声音传感器]
+
** [http://wiki.friendlyarm.com/wiki/index.php/Matrix_-_Ultrasonic_Ranger/zh 超声波模块]
+
** [http://wiki.friendlyarm.com/wiki/index.php/Matrix_-_GPS/zh GPS模块]
+
** [http://wiki.friendlyarm.com/wiki/index.php/Matrix_-_Compact_Kit/zh 迷你扩展板Matrix - Compact Kit]
+
** [http://wiki.friendlyarm.com/wiki/index.php/Matrix_-_Fire_Sensor 火焰传感器]
+
** [http://wiki.friendlyarm.com/wiki/index.php/Matrix_-_CAM500A/zh CAM500 500万像素摄像头]
+
** [http://wiki.friendlyarm.com/wiki/index.php/Matrix_-_BAll_Rolling_Switch/zh 滚珠开关模块]
+
** [http://wiki.friendlyarm.com/wiki/index.php/Matrix_-_2%278_SPI_Key_TFT/zh 2'8 SPI Key TFT 2.8寸spi液晶屏]
+
** [http://wiki.friendlyarm.com/wiki/index.php/Matrix_-_IR_Counter/zh 红外计数模块]
+
** [http://wiki.friendlyarm.com/wiki/index.php/Matrix_-_IR_Receiver/zh 红外接收模块]
+
** [http://wiki.friendlyarm.com/wiki/index.php/Matrix_-_L298N_Motor_Driver/zh 电机驱动器模块]
+
** [http://wiki.friendlyarm.com/wiki/index.php/Matrix_-_MQ-2_Gas_Sensor/zh MQ-2 烟雾传感器模块]
+
** [http://wiki.friendlyarm.com/wiki/index.php/Matrix_-_MQ-3_Gas_Sensor/zh MQ-3 气体传感器]
+
** [http://wiki.friendlyarm.com/wiki/index.php/Matrix_-_One_Touch_Sensor/zh 单点电容式数字触摸传感器模块]
+
** [http://wiki.friendlyarm.com/wiki/index.php/Matrix_-_Photoresistor/zh 光敏电阻模块]
+
** [http://wiki.friendlyarm.com/wiki/index.php/Matrix_-_Potentiometer/zh 电位器模块]
+
** [http://wiki.friendlyarm.com/wiki/index.php/Matrix_-_Pressure_and_Temperature_Sensor 压力传感器模块]
+
** [http://wiki.friendlyarm.com/wiki/index.php/Matrix_-_RGB_LED/zh RGB LED]
+
** [http://wiki.friendlyarm.com/wiki/index.php/Matrix_-_RTC/zh RTC模块]
+
** [http://wiki.friendlyarm.com/wiki/index.php/Matrix_-_Rotary_Encoder/zh Rotary Encoder]
+
** [http://wiki.friendlyarm.com/wiki/index.php/Matrix_-_Soil_Moisture_Sensor/zh 土壤湿度检测传感器模块]
+
** [http://wiki.friendlyarm.com/wiki/index.php/Matrix_-_Thermistor/zh 热敏电阻模块]
+
** [http://wiki.friendlyarm.com/wiki/index.php/Matrix_-_USB_WiFi/zh USB WiFi]
+
** [http://wiki.friendlyarm.com/wiki/index.php/Matrix_-_Water_Sensor 水位/水滴识别检测传感器模块]
+
 
+
==更新日志==
+
 
+
===2017-06-13 ===
+
Linux, Android系统:
+
* 改善了整体系统稳定性;
+
Android系统:
+
* 提升Android下ov5640拍照的稳定性;
+
 
+
===2017-04-18===
+
Ubuntu-Core系统更新如下:
+
* 修改了登录欢迎界面,当用户登录时会打印系统的基本状态信息;
+
* 增加 npi-config 工具,npi-config是一个命令行下的系统配置工具,可以对系统进行一些初始化的配置,可配置的项目包括:用户密码、系统语言、时区、Hostname、SSH开关、自动登录选项等,在命令行执行以下 sudo npi-config 即可进入;
+
* 预装NetworkManager作为网络管理工具;
+
* 新增pi用户,并配置为自动登录,自动登录特性可以使用npi-config工具配置;
+
 
+
===2017-03-08===
+
 
+
1) 启用UART2 <br />
+
2) 增加HD101B屏幕的支持 <br />
+
3) Android4.4和Android5增加硬件访问库,具体可参考:[http://wiki.friendlyarm.com/wiki/index.php/Android_Hardware_Access] <br />
+
4) 修正S430屏在Android4.4下的闪退问题
+
 
+
===2017-02-09===
+
 
+
1) 在Ubuntu Core和Debian系统中 增加7寸电阻屏 S70B 的支持<br /> 
+
2) 调整了 eFlasher Rom 的分区大小,将根分区调整为 1GB
+
 
+
===2016-11-17===
+
 
+
增加H43屏的支持: <br />
+
1) 支持s5p4418与s5p6818平台的开发板  <br />
+
2) OS方面仅支持Debian 和 Ubuntu Core系统,不支持Android <br />
+
 
+
===2016-09-02===
+
 
+
1) Debian 和 Ubuntu Core集成了CAM500A(ov5640)摄像头的demo程序(nanocams); <br />
+
2) 更新了Android 串口访问的程序,下载源代码: <br />
+
<syntaxhighlight lang="bash">
+
git clone https://github.com/friendlyarm/android_SerialPortDemo.git
+
</syntaxhighlight>
+
以前下载过的,用git pull命令更新一下。 <br />
+
内有详细说明,包括eclipse编译、打包成apk,对apk重新签名以获取system权限、关闭selinux等说明文档: <<SerialPortDemo-manual.pdf>>; <br />
+
本次更新适用于NanoPi2, NanoPi 2 Fire, NanoPi-M2, NanoPC-T2, Smart4418 <br />
+
 
+
===2016-08-20===
+
 
+
1) 推出Android4.4固件(s5p4418-kitkat-sd4g-20160803.img.zip) 和源码,Android4.4是专门为企业用户定制,并且支持4G通讯模块,即插即用; <br />
+
2) 推出一键烧写系统的固件s5p4418-eflasher-sd8g-xxx-full.img,直接下载固件回来使用LCD即可一键烧写系统; <br />
+
本次更新适用于NanoPi2, NanoPi 2 Fire, NanoPi-M2, NanoPC-T2, Smart4418 <br />
+
 
+
===2016-07-01===
+
 
+
1) 修复了Ubuntu Core下USB Wi-Fi无法加载固件的问题; <br />
+
2) 更新了Bootloader,支持使用dd命令直接将RAW image写入eMMC并能正常启动; <br />
+
3) 内核bug修正及提高稳定性; <br />
+
本次更新适用于NanoPi2, NanoPi 2 Fire, NanoPi-M2, NanoPC-T2, Smart4418 <br />
+
 
+
===2016-05-21===
+
 
+
* Android
+
1) 增加以太网设置(支持静态IP和DHCP设置); <br />
+
2) 增加硬件访问库 libfriendlyarm-hardware.so,可用于在Android下操作串口; <br />
+
使用方法可参考此份文档:http://www.arm9home.net/read.php?tid-82748.html。 <br />
+
在 NanoPi2/NanoPi M2/NanoPi2 Fire/NanoPC-T2 上,串口对应的设备名称如下: <br />
+
UART2 -> 未驱动 <br />
+
UART3 -> /dev/ttyAMA2 <br />
+
UART4 -> /dev/ttyAMA3 <br />
+
3) 增加iTest应用程序,内置串口助手功能; <br />
+
注意:运行此串口程序,需要使用system权限。 <br />
+
 
+
* Debian
+
1)增强了内核稳定性; <br />
+
 
+
* Ubuntu core with Qt-Embedded
+
1)开机后显示的界面由Qt Demo换成了一个由友善之臂开发的,开源的Qt程序 (源代码位于/opt
+
目录),该程序启动时显示系统状态信息,例如CPU和内存信息,工作温度和负载等信息,
+
系统同时集成了 qmake,uic 等Qt工具的arm版本,这样你 就可以在开发板上直接生成和编译Qt源代码。 <br />
+
本次更新适用于NanoPi2, NanoPi 2 Fire, NanoPi-M2, NanoPC-T2, Smart4418 <br />
+
 
+
===2016-04-19===
+
 
+
1)增加Debian/Ubuntu第一次开机时自动扩展分区和根文件系统,第一次启动时间会稍长  <br />
+
2) 改善非正常关机/重启导致的根文件系统问题; <br />
+
3) Debian/Ubuntu Core集成原厂开源硬解播放器NxPlayerConsole,须连LCD使用。(原厂库没有源代码) <br />
+
4) Ubuntu Core集成了OpenGL的测试程序gltest1, 完全开源 <br />
+
5)Debian/Ubuntu Core增加了USB Wi-Fi - rtl8187的支持; <br />
+
6) Debian/Ubuntu Core系统的USB摄像头的设备修改为 /dev/video0,方便opencv <br />
+
7) 用wpa_supplicant代替wicd来管理无线网络,使得Console下和X下的网络配置接口上保持一致 <br />
+
本次更新适用于NanoPi2, NanoPi 2 Fire, NanoPi-M2, NanoPC-T2, Smart4418 <br />
+
 
+
 
+
===2016-04-01===
+
 
+
* Debian:
+
1) Debian增加了常用USB Wi-Fi和USB串口的支持; <br />
+
2) 修正了带声卡的板音频输出切换的问题; <br />
+
3) 优化内核,改进稳定性; <br />
+
4) 增加LVDS接口的支持(缺省未启用); <br />
+
* Ubuntu core with Qt-Embedded系统
+
新增系统:Ubuntu Core with Qt-Embedded,这是一个没有X-windows环境,使用Qt-Embedded作为图形界面的轻量级Ubuntu系统,基于官方的Ubuntu core系统开发而成,非常适合于企业用户用作产品的基础OS。<br />
+
本系统除了保留Ubuntu core的特性以外,还包括以下特性: <br />
+
1) 支持电容和电阻触摸屏 (型号:S700, X710, S70) <br />
+
2) 支持WiFi连接 <br />
+
3) 支持以太网连接 <br />
+
4) 支持蓝牙,已预装bluez等相关软件包 <br />
+
5) 支持音频播放 <br />
+
详细可参考WiKi页面:http://wiki.friendlyarm.com/wiki/index.php/Ubuntu_Core_with_Qt-Embedded/zh <br />
+
 
+
 
+
===2016-02-29===
+
 
+
* Kernel:
+
1) 增加了基于CPU ECID生成以太网MAC地址; <br />
+
2) 修复了framebuffer console刷新不及时的问题; <br />
+
3) 优化内核提升了系统运行的稳定性; <br />
+
4) 修复了PWM LED的一个bug,基于PWM LED增加了呼吸灯效果的trigger; <br />
+
* Debian:
+
1) 修复了hostname异常的bug; <br />
+
2) 缺省启用framebuffer console, 可在LCD/HDMI看到启动信息; <br />
+
3) 集成了设置uboot环境变量的工具fw_printenv; <br />
+
* Android:
+
ROM缺省启用了ffmpeg, 可支持更多的视频格式. <br />
+
 
+
===2015-12-01===
+
* 推出新的Android 5.1.1_r6,源代码已推送到 https://github.com/friendlyarm 。
+
* 4.2.1 简易方法制作: 新的固件已支持LCD检测,因此原来分别支持LCD和HDMI的固件已合并为一个固件。
+
* 4.3 在电脑上修改SD卡上的系统: 部分内容只适应于旧版本固件,标记为删除状态。
+
* 6 如何编译系统: 编译时源代码分支更新为 nanopi2-lollipop-mr1。
+
* 6.4.2 编译内核模块: 增加了如何编译支持LCD显示的启动Debian的uImage。
+

Revision as of 08:52, 23 December 2017

English

1 介绍

Overview
Front
Back
  • NanoPi 2 是友善之臂专门为创客和物联网设计的高性能硬件开发平台,采用Cortex-A9架构的四核S5P4418处理器(主频1.4GHz),内存为1G DDR3,同时板上集成了802.11 b/g/n无线网卡及蓝牙4.0模块,可支持Android与Debian双系统,支持HDMI和LCD同步输出,并拥有丰富的扩展接口,兼容树莓派GPIO,PCB尺寸只有40*75mm。

2 资源特性

  • CPU: S5P4418, 运行主频1.4GHz
  • RAM: 1GB DDR3
  • 集成SDIO WiFi蓝牙模块
  • USB 2.0 Type A x1
  • 调试串口 x1
  • microSD Slot x2
  • microUSB x1: 支持供电和数据传输,可模拟为串口和以太网
  • LCD接口: 0.5mm间距贴片FPC座,支持全彩LCD (RGB:8-8-8)
  • HDMI: 符合1.4a规范, Type-A连接器, 1080P60输出
  • DVP Camera接口:0.5mm间距竖直贴片FPC座,包含ITU-R BT 601/656 8-bit,I2C和IO
  • GPIO1: 2.54mm间距,40pin, 兼容RPi的GPIO,含UART, SPI, I2C, IO等管脚资源
  • 按键: 用户按键一个, 复位按键一个
  • LED: 电源LED一个, 用户LED一个
  • PCB 尺寸: 75 x 40mm
  • 供电: DC 5V/2A
  • 软件支持: 安卓, Debian

compact compact with raspberry pi and beagleboard

3 接口布局和尺寸

3.1 接口布局

NanoPi 2接口布局
NanoPi 2 MicroSD
  • GPIO1管脚定义
Pin# Name Pin# Name
1 VDD_SYS_3.3V 2 VDD_5V
3 I2C0_SDA 4 VDD_5V
5 I2C0_SCL 6 DGND
7 UART4_RX/GPIOB28 8 UART3_TXD/GPIOD21
9 DGND 10 UART3_RXD/GPIOD17
11 UART4_TX/GPIOB29 12 GPIOB26
13 GPIOB30 14 DGND
15 GPIOB31 16 PWM2/GPIOC14
17 VDD_SYS_3.3V 18 GPIOB27
19 SPI0_MOSI/GPIOC31 20 DGND
21 SPI0_MISO/GPIOD0 22 PWM0/GPIOD1
23 SPI0_CLK/GPIOC29 24 SPI0_CS/GPIOC30
25 DGND 26 PWM1/GPIOC13
27 I2C1_SDA 28 I2C1_SCL
29 GPIOC8 30 DGND
31 SPI2_CLK/GPIOC9 32 GPIOC28
33 SPI2_CS/GPIOC10 34 DGND
35 SPI2_MOSI/GPIOC12 36 GPIOC7
37 SPI2_MISO/GPIOC11 38 ALIVEGPIO2
39 DGND 40 ALIVEGPIO3
  • Debug Port CON1(UART0)
Pin# Name
1 DGND
2 VDD_5V
3 TXD0
4 RXD0
  • DVP Camera IF 管脚定义
Pin# Name
1, 2 VDD_SYS_3.3V
7,9,13,15,24 DGND
3 SCL0
4 SDA0
5 GPIOB14
6 GPIOB16
8,10 NC
11 VSYNC
12 HREF
14 PCLK
16-23 Data bit7-0
  • RGB LCD IF 管脚定义
Pin# Name Description
1, 2 VDD_5V 5V输出, 可以给LCD模组供电
11,20,29, 37,38,39,40, 45 DGND 参考地, 0电位
3-10 Blue LSB to MSB RGB的蓝色信号
12-19 Green LSB to MSB RGB的绿色信号
21-28 Red LSB to MSB RGB的红色信号
30 GPIOB25 普通GPIO, 用户可控制
31 GPIOC15 一线协议信号, 以实现LCD型号识别, 背光控制和电阻触摸的功能. 系统已占用, 用户不可重新设置.
32 XnRSTOUT Form CPU 系统复位时向外输出低电平
33 VDEN 指示RGB信号有效的信号
34 VSYNC 场信号
35 HSYNC 行信号
36 LCDCLK LCD频率, Pixel frequency
41 SCL2 I2C2的时钟信号, 用来传输电容屏触摸数据
42 SDA2 I2C2的数据信号, 用来传输电容屏触摸数据
43 GPIOC16 电容触摸中断信号, 配合I2C2使用
44 NC 没有任何连接
说明
  1. VDD_SYS_3.3V: 3.3V电源输出
  2. VDD_5V: 5V电源输入/输出。当电压大于MicroUSB时,向板子供电,否则板子从MicroUSB取电。输入范围:4.7~5.6V。
  3. 更详细的信息请查看原理图:NanoPi-2-1507-Schematic.pdf

3.2 机械尺寸

NanoPi 2 Dimension

详细尺寸:NanoPi-2-1507-Dimesions(dxf).zip

4 快速入门

4.1 准备工作

要开启你的NanoPi2新玩具,请先准备好以下硬件

  • NanoPi 2 主板
  • microSD卡/TF卡: Class10或以上的 8GB SDHC卡
  • 一个microUSB接口的外接电源,要求输出为5V/2A(可使用同规格的手机充电器)
  • 一台支持HDMI输入的显示器或者电视(或选购LCD配件)
  • 一套USB键盘鼠标,同时连接还需要USB HUB (或选购串口转接板,要PC上进行操作)
  • 一台电脑,需要联网,建议使用Ubuntu 16.04 64位系统

4.2 扩展TF卡分区

  • Debian/Ubuntu系统在启动的时候,会自动扩展SD卡分区,第一次开机时自动扩展分区和根文件系统。
  • Android扩展分区,要在pc上执行下列操作:
sudo umount /dev/sdx?
sudo parted /dev/sdx unit % resizepart 4 100 resizepart 7 100 unit MB print
sudo resize2fs -f /dev/sdx7

(注:/dev/sdx请替换为实际的SD卡设备文件名)

4.3 关于LCD/HDMI分辨率

系统启动时uboot会自动识别LCD,成功则会设置为该LCD的显示分辨率,失败则缺省会设置为HDMI 720P模式。
如果要修改LCD的显示分辨率,可以直接修改内核中的文件 arch/arm/plat-s5p4418/nanopi2/lcds.c , 然后重新编译内核并更新即可。
对于HDMI的显示模式,Android则是会通过EDID获得HDMI设备如电视机所支持的显示模式,然后自动选择一个合适的分辨率。如果使用的是Debian,则缺省是720P,可通过修改内核配置来切换为1080P。

4.4 在电脑上更改SD卡的启动参数

将制作好SD卡插入一台运行Linux的电脑,可以挂载SD卡上的boot和rootfs等分区,对分区内容进行修改,想更改Kernel Command Line参数,则可以通过fw_setenv工具来操作,方法如下:
先查看当前的内核启动参数:

git clone https://github.com/friendlyarm/sd-fuse_nanopi2.git
cd sd-fuse_nanopi2/tools ./fw_printenv /dev/sdx | grep bootargs

例如要禁用Android的SELinux特性,可以执行以下命令:

./fw_setenv /dev/sdx bootargs XXX androidboot.selinux=permissive

其中上面的XXX需要替换成原来的bootargs值, /dev/sdx替换为你的SD卡设备。

4.5 运行Android或Linux

  • 将制作好SD卡插入NanoPi2,连接HDMI,按住靠近网口的boot按键,最后接电源(5V 2A)拨动开关,NanoPi2会从SD卡启动。你可以看到板上PWR灯常亮,LED1灯闪烁,这说明系统已经开始启动了,同时电视上也将能看到系统启动的画面。
  • 要在电视上进行操作,你需要连接USB鼠标和键盘;如果你选购了LCD配件,则可以直接使用LCD上面的触摸屏进行操作。

5 FriendlyCore的使用

5.1 介绍

FriendlyCore,是一个没有X-windows环境,基于Ubuntu core构建的系统,使用Qt-Embedded作为图形界面的轻量级系统,兼容Ubuntu系统软件源,非常适合于企业用户用作产品的基础OS。

本系统除了保留Ubuntu Core的特性以外,还包括以下特性:

  • 支持电容和电阻触摸屏 (型号:S700, X710, S70, HD702, S430, HD101, S70等友善电子推出的LCD屏)
  • 支持WiFi连接
  • 支持以太网连接
  • 支持蓝牙,已预装bluez等相关软件包
  • 支持音频播放
  • 支持Qt 5.10.0 EGLES和OpenGL ES1.1/2.0 (限S5P4418/S5P6818平台)

5.2 运行FriendlyCore

  • 对于有HDMI接口的板子,如果要在电视上进行操作,您需要连接USB鼠标和键盘。
  • 如果您需要进行内核开发,最好选购一个串口配件,连接了串口,则可以通过串口终端对开发板进行操作。

使用串口模块能有效地提升开发效率,以下是串口模块的连接方法:
接上串口后,您可以选择从串口模块的DC口或者从MicroUSB口 (如果有) 进行供电:
以NanoPi-M1为例:
PSU-ONECOM-M1.jpg
也可以使用USB转串口模块调试,请注意需要使用5V/2A电源给开发板MicroUSB供电:
以NanoPi-NEO2为例:
USB2UART-NEO2.jpg

  • FriendlyCore默认帐户:

普通用户:

   用户名: pi
   密码: pi

Root用户:

   用户名: root
   密码: fa

默认会以 pi 用户自动登录,你可以使用 sudo npi-config 命令取消自动登录。

  • 更新软件包:
$ sudo apt-get update

5.3 开发Qt应用

请参考 How to Build and Install Qt Application for FriendlyELEC Boards/zh

5.4 开机自动运行Qt示例程序

使用npi-config工具进行开启:

sudo npi-config

进入Boot Options -> Autologin -> Qt/Embedded,选择Enable然后重启即可。

5.5 扩展TF卡文件系统

第一次启动FriendlyCore系统时,系统会自动扩展文件系统分区,请耐心等待,TF卡/eMMC的容量越大,需要等待的时间越长,进入系统后执行下列命令查看文件系统分区大小:

df -h

5.6 使用蓝牙传输文件

以传输文件到手机为例进行说明,首先,将你的手机蓝牙设置为可侦测状态,然后执行以下命令开始蓝牙搜索:

hcitool scan


搜索到设备时,结果举例如下:

Scanning ...
    2C:8A:72:1D:46:02   HTC6525LVW

这表示搜索到一台名为HTC6525LVW的手机,我们记下手机名称前面的MAC地址,然后用sdptool命令查看该手机支持的蓝牙服务:

sdptool browser 2C:8A:72:1D:46:02

注:上述命令中的MAC地址请替换成手机实际的蓝牙MAC地址
这个命令会详细列出手机蓝牙所支持的协议,我们需要关心的是一个名为 OBEX Object Push 的文件传输服务,以HTC6525LVW手机为例,其显示结果如下所示:

Service Name: OBEX Object Push
Service RecHandle: 0x1000b
Service Class ID List:
  "OBEX Object Push" (0x1105)
Protocol Descriptor List:
  "L2CAP" (0x0100)
  "RFCOMM" (0x0003)
    Channel: 12
  "OBEX" (0x0008)
Profile Descriptor List:
  "OBEX Object Push" (0x1105)
    Version: 0x0100

从上面的信息可以看到,这个手机的OBEX Object Push服务的所用的频道是12, 我们需要将它传递给obexftp命令,最后发起文件传输请求的命令如下:

obexftp --nopath --noconn --uuid none --bluetooth -b 2C:8A:72:1D:46:02 -B 12 -put example.jpg

注:上述命令中的MAC地址、频道和文件名请替换成实际的

执行上述命令后,请留意手机屏幕,正常情况下手机会弹出配对和接收文件的提示,确定后就开始文件传輪了。

蓝牙常见问题:
1) 开发板上找不到蓝牙设备, 可尝试用以下命令开启蓝牙:

rfkill unblock 0

2) 提示找不到相关命令,可尝试用以下命令安装相关软件:

apt-get install bluetooth bluez obexftp openobex-apps python-gobject ussp-push

5.7 连接WiFi

无论是SD WiFi还是USB WiFi, 它们的连接方式都是一样的。正基科技的APXX系列芯片属于SD WiFi,另外系统默认也已经支持市面上众多常见的USB WiFi,已测试过的USB WiFi型号如下:

序号 型号
1 RTL8188CUS/8188EU 802.11n WLAN Adapter
2 RT2070 Wireless Adapter
3 RT2870/RT3070 Wireless Adapter
4 RTL8192CU Wireless Adapter
5 小米WiFi mt7601
6 5G USB WiFi RTL8821CU
7 5G USB WiFi RTL8812AU

目前使用 NetworkManager 工具来管理网络,其在命令行下对应的命令是 nmcli,要连接WiFi,相关的命令如下:

  • 切换到root账户
$ su root
  • 查看网络设备列表
$ nmcli dev

注意,如果列出的设备状态是 unmanaged 的,说明网络设备不受NetworkManager管理,你需要清空 /etc/network/interfaces下的网络设置,然后重启.

  • 开启WiFi
$ nmcli r wifi on
  • 扫描附近的 WiFi 热点
$ nmcli dev wifi
  • 连接到指定的 WiFi 热点
$ nmcli dev wifi connect "SSID" password "PASSWORD" ifname wlan0

请将 SSID和 PASSWORD 替换成实际的 WiFi名称和密码。
连接成功后,下次开机,WiFi 也会自动连接。

更详细的NetworkManager使用指南可参考这篇文章: Use NetworkManager to configure network settings

如果你的USB WiFi无法正常工作, 大概率是因为文件系统里缺少了对应的USB WiFi固件。对于Debian系统, 可以在Debian-WiFi里找到并安装USB WiFi芯片的固件。而对于Ubuntu系统, 则可以通过下列命令安装所有的USB WiFi固件:

$ apt-get install linux-firmware

一般情况下, 各种WiFi芯片的固件都存放在/lib/firmware目录下。


5.8 连接以太网

默认插上网线开机,会自动连接并通过DHCP获取IP地址,如需要配置静态IP地址,请参考 NetworkManager 的相关文档: Use NetworkManager to configure network settings


5.9 定制命令行的欢迎信息(文字LOGO)

欢迎信息主要是这个目录下的脚本来打印的:

/etc/update-motd.d/

比如要修改 FriendlyELEC 的大字LOGO,可以修改/etc/update-motd.d/10-header 这个文件,比如要将LOGO改为HELLO,可将以下行:

TERM=linux toilet -f standard -F metal $BOARD_VENDOR

改为:

TERM=linux toilet -f standard -F metal HELLO

5.10 修改时区

例如更改为Shanghai时区:

sudo rm /etc/localtime
sudo ln -ls /usr/share/zoneinfo/Asia/Shanghai /etc/localtime

5.11 选择系统默认音频设备

如果当前系统存在多个音频设备, 例如HDMI-Audio、3.5mm耳机座、I2S-Codec时, 可以通过下列操作设置系统默认使用的音频设备。

  • 启动板子后,执行以下步骤安装alsa包:
$ apt-get update
$ apt-get install libasound2
$ apt-get install alsa-base
$ apt-get install alsa-utils
  • 安装好需要的库后,查看系统当前所有的声卡设备的序列号。这里假设aplay的输出如下, 并不是真实情况, 请根据实际情况进行相对应的修改:
$ aplay -l
card 0: HDMI
card 1: 3.5mm codec
card 2: I2S codec

上面的信息表示card 0代表HDMI-Audio,card 1代表3.5mm耳机座, card 2代表I2S-Codec,修改配置文件/etc/asound.conf如下表示选择HDMI-Audio:

pcm.!default {
    type hw
    card 0
    device 0
}
 
ctl.!default {
    type hw
    card 0
}

如果将card 0修改为card 1, 则表示选择3.5mm耳机座, 以此类推。
拷贝一首 .wav 格式的音乐到开发板上,播放音乐:

$ aplay /root/Music/test.wav

可以听见从系统默认的音频设备里输出音频。
如果您使用的开发板是H3/H5/H2+系列并且使用的是主线内核,那么更简便的方法是使用npi-config


5.12 运行 Qt 5.10.0 演示程序

FriendlyCore系统集成了Qt 5.10.0图形库,支持OpenGL硬件加速,在命令行输出以下命令,可预览Qt5演示程序,
Qt5演示程序的界面如下图所示,你可以使用触摸屏或者鼠标来操作,Qt5支持大部分FriendlyELEC在售的LCD触摸屏:

$ sudo qt5demo

S5pxx18-QtE

5.13 运行 Qt5-OpenGL示例

Run the following command

. setqt5env
cd $QTDIR
cd /examples/opengl/qopenglwidget
./qopenglwidget

更多示例可以在这里找到:
cd $QTDIR/examples/

5.14 硬解播放高清视频

FriendlyCore系统集成支持VPU加速的GStreamer 1.0多媒体开发框架, 可在命令行输入以下命令,播放1080P的演示视频:

sudo gst-player /home/pi/demo.mp4

gst-player是一个GStreamer播放器的外壳程序,上面命令等效于Gsteamer的以下命令:

sudo gst-launch-1.0 filesrc location=/home/pi/demo.mp4 ! qtdemux name=demux demux. ! queue ! faad ! audioconvert ! audioresample ! alsasink device="hw:0,DEV=1" demux. ! queue ! h264parse ! nxvideodec ! nxvideosink dst-x=0 dst-y=93 dst-w=1280 dst-h=533

5.15 连接DVP摄像头模块(CAM500B)

CAM500B是一款500万像素摄像头模块,以DVP并行信号输出,详细信息请参考Matirx-CAM500B
输入以下命令预览图像:

gst-launch-1.0 -e v4l2src device=/dev/video6 ! video/x-raw,format=I420,framerate=30/1,width=1280,height=720 ! nxvideosink

输入以下命令开始录像 (VPU硬编码):

gst-launch-1.0 -e v4l2src device=/dev/video6 ! video/x-raw,format=I420,framerate=30/1,width=1280,height=720 ! tee name=t t. \
 ! queue ! nxvideosink t. ! queue ! nxvideoenc bitrate=12000000 ! mp4mux ! \
 filesink location=result_720.mp4

5.16 电源管理: 关机和定时开机

“PMU Power Management” 特性支持 软件关机和定时开机功能.

使用方法如下:
设置100秒后自动开机 (设置的时间不得低于60秒):

$ sudo echo 100 > /sys/class/i2c-dev/i2c-3/device/3-002d/wakealarm

设置了定时开机之后,就可以用 poweroff 关机了:

$ sudo poweroff

以下命令用于取消定时开机:

$ sudo echo 0 > /sys/class/i2c-dev/i2c-3/device/3-002d/wakealarm

用以下命令查询当前的设置, 前面的是单片机当前时间,后面是定时开机时间,如果定时开机已禁止就是 disabled:

$ sudo cat /sys/class/i2c-dev/i2c-3/device/3-002d/wakealarm


需要注意的是,旧版本的硬件由于没有集成PMU所以可能没有这个功能,如果你在文件系统里没有发现这个文件节点:
/sys/class/i2c-dev/i2c-3/device/3-002d/wakealarm
那就是说明你所用的硬件不支持这个特性。

5.17 安装与使用 OpenCV 4.1.2

在新版本的 FriendlyCore 中已经预装了 OpenCV 4.1.2,无需手动安装,如需手动安装到自已的系统中,可参考以下仓库:
https://github.com/friendlyarm/install-opencv-on-friendlycore/blob/s5pxx18/README.md

运行OpenCV示例:

. /usr/bin/cv-env.sh
. /usr/bin/setqt5env-eglfs
cd /usr/local/share/opencv4/samples/python
python3 turing.py

5.18 安装与使用 Caffe

使用如下命令:

git clone https://github.com/friendlyarm/install-caffe-on-friendlycore
cd install-caffe-on-friendlycore
sudo ./install-caffe.sh

6 更新日志

6.1 日期 2023-01-09

6.1.1 FriendlyCore更新说明:

  • 优化了开机服务

6.2 日期 2020-10-26

  • FriendlyCore, Lubuntu更新如下:

修正蓝牙稳定性问题

6.3 日期 2019-12-28

  • eflasher更新如下:

1) 支持只烧写部分文件,例如仅更新emmc内的内核和uboot
2) 在界面上增加禁用overlay filesystem选项
3) 增加命令行参数,方便脚本调用,可以实现无交互的一键安装
4) 修正备份与恢复镜像后,不同设备会出现相同mac地址的问题
5) UI界面现在可以配置标题,隐藏界面菜单与按钮

6.4 日期 2019-11-26

  • FriendlyCore:

预装 OpenCV 4.1.2

6.5 日期 2019-11-14

  • 新系统 FriendlyWrt:

推出完全开源的FriendlyWrt路由器系统, 基于官方OpenWrt定制,详情可查看:http://wiki.friendlyelec.com/wiki/index.php/How_to_Build_FriendlyWrt

  • FriendlyCore, Lubuntu更新如下:

1)增加了新的4.3寸屏YZ43的支持
2)编译bcmdhd为模块,方便加载模块时传递参数以及定制

  • Android7更新如下:

1)增加了新的4.3寸屏YZ43的支持
2)优化Android 7系统下使用HD900屏幕与S702屏幕时的触摸与按键体验

6.6 日期 2019-10-18

  • Android7 与 FriendlyCore, Lubuntu更新如下:

修正音频播放在某些情况下可能会出现杂音的问题。

6.7 日期 2019-09-30

  • Android7 更新如下:

1)增加Android硬件访问库FriendlyThing的支持,支持GPIO、PWM、RTC、串口和看门狗等硬件资源的访问,提供开源demo
2) 增加摄像头 CAM500B (OV5640) 的支持
3) 增加 LCD-W500 (800x480) 的支持
4) 修正 LCD-S430 的兼容性问题

  • FriendlyCore, Lubuntu 更新如下:

1) 内核版本更新到 v4.4.172,与Android 7内核保持一致
2) 增加Docker的支持, 支持32bit与64bit文件系统 (使用方法请在具体产品的wiki页面搜索docker)
3) 内核配置项进行了优化,启用更多特性与设备驱动

6.8 日期 2019-07-18

  • 新系统 Android 7.1.2

1) 推出新的系统 Android 7.1.2, 特性与旧版本的Android 5基本保持一致,支持4G,WiFi,以太网,蓝牙等
2) 内核版本为 4.4.172
3) 已知问题:摄像头暂时还不能工作

  • Android/FriendlyCore/Lubuntu 更新:

1) 修复某些情况下HD101B无法触摸的问题
2) 修复Power key的GPIO配置
3) 解决音量过小的问题:播放时DAC的音量由 -20dB 修改为 -6dB
4) 集成了驱动模块(rtl8821CU.ko, rtl88XXau.ko)以增加更多型号的USB Wi-Fi支持

  • 仅适用于Lubuntu的更新:

1) 修改Lubuntu的Power key行为为(不弹出窗口)直接关机
2) 集成脚本xrotate.sh用于简化屏幕旋转设置 (注:屏幕旋转会损失性能)

  • 仅适用于NanoPC T2,Smart4418的更新:

支持从板载EEPROM中读取以太网Mac地址,仅支持以下系统:FriendlyCore, Lubuntu, Android7

6.9 日期 2019-06-25

Linux(Ubuntu 16.04/18.04) 全面采用 OverlayFS,以增强文件系统的稳定性

6.10 日期 2019-06-03

1) 配置LED1为心跳模式
2) 修复HDMI 1080P可能在某些情况下无显示的问题
3)Linux下修复无法安装 mysql 的问题
4)修复lubuntu下1-wire触摸电阻屏无法使用的问题

6.11 日期 2019-01-24

1) 增加新的LCD型号HD702V的支持
2) 优化Linux下Qt5的字体

6.12 日期 2018-12-17

  • Android5 更新如下:

1) 增加4G网络的支持,支持模块的型号为:Quectel EC20
2) 增加音频输出设置,可设置默认输出到耳机或者HDMI
3) 在系统Shutdown时,同步关闭一线触摸屏的背光

  • FriendlyCore更新如下:

1) 增加OV5640摄像头支持
2) 更新BL1以提高系统启动的稳定性

  • Lubuntu更新如下:

1) 增加chromium-browser浏览器,支持网页硬解播放, 支持WebGL
2) 将音频输出通道默认设置为HDMI (可通过/etc/asound.conf更改)
3) 更新BL1以提高系统启动的稳定性
4) 修正前一版本中存在的一些关于软件包报错的issue
5) 调整DPMS设置,默认关闭自动休眠

6.13 日期 2018-09-06

  • 增加10.1寸屏 HD101B 的支持
  • 提高一线屏识别的可靠性

6.14 日期 2018-08-11

FriendlyCore:

Android5:

  • 增加永不睡眠的设置选项

6.15 日期 2018-03-24

  • 修正只连接HDMI的情况下开机没图像显示的问题
  • 增加蓝牙的支持

以上更新适用于所有4.4内核的系统,包括FriendlyCore和Lubuntu。

6.16 日期 2017-06-13

Linux, Android系统:

  • 改善了整体系统稳定性;

Android系统:

  • 提升Android下ov5640拍照的稳定性;

6.17 日期 2017-04-18

Ubuntu-Core系统更新如下:

  • 修改了登录欢迎界面,当用户登录时会打印系统的基本状态信息;
  • 增加 npi-config 工具,npi-config是一个命令行下的系统配置工具,可以对系统进行一些初始化的配置,可配置的项目包括:用户密码、系统语言、时区、Hostname、SSH开关、自动登录选项等,在命令行执行以下 sudo npi-config 即可进入;
  • 预装NetworkManager作为网络管理工具;
  • 新增pi用户,并配置为自动登录,自动登录特性可以使用npi-config工具配置;

6.18 日期 2017-03-08

1) 启用UART2
2) 增加HD101B屏幕的支持
3) Android4.4和Android5增加硬件访问库,具体可参考:[1]
4) 修正S430屏在Android4.4下的闪退问题

6.19 日期 2017-02-09

1) 在Ubuntu Core和Debian系统中 增加7寸电阻屏 S70B 的支持
2) 调整了 eFlasher Rom 的分区大小,将根分区调整为 1GB

6.20 日期 2016-11-17

增加H43屏的支持:
1) 支持s5p4418与s5p6818平台的开发板
2) OS方面仅支持Debian 和 Ubuntu Core系统,不支持Android

6.21 日期 2016-09-02

1) Debian 和 Ubuntu Core集成了CAM500A(ov5640)摄像头的demo程序(nanocams);
2) 更新了Android 串口访问的程序,下载源代码:

git clone https://github.com/friendlyarm/android_SerialPortDemo.git

以前下载过的,用git pull命令更新一下。
内有详细说明,包括eclipse编译、打包成apk,对apk重新签名以获取system权限、关闭selinux等说明文档: <<SerialPortDemo-manual.pdf>>;
本次更新适用于NanoPi2, NanoPi 2 Fire, NanoPi-M2, NanoPC-T2, Smart4418

6.22 日期 2016-08-20

1) 推出Android4.4固件(s5p4418-kitkat-sd4g-20160803.img.zip) 和源码,Android4.4是专门为企业用户定制,并且支持4G通讯模块,即插即用;
2) 推出一键烧写系统的固件s5p4418-eflasher-sd8g-xxx-full.img,直接下载固件回来使用LCD即可一键烧写系统;
本次更新适用于NanoPi2, NanoPi 2 Fire, NanoPi-M2, NanoPC-T2, Smart4418

6.23 日期 2016-07-01

1) 修复了Ubuntu Core下USB Wi-Fi无法加载固件的问题;
2) 更新了Bootloader,支持使用dd命令直接将RAW image写入eMMC并能正常启动;
3) 内核bug修正及提高稳定性;
本次更新适用于NanoPi2, NanoPi 2 Fire, NanoPi-M2, NanoPC-T2, Smart4418

6.24 日期 2016-05-21

  • Android

1) 增加以太网设置(支持静态IP和DHCP设置);
2) 增加硬件访问库 libfriendlyarm-things.so,可用于在Android下操作串口;
使用方法可参考此份文档:http://www.arm9home.net/read.php?tid-82748.html。
在 NanoPi2/NanoPi M2/NanoPi2 Fire/NanoPC-T2 上,串口对应的设备名称如下:
UART2 -> 未驱动
UART3 -> /dev/ttyAMA2
UART4 -> /dev/ttyAMA3
3) 增加iTest应用程序,内置串口助手功能;
注意:运行此串口程序,需要使用system权限。

  • Debian

1)增强了内核稳定性;

  • Ubuntu core with Qt-Embedded

1)开机后显示的界面由Qt Demo换成了一个由友善之臂开发的,开源的Qt程序 (源代码位于/opt 目录),该程序启动时显示系统状态信息,例如CPU和内存信息,工作温度和负载等信息, 系统同时集成了 qmake,uic 等Qt工具的arm版本,这样你 就可以在开发板上直接生成和编译Qt源代码。
本次更新适用于NanoPi2, NanoPi 2 Fire, NanoPi-M2, NanoPC-T2, Smart4418

6.25 日期 2016-04-19

1)增加Debian/Ubuntu第一次开机时自动扩展分区和根文件系统,第一次启动时间会稍长
2) 改善非正常关机/重启导致的根文件系统问题;
3) Debian/Ubuntu Core集成原厂开源硬解播放器NxPlayerConsole,须连LCD使用。(原厂库没有源代码)
4) Ubuntu Core集成了OpenGL的测试程序gltest1, 完全开源
5)Debian/Ubuntu Core增加了USB Wi-Fi - rtl8187的支持;
6) Debian/Ubuntu Core系统的USB摄像头的设备修改为 /dev/video0,方便opencv
7) 用wpa_supplicant代替wicd来管理无线网络,使得Console下和X下的网络配置接口上保持一致
本次更新适用于NanoPi2, NanoPi 2 Fire, NanoPi-M2, NanoPC-T2, Smart4418


6.26 日期 2016-04-01

  • Debian:

1) Debian增加了常用USB Wi-Fi和USB串口的支持;
2) 修正了带声卡的板音频输出切换的问题;
3) 优化内核,改进稳定性;
4) 增加LVDS接口的支持(缺省未启用);

  • Ubuntu core with Qt-Embedded系统

新增系统:Ubuntu Core with Qt-Embedded,这是一个没有X-windows环境,使用Qt-Embedded作为图形界面的轻量级Ubuntu系统,基于官方的Ubuntu core系统开发而成,非常适合于企业用户用作产品的基础OS。
本系统除了保留Ubuntu core的特性以外,还包括以下特性:
1) 支持电容和电阻触摸屏 (型号:S700, X710, S70)
2) 支持WiFi连接
3) 支持以太网连接
4) 支持蓝牙,已预装bluez等相关软件包
5) 支持音频播放
详细可参考WiKi页面:http://wiki.friendlyelec.com/wiki/index.php/Ubuntu_Core_with_Qt-Embedded/zh


6.27 日期 2016-02-29

  • Kernel:

1) 增加了基于CPU ECID生成以太网MAC地址;
2) 修复了framebuffer console刷新不及时的问题;
3) 优化内核提升了系统运行的稳定性;
4) 修复了PWM LED的一个bug,基于PWM LED增加了呼吸灯效果的trigger;

  • Debian:

1) 修复了hostname异常的bug;
2) 缺省启用framebuffer console, 可在LCD/HDMI看到启动信息;
3) 集成了设置uboot环境变量的工具fw_printenv;

  • Android:

ROM缺省启用了ffmpeg, 可支持更多的视频格式.

6.28 日期 2015-12-01

  • 推出新的Android 5.1.1_r6,源代码已推送到 https://github.com/friendlyarm
  • 4.2.1 简易方法制作: 新的固件已支持LCD检测,因此原来分别支持LCD和HDMI的固件已合并为一个固件。
  • 4.3 在电脑上修改SD卡上的系统: 部分内容只适应于旧版本固件,标记为删除状态。
  • 6 如何编译系统: 编译时源代码分支更新为 nanopi2-lollipop-mr1。
  • 6.4.2 编译内核模块: 增加了如何编译支持LCD显示的启动Debian的uImage。