Template:FriendlyCoreGeneral/zh
Contents
1 FriendlyCore的使用
1.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平台)
1.2 运行FriendlyCore
- 对于有HDMI接口的板子，如果要在电视上进行操作，您需要连接USB鼠标和键盘。
- 如果您需要进行内核开发，最好选购一个串口配件，连接了串口，则可以通过串口终端对开发板进行操作。
使用串口模块能有效地提升开发效率，以下是串口模块的连接方法：
接上串口后，您可以选择从串口模块的DC口或者从MicroUSB口 (如果有) 进行供电：
以NanoPi-M1为例：
也可以使用USB转串口模块调试，请注意需要使用5V/2A电源给开发板MicroUSB供电：
以NanoPi-NEO2为例：
- FriendlyCore默认帐户：
普通用户：
用户名: pi 密码: pi
Root用户：
用户名: root 密码: fa
默认会以 pi 用户自动登录，你可以使用 sudo npi-config 命令取消自动登录。
- 更新软件包：
$ sudo apt-get update
1.3 使用npi-config配置系统
npi-config是一个命令行下的系统配置工具，可以对系统进行一些初始化的配置，可配置的项目包括：用户密码、系统语言、时区、Hostname、SSH开关、自动登录选项等，在命令行执行以下命令即可进入:
$ sudo npi-config
npi-config的显示界面如下所示：
1.4 开发Qt应用
请参考 How to Build and Install Qt Application for FriendlyELEC Boards/zh
1.5 开机自动运行Qt示例程序
使用npi-config工具进行开启：
sudo npi-config进入Boot Options -> Autologin -> Qt/Embedded，选择Enable然后重启即可。
1.6 扩展TF卡文件系统
第一次启动FriendlyCore系统时，系统会自动扩展文件系统分区，请耐心等待，TF卡/eMMC的容量越大，需要等待的时间越长，进入系统后执行下列命令查看文件系统分区大小：
df -h
1.7 使用蓝牙传输文件
以传输文件到手机为例进行说明，首先，将你的手机蓝牙设置为可侦测状态，然后执行以下命令开始蓝牙搜索：
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 02) 提示找不到相关命令，可尝试用以下命令安装相关软件：
apt-get install bluetooth bluez obexftp openobex-apps python-gobject ussp-push1.8 连接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目录下。
1.9 连接以太网
默认插上网线开机，会自动连接并通过DHCP获取IP地址，如需要配置静态IP地址，请参考 NetworkManager 的相关文档: Use NetworkManager to configure network settings。
1.10 选择系统默认音频设备
如果当前系统存在多个音频设备, 例如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。
