View source for FriendlyThings for Rockchip/zh

[[FriendlyThings for Rockchip|English]]<br /><br />
注：本篇所述仅适用于友善电子出品的Rockchip平台主板，若需其他平台请参考 [[FriendlyThings/zh]]
<br />
{{FriendlyThings Introduction/zh}}
{{FriendlyThings AndroidVersion for Rockchip/zh}}
{{FriendlyThings Boards for Rockchip/zh}}
{{FriendlyThings Installation Guide/zh}}
==函数库(libfriendlyarm-things.so)接口说明==
请参考这份WiKi文档：[[FriendlyThings APIs/zh]]

==硬件资源的程序访问==
===Serial Port===
内核默认启用了以下串口可供测试（实际以内核dts配置为准），要使用更多串口可以自行配置内核dts：
{| class="wikitable" 
|-
! CPU
! Model
! Port
! Device Node
|-
| RK3588
| NanoPC-T6
| UART6
| /dev/ttyS6
|-
| RK3588S
| NanoPi-R6S/R6C
| UART5
| /dev/ttyS5
|-
| RK3568
| NanoPi-R5S
| UART9
| /dev/ttyS9
|-
| RK3399
| NanoPC-T4
| UART4
| /dev/ttyS4
|}

====串口读写的接口说明====
<syntaxhighlight lang="c">
HardwareControler.openSerialPortEx //打开串口设备
HardwareControler.select   //轮询串口是否有数据可写或可读
HardwareControler.read     //读取串口数据
HardwareControler.write    //写数据到串口
HardwareControler.close    //关闭设备
</syntaxhighlight>
接口说明请参考：[[FriendlyThings APIs/zh]]

===GPIO===
通过 sysfs 方式控制来 GPIO，是先访问 /sys/class/gpio 目录，向 export 文件写入 GPIO编号，使得该 GPIO 的操作接口从内核空间暴露到用户空间，然后就可以操作引脚的 direction 和 value 等，direction 控制 GPIO 方向，而 value 可控制 GPIO 输出或获得 GPIO 输入。<br />
<br />
下面列出内核默认配置成GPIO功能的引脚（实际以内核dts配置为准）：
====NanoPC T6====
::{| class="wikitable"
|-
| style="background: PaleTurquoise; color: black" | '''Physical Index'''
| style="background: PaleTurquoise; color: black" |'''GPIO Index'''
|-
|Pin7||106
|-
|Pin12||111
|-
|Pin15||39
|-
|Pin16||107
|-
|Pin18||108
|-
|Pin26||40
|-
|}
====NanoPi R6C====
::{| class="wikitable"
|-
| style="background: PaleTurquoise; color: black" | '''Physical Index'''
| style="background: PaleTurquoise; color: black" |'''GPIO Index'''
|-
|Pin7||128
|-
|Pin11||129
|-
|Pin13||130
|-
|Pin15||133
|-
|Pin16||134
|-
|Pin18||137
|-
|Pin22||138
|-
|}
====NanoPi R6S====
::{| class="wikitable"
|-
| style="background: PaleTurquoise; color: black" | '''Physical Index'''
| style="background: PaleTurquoise; color: black" |'''GPIO Index'''
|-
|Pin3||43
|-
|Pin5||41
|-
|Pin6||44
|-
|Pin7||42
|-
|Pin9||47
|-
|Pin10||46
|-
|}
====NanoPi R5S====
::{| class="wikitable"
|-
| style="background: PaleTurquoise; color: black" | '''Physical Index'''
| style="background: PaleTurquoise; color: black" |'''GPIO Index'''
|-
|Pin3||115
|-
|Pin5||114
|-
|Pin6||97
|-
|Pin7||113
|-
|Pin11||116
|-
|Pin12||117
|-
|}
====NanoPC T4====
::{| class="wikitable"
|-
| style="background: PaleTurquoise; color: black" | '''物理序号'''
| style="background: PaleTurquoise; color: black" |'''GPIO编号'''
|-
|Pin11||33
|-
|Pin12||50
|-
|Pin15||36
|-
|Pin16||54
|-
|Pin18||55
|-
|Pin22||56
|-
|Pin37||96
|-
|Pin38||125
|-
|Pin40||126
|}
====NanoPi M4/M4v2/M4B/NEO4====
::{| class="wikitable"
|-
| style="background: PaleTurquoise; color: black" | '''物理序号'''
| style="background: PaleTurquoise; color: black" |'''Linux索引号'''
|-
|Pin11||33
|-
|Pin12||50
|-
|Pin15||36
|-
|Pin16||54
|-
|Pin18||55
|-
|Pin22||56
|}
====SOM-RK3399/SOM-RK3399v2====
::{| class="wikitable"
|-
| style="background: PaleTurquoise; color: black" | '''Physical Index'''
| style="background: PaleTurquoise; color: black" |'''GPIO Index'''
|-
|Pin7||41
|-
|Pin9||42
|}

