Difference between revisions of "Template:FriendlyCoreGeneral/zh"

From FriendlyELEC WiKi
Jump to: navigation, search
(FriendlyCore的使用)
(Work with FriendlyCore)
Line 42: Line 42:
 
[[File:npi-config.jpg|frameless|500px|npi-config]]<br />
 
[[File:npi-config.jpg|frameless|500px|npi-config]]<br />
  
===扩展TF卡文件系统===
+
===Extend TF Card's Section===
第一次启动FriendlyCore系统时,系统会自动扩展文件系统分区,请耐心等待,TF卡/eMMC的容量越大,需要等待的时间越长,进入系统后执行下列命令查看文件系统分区大小:
+
When FriendlyCore is loaded the TF card's section will be automatically extended.You can check the section's size by running the following command:
 
<syntaxhighlight lang="bash">
 
<syntaxhighlight lang="bash">
df -h
+
$ df -h
 
</syntaxhighlight>
 
</syntaxhighlight>
  
===连接WiFi===
+
===WiFi===
 
+
You can use the NetworkManager utility in FriendlyCore to manager its network. You can run "nmcli" in the commandline utility to start it. Here are the commands to start a WiFi connection:
FriendlyCore 使用 NetworkManager 工具来管理网络,其在命令行下对应的命令是 nmcli,要连接WiFi,相关的命令如下:
+
* Check device list
* 查看网络设备列表
+
 
<syntaxhighlight lang="bash">
 
<syntaxhighlight lang="bash">
$ sudo nmcli dev
+
sudo nmcli dev
 
</syntaxhighlight>
 
</syntaxhighlight>
注意,如果列出的设备状态是 unmanaged 的,说明网络设备不受NetworkManager管理,你需要清空 /etc/network/interfaces下的网络设置,然后重启.
+
Note: if the status of a device is "unmanaged" it means that device cannot be accessed by NetworkManager. To make is accessed you need to clear the settings under "/etc/network/interfaces" and reboot your system.
  
* 开启WiFi
+
* Start WiFi
 
<syntaxhighlight lang="bash">
 
<syntaxhighlight lang="bash">
$ sudo nmcli r wifi on
+
sudo nmcli r wifi on
 
</syntaxhighlight>
 
</syntaxhighlight>
  
* 扫描附近的 WiFi 热点
+
* Scan Surrounding WiFi Sources
 
<syntaxhighlight lang="bash">
 
<syntaxhighlight lang="bash">
$ sudo nmcli dev wifi
+
sudo nmcli dev wifi
 
</syntaxhighlight>
 
</syntaxhighlight>
  
* 连接到指定的 WiFi 热点
+
* Connect to a WiFi Source
 
<syntaxhighlight lang="bash">
 
<syntaxhighlight lang="bash">
$ sudo nmcli dev wifi connect "SSID" password "PASSWORD"
+
sudo nmcli dev wifi connect "SSID" password "PASSWORD"
 
</syntaxhighlight>
 
</syntaxhighlight>
请将 SSID和 PASSWORD 替换成实际的 WiFi名称和密码。<br />
+
The "SSID" and "PASSWORD" need to be replaced with your actual SSID and password.If you have multiple WiFi devices you need to specify the one you want to connect to a WiFi source with iface<br />
连接成功后,下次开机,WiFi 也会自动连接。<br />
+
If a connection succeeds it will be automatically setup on next system reboot.<br />
 
<br />
 
<br />
更详细的NetworkManager使用指南可参考这篇文章: [[Use NetworkManager to configure network settings]]<br />
+
For more details about NetworkManager refer to this link: [[Use NetworkManager to configure network settings]]<br />
  
* 使用USB WiFi
+
* Use USB WiFi
系统已经支持市面上众多常见的USB WiFi,已测试过的USB WiFi型号如下:
+
Our OS system has support for popular USB WiFi drivers. Many USB WiFi modules are plug and play with our system. Here is a list of models we tested;
 
::{| class="wikitable"
 
::{| class="wikitable"
 
|-
 
|-
|序号||型号        
+
|Number||Model        
 
|-
 
|-
|1  ||  RTL8188CUS/8188EU 802.11n WLAN Adapter     
+
|1  ||  RTL8188CUS 802.11n WLAN Adapter     
 
|-
 
|-
 
|2  ||  RT2070 Wireless Adapter     
 
|2  ||  RT2070 Wireless Adapter     
Line 90: Line 89:
 
|4  ||  RTL8192CU Wireless Adapter
 
|4  ||  RTL8192CU Wireless Adapter
 
|-
 
|-
|5  ||  小米WiFi mt7601
+
|5  ||  mi WiFi mt7601
 
|}
 
|}
  
