Update RK3568 development documents

guowenxue

2024-06-25 65db11d7a48e71642dd21ee6914cdd269eb7f01f

Update RK3568 development documents

Signed-off-by: guowenxue <guowenxue@gmail.com>

 documents/docs/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)

**关机方式**

@@ -642,6 +690,8 @@
**当我们将EM05配置成ECM模式后，在Linux下就可以直接获取ip地址，直接上网了，但是在Android系统下不会有这些服务，解决方法见 5.  Android 出现4G模块无法上网问题**

## 3.8 DIO测试

**注意： 测试之前需要将每个gpio确认没有在设备树中复用，否则无法控制电平变化**

### 3.8.1 硬件原理图说明

@@ -737,7 +787,7 @@



# 5.  Android 出现4G模块无法上网问题
# 5.  Android11 出现4G模块无法上网问题

背景：出现这个问题之前，4G模块EM05在Linux系统可以通过ECM模式上网，但是到了Android系统发现usb0网络无法获取到IP地址，从而无法上网。

@@ -747,21 +797,29 @@

在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 

   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)

@@ -789,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*

@@ -821,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

 documents/docs/RK3568_Android_SDK开发文档/images/ee304351b17e2807aa62a87d75502e9.png

 documents/docs/RK3568_Android_SDK开发文档/images/image-20240612152345151.png

 documents/docs/RK3568_Android_SDK开发文档/images/image-20240612152601794.png

 documents/docs/RK3568_Android_SDK开发文档/images/image-20240612152707294.png

 documents/docs/RK3568_Android_SDK开发文档/images/image-20240612194003337.png

 documents/docs/RK3568_Android_SDK开发文档/images/image-20240612200324154.png

 documents/docs/RK3568_Android_SDK开发文档/images/image-20240612201315942.png

 documents/docs/RK3568_Android_SDK开发文档/images/image-20240614181327583.png

 documents/docs/RK3568_Android_SDK开发文档/images/image-20240614181339997.png

 documents/docs/RK3568_Android_SDK开发文档/images/image-20240614181905718.png

 documents/docs/RK3568_Android_SDK开发文档/images/image-20240614182726060.png

 documents/docs/RK3568_Android_SDK开发文档/images/image-20240614183103768.png

 documents/docs/RK3568_Android_SDK开发文档/images/image-20240614183213299.png

 documents/docs/RK3568_Android_SDK开发文档/images/image-20240614185002556.png

 documents/docs/RK3568_Android_SDK开发文档/images/image-20240614190107279.png

 documents/docs/RK3568_Android_SDK开发文档/images/image-20240614190356746.png

 documents/docs/RK3568_Android_SDK开发文档/images/image-20240614190510415.png

 documents/docs/RK3568_Android_SDK开发文档/images/image-20240614190755053.png

 documents/docs/RK3568_Linux_SDK开发文档/RK3568_Linux_SDK开发文档.md

@@ -239,7 +239,7 @@

我们将烧录的rootfs文件替换成linaro-rootfs.img即可

烧录完成后启动开发板，会提示输入用户名和密码，这里的用户名和密码在编译脚本里写好了的均为linaro
烧录完成后启动开发板，会提示输入用户名和密码，**这里的用户名和密码在编译脚本里写好了的均为linaro**

登录后切换su用户`sudo su`,进入根目录下展示的就是Debian的根文件系统

@@ -775,6 +775,8 @@
DTS文件修改

```c
#Linux 4.19

&can0 {
        compatible = "rockchip,can-1.0";
        assigned-clocks = <&cru CLK_CAN0>;
@@ -792,6 +794,26 @@
        pinctrl-0 = <&can1m1_pins>;
        status = "okay";
};

#Linux 5.10
&can0 {
        compatible = "rockchip,rk3568-can-2.0";
        assigned-clocks = <&cru CLK_CAN0>;
        assigned-clock-rates = <150000000>;
        pinctrl-names = "default";
        pinctrl-0 = <&can0m1_pins>;
        status = "okay";
};

&can1 {
        compatible = "rockchip,rk3568-can-2.0";
        assigned-clocks = <&cru CLK_CAN1>;
        assigned-clock-rates = <150000000>;
        pinctrl-names = "default";
        pinctrl-0 = <&can1m1_pins>;
        status = "okay";
};

```


@@ -1313,7 +1335,7 @@

ppp拨号方式需要编写三个脚本文件存放在/etc/ppp/peers下

默认是没有这些文件夹的，所以需要去创建ppp和peer文件夹，创建好后在peers下创建如下三个脚本文件
默认是没有这些文件夹的，所以需要去创建ppp和peers文件夹，创建好后在peers下创建如下三个脚本文件

**rasppp.sh**