====GPIO接口说明====
<syntaxhighlight lang="c">
HardwareControler.exportGPIOPin      //导出GPIO
HardwareControler.setGPIODirection   //改变GPIO的方向
HardwareControler.getGPIODirection   //获得当前GPIO的方向
HardwareControler.setGPIOValue    //向引脚输出高电平或低电平
HardwareControler.getGPIOValue    //获得引脚的输入（当前的值）
HardwareControler.unexportGPIOPin //取消导出
</syntaxhighlight>
接口说明请参考：[[FriendlyThings APIs/zh]]

====GPIO示例说明====
可以用LED配件来测试GPIO示例，在界面上对引脚输出高电平时，LED亮，低电平时，LCD灭。
[[File:rk3399-android-gpio.png|frameless|GPIO]]
===ADC===
在 Android 下用标准的文件读取接口就可以读取，你可以将一个可调电阻配件连接到开发板上进行测试。
====RK3588====
Channel2对应的文件节点如下所示, 此ADC可用于查询USB-C的输入电压：
::{| class="wikitable"
|-
| style="background: PaleTurquoise; color: black" | '''频道'''
| style="background: PaleTurquoise; color: black" |'''文件节点'''
|-
|Channel 2||/sys/devices/platform/fec10000.saradc/iio:device0/in_voltage2_raw
|}
====RK3568====
Channel2对应的文件节点如下所示, 此ADC可用于查询USB-C的输入电压：
::{| class="wikitable"
|-
| style="background: PaleTurquoise; color: black" | '''频道'''
| style="background: PaleTurquoise; color: black" |'''文件节点'''
|-
|Channel 2||/sys/devices/platform/fe720000.saradc/iio:device0/in_voltage2_raw
|}
====RK3399====
RK3399引出了三路ADC，channel为0, 2, 3，对应的文件节点为：
::{| class="wikitable"
|-
| style="background: PaleTurquoise; color: black" | '''频道'''
| style="background: PaleTurquoise; color: black" |'''文件节点'''
|-
|Channel 0||/sys/devices/platform/ff100000.saradc/iio:device0/in_voltage0_raw
|-
|Channel 2||/sys/devices/platform/ff100000.saradc/iio:device0/in_voltage2_raw
|-
|Channel 3||/sys/devices/platform/ff100000.saradc/iio:device0/in_voltage3_raw
|}
===PWM===
====NanoPC-T6====
默认已配置 Pin32 为PWM，可以使用LED进行测试
====NanoPi-R6C====
默认已配置 Pin29 为PWM，可以使用LED进行测试
====RK3399====
<b>Note: 默认情况下，PWM接口已经用于连接风扇，如果您想自己控制PWM，则需要先禁用风扇，<br />
请参考这篇文章: </b>[[Template:RK3399 Android PWMFan/zh]]<br />
RK3399开发板也是通过sysfs方式来控制PWM，直接操作 /sys/class/pwm/pwmchip1 下的文件节点即可，下面以在命令行操作PWM风扇风速作为示例：
=====PWM接口说明=====
* 将PWM0暴露到用户空间
<syntaxhighlight lang="bash">
echo 0 > /sys/class/pwm/pwmchip1/export
</syntaxhighlight>
* 通过设置PWM的period和duty_cycle来控制风速
<syntaxhighlight lang="bash">
echo 0 > /sys/class/pwm/pwmchip1/pwm0/enable
echo 50000 > /sys/class/pwm/pwmchip1/pwm0/period
echo 1 > /sys/class/pwm/pwmchip1/pwm0/enable
echo 45000 > /sys/class/pwm/pwmchip1/pwm0/duty_cycle
</syntaxhighlight>
=====PWM示例说明=====
可以连接一个PWM风扇（3针）到NanoPC-T4的风扇接口来测试PWM示例。<br />
[[File:rk3399-android-pwm.png|frameless|PWM]]

===I2C===
====RK3399====
运行I2C Demo需要将一个LCD1602的模块连接到NanoPC-T4的以下引脚：
::{| class="wikitable"
|-
| style="background: PaleTurquoise; color: black" | '''物理序号'''
| style="background: PaleTurquoise; color: black" |'''I2C功能'''
|-
|Pin3||I2C2_SDA(3V)
|-
|Pin4||VCC5V0_SYS
|-
|Pin5||I2C2_SCL(3V)
|-
|Pin6||GND
|}

如下图所示：<br />
[[File:NanoPC-T4+OLED.jpg|frameless|450px]]

