Android 系统基础操作

1. 概述

1.1 功能简介

本文档介绍 shimetapi RK3588 开发板（C-3588LQ 核心板 + SHIMETAPI-M5-R2A 底板）的 Android 系统基础操作，包括系统界面导航、设置配置、应用安装、存储管理、网络配置等常用功能。

1.2 应用场景

  • 系统首次启动配置与初始化
  • 日常操作与维护
  • 外设功能验证（显示、触摸、音频、网络）
  • 开发调试环境准备

1.3 工作原理

Android 系统架构：
应用层（Launcher/APK） --> Framework（SystemServer/ServiceManager） --> HAL（硬件抽象层） --> Linux Kernel 6.1 --> RK3588 硬件

2. 硬件准备

设备型号/规格数量说明
核心板C-3588LQ V1.01RK3588 主芯片
底板SHIMETAPI-M5-R2A V1.01提供 HDMI/USB/以太网等接口
显示器HDMI 接口1用于 Android 系统显示
鼠标/键盘USB 接口1 套用于系统操作（可选，触摸屏也可用）
电源适配器12V/3A DC1通过底板 DC 接口供电

3. 软件准备

项目说明
固件已烧录 Android 14 系统的 RK3588 开发板（参考 ch01-android-flashing-and-boot.md）
ADB 工具platform-tools（PC 端，用于调试和远程操作）

4. 操作步骤

4.1 系统首次启动与设置

步骤1：连接硬件

  1. 使用 HDMI 线连接底板 HDMI 接口到显示器
  2. 连接 USB 鼠标和键盘到底板 USB 接口
  3. 连接电源适配器（12V/3A DC）到底板 DC 接口

步骤2：上电启动

  1. 接通电源，红色 PWR 指示灯常亮
  2. 绿色 RUN 灯闪烁表示系统启动中
  3. HDMI 显示器显示 Android 启动动画
  4. 首次启动进入 Android 桌面

首次启动因初始化数据分区，耗时约 1-3 分钟。后续启动时间约 30-60 秒。

步骤3：系统设置

启动后可通过 Launcher 进入"设置"应用进行以下基础配置：

  • 语言与输入法：Settings -> System -> Languages & input
  • 日期和时间：Settings -> System -> Date & time
  • 显示设置：Settings -> Display（亮度、屏幕旋转、休眠时间等）
  • 网络连接：Settings -> Network & internet（以太网/WiFi）

4.2 开发者选项与 ADB 调试

开启开发者选项：

  1. 进入 Settings -> About tablet
  2. 连续点击"Build number"（版本号）7 次
  3. 返回 Settings 主界面，出现"Developer options"（开发者选项）

开启 USB 调试：

  1. 进入 Settings -> Developer options
  2. 打开"USB debugging"（USB 调试）开关
  3. 连接 USB 线到底板 OTG 口，PC 端执行 adb devices 确认连接

4.3 系统信息查询

通过 ADB shell 查看系统信息：

# 查看 Android 版本
adb shell getprop ro.build.version.release

# 查看 SDK 版本
adb shell getprop ro.build.version.sdk

# 查看内核版本（内核版本在 uname 中；ro.build.version.base_os 实测为空）
adb shell uname -r

# 查看设备型号
adb shell getprop ro.product.model

# 查看所有系统属性
adb shell getprop

下面的输出取自 2026-10-22 的实机：

$ adb shell getprop ro.build.version.release
16
$ adb shell getprop ro.build.version.sdk
36
$ adb shell getprop ro.product.model
rk3588_smdt_3588a_v31
$ adb shell uname -r
6.1.172-android14-11-g5b6e3d242716-ab15726104

4.4 应用管理

安装应用：

# 安装 APK（通过 ADB）
adb install /path/to/app.apk

# 重新安装（保留数据）
adb install -r /path/to/app.apk

# 安装到 SD 卡
adb install -s /path/to/app.apk

卸载应用：

# 通过包名卸载
adb uninstall com.example.app

# 保留数据卸载
adb uninstall -k com.example.app

查看已安装应用：

# 列出所有第三方应用包名
adb shell pm list packages -3

# 列出所有应用（包括系统应用）
adb shell pm list packages

# 查看指定应用的安装路径
adb shell pm path com.android.settings

4.5 文件系统与存储管理

查看存储空间：

# 查看分区使用情况
adb shell df -h

# 查看磁盘分区
adb shell mount | grep "^/"

