anheng
2024-04-20 2bb4ec14bcce75f49256cc5c325c975a46a360f9
RK3568_Android_SDK开发文档/RK3568_Android_SDK开发文档.md
@@ -0,0 +1,273 @@
# 1. Rockchip Android 11.0 SDK代码下载编译
## 1.1 下载压缩包
```
wget http://192.168.0.2:2211/rockchip/android/android-11.0-mid-rkr12.tgz
```
## 1.2 解压压缩包
```
tar -xzvf android-11.0-mid-rkr12.tgz
```
## 1.3. 代码编译
进入解压路径后,输入如下命令:
```
source build/envsetup.sh
lunch rk3568_r-userdebug
./build.sh -AUCKu
```
编译完成后,会在/rockdev/Image-rk3568_r目录下生成镜像文件,如图:
![build_result](./images/build_result.PNG)
# 2. 系统烧录
## 2.1 开发板烧录链接
![Board_Connect](./images/Board_Connect.png)
* 使用 12V/1A 的电源给开发板供电;
* 使用两端都是 TypeA接口的USB线连接开发板上的USB3.0接口到自己的PC上,该USB接口为系统烧录口;
* 使用 TypeB 接口的USB线连接开发板上的 Console 调试串口到自己的PC上;
*
***注: 开发板上电时,可以听到继电器上电后的咔嚓切换声音。***
## 2.2 烧录软件下载
从凌云实验室文件服务器上下载并安装下面烧录软件。
*  [CP210x_VCP_Windows.zip](http://studio.iot-yun.club:2211/rockchip/tools/CP210x_VCP_Windows.zip)  解压缩并安装开发板的Console调试串口驱动;
*  [DriverAssitant_v5.1.1.zip](http://studio.iot-yun.club:2211/rockchip/tools/DriverAssitant_v5.1.1.zip) , 解压缩安装RK3568开发板驱动;
*  [RKDevTool_Release_v2.86.zip](http://studio.iot-yun.club:2211/rockchip/tools/RKDevTool_Release_v2.86.zip) ,直接解压缩即可运行的 RK3568开发板烧录软件;
![tools_download](./images/tools_download.PNG)
## 2.3 固件烧写
打开RKDevTool工具
![RKDevTool-1](./images/RKDevTool-1.png)
在下载镜像页面配置各个镜像文件及其烧录地址如下:
![RKDevTool-2](./images/RKDevTool-2.png)
### 2.3.1 按住 Maskrom 按键进入
如下图所示,将开发板上电后,按住 **S1300(Maskrom)按键** 同时,然后 **按下并释放 SW2100(Reset)按键** 将开发板重启,接下来 **再释放S1300按键**,这时候CPU将会进入到 **Maskrom模式**,在该模式下我们可以烧录或升级系统镜像。
![boot_maskrom](./images/boot_maskrom.png)
下面是开发板上的各个按键说明:
| 按键   | 作用           | 备注                                   |
| ------ | -------------- | -------------------------------------- |
| SW2101 | RK809_PWRON    | 长按8秒左右关机,再按开机              |
| S1300  | A核Maskrom按键 | 按住该键+复位键系统将进入到MASKROM模式 |
| SW1501 | Recovery Key   | 按住该键+复位键系统将进入到Loader模式  |
| SW2100 | RESETN         | A核复位按键                            |
| S6000  | M3核复位按键   | M核复位按键                            |
| S6001  | M3核ISP按键    | 按下复位M核将进入UART ISP模式          |
此时在 **RKDevTool.exe** 软件底行会显示 “**发现一个MASKROM设备**” 。
### 2.3.2 按住 Recovery 按键进入
如下图所示,将开发板上电后,按住 **SW1501(Recovery)按键** 同时,然后 **按下并释放 SW2100(Reset)按键** 将开发板重启,**继续SW1501(Recovery)按键 8秒后释放**,这时候CPU将会进入到 **Loader 模式**,在该模式下我们可以烧录或升级系统镜像。
![boot_loader](./images/boot_loader.png)
此时在 **RKDevTool.exe** 软件底行会显示 “**发现一个LOADER设备**”。
接下来切换到 “**高级功能**” 菜单下,并点击 “**进入Maskrom**” 按钮,这时候将会切换到 “**Maskrom**” 模式。
![mode_switch](./images/mode_switch.png)
## 2.4 系统烧录与启动
在 **RKDevTool.exe** 烧录软件上,确认设备已经进入到 Maskrom模式后,点击上面的 **“执行”** 按钮。
![maskrom_program](./images/maskrom_program.PNG)
![Board_Connect_2](./images/Board_Connect_2.png)
**(注意:当系统烧录完后,切勿拔掉USB3.0烧录口,不然后面开发板启动会报错!!!)**
烧录完成第一次启动后,系统将会自动初始化。初始化完成之后将会再次重启,此时可以使用 Console 串口上登录到开发板的 Android11系统中去。
![console_login](./images/console_login.PNG)
注意:在系统启动时会弹出类似于:
```
[   31.545394] type=1400 audit(1712609351.273:45): avc: denied { read } for comm="Binder:190_2" name="wakeup4" dev="sysfs" ino=23884 scontext=u:r:system_suspend:s0 tcontext=u:object_r:sysfs:s0 tclass=dir permissive=1
[   31.545632] type=1400 audit(1712609351.273:46): avc: denied { open } for comm="Binder:190_2" path="/sys/devices/platform/fe6e0030.pwm/wakeup/wakeup4" dev="sysfs" ino=23884 scontext=u:r:system_suspend:s0 tcontext=u:object_r:sysfs:s0 tclass=dir permissive=1
[   31.545831] type=1400 audit(1712609351.273:47): avc: denied { read } for comm="Binder:190_2" name="event_count" dev="sysfs" ino=23891 scontext=u:r:system_suspend:s0 tcontext=u:object_r:sysfs:s0 tclass=file permissive=1
[   31.546114] type=1400 audit(1712609351.273:48): avc: denied { open } for comm="Binder:190_2" path="/sys/devices/platform/fe6e00t" dev="sysfs" ino=23891 scontext=u:r:system_suspend:s0 tcontext546228] type=1400 audit(1712609351.273:49): avc: denied { getattwakeup/wakeup4/event_count" dev="sysfs" ino=23891 scontext=u:r:s1
```
此时需要输入命令`su`,切换到root用户,既不会弹出。
### ADB调试工具
1. 下载解压platform-tools-latest-windows.zip
![](./images/adb1.png)
2. 添加环境变量
将解压的文件夹的目录位置添加到环境变量Path下
![image-20240413162146596](./images/adb2.png)
3. 打开cmd窗口,输入adb命令
![](./images/adb3.png)
上面表示adb安装成功!
**如果遇到问题无法使用,或者提示找不到adb命令,把解压出来的文件夹里的adb.exe文件复制到C:\Windows\SysWOW64**
4. 上传文件到开发版的Android系统
(1)把开发板的串口线接到PC端后,输入`adb root`获取权限
![](./images/adb4.png)
(2)重新挂载根文件系统,输入`adb remount`重新挂载
![](./images/adb5.png)
(3)将windows文件上传到开发板系统,利用`adb push`命令上传文件
例如我需要将windows下E:\music.wav文件上传到开发板的/sdcard/Music下
`adb push E:\music.wav /sdcard/Musci`
![image-20240413163255828](./images/adb6.png)
![](./images/adb7.png)
### Android 出现4G模块无法上网问题
背景:出现这个问题之前,4G模块EM05在Linux系统可以通过ECM模式上网,但是到了Android系统发现usb0网络无法获取到IP地址,从而无法上网。
解决方法:
Android系统带的RIL机制,Android RIL提供了Android电话服务和无线电硬件之间的抽象层。
在Windows和Linux系统下会有后台进程帮我们自动获取IP,只需要我们把模块设置成ECM模式就可以了,但是Android下没有这个服务。在Android系统下存在一个rild_damon这个守护进程,RILD(RIL Daemon)是系统的守护进程,系统已启动,就会一直运行。手机开机时,kernel完成初始化后,Android启动一个初始化进程Init用于加载系统基础服务,如文件系统,zygote进程,服务管家ServiceManager,以及RILD
在/home/android/rk3568/android11/hardware/ril/rild下存在一个rild.rc文件,在这个文件中配置了rild_damon这个服务,也是解决这个问题的关键。
1. 获取移远公司提供的libreference-ril.so , 在系统执行rild可执行文件的时候会链接到这个动态库
2. 将libreference-ril.so添到/home/android/rk3568/android11/vendor/rockchip/common/phone/lib目录下,并重命名为libreference-ril-em05.so
   ![image-20240416220016981](./images/image-20240416220016981.png)
3. 修改/home/android/rk3568/android11/vendor/rockchip/common/phone/phone.mk
   ![image-20240416215946520](./images/image-20240416215946520.png)
   (这里添加这个动态库的目的是让最后生成的根文件系统里的/vendor/lib64/下存在libreference-ril-em05.so,如果不存在这个动态库,rild_daemon守护进程会一直打印退出重启信息,直到/vendor/lib64/下存在该动态库)
   4. 修改/home/android/rk3568/android11/hardware/ril/rild/rild.rc
      ![image-20240416220256988](./images/image-20240416220256988.png)
​      (从第一行可以看到,在启动ril-daemon这个服务的时候,系统会调用/vendor/bin/hw/rild程序,该程序需要链接到动态库)
修改好上面内容后,重新编译,烧录新的镜像到开发板中
测试结果:
1. 将EM05上电(上电流程参考linux系统)
2. 上电后会出现如下信息
   ![image-20240416220642197](./images/image-20240416220642197.png)
(中间的denied信息是由于SELinux下权限问题,暂时先不用管)
我们通过`ifconfig usb0`查看usb0的信息
![image-20240416220752393](./images/image-20240416220752393.png)
通过`ping www.baidu.com`测试上网功能
![image-20240416220836773](./images/image-20240416220836773.png)
### Android声卡测试
![image-20240418191114947](./images/image-20240418191114947.png)
先将模式切换成输出模式,默认是高电平静音模式
```
gpioset 3 19=0
或者
echo "out" > /sys/class/gpio/gpio115/direction
echo 0 > /sys/class/gpio/gpio115/value
```
当听到喇叭发出“砰”的一声就说明可以了
因为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)
播放音乐
```
tinyplay ./music.wav
```
设置输出方式为扬声器输出(SPK)
```
tinymix 0 SPK
```
同样可以输出