===RTC===
'''注：定时开关机只有某些型号支持，例如NanoPC-T4'''<br />
通过 /sys/class/rtc/rtc0/下面的接口来操作RTC，比如查看当前RTC的日期和时间：<br />
<syntaxhighlight lang="bash">
cat /sys/class/rtc/rtc0/date
# 2018-10-20                                                              
cat /sys/class/rtc/rtc0/time                                            
# 08:20:14
</syntaxhighlight>
设置开机时间，如设置120秒后开机：
<syntaxhighlight lang="bash">
#120秒后定时开机
echo +120 >  /sys/class/rtc/rtc0/wakealarm
</syntaxhighlight>
[[File:rk3399-android-rtc.png|frameless|RTC]]

===Watch dog===
看门狗的操作比较简单，打开设备 /dev/watchdog 并定时写入字符即可，如果系统出现问题导致没有写入字符，设备会过一段时间自动重启：
<syntaxhighlight lang="java">
mWatchDogFD = HardwareControler.open("/dev/watchdog", FileCtlEnum.O_WRONLY);
HardwareControler.write(mWatchDogFD, "a".getBytes());
</syntaxhighlight>
[[File:rk3399-android-watchdog.png|frameless|WatchDog]]
===SPI===
====RK3399====
=====启用SPI=====
SPI由于与UART4共用引脚，所以需要修改内核DTS文件，修改方法如下: <br />
编辑内核目录下的dts文件 arch/arm64/boot/dts/rockchip/rk3399-nanopi4-common.dtsi:
<syntaxhighlight lang="c">
cd ANDROID_SOURCE/kernel
vim arch/arm64/boot/dts/rockchip/rk3399-nanopi4-common.dtsi
</syntaxhighlight>
其中，ANDROID_SOURCE请替换为真实的 Android7或Android8源代码目录。

首先找到 spi1 的定义:
<syntaxhighlight lang="c">
&spi1 {
    status = "disabled";  // 将其中的 disabled 改为 okay
</syntaxhighlight>
然后再在 rk3399-nanopi4-common.dtsi 文件到找到 uart4 的定义：
<syntaxhighlight lang="c">
&uart4 {
    status = "okay";   // 将其中的 okay 改为 disabled
</syntaxhighlight>
最后重新编译内核:
<syntaxhighlight lang="bash">
cd ANDROID_SOURCE/
./build-nanopc-t4.sh -K -M
</syntaxhighlight>
更新 rockdev/Image-nanopc_t4/resource.img 到开发板即可，可以将resource.img拷贝到安装有 eflasher 系统的TF卡中，位置是FriendlyARM分区的androidX 目录，替换里面的resource.img文件，然后用TF卡重刷系统。 

=====SPI示例=====
SPI示例默认没有预装，需要手动编译，方法是修改Android源代码的以下文件：<br />
vendor/friendlyelec/apps# vi device-partial.mk<br />
去掉前面的注释:<br />
<syntaxhighlight lang="bash">
# PRODUCT_PACKAGES += SPI-OLED
</syntaxhighlight>
然后重新编译 Android源代码。<br />
<br />
运行SPI示例需要在NanoPC-T4上连接一个 SPI接口的OLED，规格为0.96寸的128x64屏。<br />
<br />
屏幕上有7个引脚，与开发板用母对母杜邦线连接，接法如下表：<br />
::{| class="wikitable"
|-
| style="background: PaleTurquoise; color: black" | '''OLED引脚'''
| style="background: PaleTurquoise; color: black" |'''功能'''
| style="background: PaleTurquoise; color: black" |'''NanoPC-T4引脚编号'''
| style="background: PaleTurquoise; color: black" |'''备注'''
|-
|GND|| ||Pin6  GND ||
|-
|VCC|| ||Pin2  VCC5V ||
|-
|DO||SCLK||Pin23 (SPI1_CLK(3V) ||时钟信号，由主设备产生
|-
|DI||MOSI||Pin19 (SPI1_TXD) ||主设备数据输出，从设备数据输入
|-
|RES|| ||Pin16 (GPIO1_C6(3V)) ||
|-
|D/C|| ||Pin12 (GPIO1_C2) ||
|-
|CS||CS0||Pin24 (SPI1_CSn0) ||从设备使能信号，由主设备控制
|}
<br />
====SPI接口说明====
请参考：[[FriendlyThings APIs/zh]]

==示例程序下载地址==
所有硬件访问的示例程序均已集成到 Android 的源代码当中，位于 Android7.1.2 和 Android8.1 源代码的以下目录：vendor/friendlyelec/apps，也可以单独网上下载，下表中列出各个 Demo 的源代码地址：
{{FriendlyThings Android8 Demos}}
{{FriendlyThings Android7 Demos}}