Template:FriendlyCoreGeneral/zh

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等相关软件包
• 支持音频播放
• 支持Qt5.9 EGLES和OpenGL ES1.1/2.0 (限S5P4418/S5P6818平台)

1.2 运行FriendlyCore

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

以下是串口配件的接法，接上串口，即可调试。
接上串口后，你可以选择从串口模块的DC口或者从MicroUSB口 (如果有) 进行供电：
TODO 也可以使用USB转串口模块调试，请注意需要使用5V/2A电源从NanoPi NEO Plus2的MicroUSB口给NEO Plus2供电：
TODO

• 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 扩展TF卡文件系统

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

df -h

1.5 连接WiFi

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

• 查看网络设备列表

$ sudo nmcli dev

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

• 开启WiFi

$ sudo nmcli r wifi on

• 扫描附近的 WiFi 热点

$ sudo nmcli dev wifi

• 连接到指定的 WiFi 热点

$ sudo nmcli dev wifi connect "SSID" password "PASSWORD"

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

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

• 使用USB 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

1.6 连接以太网

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

1.7 使用蓝牙

如果你的开发板板载有蓝牙模块，可输入以下命令搜索周边的蓝牙设备：

hcitool scan

使用hciconfig命令来了解接口的状态。

1.8 播放音频

在串口终端执行以下aplay命令播放一段音频：

aplay -t raw -c 2 -f S16_LE -r 44100 /root/test.pcm

1.9 HDMI输出声音

系统默认从3.5mm耳机座输出声音，想从HDMI输出需要修改文件系统上的配置文件/etc/asound.conf如下：

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

card 0代表3.5mm耳机孔，card 1代表HDMI音频。设置完成后需要重启系统才能生效。

1.10 连接USB摄像头模块(FA-CAM202)

FA-CAM202是一款200万像素的USB摄像头模块。
连接测试USB摄像头的方法请参考：连接DVP摄像头模块(CAM500B)

1.11 开发自已的Qt应用

请参考 How to build Qt application

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

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

sudo npi-config

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