From 71c14e7c42e2f312f88dc8abcec4383e6ba10529 Mon Sep 17 00:00:00 2001
From: anheng <12857953+aahh123456@user.noreply.gitee.com>
Date: Thu, 25 Apr 2024 17:06:34 +0800
Subject: [PATCH] Android documentation updated
---
RK3568_Android_SDK开发文档/RK3568_Android_SDK开发文档.md | 557 +++++++++++++++++++++++++++++++++++++++++++++++++++++--
1 files changed, 533 insertions(+), 24 deletions(-)
diff --git "a/RK3568_Android_SDK\345\274\200\345\217\221\346\226\207\346\241\243/RK3568_Android_SDK\345\274\200\345\217\221\346\226\207\346\241\243.md" "b/RK3568_Android_SDK\345\274\200\345\217\221\346\226\207\346\241\243/RK3568_Android_SDK\345\274\200\345\217\221\346\226\207\346\241\243.md"
index e1d645b..625dd5c 100644
--- "a/RK3568_Android_SDK\345\274\200\345\217\221\346\226\207\346\241\243/RK3568_Android_SDK\345\274\200\345\217\221\346\226\207\346\241\243.md"
+++ "b/RK3568_Android_SDK\345\274\200\345\217\221\346\226\207\346\241\243/RK3568_Android_SDK\345\274\200\345\217\221\346\226\207\346\241\243.md"
@@ -124,9 +124,524 @@
此时需要输入命令`su`，切换到root用户，既不会弹出。
+# 3. 外设调试与测试
+
+## 3.1 系统心跳灯
+
+### 3.1.1 内核修改支持
+
+DTS文件修改(默认已经添加节点)
+
+ leds: leds {
+ compatible = "gpio-leds";
+ work_led: work {
+ gpios = <&gpio0 RK_PC0 GPIO_ACTIVE_HIGH>;
+ linux,default-trigger = "heartbeat";
+ status = “okay”
+ };
+ };
-### ADB调试工具
+
+内核make menuconfig配置(默认已使能)
+
+```
+Device Drivers ->
+ LED Support ->
+ LED Support for GPIO connected LEDs
+```
+
+```
+Device Drivers ->
+ LED Support ->
+ LED Trigger support ->
+ LED Heartbeat Trigger
+```
+
+### 3.1.2 应用程序测试
+
+
+
+设置好config之后重新编译内核并烧到开发板中，当系统启动时就会看到蓝色led灯闪烁。
+
+
+
+## 3.2 RGB灯和蜂鸣器扩展接口
+
+
+
+### 3.2.1 内核修改支持
+
+
+
+原理图及分析
+
+
+
+
+
+这里的测试只要就是对这些gpio进行配置即可，利用gpioset来控制高低电平
+
+**注意：这四个gpio在设备树中可能会被其他设备所占用，导致不能操作gpio，所以要查看哪些设备占用着这几个gpio需要屏蔽掉这些设备。**
+
+### 3.2.2 应用程序测试
+
+由于这四个引脚都是用MOS管控制的开漏输出，所以我们需要去测试MOS管的栅极看看是否是3.3V电平
+
+**规则：**
+
+**GPIO输出1的时候，对应的栅极是0V**
+**GPIO输出0的时候，对应的栅极是3.3V**
+
+```c
+gpioset 0 18=1/0
+gpioset 0 20=1/0
+gpioset 0 22=1/0
+gpioset 3 21=1/0
+```
+
+利用万用表，将万用表调到直流电压20V这一档，这四个模块对应的三极管如下图所示，利用gpioset来控制四个gpio的高低电平，看看是否符合上述规则。
+
+
+
+## 3.3 RTC芯片
+
+
+
+### 3.3.1 内核修改支持
+
+
+
+内核make menuconfig配置
+
+默认已使能
+
+```
+Device Drivers ->
+ Real Time Clock ->
+ Rockchip RK805/RK808/RK809/RK816/RK817/RK818 RTC ->
+```
+
+
+
+### 3.3.2 应用程序测试
+
+输入命令：
+
+```
+date -s "2024-04-01 11:40:00"
+```
+
+
+
+设置完成后再次使用`date`命令查看一下当前时间就会发现时间改过来了
+
+大家注意我们使用`date -s`命令仅仅是修改了当前时间，此时间还没有写入到RK809内部 RTC 里面或其他的 RTC 芯片里面，因此系统重启以后时间又会丢失。我们需要将当前的时间写入到 RTC 里面，这里要用到`hwclock` 命令，输入如下命令将系统时间写入到 RTC 里面:
+
+```
+hwclock -w /将当前系统时间写入RTC里面/
+```
+
+时间写入到 RTC 里面以后就不怕系统重启以后时间丢失了
+
+间隔时间输入如下命令：
+
+```
+hwclock -r /读取当前系统时间/
+```
+
+
+
+发现当前系统时间在走动，系统时间正常。
+
+## 3.4 RS232和RS485
+
+
+
+### 3.4.1 内核修改支持
+
+RS232 DTS文件修改
+
+```c
+&uart3{
+ dma-names = "tx", "rx";
+ pinctrl-names = "default";
+ pinctrl-0 = <&uart3m1_xfer>;
+ status = "okay";
+};
+
+&uart4{
+ dma-names = "tx", "rx";
+ pinctrl-names = "default";
+ pinctrl-0 = <&uart4m1_xfer>;
+ status = "okay";
+};
+```
+
+RS485 DTS文件修改
+
+```c
+&uart9 {
+ pinctrl-names = "default";
+ pinctrl-0 = <&uart9m1_xfer &rs485_ctrl>;
+ status = "okay";
+};
+
+//在rk3568-pinctrl.dtsi下加入
+rs485 {
+ rs485_ctrl: rs485-ctrl {
+ rockchip,pins =
+ <4 RK_PD2 RK_FUNC_GPIO &pcfg_output_low>;
+ };
+};
+```
+
+因为RS485是半双工的，所以要么先测接收功能要么测发送功能，从原理图上可以看到，接受与发送功能的切换是GPIO4_D2来控制的，默认情况是接收功能，我们可以利用gpioset命令拉高该gpio让其工作在发送模式
+
+### 3.4.2 应用程序测试
+
+RS232测试
+
+在/dev目录下的ttyS3和ttyS4为两路RS232设备，使用microcom 命令可以操作232串口。具体测试如下
+
+将两个232设备的RX和TX口用杜邦线进行连接，如下图所示
+
+
+
+连接好之后我们在设备1和设备2上均输入
+
+```c
+microcom /dev/ttyS3 -s 115200
+```
+
+测试结果
+
+
+
+
+
+由于microcom没有回显，所以看不到自己发送的是什么，但是接受的结果是没错的
+
+
+
+RS485测试接受功能
+
+如图所示，利用TTL转RS485模块来作为另外一台RS485设备，连线如下图所示
+
+
+
+
+
+
+
+RS485测试发送功能
+
+将控制引脚拉高电平,输入如下命令
+
+```c
+gpioset 4 28=1
+```
+
+
+
+## 3.5 CAN总线
+
+
+
+### 3.5.1 内核修改支持
+
+DTS文件修改
+
+```c
+&can0 {
+ compatible = "rockchip,can-1.0";
+ assigned-clocks = <&cru CLK_CAN0>;
+ assigned-clock-rates = <150000000>;
+ pinctrl-names = "default";
+ pinctrl-0 = <&can0m1_pins>;
+ status = "okay";
+};
+
+&can1 {
+ compatible = "rockchip,can-1.0";
+ assigned-clocks = <&cru CLK_CAN1>;
+ assigned-clock-rates = <150000000>;
+ pinctrl-names = "default";
+ pinctrl-0 = <&can1m1_pins>;
+ status = "okay";
+};
+```
+
+
+
+内核make menuconfig配置
+
+```
+Networking support ->
+ CAN bus subsystem support ->
+ CAN Device Drivers ->
+ Platform CAN drivers with Netlink support ->
+```
+
+### 3.5.2 应用程序测试
+
+我们可以用ifconfig -a来查看can的数量，如下图所示
+
+
+
+
+
+这里我们测试can1的收发功能，can0与之完全相同
+
+首先我们将两个can设备利用杜邦线进行连接，连接如下图所示
+
+
+
+连接好之后，我们需要对can1进行配置，利用ip命令
+
+```c
+ip link set can1 down //关闭 can 网络
+ip link set can1 up type can bitrate 800000 //设置 can1 的波特率为 800kbps，can 网络波特率最大值为 1mbps
+ip link set can1 up type can //打开 can 网络
+```
+
+
+
+设置好之后，我们上图所示中的设备1作为接受方，设备2作为发送方
+
+注意：因为Android上没有can的相关命令，所以需要去网上下载适配Android系统的canutils工具源码，然后使用安卓编译系统编译源码，具体步骤
+
+1. 下载解压canutils，将canutils放在/home/android/rk3568/android11/external目录下
+
+2. 回到/home/android/rk3568/android11目录使用如下命令配置好编译系统环境
+
+ ```
+ source build/envsetup.sh
+ lunch rk3568_r-userdebug
+ ```
+
+3. 在进入/home/android/rk3568/android11/external/canutils目录下，输入mm，即可自动编译源码
+
+ 
+
+4. 最后可执行文件都会安装到
+
+ /home/android/rk3568/android11/out/target/product/rk3568_r/system/bin
+
+ (ps. 其实我们可以将这个canutils的编译放进整个的安卓编译系统，这样我们编译安卓源码的时候就可以自动编译canutils，这样我们烧录镜像后会发现，系统出厂自带了canutils，这个步骤可以借鉴网上博客)
+
+5. 我们使用adb命令可以将我们需要的candump和cansend程序传到我们开发版的/system/bin目录下，授予执行权限后就可以使用了
+
+在设备1上输入
+
+```c
+candump can1
+```
+
+在设备2上输入
+
+```c
+cansend can1 0x11 0x22 0x33 0x44 0x55 0x66 0x77 0x88
+```
+
+结果如图所示
+
+
+
+
+
+
+
+## 3.6 声卡Codec
+
+
+
+### 3.6.1 内核修改支持
+
+
+
+原理图及分析
+
+
+
+
+
+
+
+
+
+### 3.6.2 应用程序测试
+
+先将模式切换成输出模式，默认是高电平静音模式
+
+```
+gpioset 3 19=0
+
+或者
+
+echo "out" > /sys/class/gpio/gpio115/direction
+echo 0 > /sys/class/gpio/gpio115/value
+```
+
+当听到喇叭发出“砰”的一声就说明可以了
+
+
+
+J5950端子上部为音频功放输出端口
+
+实物图连接：
+
+
+
+因为Android11集成的声卡设置和linux下不同，所以命令不同
+
+Android使用的是toybox下的tinyalsa工具
+
+使用方法可参考[如何查看声卡、pcm设备以及tinyplay、tinymix、tinycap的使用-CSDN博客](https://blog.csdn.net/luyao3038/article/details/121859072)
+
+设备树加入use-ext-amplifier后可支持外部扬声器播放音乐
+
+
+
+设置输出方式为耳机输出（HP）
+
+```
+tinymix 0 HP
+```
+
+
+
+用adb命令将.wav音乐传到开发板上，播放音乐
+
+```
+tinyplay ./music.wav
+```
+
+设置输出方式为扬声器输出（SPK）
+
+```
+tinymix 0 SPK
+```
+
+同样可以输出
+
+
+
+## 3.7 4G模块
+
+### 3.7.1 应用程序测试
+
+**开机方式**
+
+首先操作GPIO，给4G模块上电
+
+**（注意：开关机按键，复位按键，在开发板上是MPU的GPIO出来后，硬件做了反向的。低电平，上电 低脉冲，复位）**
+
+输入如下命令
+
+```
+gpioset 3 0=0
+gpioset 3 1=0
+```
+
+将这两个引脚拉低后，模块上电如下所示
+
+
+
+**关机方式**
+
+1. 软件方式关机
+
+ 先发送AT+QPOWD命令给模块，再拉高引脚
+
+ ```
+ microcom /dev/ttyUSB3 -s 115200
+ AT+QPOWD
+ ```
+
+ 按住Ctrl+x,再输入如下命令
+
+ ```
+ gpioset 3 1=1
+ ```
+
+ **（注意：在发送AT命令后需要在几秒内拉高gpio引脚，否则模块会再次开启）**
+
+ 
+
+2. 硬件方式关机
+
+ 先拉低RESET大于100ms后，拉低电源引脚Power_on
+ 硬件关机时序如下图所示：
+
+ 
+
+当4G模块上电后，可以在dev目录下看到四个ttyUSB设备
+
+
+
+我们可以使用microcom命令对串口发送AT命令
+
+```c
+microcom /dev/ttyUSB3 -s 115200
+```
+
+
+
+检测手机卡是否在位
+
+AT+CPIN?
+
+
+
+网络运行商名称
+
+AT+COPS?
+
+
+
+CHN-CT 表示中国电信
+
+网络注册状态
+
+AT+CREG?
+
+
+
+第二个参数为0 表示没有注册网络，为1表示网络已注册
+
+
+
+信号强度
+
+AT+CSQ
+
+
+
+数值越大表明信号质量越好；
+
+
+
+**注意：如果在linux系统下对EM05设置成了ECM模式，那上电后会自动进入ECM模式，如果有，跳过下面的ECM模式拨号上网切换过程**
+
+
+
+**ECM模式拨号上网**
+
+当我们上电4G模块之后,我们发送如下AT命令切换模块的工作模式为ECM
+
+```
+microcom /dev/ttyUSB3 -s 115200
+AT+QCFG="usbnet",1
+```
+
+
+
+**当我们将EM05配置成ECM模式后，在Linux下就可以直接获取ip地址，直接上网了，但是在Android系统下不会有这些服务，解决方法见 5. Android 出现4G模块无法上网问题**
+
+
+
+# 4. ADB调试工具
1. 下载解压platform-tools-latest-windows.zip
@@ -170,7 +685,7 @@
-### Android 出现4G模块无法上网问题
+# 5. Android 出现4G模块无法上网问题
背景：出现这个问题之前，4G模块EM05在Linux系统可以通过ECM模式上网，但是到了Android系统发现usb0网络无法获取到IP地址，从而无法上网。
@@ -220,42 +735,36 @@
-### Android声卡测试
-
-先将模式切换成输出模式，默认是高电平静音模式
+# 6. Android系统修改硬件设备访问权限
-```
-gpioset 3 19=0
+背景：在使用Android Studio工具实现屏幕按键控制三色灯亮灭的时候，未获得权限导致不能打开/dev/gpiochip*
-或者
+在硬件抽象层模块文件(so)文件中，提供的函数调用open函数来打开设备文件，比如/dev/gpio，如果不修改设备文件/dev/gpio的访问权限，那么应用程序通过JNI接口来调用硬件抽象层提供的函数接口来调用open函数打开设备文件就会失败，这表示当前用户没有权限打开设备文件/dev/gpio文件。在默认情况下，只有root用户才有权限访问系统的设备文件，由于一般的应用程序没有root权限的。
-echo "out" > /sys/class/gpio/gpio115/direction
-echo 0 > /sys/class/gpio/gpio115/value
-```
+
-当听到喇叭发出“砰”的一声就说明可以了
+为了解决上面的问题，需要为用户赋予访问设备文件/dev/gpio的权限。在linux系统中，可通过udev规则在系统启动时修改设备文件的访问权限，但在Android系统中没有实现udev规则，而是提供uevent机制，可以在系统启动时修改设备文件的访问权限
-因为Android11集成的声卡设置和linux下不同，所以命令不同
+修改步骤
-Android使用的是toybox下的tinyalsa工具
+1. 关闭SELinux(如果已经关闭可跳过)
-使用方法可参考[如何查看声卡、pcm设备以及tinyplay、tinymix、tinycap的使用-CSDN博客](https://blog.csdn.net/luyao3038/article/details/121859072)
+ device/rockchip/common
-设置输出方式为耳机输出（HP）
+ 
-```
-tinymix 0 HP
-```
+2. `vim /system/core/rootdir/uevent.rc`
-
+添加如下内容
-播放音乐
+
-```
-tinyplay ./music.wav
-```
+重新编译Android镜像
+启动后查看是否修改成功
+
+
--
Gitblit v1.9.1