实测要点：

  • 存储：eMMC 32GB（/dev/block/mmcblk0，约 29.2 GiB），super 动态分区 5.47 GiB，userdata 22.6 GiB
  • 内存：RAM 4GB（MemTotal 3975120 kB），并启用约 1.9 GiB zram 交换（把一部分内存压缩后当作交换空间使用）
  • 系统分区均以 dm-N 设备挂载（GKI 动态分区）：/（dm-8）、/vendor（dm-9）、/system_ext（dm-12）、/product（dm-15）等

数据传输：

# 从 PC 上传文件到设备
adb push /local/file.txt /sdcard/

# 从设备下载文件到 PC
adb pull /sdcard/file.txt /local/path/

关键目录说明：

目录说明
/sdcard/内部共享存储，用户数据和媒体文件
/data/应用数据分区（需要 root 访问）
/system/系统分区（只读，Android 14 动态分区）
/vendor/厂商定制分区（只读，Android 14 动态分区）
/cache/缓存分区

4.6 网络配置

以太网：

RK3588 底板支持通过以太网接口（RJ45）连接网络。插入网线后，系统会自动获取 IP 地址。

# 查看网络接口状态
adb shell ifconfig
# 或
adb shell ip addr show

# 测试网络连通性
adb shell ping 8.8.8.8

实测：插入网线后 eth0 自动通过 DHCP 获取地址：

$ adb shell ip -brief addr show eth0
eth0             UP             192.168.49.63/24 fe80::ad30:f55b:aca0:6816/64

WiFi 配置：

通过 Android 设置界面配置 WiFi：

  1. Settings -> Network & internet -> Wi-Fi
  2. 打开 WiFi 开关
  3. 选择可用网络并输入密码

实测：设备存在 wlan0 接口（wlan.driver.status 为 ok），未连接时接口状态为 DOWN。

RK3588 Android 14 默认 WiFi 休眠策略为"始终保持连接"。如需修改为休眠断开，可在 BoardConfig.mk 中配置：

- <integer name="def_wifi_sleep_policy">2</integer>
+ <integer name="def_wifi_sleep_policy">0</integer>

4.7 显示与屏幕旋转

显示输出：

RK3588 支持多种显示输出接口，Android 14 下默认 HDMI 输出。可以通过 Settings -> Display 调整：

  • 亮度调节
  • 屏幕超时（休眠时间）
  • 字体大小
  • 屏幕旋转方向

实测输出：

$ adb shell wm size
Physical size: 1920x1080
$ adb shell wm density
Physical density: 320

dumpsys SurfaceFlinger 的 activeMode 同样显示 resolution=1920x1080, vsyncRate=60.00 Hz，即当前 HDMI 输出为 1080P60。

系统级旋转配置：

可通过修改 BoardConfig.mk 中的 SurfaceFlinger 旋转配置来固定屏幕方向：

# For Surface Flinger Rotation
# 0 = 不旋转, 90, 180, 270
SF_PRIMARY_DISPLAY_ORIENTATION ?= 0

Recovery 模式旋转配置：

# 0: ROTATION_NONE   旋转0度
# 90: ROTATION_RIGHT  旋转90度
# 180: ROTATION_DOWN  旋转180度
# 270: ROTATION_LEFT  旋转270度
TARGET_RECOVERY_DEFAULT_ROTATION ?= ROTATION_NONE

4.8 系统恢复与重置

恢复出厂设置：

  1. Settings -> System -> Reset options -> Erase all data (factory reset)
  2. 确认后系统将清除所有用户数据并重启

进入 Recovery 模式：

# 通过 ADB 重启到 Recovery
adb reboot recovery

或在启动时按住 RECOVERY 按键进入 Recovery 模式，可用于：

  • 恢复出厂设置
  • 应用 OTA 更新包
  • 日志抓取

4.9 系统日志与调试

# 查看内核日志
adb shell dmesg

# 查看系统日志
adb logcat

# 查看 bug 报告
adb bugreport

详细日志分析方法请参考 ch03-adb-debugging-and-logs.md。

4.10 开机 Logo 替换

Android 14 启动过程中显示两个阶段的开机 logo：

阶段文件说明
U-Boot 阶段kernel-6.1/logo.bmp第一张开机图片
Kernel 阶段kernel-6.1/logo_kernel.bmp第二张开机图片

替换方法：使用同名的 BMP 文件替换，重新编译即可。编译后文件位置以固件方案为准：实测固件（Android 16 / A/B）中 logo 位于独立 resource 分区（resource_a/resource_b）；Android 14 SDK 单分区方案则打包在 boot.img 中。

Logo 图片大小目前只支持 8M 以内的 BMP 格式，支持 8/16/24/32 位色深。

5. 代码详解

5.1 编译配置

