RK3588 ADB使用

安卓adb操作介绍

adb（Android Debug Bridge）是一个用于与安卓设备进行通信和控制的工具。adb可以通过USB或无线网络连接安卓设备，执行各种命令，如安装和卸载应用，传输文件，查看日志，运行shell命令等。adb是安卓开发和测试的重要工具，可以帮助开发者快速地调试和优化应用。

3.2. 1. 打开开发者选项

1.1 设置->关于->版本号>点击七次提示已打开开发选择，退后；

1.2 设置->系统->高级选择->开发者选择；

1.3 启用USB调试

3.3. 2. 连接到设备

支持Android系统设备有：

LubanCat W

LubanCat N

LubanCat 1

LubanCat 1N

LubanCat 2

LubanCat 2N

LubanCat 2IO

LubanCat 4

Lubancat 5

后续支持多个设备

使用usb连接设备：主机通过 USB 连接设备USB Type C 的接口。

3.4. 1. 使用操作命令

ADB安装方法请参考CSDN

windows下载安装adb（极其简单）_adb工具下载windows-CSDN博客

查询设备

adb devices

../../_images/query-device.jpg

安装应用

adb install <apk文件路径> :这个命令将指定的apk文件安装到设备上
列 adb install qq.apk 即可安装

卸载应用

adb uninstall <软件名>
adb uninstall -k <软件名>

如果加 -k 参数,为卸载软件但是保留配置和缓存文件.

进入设备或模拟器的shell

adb shell

../../_images/shell.png

通过上面的命令，就可以进入设备或模拟器的shell环境中，在这个Linux Shell中，你可以执行各种Linux的命令，另外如果只想执行一条shell命令，可以采用以下的方式：

查询设备显示磁盘空间统计信息

df -h

../../_images/df.png

Linux su命令切换管理身份

su

这些只是adb命令的一部分，更多的命令可以参考官方文档或者使用adb help查看。

其他command是要执行的具体命令，例如：

adb push test.txt /sdcard/  // 把test.txt文件推送到设备的sdcard目录
adb pull /sdcard/test.txt .  // 把设备的sdcard目录下的test.txt文件拉取到当前目录
adb logcat  // 查看设备的日志输出
adb shell ls /system  // 在设备上运行shell命令ls /system

5.3. 设置屏幕横屏方法

我们需要在系统启动时配置好屏幕的参数，并通过mipi接口发送正确的信号给屏幕控制器。这样，屏幕就能正常显示系统的图形界面，方便用户操作和交互。

提供SDK默认竖屏，需要改横屏请参考我们修改方法如下：找到文件修改：

rk356x：android11-dev/device/rockchip/rk356x/BoardConfig.mk
rk3588：android12-dev/device/rockchip/rk3588/BoardConfig.mk

屏幕信息参考下：

#rotate screen to 0, 90, 180, 270
#0:   ROTATION_NONE      ORIENTATION_0  : 0       #竖屏
#90:  ROTATION_RIGHT     ORIENTATION_90 : 90      #横屏
#180: ROTATION_DOWN      ORIENTATION_180: 180
#270: ROTATION_LEFT      ORIENTATION_270: 270

将Recovery和Android系统改为横屏：

- TARGET_RECOVERY_DEFAULT_ROTATION ?= ROTATION_NONE
+ TARGET_RECOVERY_DEFAULT_ROTATION ?= ROTATION_RIGHT

- SF_PRIMARY_DISPLAY_ORIENTATION ?= 0
+ SF_PRIMARY_DISPLAY_ORIENTATION ?= 90

Android12：禁用dsi1，防止启动vp2与3导致卡死系统

// 野火10.1寸屏幕
  #include "rk3588s-lubancat-dsi0-ebf410177_800x1280.dtsi"
- #include "rk3588s-lubancat-dsi1-ebf410177_800x1280.dtsi"
+ #include "rk3588s-lubancat-dsi1-ebf410177_800x1280.dtsi" //禁用dsi1

以上修改完成后，重新编译刷上开机屏幕已是横屏了。

../../_images/screen2.png

5.4. 修改开机logo