===连接以太网===
+
===Ethernet Connection===
 +
If a board is connected to a network via Ethernet before it is powered on it will automatically obtain an IP with DHCP activated after it is powered up. If you want to set up a static IP refer to: [[Use NetworkManager to configure network settings]].
  
默认插上网线开机,会自动连接并通过DHCP获取IP地址,如需要配置静态IP地址,请参考 NetworkManager 的相关文档:  [[Use NetworkManager to configure network settings]]。
+
===Bluetooth===
 
+
If your board has an onboard bluetooth module you can search for surrounding bluetooth devices by running the following command:<br/>
===使用蓝牙===
+
 
+
如果你的开发板板载有蓝牙模块,可输入以下命令搜索周边的蓝牙设备:<br />
+
 
<syntaxhighlight lang="bash">
 
<syntaxhighlight lang="bash">
 
hcitool scan
 
hcitool scan
 
</syntaxhighlight>
 
</syntaxhighlight>
 +
You can run "hciconfig" to check bluetooth's status.
  
使用hciconfig命令来了解接口的状态。
+
===Play Audio===
 
+
You can play an audio file by running the following command:
 
+
===播放音频===
+
 
+
在串口终端执行以下aplay命令播放一段音频:
+
 
<syntaxhighlight lang="bash">
 
<syntaxhighlight lang="bash">
 
aplay -t raw -c 2 -f S16_LE -r 44100 /root/test.pcm
 
aplay -t raw -c 2 -f S16_LE -r 44100 /root/test.pcm
 
</syntaxhighlight>
 
</syntaxhighlight>
  
===HDMI输出声音===
+
===HDMI Audio Output===
系统默认从3.5mm耳机座输出声音,想从HDMI输出需要修改文件系统上的配置文件/etc/asound.conf如下:
+
Our system's default audio output is the 3.5mm audio jack. You can turn on the HDMI audio by editing the /etc/asound.conf file:
 
<syntaxhighlight lang="bash">
 
<syntaxhighlight lang="bash">
 
pcm.!default {
 
pcm.!default {
Line 128: Line 122:
 
}
 
}
 
</syntaxhighlight>
 
</syntaxhighlight>
card 0代表3.5mm耳机孔,card 1代表HDMI音频。设置完成后需要重启系统才能生效。
+
card 0 points to the 3.5mm audio jack and card 1 points to the HDMI audio. You need to save your changes and reboot your system to make your changes take effect.
  