# 设置编译环境
source build/envsetup.sh

# 选择目标
lunch rk3588_u-userdebug    # 调试版本（推荐开发使用）
# 或
lunch rk3588_u-user         # 生产版本

# 完整编译
./build.sh -AUKu

5.2 64 位仅系统配置

Android 14 支持配置为仅支持 64 位系统，以减少内存占用。在 device/rockchip/rk3588/BoardConfig.mk 中添加：

DEVICE_IS_64BIT_ONLY := true

TARGET_2ND_ARCH :=
TARGET_2ND_ARCH_VARIANT :=
TARGET_2ND_CPU_ABI :=
TARGET_2ND_CPU_ABI2 :=
TARGET_2ND_CPU_VARIANT :=

Android 14 如果需通过 GMS 或 EDLA 认证，要求配置为仅支持 64 位系统。

5.3 常用系统属性

属性名说明示例值
ro.build.version.releaseAndroid 版本号16（实测）
ro.build.version.sdkSDK 版本36（实测）
ro.product.model产品型号rk3588_smdt_3588a_v31（实测）
ro.product.manufacturer制造商rockchip
ro.soc.modelSoC 型号RK3588（实测）
ro.serialno设备序列号aec7944879c313ab（实测）
ro.build.version.security_patch安全补丁级别2025-09-05（实测）
persist.sys.timezone系统时区Asia/Shanghai（实测）

6. 常见问题

6.1 系统启动后黑屏

现象： 开发板启动后 HDMI 显示器无信号或黑屏。

原因：

  1. HDMI 线缆未正确连接
  2. 显示器未切换到对应输入源
  3. 系统显示配置问题

解决方案：

  1. 确认 HDMI 线已牢固插入底板 HDMI 接口
  2. 检查显示器输入源设置
  3. 通过串口确认系统已正常启动（查看内核日志）
  4. 尝试通过 ADB 连接后执行 wm size 查看显示配置

6.2 USB 调试无法连接

现象： adb devices 无法识别设备。

原因：

  1. 未开启 USB 调试
  2. 未安装 USB 驱动
  3. 连接的是 USB Host 口而非 OTG 口

解决方案：

  1. 确认已在开发者选项中开启"USB debugging"
  2. 确认使用底板 OTG 接口连接
  3. Windows 下安装 DriverAssitant v5.1.1
  4. 尝试重新插拔 USB 线

6.3 应用安装失败

现象： adb install 提示 INSTALL_FAILED 错误。

原因：

  1. APK 架构不匹配（32 位应用在 64 位仅系统上）
  2. 存储空间不足
  3. 存在签名冲突

解决方案：

  1. 确认 APK 为 64 位兼容版本（实测固件 abilist 仅 arm64-v8a，不支持 32 位应用）
  2. 使用 df -h 检查存储空间
  3. 使用 adb uninstall <package> 先卸载旧版本再安装
  4. 使用 adb install -r 强制重新安装

6.4 以太网无法连接

现象： 插入网线后无法获取 IP 地址。

原因：

  1. 网线未插紧
  2. DHCP 服务器未响应
  3. 以太网驱动未加载

解决方案：

  1. 检查网线连接和指示灯状态
  2. 尝试设置静态 IP：Settings -> Network & internet -> Ethernet -> 选择网络 -> 修改为静态 IP
  3. 通过 ADB 执行 dmesg | grep eth 查看以太网驱动状态

6.5 触摸屏无响应

现象： 触摸屏无反应，USB 鼠标操作正常。

实测排查：

# 查看输入设备：实测无触摸设备节点，仅有 USB 鼠标等
adb shell getevent -l

# 触摸驱动 probe 失败（GT911 @ i2c-5 0x14）
adb shell dmesg | grep -iE "gt1x|goodix"
# I2c transfer error! (-6)
# Goodix-TS-GT1X: probe of 5-0014 failed with error -1

结论： 触摸控制器（实测板卡同时配置了 GT911 与 CST3240，两者均 probe 失败）I2C 无应答，未生成触摸输入设备。多为硬件问题：FPC 排线接触不良、触摸供电（两驱动均报 vdd_ana not specified）、RST/INT 引脚状态。可在 root 下用 i2cdetect -y 5 确认器件是否应答。

7. 相关文档

文档说明
ch01-android-flashing-and-boot.md系统烧录与启动
ch03-adb-debugging-and-logs.mdADB 调试方法
Debian-Ubuntu/quick-start-guide/ch01-boot-and-basic-operations.mdLinux 系统基础操作参考
hardware-reference/ch01-core-board-specifications.md核心板参数