选择自己想要修改的logo图片，将图片底色设置为透明底色，并将格式转换为24bit或者32bit的bmp格式，控制图片大小在4MB左右。
将得到的bmp格式的图片复制成三份，分别重命名为logo.bmp、logo_boot.bmp、logo_kernel.bmp。替换安卓源码kernel目录下原有的文件，这就完成了启动logo的替换。
重新编译安卓镜像，烧录到板卡上即可。

若编译过程中出现以下错误，可修改：android11/device/rockchip/common/BoardConfig.mk文件，将其中的42606592改为55373824（对应自己报错的大小，有两处）。然后继续编译即可

../../_images/screen5.png

5.5. 修改Android动画

概述

Android 开机动画是一个存储在 bootanimation.zip 文件中的无压缩 ZIP 档案，通常位于 /system/media/目录。该文件包含 PNG 图片序列和一个 desc.txt 配置文件，用于定义动画的分辨率、帧率和播放方式。通过替换 bootanimation.zip，您可以自定义开机动画。

本教程将指导您：

创建一个新的 bootanimation.zip 文件，基于您的配置（分辨率 720x190，帧率 60 FPS，单部分动画）。
将新的 bootanimation.zip 安装到 Android 设备。

准备工作

所需工具

电脑：Windows、Mac 或 Linux 系统。
图像编辑软件：如 Photoshop、GIMP，用于创建或编辑 PNG 图片。
7-Zip 或 WinRAR：用于创建无压缩的 ZIP 文件。
ADB（Android Debug Bridge）：用于将文件推送至设备（可在 Android SDK 中下载）。

设备要求

Android 设备（已启用 USB 调试）。
确保设备分辨率与动画配置匹配（本例为 720x190）。

步骤 1：创建新的 bootanimation.zip 文件

1.1 准备动画素材

创建 PNG 图片：

使用图像编辑软件创建一系列 PNG 图片，每张图片代表动画的一帧。
图片分辨率应为 720x190（与你的配置匹配）。
命名图片为连续编号，例如 0000.png, 0001.png, 0002.png 等，建议从 0000 开始。
确保图片格式为 PNG（支持最高 32 位），避免使用 JPG 或其他格式。
根据帧率 60 FPS，每秒需要 60 张图片。例如，5 秒动画需要约 300 张图片。

组织文件夹结构：

创建一个名为 bootanimation 的文件夹。
在 bootanimation 文件夹中，创建子文件夹 part0（根据你的配置 part0）。
将所有 PNG 图片放入 part0 文件夹。

示例结构：

bootanimation/
├── desc.txt
└── part0/
    ├── 0000.png
    ├── 0001.png
    ├── 0002.png
    └── ...

1.2 创建 desc.txt 文件

编写 desc.txt：

在 bootanimation 文件夹中创建 desc.txt 文件。
根据你的配置（720 190 60 和 c 1 30 part0），内容如下：

720 190 60
c 1 30 part0

第一行：720 190 60

720：动画宽度（像素）。

190：动画高度（像素）。

60：帧率（每秒帧数，FPS）。

第二行：c 1 30 part0

c：动画类型，表示在系统启动完成时立即停止.

1：循环次数（1 表示播放一次）。

30：动画结束后暂停的帧数（以帧为单位，30 帧在 60 FPS 下约为 0.5 秒）。

part0：动画部分的文件夹名称。

注意：文件需使用 Linux 换行格式（LF），避免 Windows 的 CRLF 格式。可用 Notepad++ 或 VS Code 保存为 LF 格式。

确保文件正确：

确认 desc.txt 和 part0 文件夹名称与配置一致。
确保 PNG 文件按顺序命名，且无其他无关文件（如 Windows 自动生成的 thumbs.db）。

1.3 打包 bootanimation.zip

使用 7-Zip 打包：

打开 7-Zip，导航到 bootanimation 文件夹。
选中 desc.txt 和 part0 文件夹。
右键选择“添加到压缩包”。

设置：

压缩格式：zip

压缩级别：存储（无压缩，重要！）
输出文件名：bootanimation.zip
点击“确定”生成 bootanimation.zip。

验证 ZIP 文件：

确保 ZIP 文件未压缩（可打开检查文件大小接近原始 PNG 文件总和）。
确认内部结构正确：