===连接USB摄像头模块(FA-CAM202)===
+
===Connect to USB Camera(FA-CAM202)===
FA-CAM202是一款200万像素的USB摄像头模块。<br>
+
The FA-CAM202 is a 200M USB camera.<br>
连接测试USB摄像头的方法请参考:[[NanoPi_M1/zh#.E8.BF.9E.E6.8E.A5DVP.E6.91.84.E5.83.8F.E5.A4.B4.E6.A8.A1.E5.9D.97.28CAM500B.29_2|连接DVP摄像头模块(CAM500B)]] <br>
+
Refer to this link for more details on how to connect to a FA-CAM202:
 +
[[NanoPi_M1#Connect_NanoPi_M1_to_DVP_Camera_CAM500B|Connect NanoPi M1 to DVP Camera CAM500B]] <br>
  
===开发自已的Qt应用===
+
===Develop Qt Application===
请参考 [[How to build Qt application]]
+
Please refer to:  [[How to build Qt application]]
  
===开机自动运行Qt示例程序===
+
===Setup Program to AutoRun===
使用npi-config工具进行开启:
+
You can setup a program to autorun on system boot with npi-config:
 
<syntaxhighlight lang="bash">
 
<syntaxhighlight lang="bash">
 
sudo npi-config
 
sudo npi-config
 
</syntaxhighlight>
 
</syntaxhighlight>
  
进入Boot Options -> Autologin -> Qt/Embedded,选择Enable然后重启即可。
+
Go to Boot Options -> Autologin -> Qt/Embedded, select Enable and reboot.

Revision as of 03:44, 25 December 2017

1 Work with FriendlyCore

1.1 Introduction

FriendlyCore is a light Linux system without X-windows, based on ubuntu core, It uses the Qt-Embedded's GUI and is popular in industrial and enterprise applications.

Besides the regular Ubuntu core's features our FriendlyCore has the following additional features:

  • it supports our LCDs with both capacitive touch and resistive touch(S700, X710, HD702, S430, HD101 and S70)
  • it supports WiFi
  • it supports Ethernet
  • it supports Bluetooth and has been installed with bluez utilities
  • it supports audio playing
  • it supports Qt5.9 EGLES and OpenGL ES1.1/2.0 (Only for S5P4418/S5P6818)

1.2 FriendlyCore's User Accounts

  • If your board is connected to an HDMI monitor you need to use a USB mouse and keyboard.
  • If you want to do kernel development you need to use a serial communication board, ie a PSU-ONECOM board, which will allow you to operate the board via a serial terminal.Here is a setup where we connect a board to a PC via the PSU-ONECOM and you can power on your board from either the PSU-ONECOM or its MicroUSB:

PSU-ONECOM-NEO_Plus2
You can use a USB to Serial conversion board too.
Make sure you use a 5V/2A power to power your board from its MicroUSB port:
USB2UART-NEO-Plus2

  • FriendlyCore User Accounts:

Non-root User:

   User Name: pi
   Password: pi

Root:

   User Name: root
   Password: fa

The system is automatically logged in as "pi". You can do "sudo npi-config" to disable auto login.

  • Update packages
$ sudo apt-get update

1.3 Configure System with npi-config

The npi-config is a commandline utility which can be used to initialize system configurations such as user password, system language, time zone, Hostname, SSH switch , Auto login and etc. Type the following command to run this utility.

$ sudo npi-config

Here is how npi-config's GUI looks like:
npi-config

1.4 Extend TF Card's Section

When FriendlyCore is loaded the TF card's section will be automatically extended.You can check the section's size by running the following command:

$ df -h

1.5 WiFi

You can use the NetworkManager utility in FriendlyCore to manager its network. You can run "nmcli" in the commandline utility to start it. Here are the commands to start a WiFi connection:

  • Check device list
sudo nmcli dev

Note: if the status of a device is "unmanaged" it means that device cannot be accessed by NetworkManager. To make is accessed you need to clear the settings under "/etc/network/interfaces" and reboot your system.

  • Start WiFi
sudo nmcli r wifi on
  • Scan Surrounding WiFi Sources
sudo nmcli dev wifi
  • Connect to a WiFi Source
sudo nmcli dev wifi connect "SSID" password "PASSWORD"

The "SSID" and "PASSWORD" need to be replaced with your actual SSID and password.If you have multiple WiFi devices you need to specify the one you want to connect to a WiFi source with iface
If a connection succeeds it will be automatically setup on next system reboot.

For more details about NetworkManager refer to this link: Use NetworkManager to configure network settings

  • Use USB WiFi

Our OS system has support for popular USB WiFi drivers. Many USB WiFi modules are plug and play with our system. Here is a list of models we tested;

Number Model
1 RTL8188CUS 802.11n WLAN Adapter
2 RT2070 Wireless Adapter
3 RT2870/RT3070 Wireless Adapter
4 RTL8192CU Wireless Adapter
5 mi WiFi mt7601

1.6 Ethernet Connection

If a board is connected to a network via Ethernet before it is powered on it will automatically obtain an IP with DHCP activated after it is powered up. If you want to set up a static IP refer to: Use NetworkManager to configure network settings.

1.7 Bluetooth

If your board has an onboard bluetooth module you can search for surrounding bluetooth devices by running the following command:

hcitool scan

You can run "hciconfig" to check bluetooth's status.

1.8 Play Audio

You can play an audio file by running the following command:

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

1.9 HDMI Audio Output

Our system's default audio output is the 3.5mm audio jack. You can turn on the HDMI audio by editing the /etc/asound.conf file:

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

card 0 points to the 3.5mm audio jack and card 1 points to the HDMI audio. You need to save your changes and reboot your system to make your changes take effect.

1.10 Connect to USB Camera(FA-CAM202)

The FA-CAM202 is a 200M USB camera.
Refer to this link for more details on how to connect to a FA-CAM202: Connect NanoPi M1 to DVP Camera CAM500B

1.11 Develop Qt Application

Please refer to: How to build Qt application

1.12 Setup Program to AutoRun

You can setup a program to autorun on system boot with npi-config:

sudo npi-config

Go to Boot Options -> Autologin -> Qt/Embedded, select Enable and reboot.