From 65db11d7a48e71642dd21ee6914cdd269eb7f01f Mon Sep 17 00:00:00 2001
From: guowenxue <guowenxue@gmail.com>
Date: Tue, 25 Jun 2024 22:08:45 +0800
Subject: [PATCH] Update RK3568 development documents
---
documents/docs/RK3568_Android_SDK开发文档/RK3568_Android_SDK开发文档.md | 292 +++++++++++++++++++++++++++++++++++++++++++++++++++++----
1 files changed, 268 insertions(+), 24 deletions(-)
diff --git "a/documents/docs/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/documents/docs/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 a95c5ca..4dd2c8b 100644
--- "a/documents/docs/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/documents/docs/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"
@@ -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 也是一样的)**
+
+
+
+Android13 编译产物如下
+
+
# 2. 系统烧录
@@ -99,9 +122,17 @@
## 2.4 系统烧录与启动
-在 **RKDevTool.exe** 烧录软件上，确认设备已经进入到 Maskrom模式后，点击上面的 **“执行”** 按钮。
+在 **RKDevTool.exe** 烧录软件上，确认设备已经进入到 Maskrom模式后，在左侧空白处右键选择导入配置，找到下载镜像的目录，里面有个config.cfg，这个文件可以一键配置烧录选项和烧录镜像的各个地址
-
+
+
+
+
+
+
+此时配置导入成功，将原始路径换成自己的下载镜像的路径。最后点击执行即可。
+
+
@@ -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，即可自动编译源码
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
```
+
+```
+#Android 13
+
+tinymix 3 HP
+```
+
+
用adb命令将.wav音乐传到开发板上，播放音乐
@@ -522,7 +565,12 @@
设置输出方式为扬声器输出（SPK）
```
+#Android 11
+
tinymix 0 SPK
+
+#Android 13
+tinymix 3 SPK
```
同样可以输出
@@ -548,7 +596,7 @@
将这两个引脚拉低后，模块上电如下所示
-
+
**关机方式**
@@ -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,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
-3. 修改/home/android/rk3568/android11/vendor/rockchip/common/phone/phone.mk
+3. 修改~/rk3568/android11/vendor/rockchip/common/phone/phone.mk
(这里添加这个动态库的目的是让最后生成的根文件系统里的/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
+
+ 
+
+ 
+
+5. 修改~/rk3568/android11/hardware/ril/rild/rild.rc
+
+
(从第一行可以看到，在启动ril-daemon这个服务的时候，系统会调用/vendor/bin/hw/rild程序，该程序需要链接到动态库)
@@ -789,7 +847,195 @@
-# 6. Android系统修改硬件设备访问权限
+# 6. Android13 4G上网问题
+
+背景：在升级android到13的时候发现用android11的方法去使用ril机制出现了各种各样的问题，所以在原先11的基础上还需要修改一些地方
+
+1. 首先需要获取适配Android13的ril库，不能使用android11那个库，版本是不对的
+
+ RIL驱动版本是3.6.24
+
+
+
+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文件
+
+ 
+
+ 也就是指定刚才拷贝过来的几个文件，这里是需要指定最后将这些文件拷贝到开发版的哪些位置
+
+4. 打开BOARD_HAVE_DONGLE 和BOARD_HAS_RK_4G_MODEM
+
+ BOARD_HAVE_DONGLE和BOARD_HAS_RK_4G_MODEM 都在/device/rockchip/common/BoardConfig.mk 都将其改为true
+
+ 
+
+ 
+
+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的部分的时候就会报如下错误：
+
+ 
+
+ 解决办法就是按照compatibility_matrix.5.xml的接口声明去修改compatibility_matrix.7.xml的内容，这是因为android11和13的manifest.xml内容是一模一样的。
+
+ manifest.xml内容如下
+
+ 
+
+ 从内容中我们可以看到一共有三个部分，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
+
+
+
+ (从第一行可以看到，在启动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
+
+
+
+ 
+
+ 进入device/rockchip/common/overlay_wifi_only/frameworks/base/core/res/res/values/config.xml
+
+ 找到config_mobile_data_capable 将false改为true
+
+ 
+
+ 进入frameworks/base/core/res/res/values/config.xml
+
+ 这里默认是true 如果不是就改为true
+
+ 
+
+9. 修改frameworks/opt/telephony/src/java/com/android/internal/telephony/uicc/IccCardStatus.java
+
+ 找到public IccSlotPortMapping mSlotPortMapping；将其改为public IccSlotPortMapping mSlotPortMapping = new IccSlotPortMapping();
+
+ 
+
+编译android系统后烧录进开发板，上电em05模块后可以发现rild后台进程帮我们获取到了ip，查看usb0可以看到存在了ip，这是就可以通过4g上网。
+
+# 7. Android系统修改硬件设备访问权限
背景：在使用Android Studio工具实现屏幕按键控制三色灯亮灭的时候，未获得权限导致不能打开/dev/gpiochip*
@@ -821,9 +1067,7 @@
-
-
-# 7. Android 永不息屏和关闭锁屏
+# 8. Android 永不息屏和关闭锁屏
永不息屏
\android11\device\rockchip\rk356x\overlay\frameworks\base\packages\SettingsProvider\res\values\defaults.xml
--
Gitblit v1.9.1