bootanimation.zip
├── desc.txt
└── part0/
    ├── 0000.png
    ├── 0001.png
    └── ...

连接设备调试：

将设备通过 USB 连接到电脑。
打开命令行（Windows CMD 或终端）

推送文件：

使用 ADB 将新 bootanimation.zip 推送到 /system/media/

adb root && adb remount
adb push 电脑路径\bootanimation.zip /system/media/bootanimation.zip

重启设备：

使用 ADB 或手动重启：

adb reboot

检查新动画是否生效。

替换源码sdk动画：

测试效果ok，将源码储存device/rockchip/common/bootanimation.zip，替换您修改的新动画文件bootanimation.zip，然后-Au编译最终完成。

调试与故障排除:

动画不播放，显示默认 Android 文本：

检查 bootanimation.zip 是否正确命名为 bootanimation.zip。
确保 ZIP 文件使用“存储”模式打包（无压缩）。
验证 desc.txt 格式正确（使用 LF 换行，无多余空格或空行）。
确保 PNG 文件命名连续且正确（如 0000.png 开始）。

黑屏或闪烁：

确保 PNG 文件分辨率与 desc.txt 中的 720 190 一致。
检查是否存在无关文件（如 thumbs.db）。
尝试将文件放置在 /system/media/

动画播放速度不正确：

确认 desc.txt 中的帧率（60 FPS）与 PNG 图片数量匹配。
调整图片数量或帧率以优化播放时长。

鲁班猫支持的移动网络模块

模块型号	网络制式	接口
EC20	4G LTE	Mini PCI E
RG200U-CN(展锐)	5G NR	Mini PCI E
RM500U-CN(展锐)	5G NR	M2 Key b
RM500Q-GL(高通x55)	5G NR	M2 Key b
RM500Q-CN(高通x55)	5G NR	M2 Key b
RM520N-GL(高通x62)	5G NR	M2 Key b
RM520N-CN(高通x62)	5G NR	M2 Key b

6.3. 第一步：硬件插入

确认接口：

检查鲁班猫开发板的 Mini PCIe 插槽位置，通常标有 “PCIe” 或 “Mini PCIe”。
确保插槽支持 USB 信号（EC20 通过 USB 通信），可参考开发板说明书。

安装 EC20 模块：

将 EC20 模块对准 Mini PCIe 插槽，轻轻按下，确保卡扣固定到位。
连接主天线（MAIN）到 EC20 的主天线接口（通常标有 “M” 或 “MAIN”）。
连接辅天线（AUX）到辅助天线接口（标有 “A” 或 “AUX”），增强信号接收。
将 SIM 卡插入 EC20 的 SIM 卡槽，小心不要插反（参考卡槽上的方向标记）。

检查硬件连接：

确保模块、天线和 SIM 卡安装牢固，避免松动。
通电启动鲁班猫开发板

../../_images/4g-ec202.png

6.4. 第二步：基本使用

开机验证

启动鲁班猫开发板，进入系统（假设为 Android）。
使用 ADB 连接设备：

adb shell

检查设备是否识别 EC20：

执行ls /dev/ttyUSB*

rk3576_lubancat_3_hdmi:/ $ ls -l /dev/ttyUSB*
crw-rw---- 1 radio radio 188,   0 2025-03-04 14:42 /dev/ttyUSB0
crw-rw---- 1 radio radio 188,   1 2025-03-04 14:42 /dev/ttyUSB1
crw-rw---- 1 radio radio 188,   2 2025-03-04 14:43 /dev/ttyUSB2
crw-rw---- 1 radio radio 188,   3 2025-03-04 14:42 /dev/ttyUSB3

如果看到类似 /dev/ttyUSB0 /dev/ttyUSB1 /dev/ttyUSB2 /dev/ttyUSB3 说明模块被识别。

测试网络连接：

进入 Android 设置界面，找到“移动网络”或“数据连接”选项。
打开数据开关，等待几秒钟，查看状态栏是否显示信号图标（如 4G/LTE）。

EC20 4G 模块安装示例

注意

移远单卡模块（例如 EC20）不支持禁用移动网络功能，请避免尝试关闭该选项。

如果系统支持，可通过adb进入系统，执行以下命令查看信号：

