anheng
2024-06-15 f4b1e28acfa2f644ed98edfdad23e45e43746fd0
RK3568_Android_SDK开发文档/RK3568_Android_SDK开发文档.md
@@ -1,15 +1,26 @@
# 1. Rockchip Android 11.0 SDK代码下载编译
# 1. Rockchip Android 11.0 / 13.0 SDK代码下载编译
## 1.1 下载压缩包
```
android 11
wget http://192.168.0.2:2211/rockchip/android/android-11.0-mid-rkr12.tgz
android 13
wget http://192.168.0.2:2211/rockchip/bsp/rk3568_linuxSDK/sdkV1.3.0_linux4.19/rk356x_linux_release_v1.3.0_20220925.tgz
```
## 1.2 解压压缩包
```
android 11
tar -xzvf android-11.0-mid-rkr12.tgz
android 13
tar -xzvf android-13.0-mid-rkr6.tar.bz2
//使用 repo 命令将源码 checkout 出来
.repo/repo/repo sync -l
```
## 1.3. 代码编译
@@ -17,14 +28,26 @@
进入解压路径后,输入如下命令:
```
#android 11
source build/envsetup.sh
lunch rk3568_r-userdebug
./build.sh -AUCKu
#android 13
source build/envsetup.sh
lunch rk3568_t-userdebug
./build.sh -AUCKu
```
编译完成后,会在/rockdev/Image-rk3568_r目录下生成镜像文件,如图:
编译完成后,会在/rockdev/Image-rk3568_r目录下生成镜像文件,如图:**(android13 也是一样的)**
![build_result](./images/build_result.PNG)
Android13 编译产物如下
![image-20240612152345151](./images/image-20240612152345151.png)
# 2. 系统烧录
@@ -99,9 +122,17 @@
## 2.4 系统烧录与启动
在 **RKDevTool.exe** 烧录软件上,确认设备已经进入到 Maskrom模式后,点击上面的 **“执行”** 按钮。
在 **RKDevTool.exe** 烧录软件上,确认设备已经进入到 Maskrom模式后,在左侧空白处右键选择导入配置,找到下载镜像的目录,里面有个config.cfg,这个文件可以一键配置烧录选项和烧录镜像的各个地址
![maskrom_program](./images/maskrom_program.PNG)
![image-20240612152601794](./images/image-20240612152601794.png)
![image-20240612152707294](./images/image-20240612152707294.png)
此时配置导入成功,将原始路径换成自己的下载镜像的路径。最后点击执行即可。
![Board_Connect_2](./images/Board_Connect_2.png)
@@ -258,8 +289,6 @@
## 3.4 RS232和RS485
### 3.4.1 内核修改支持
RS232 DTS文件修改
@@ -326,6 +355,10 @@
**注意:Android系统下的microcom命令来自tinybox 和linux用法大致一样的,但是退出方式不一样,Android 下退出microcom是“Ctrl+]”**
RS485测试接受功能
如图所示,利用TTL转RS485模块来作为另外一台RS485设备,连线如下图所示
@@ -382,7 +415,9 @@
Networking support ->
    CAN bus subsystem support ->
         CAN Device Drivers  ->
               Platform CAN drivers with Netlink support  ->
               <*>Platform CAN drivers with Netlink support
               <*>Rockchip CAN controller
               <*>Rockchip CANFD controller
