anheng
2024-04-25 71c14e7c42e2f312f88dc8abcec4383e6ba10529
Android documentation updated
2 files modified
32 files added
599 ■■■■■ changed files
RK3568_Android_SDK开发文档/RK3568_Android_SDK开发文档.md 565 ●●●●● patch | view | raw | blame | history
RK3568_Android_SDK开发文档/images/4g-13.png patch | view | raw | blame | history
RK3568_Android_SDK开发文档/images/4g-16.png patch | view | raw | blame | history
RK3568_Android_SDK开发文档/images/4g-17.png patch | view | raw | blame | history
RK3568_Android_SDK开发文档/images/4g-2.png patch | view | raw | blame | history
RK3568_Android_SDK开发文档/images/4g-3.png patch | view | raw | blame | history
RK3568_Android_SDK开发文档/images/4g-4.png patch | view | raw | blame | history
RK3568_Android_SDK开发文档/images/4g-5.png patch | view | raw | blame | history
RK3568_Android_SDK开发文档/images/4g-6.png patch | view | raw | blame | history
RK3568_Android_SDK开发文档/images/4g-7.png patch | view | raw | blame | history
RK3568_Android_SDK开发文档/images/4g-9.png patch | view | raw | blame | history
RK3568_Android_SDK开发文档/images/CAN.png patch | view | raw | blame | history
RK3568_Android_SDK开发文档/images/CAN1.png patch | view | raw | blame | history
RK3568_Android_SDK开发文档/images/CAN_result.png patch | view | raw | blame | history
RK3568_Android_SDK开发文档/images/RS232.png patch | view | raw | blame | history
RK3568_Android_SDK开发文档/images/RS232_result.png patch | view | raw | blame | history
RK3568_Android_SDK开发文档/images/RS232_result2.png patch | view | raw | blame | history
RK3568_Android_SDK开发文档/images/RS485_2.png patch | view | raw | blame | history
RK3568_Android_SDK开发文档/images/RS485_rx.png patch | view | raw | blame | history
RK3568_Android_SDK开发文档/images/RS485_tx.png patch | view | raw | blame | history
RK3568_Android_SDK开发文档/images/RTC_result.png patch | view | raw | blame | history
RK3568_Android_SDK开发文档/images/RTC_result2.png patch | view | raw | blame | history
RK3568_Android_SDK开发文档/images/audio.png patch | view | raw | blame | history
RK3568_Android_SDK开发文档/images/audio2.png patch | view | raw | blame | history
RK3568_Android_SDK开发文档/images/audio4.png patch | view | raw | blame | history
RK3568_Android_SDK开发文档/images/image-20240424165202351.png patch | view | raw | blame | history
RK3568_Android_SDK开发文档/images/image-20240424165301524.png patch | view | raw | blame | history
RK3568_Android_SDK开发文档/images/image-20240424170641040.png patch | view | raw | blame | history
RK3568_Android_SDK开发文档/images/image-20240425162537809.png patch | view | raw | blame | history
RK3568_Android_SDK开发文档/images/led_buzzer2.png patch | view | raw | blame | history
RK3568_Android_SDK开发文档/images/len_buzzer.png patch | view | raw | blame | history
RK3568_Android_SDK开发文档/images/visitFile&sign=86650e641707df132c1a6cf6a25c462f.png patch | view | raw | blame | history
RK3568_Android_SDK开发文档/images/visitFile&sign=d3877fca8eee36667a6e525abdd84b68.png patch | view | raw | blame | history
RK3568_Linux_SDK开发文档/RK3568_Linux_SDK开发文档.md 34 ●●●●● patch | view | raw | blame | history
RK3568_Android_SDK开发文档/RK3568_Android_SDK开发文档.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 内核修改支持
原理图及分析
![](./images/len_buzzer.png)
这里的测试只要就是对这些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的高低电平,看看是否符合上述规则。
![](./images/led_buzzer2.png)
## 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"
```
![](./images/RTC_result.png)
设置完成后再次使用`date`命令查看一下当前时间就会发现时间改过来了
大家注意我们使用`date -s`命令仅仅是修改了当前时间,此时间还没有写入到RK809内部 RTC 里面或其他的 RTC 芯片里面,因此系统重启以后时间又会丢失。我们需要将当前的时间写入到 RTC 里面,这里要用到`hwclock` 命令,输入如下命令将系统时间写入到 RTC 里面:
```
hwclock -w     /将当前系统时间写入RTC里面/
```
时间写入到 RTC 里面以后就不怕系统重启以后时间丢失了
间隔时间输入如下命令:
```
hwclock -r    /读取当前系统时间/
```
![](./images/RTC_result2.png)
发现当前系统时间在走动,系统时间正常。
## 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口用杜邦线进行连接,如下图所示
![](./images/RS232.png)
连接好之后我们在设备1和设备2上均输入
```c
microcom /dev/ttyS3 -s 115200
```
测试结果
![](./images/RS232_result.png)
![](./images/RS232_result2.png)
由于microcom没有回显,所以看不到自己发送的是什么,但是接受的结果是没错的
RS485测试接受功能
如图所示,利用TTL转RS485模块来作为另外一台RS485设备,连线如下图所示
![](./images/RS485_2.png)
![](./images/RS485_rx.png)
RS485测试发送功能
将控制引脚拉高电平,输入如下命令
```c
gpioset 4 28=1
```
![](./images/RS485_tx.png)
## 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的数量,如下图所示
![](./images/CAN.png)
这里我们测试can1的收发功能,can0与之完全相同
首先我们将两个can设备利用杜邦线进行连接,连接如下图所示
![](./images/CAN1.png)
连接好之后,我们需要对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,即可自动编译源码
   ![image-20240425162537809](./images/image-20240425162537809.png)
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
```
结果如图所示
![img](./images/visitFile&sign=86650e641707df132c1a6cf6a25c462f.png)
![img](./images/visitFile&sign=d3877fca8eee36667a6e525abdd84b68.png)
## 3.6 声卡Codec
### 3.6.1 内核修改支持
原理图及分析
![](./images/audio.png)
![image-20240418191114947](./images/image-20240418191114947.png)
### 3.6.2 应用程序测试
先将模式切换成输出模式,默认是高电平静音模式
```
gpioset 3 19=0
或者
echo "out" > /sys/class/gpio/gpio115/direction
echo 0 > /sys/class/gpio/gpio115/value
```
当听到喇叭发出“砰”的一声就说明可以了
J5950端子上部为音频功放输出端口
实物图连接:
![](./images/audio2.png)
因为Android11集成的声卡设置和linux下不同,所以命令不同
Android使用的是toybox下的tinyalsa工具
使用方法可参考[如何查看声卡、pcm设备以及tinyplay、tinymix、tinycap的使用-CSDN博客](https://blog.csdn.net/luyao3038/article/details/121859072)
设备树加入use-ext-amplifier后可支持外部扬声器播放音乐
![image-20240418205004185](./images/image-20240418205004185.png)
设置输出方式为耳机输出(HP)
```
tinymix 0 HP
```
![image-20240418191756605](./images/image-20240418191756605.png)
用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
```
将这两个引脚拉低后,模块上电如下所示
![](./images/4g-9.png)
**关机方式**
1. 软件方式关机
   先发送AT+QPOWD命令给模块,再拉高引脚
   ```
   microcom /dev/ttyUSB3 -s 115200
   AT+QPOWD
   ```
   按住Ctrl+x,再输入如下命令
   ```
   gpioset 3 1=1
   ```
   **(注意:在发送AT命令后需要在几秒内拉高gpio引脚,否则模块会再次开启)**
   ![](./images/4g-16.png)
2. 硬件方式关机
   先拉低RESET大于100ms后,拉低电源引脚Power_on
   硬件关机时序如下图所示:
   ![](./images/4g-17.png)
当4G模块上电后,可以在dev目录下看到四个ttyUSB设备
![](./images/4g-2.png)
我们可以使用microcom命令对串口发送AT命令
```c
microcom /dev/ttyUSB3 -s 115200
```
![](./images/4g-3.png)
检测手机卡是否在位
AT+CPIN?
![](./images/4g-4.png)
网络运行商名称
AT+COPS?
![](./images/4g-5.png)
CHN-CT 表示中国电信
网络注册状态
AT+CREG?
![](./images/4g-6.png)
第二个参数为0 表示没有注册网络,为1表示网络已注册
信号强度
AT+CSQ
![](./images/4g-7.png)
数值越大表明信号质量越好;
**注意:如果在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,54 +735,36 @@
![image-20240416220836773](./images/image-20240416220836773.png)
### Android声卡测试
![image-20240418191114947](./images/image-20240418191114947.png)
先将模式切换成输出模式,默认是高电平静音模式
# 6. Android系统修改硬件设备访问权限
```
gpioset 3 19=0
背景:在使用Android Studio工具实现屏幕按键控制三色灯亮灭的时候,未获得权限导致不能打开/dev/gpiochip*
或者
echo "out" > /sys/class/gpio/gpio115/direction
echo 0 > /sys/class/gpio/gpio115/value
```
当听到喇叭发出“砰”的一声就说明可以了
在硬件抽象层模块文件(so)文件中,提供的函数调用open函数来打开设备文件,比如/dev/gpio,如果不修改设备文件/dev/gpio的访问权限,那么应用程序通过JNI接口来调用硬件抽象层提供的函数接口来调用open函数打开设备文件就会失败,这表示当前用户没有权限打开设备文件/dev/gpio文件。在默认情况下,只有root用户才有权限访问系统的设备文件,由于一般的应用程序没有root权限的。
因为Android11集成的声卡设置和linux下不同,所以命令不同
为了解决上面的问题,需要为用户赋予访问设备文件/dev/gpio的权限。在linux系统中,可通过udev规则在系统启动时修改设备文件的访问权限,但在Android系统中没有实现udev规则,而是提供uevent机制,可以在系统启动时修改设备文件的访问权限
Android使用的是toybox下的tinyalsa工具
使用方法可参考[如何查看声卡、pcm设备以及tinyplay、tinymix、tinycap的使用-CSDN博客](https://blog.csdn.net/luyao3038/article/details/121859072)
设备树加入use-ext-amplifier后可支持外部扬声器播放音乐
修改步骤
![image-20240418205004185](./images/image-20240418205004185.png)
1. 关闭SELinux(如果已经关闭可跳过)
设置输出方式为耳机输出(HP)
    device/rockchip/common
```
tinymix 0 HP
```
   ![image-20240424170641040](./images/image-20240424170641040.png)
![image-20240418191756605](./images/image-20240418191756605.png)
2. `vim /system/core/rootdir/uevent.rc`
播放音乐
添加如下内容
```
tinyplay ./music.wav
```
![image-20240424165202351](./images/image-20240424165202351.png)
设置输出方式为扬声器输出(SPK)
重新编译Android镜像
```
tinymix 0 SPK
```
启动后查看是否修改成功
同样可以输出
![image-20240424165301524](./images/image-20240424165301524.png)
RK3568_Android_SDK开发文档/images/4g-13.png
RK3568_Android_SDK开发文档/images/4g-16.png
RK3568_Android_SDK开发文档/images/4g-17.png
RK3568_Android_SDK开发文档/images/4g-2.png
RK3568_Android_SDK开发文档/images/4g-3.png
RK3568_Android_SDK开发文档/images/4g-4.png
RK3568_Android_SDK开发文档/images/4g-5.png
RK3568_Android_SDK开发文档/images/4g-6.png
RK3568_Android_SDK开发文档/images/4g-7.png
RK3568_Android_SDK开发文档/images/4g-9.png
RK3568_Android_SDK开发文档/images/CAN.png
RK3568_Android_SDK开发文档/images/CAN1.png
RK3568_Android_SDK开发文档/images/CAN_result.png
RK3568_Android_SDK开发文档/images/RS232.png
RK3568_Android_SDK开发文档/images/RS232_result.png
RK3568_Android_SDK开发文档/images/RS232_result2.png
RK3568_Android_SDK开发文档/images/RS485_2.png
RK3568_Android_SDK开发文档/images/RS485_rx.png
RK3568_Android_SDK开发文档/images/RS485_tx.png
RK3568_Android_SDK开发文档/images/RTC_result.png
RK3568_Android_SDK开发文档/images/RTC_result2.png
RK3568_Android_SDK开发文档/images/audio.png
RK3568_Android_SDK开发文档/images/audio2.png
RK3568_Android_SDK开发文档/images/audio4.png
RK3568_Android_SDK开发文档/images/image-20240424165202351.png
RK3568_Android_SDK开发文档/images/image-20240424165301524.png
RK3568_Android_SDK开发文档/images/image-20240424170641040.png
RK3568_Android_SDK开发文档/images/image-20240425162537809.png
RK3568_Android_SDK开发文档/images/led_buzzer2.png
RK3568_Android_SDK开发文档/images/len_buzzer.png
RK3568_Android_SDK开发文档/images/visitFile&sign=86650e641707df132c1a6cf6a25c462f.png
RK3568_Android_SDK开发文档/images/visitFile&sign=d3877fca8eee36667a6e525abdd84b68.png
RK3568_Linux_SDK开发文档/RK3568_Linux_SDK开发文档.md
@@ -397,7 +397,7 @@
![](images/work-led.png)
DTS文件修改(如果有)
DTS文件修改(默认已经添加节点)
```
        leds: leds {
@@ -455,9 +455,7 @@
**注意:这四个gpio在设备树中可能会被其他设备所占用,导致不能操作gpio,所以要查看哪些设备占用着这几个gpio需要屏蔽掉这些设备。**
#### 测试方法
### 3.2.2 应用程序测试
由于这四个引脚都是用MOS管控制的开漏输出,所以我们需要去测试MOS管的栅极看看是否是3.3V电平
@@ -465,12 +463,6 @@
**GPIO输出1的时候,对应的栅极是0V**
**GPIO输出0的时候,对应的栅极是3.3V**
利用万用表,将万用表调到直流电压20V这一档,这四个模块对应的三极管如下图所示,利用gpioset来控制四个gpio的高低电平,看看是否符合上述规则。
### 3.2.2 应用程序测试
```c
gpioset 0 18=1/0
@@ -481,7 +473,7 @@
利用万用表,将万用表调到直流电压20V这一档,这四个模块对应的三极管如下图所示,利用gpioset来控制四个gpio的高低电平,看看是否符合上述规则。
![](/images/led_buzzer2.png)
![](./images/led_buzzer2.png)
@@ -776,7 +768,7 @@
点击 [下载地址](https://pyropus.ca./software/memtester/),即可下载memtester。
##### 编译方法1:
编译方法1:
打开终端进入到该路径下,输入解压命令:
@@ -810,7 +802,7 @@
##### 编译方法2:
编译方法2:
可以使用郭工的编译脚本进行编译,只需修改脚本的编译目标即可
@@ -840,7 +832,7 @@
### 3.8.1 内核修改支持
#### Iperf下载
**Iperf下载**
iperf官网:[iperf.fr](https://iperf.fr/)
@@ -854,7 +846,7 @@
2.cd iperf-3.x 进入目录,执行git tag查看历史版本。
3.执行git checkout 3.1.3 回退到3.1.3的历史版本。
#### 网络连接和IP配置
**网络连接和IP配置**
服务端与客户端的网口通过网线和交换机连接,两者IP需要保持在同一网段,如下所示:
@@ -862,7 +854,7 @@
Linux系统终端:192.168.10.50
#### 服务端iperf的安装与使用
**服务端iperf的安装与使用**
关闭Windows系统的防火墙与杀毒软件或允许iperf通过防火墙。
拷贝iperf-3.0.11-win32.rar并解压至Windows系统的的英文路径的目录(如D盘根目录)。
@@ -871,7 +863,7 @@
![](images/net.png)
#### 客户端iperf的安装与使用
**客户端iperf的安装与使用**
直接使用郭工安装库脚本文件build.sh,并做修改
@@ -939,7 +931,7 @@
将 iperf3拷贝到开发板
#### 测试TCP
**测试TCP**
在Linux终端执行
@@ -1013,8 +1005,6 @@
### 3.10.2 应用程序测试
#### 模块开关机
**开机方式**
@@ -1109,7 +1099,7 @@
#### PPP拨号方式
**PPP拨号方式**
内核配置好后,编译生成新的镜像烧录到开发板中
@@ -1262,7 +1252,7 @@
![](./images/4g-12.png)
#### ECM模式拨号上网
**ECM模式拨号上网**
上面的ppp模式拨号较为繁琐,需要大量的步骤依赖pppd软件,并且ppp拨号的稳定性不强,所以接下来介绍ECM模式,只需要AT命令就可以拨号上网