dumpsys telephony.registry | grep signal

简单 AT 命令测试（可选）：

使用 ADB 发送 AT 命令验证模块状态：

echo "AT" > /dev/ttyUSB2
cat /dev/ttyUSB2

返回 “OK” 表示模块正常响应。

检查信号质量：

echo "AT+CSQ" > /dev/ttyUSB2
cat /dev/ttyUSB2

使用网络：

打开浏览器或任意联网应用，测试是否能访问网页（如 www.baidu.com）。
如果无法联网，检查 SIM 卡是否正常激活，或联系运营商确认网络覆盖。

注意事项

天线安装：

主天线必须连接，否则无法搜索网络。
放置天线时避免金属遮挡，尽量靠近窗户以增强信号。

SIM 卡问题：

确保 SIM 卡支持 4G，且未欠费或锁定。
如果 SIM 卡有 PIN 码，可能需要先用手机解锁。

6.5. 通过 USB 转接板使用 EC20 和 RM520N-CN 模块

您可以使用 Mini PCIe 转 USB 转接板（适用于 EC20）或 M.2 Key B 转 USB 转接板（适用于 RM520N-CN）将模块连接到鲁班猫开发板的 USB 接口，实现移动网络功能。以下是具体步骤：

准备硬件

移远 EC20（Mini PCIe 封装，网络制式：4G LTE）
移远 RM520N-CN（M.2 Key B 封装，网络制式：5G NR）

转接板：

Mini PCIe 转 USB 转接板（用于 EC20，带 3.3V 供电）。
M.2 Key B 转 USB 转接板（用于 RM520N-CN，带 3.8V 供电）。

配件：

4G/5G 主天线和辅天线（支持对应频段，如 LTE 或 Sub-6GHz）。
已激活的 SIM 卡（支持 4G 或 5G 网络）。
鲁班猫开发板（带 USB 接口，推荐 USB 3.0 端口）。

安装 EC20 到 Mini PCIe 转 USB 转接板

将 EC20 模块插入 Mini PCIe 转 USB 转接板的 Mini PCIe 插槽，轻轻按下至卡扣固定。
连接主天线到 EC20 的 MAIN 接口（通常标有“M”），辅天线到 AUX 接口（标有“A”）。
将 SIM 卡插入 EC20 的 SIM 卡槽（注意缺角对齐卡槽标记）。
将转接板的 USB 接口插入鲁班猫开发板的 USB 端口（建议靠近电源端的 USB 3.0 端口，确保供电稳定）。

安装 RM520N-CN 到 M.2 Key B 转 USB 转接板

将 RM520N-CN 模块插入 M.2 Key B 转 USB 转接板的 M.2 Key B 插槽，用螺丝固定（通常需要 M2 螺丝）。
连接主天线到 RM520N-CN 的 MAIN 接口，辅天线到 AUX 接口。
将 SIM 卡插入 RM520N-CN 的 SIM 卡槽（确认方向正确）。
将转接板的 USB 接口插入鲁班猫开发板的 USB 端口（推荐 USB 3.0 端口以支持更高带宽和供电）。

验证连接

启动鲁班猫开发板，观察模块指示灯：

EC20：PWR 灯常亮，NET 灯闪烁表示搜索 4G 网络。
RM520N-CN：PWR 灯常亮，NET 灯闪烁表示搜索 5G/4G 网络。

使用 ADB 工具连接开发板检查模块是否被识别：

执行ls /dev/ttyUSB*

rk3576_lubancat_3_hdmi:/ $ ls -l /dev/ttyUSB*
crw-rw---- 1 radio radio 188,   0 2025-03-04 14:42 /dev/ttyUSB0
crw-rw---- 1 radio radio 188,   1 2025-03-04 14:42 /dev/ttyUSB1
crw-rw---- 1 radio radio 188,   2 2025-03-04 14:43 /dev/ttyUSB2
crw-rw---- 1 radio radio 188,   3 2025-03-04 14:42 /dev/ttyUSB3

如果看到类似 /dev/ttyUSB0 /dev/ttyUSB1 /dev/ttyUSB2 /dev/ttyUSB3 说明模块被识别。

使用网络