View source for FriendlyThings for RK3399/zh

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

==RK3399平台Android硬件资源的程序访问==
===Serial Port===
目前可直接使用的串口是UART4，设备名称为/dev/ttyS4，其他串口资源已被分配给其它功能，如下表所示，你也可以使用USB转串口来扩展：
::{| class="wikitable"
|-
|串口设备 || 串口资源占用情况
|-
|UART0  || 已被蓝牙占用
|-
|UART1   ||  已被千兆以太网占用  
|-
|UART2  ||  已被作为调试串口
|-
|UART3  ||  已被千兆以太网占用
|-
|UART4  ||  空闲，设备名称为 /dev/ttyS4 （注：需使用20180618之后的ROM）
|}

====串口读写的接口说明====
<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 />
下面中列出RK3399可直接操作的GPIO编号：
* 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和NanoPi 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
|}

====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===

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
|}

在 Android 下用标准的文件读取接口就可以读取，你可以将一个可调电阻配件连接到开发板上进行测试。

===PWM===
<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示例。
[[File:rk3399-android-pwm.png|frameless|PWM]]

===I2C===

运行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===
通过 /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===
====启用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}}