```
### 3.5.2 应用程序测试
@@ -413,22 +448,22 @@
注意:因为Android上没有can的相关命令,所以需要去网上下载适配Android系统的canutils工具源码,然后使用安卓编译系统编译源码,具体步骤
1. 下载解压canutils,将canutils放在/home/android/rk3568/android11/external目录下
1. 下载解压canutils,将canutils放在~rk3568/android11/external目录下
2. 回到/home/android/rk3568/android11目录使用如下命令配置好编译系统环境
2. 回到~/rk3568/android11目录使用如下命令配置好编译系统环境
   ```
   source build/envsetup.sh
   lunch rk3568_r-userdebug
   ```
3. 在进入/home/android/rk3568/android11/external/canutils目录下,输入mm,即可自动编译源码
3. 在进入~/rk3568/android11/external/canutils目录下,输入mm,即可自动编译源码
   ![image-20240425162537809](./images/image-20240425162537809.png)
4. 最后可执行文件都会安装到
   /home/android/rk3568/android11/out/target/product/rk3568_r/system/bin
   ~/rk3568/android11/out/target/product/rk3568_r/system/bin
   (ps. 其实我们可以将这个canutils的编译放进整个的安卓编译系统,这样我们编译安卓源码的时候就可以自动编译canutils,这样我们烧录镜像后会发现,系统出厂自带了canutils,这个步骤可以借鉴网上博客)
@@ -455,8 +490,6 @@
## 3.6 声卡Codec
### 3.6.1 内核修改支持
@@ -508,10 +541,20 @@
设置输出方式为耳机输出(HP)
```
#Android 11
tinymix 0 HP
```
![image-20240418191756605](./images/image-20240418191756605.png)
```
#Android 13
tinymix 3 HP
```
![image-20240612194003337](./images/image-20240612194003337.png)
用adb命令将.wav音乐传到开发板上,播放音乐
@@ -522,7 +565,12 @@
设置输出方式为扬声器输出(SPK)
```
#Android 11
tinymix 0 SPK
#Android 13
tinymix 3 SPK
```
同样可以输出
@@ -548,7 +596,7 @@
将这两个引脚拉低后,模块上电如下所示
![](./images/4g-9.png)
![image-20240612200324154](./images/image-20240612200324154.png)
**关机方式**
@@ -641,43 +689,59 @@
**当我们将EM05配置成ECM模式后,在Linux下就可以直接获取ip地址,直接上网了,但是在Android系统下不会有这些服务,解决方法见 5.  Android 出现4G模块无法上网问题**
## 3.8 DIO测试
**注意: 测试之前需要将每个gpio确认没有在设备树中复用,否则无法控制电平变化**
### 3.8.1 硬件原理图说明
![8d0dcd185714d7a482bc6e537d904837_](./images/8d0dcd185714d7a482bc6e537d904837_.jpg)
![d3348419dd510670f7c897be5dec417e_](./images/d3348419dd510670f7c897be5dec417e_.jpg)
![image-20240513112427985](./images/image-20240513112427985.png)
![image-20240513112435295](./images/image-20240513112435295.png)
### 3.8.2 Din测试
![d4220b70053963e8c9846de84e68b129_](./images/d4220b70053963e8c9846de84e68b129_.jpg)
按照上图的说明方法,将Din-0短接GND,此时Din-0输出低电平,测量R6114两侧的电压值,红表笔接一侧,黑笔接地。此时可以发现万用表显示电压为0.17v左右。其他的三个Din均是相同的方法。
**注意:为什么不是0V而是0.17v的微弱电压?**
**因为从下图可以看出光耦内置三极管的CE结,饱合导通时会存在一定的压降,这个0.17v即为压降。**
![ea23d8f7b3f22251da9646a52106a24](./images/ea23d8f7b3f22251da9646a52106a24.jpg)
### 3.8.3 Dout测试
![f96ddb352acf28b8a7088acf58e72ab6_](./images/f96ddb352acf28b8a7088acf58e72ab6_.jpg)
如上图所示连接好电路,以Dout-0为例说明,其他的Dout的测试方法均相同
输入`gpioset 0 4=0`,使gpio输出为低电平,用万用表测试R6211两端的电压正常情况均为0v。
输入`gpioset 0 4=1`,使gpio输出为高电平,用万用表测试R6211两端的电压正常情况均为3.3v。
## 3.8 RK3568自带的NPU
### 3.8.1 应用程序测试
**注意:在RK3568上如果某个gpio没有被复用,默认情况下该引脚的模式是gpio模式,但是此处的GPIO0_PA4例外,所以需要在设备树中特殊配置一下该引脚使用gpio模式。**
测试的程序是一个yolov5的目标识别demo,编译环境是Linux arm64系统
![image-20240513115053582](./images/image-20240513115053582.png)
先去github下载RKNPU2并解压生成rknpu2-master文件夹
### 3.8.4 Dout/ Din 联合测试
[GitHub - rockchip-linux/rknpu2](https://github.com/rockchip-linux/rknpu2?tab=readme-ov-file)
![57c8bc8656696e1eff33f79e808344e2_](./images/57c8bc8656696e1eff33f79e808344e2_.jpg)
1. 进入/home/anheng/rk3568/rknpu2-master/examples/rknn_yolov5_demo目录
如上图所示将Din与Dout连接好,通过改变Dout的输出电平,检测Din是否收到对应的电平,以Din-0和Dout-0为例说明
2. `vim build-linux_RK3566_RK3568.sh`
输入`gpioset 0 4=0` `gpioget 3 3`,显示Din-0的电平应为0
3. 更改交叉编译器路径
输入`gpioset 0 4=1` `gpioget 3 3`,显示Din-0的电平应为1
   ![image-20240425173202774](./images/image-20240425173202774.png)
4. 授予build-linux_RK3566_RK3568.sh执行权限,./build-linux_RK3566_RK3568.sh
​       编译好了之后会生成install文件,里面就有官方提供的rknn模型,可执行程序,以及相应的动态库文件,如下
![image-20240425173407578](./images/image-20240425173407578.png)
5. 用adb命令将/home/anheng/rk3568/rknpu2-master/examples/rknn_yolov5_demo/install目录下的rknn_yolov5_demo_Linux文件夹上传到开发板的/data目录下
6. 指定库文件路径 `export LD_LIBRARY_PATH=/data/rknn_yolov5_demo_Linux/lib `
7. 运行程序识别相应的图片中物体的类别。`./rknn_yolov5_demo ./model/RV1106/yolov5s-640-640.rknn ./model/bus.jpg `
   ![eb02125fb19e15ed9b3fdd421be39b5](./images/eb02125fb19e15ed9b3fdd421be39b5.png)
   识别的结果会以out.jpg保存在当前目录
   ![b2a248d83fc722b08b2d0bfb24f84a0](./images/b2a248d83fc722b08b2d0bfb24f84a0.png)
# 4.  ADB调试工具
@@ -723,7 +787,7 @@
# 5.  Android 出现4G模块无法上网问题
# 5.  Android11 出现4G模块无法上网问题
背景:出现这个问题之前,4G模块EM05在Linux系统可以通过ECM模式上网,但是到了Android系统发现usb0网络无法获取到IP地址,从而无法上网。
@@ -733,23 +797,31 @@
在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这个服务,也是解决这个问题的关键。
在~/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
2. 将libreference-ril.so添到~/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
3. 修改~/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
4. 打开BOARD_HAVE_DONGLE 和BOARD_HAS_RK_4G_MODEM
      ![image-20240416220256988](./images/image-20240416220256988.png)
   BOARD_HAVE_DONGLE和BOARD_HAS_RK_4G_MODEM 都在/device/rockchip/common/BoardConfig.mk    都将其改为true
   ![image-20240614183103768](./images/image-20240614183103768.png)
   ![image-20240614183213299](./images/image-20240614183213299.png)
5. 修改~/rk3568/android11/hardware/ril/rild/rild.rc
![image-20240416220256988](./images/image-20240416220256988.png)
​      (从第一行可以看到,在启动ril-daemon这个服务的时候,系统会调用/vendor/bin/hw/rild程序,该程序需要链接到动态库)
@@ -775,7 +847,195 @@
# 6. Android系统修改硬件设备访问权限
# 6. Android13 4G上网问题
背景:在升级android到13的时候发现用android11的方法去使用ril机制出现了各种各样的问题,所以在原先11的基础上还需要修改一些地方
1. 首先需要获取适配Android13的ril库,不能使用android11那个库,版本是不对的
​      RIL驱动版本是3.6.24
![image-20240614181905718](./images/image-20240614181905718.png)
2. 将这些文件分别拷贝到如下地址
​   /vendor/rockchip/common/phone/bin/chat
​   /vendor/rockchip/common/phone/etc/ppp/ip-down
​   /vendor/rockchip/common/phone/etc/ppp/ip-up
​   /vendor/rockchip/common/phone/etc/ql-ril.conf
​   /vendor/rockchip/common/phone/lib/libreference-ril-em05.so(这里的libreference-ril-em05.so就是压缩包文件libreference-ril.so重命名的)
3. 修改/vendor/rockchip/common/phone/phone.mk文件
   ![image-20240614182726060](./images/image-20240614182726060.png)
   也就是指定刚才拷贝过来的几个文件,这里是需要指定最后将这些文件拷贝到开发版的哪些位置
4. 打开BOARD_HAVE_DONGLE 和BOARD_HAS_RK_4G_MODEM
   BOARD_HAVE_DONGLE和BOARD_HAS_RK_4G_MODEM 都在/device/rockchip/common/BoardConfig.mk    都将其改为true
   ![image-20240614183103768](./images/image-20240614183103768.png)
   ![image-20240614183213299](./images/image-20240614183213299.png)
5. 修改文件/device/rockchip/common/modules/4g_modem.mk
   ```
   # Copyright 2021 Rockchip Limited
   #
   # Licensed under the Apache License, Version 2.0 (the "License");
   # you may not use this file except in compliance with the License.
   # You may obtain a copy of the License at
   #
   #      http://www.apache.org/licenses/LICENSE-2.0
   #
   # Unless required by applicable law or agreed to in writing, software
   # distributed under the License is distributed on an "AS IS" BASIS,
   # WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
   # See the License for the specific language governing permissions and
   # limitations under the License.
   #
   PRODUCT_PACKAGES += \
       CarrierDefaultApp \
       CarrierConfig \
       rild \
       libreference-ril-em05 \
       dhcpcd
   PRODUCT_COPY_FILES += vendor/rockchip/common/phone/etc/apns-full-conf.xml:$(TARGET_COPY_OUT_PRODUCT)/etc/apns-conf.xml
   PRODUCT_PACKAGES += \
       android.hardware.radio@1.2-radio-service \
       android.hardware.radio.config@1.0-service
   PRODUCT_PROPERTY_OVERRIDES += \
       ro.boot.noril=false \
       ro.telephony.default_network=9
   DEVICE_MANIFEST_FILE += device/rockchip/common/4g_modem/manifest.xml
   ifeq ($(strip $(TARGET_ARCH)), arm64)
   PRODUCT_PROPERTY_OVERRIDES += \
       vendor.rild.libpath=/vendor/lib64/libreference-ril-em05.so
   PRODUCT_COPY_FILES += \
       $(LOCAL_PATH)/../4g_modem/bin64/dhcpcd:$(TARGET_COPY_OUT_VENDOR)/bin/dhcpcd \
       $(LOCAL_PATH)/../4g_modem/lib64/librk-ril.so:$(TARGET_COPY_OUT_VENDOR)/lib64/librk-ril.so
   else
   PRODUCT_PROPERTY_OVERRIDES += \
       vendor.rild.libpath=/vendor/lib/libreference-ril-em05.so
   PRODUCT_COPY_FILES += \
       $(LOCAL_PATH)/4g_modem/bin32/dhcpcd:$(TARGET_COPY_OUT_VENDOR)/bin/dhcpcd \
       $(LOCAL_PATH)/4g_modem/lib32/librk-ril.so:$(TARGET_COPY_OUT_VENDOR)/lib/librk-ril.so
   endif
   ```
6. 修改文件/hardware/interfaces/compatibility_matrices/compatibility_matrix.7.xml
   这一步比较关键,在android11中使用的是compatibility_matrix.5.xml,这个compatibility_matrix文件定义了 Android 系统和硬件之间的兼容性规范。包括了所有 HAL(硬件抽象层)的声明,版本信息,以及与 Android 框架的兼容性设置。
   由于android13使用的是compatibility_matrix.7.xml,这里面声明的HAL内容和版本5有很多不一样的,所以在/device/rockchip/common/4g_modem/manifest.xml这个文件里声明的HAL接口必须要在compatibility_matrix.7.xml内能够找得到才会编译通过,之前的android11不存在这个问题就是因为11的manifest.xml里的接口都在compatibility_matrix.5.xml声明过了。如果不修改compatibility_matrix.7.xml文件,那么在编译到android的部分的时候就会报如下错误:
   ![ee304351b17e2807aa62a87d75502e9](./images/ee304351b17e2807aa62a87d75502e9.png)
   解决办法就是按照compatibility_matrix.5.xml的接口声明去修改compatibility_matrix.7.xml的内容,这是因为android11和13的manifest.xml内容是一模一样的。
   manifest.xml内容如下
   ![image-20240614185002556](./images/image-20240614185002556.png)
   从内容中我们可以看到一共有三个部分,android.hardware.radio,android.hardware.radio.deprecated,android.hardware.radio.config
   也就是说我们需要将compatibility_matrix.7.xml里面对于这三个部分的声明修改成compatibility_matrix.5.xml对这三个部分的声明,这样编译就可以通过了
   将如下内容加入到compatibility_matrix.7.xml里面
   ```
       <hal format="hidl" optional="true">
           <name>android.hardware.radio</name>
       <version>1.1</version>
       <version>1.2</version>
       <version>1.3</version>
           <version>1.4</version>
           <version>1.5</version>
           <interface>
               <name>IRadio</name>
               <instance>slot1</instance>
               <instance>slot2</instance>
               <instance>slot3</instance>
           </interface>
       </hal>
       <hal format="hidl" optional="true">
       <name>android.hardware.radio.deprecated</name>
           <version>1.0</version>
           <interface>
           <name>IOemHook</name>
           <instance>slot1</instance>
           </interface>
       </hal>
       <hal format="hidl" optional="true">
           <name>android.hardware.radio</name>
           <version>1.2</version>
           <interface>
               <name>ISap</name>
               <instance>slot1</instance>
           </interface>
       </hal>
       <hal format="hidl" optional="true">
           <name>android.hardware.radio.config</name>
           <!--
           See compatibility_matrix.4.xml on versioning of radio config HAL.
           -->
       <version>1.0</version>
           <version>1.1</version>
           <interface>
               <name>IRadioConfig</name>
               <instance>default</instance>
           </interface>
       </hal>
   ```
7. 修改hardware/ril/rild/rild.rc
![image-20240416220256988](./images/image-20240416220256988.png)
​      (从第一行可以看到,在启动ril-daemon这个服务的时候,系统会调用/vendor/bin/hw/rild程序,该程序需要链接到动态库)
8. 打开config_mobile_data_capable(config_mobile_data_capable指定设备是否支持移动数据连接)
   进入device/google/atv/overlay/TvFrameworkOverlay/res/values/config.xml
   找到config_mobile_data_capable 将false改为true
   ![image-20240614190107279](./images/image-20240614190107279.png)
   进入device/rockchip/common/overlay_wifi_only/frameworks/base/core/res/res/values/config.xml
   找到config_mobile_data_capable 将false改为true
   ![image-20240614190356746](./images/image-20240614190356746.png)
   进入frameworks/base/core/res/res/values/config.xml
   这里默认是true 如果不是就改为true
   ![image-20240614190510415](./images/image-20240614190510415.png)
9. 修改frameworks/opt/telephony/src/java/com/android/internal/telephony/uicc/IccCardStatus.java
   找到public IccSlotPortMapping mSlotPortMapping;将其改为public IccSlotPortMapping mSlotPortMapping = new IccSlotPortMapping();
   ![image-20240614190755053](./images/image-20240614190755053.png)
编译android系统后烧录进开发板,上电em05模块后可以发现rild后台进程帮我们获取到了ip,查看usb0可以看到存在了ip,这是就可以通过4g上网。
# 7. Android系统修改硬件设备访问权限
背景:在使用Android Studio工具实现屏幕按键控制三色灯亮灭的时候,未获得权限导致不能打开/dev/gpiochip*
@@ -807,9 +1067,7 @@
![image-20240424165301524](./images/image-20240424165301524.png)
# 7. Android 永不息屏和关闭锁屏
# 8. Android 永不息屏和关闭锁屏
永不息屏
\android11\device\rockchip\rk356x\overlay\frameworks\base\packages\SettingsProvider\res\values\defaults.xml