开发环境搭建

1. 概述

1.1 功能简介

本文档介绍如何搭建 M4-R2 (RK3576) 开发板 Android 系统所需的开发环境，包括串口调试、ADB 工具、网络连接、文件传输等基础工具链的配置方法。

1.2 开发环境总览

工具用途推荐平台
串口终端（MobaXterm）调试串口连接Windows
ADB 工具设备调试与文件传输Windows/Linux

2. 串口终端配置

2.1 安装串口驱动

使用 USB 转 TTL 模块（如 CH340、CP2102、FT232）时，需要安装对应驱动：

芯片型号驱动名称备注
CH340/CH341CH340 驱动国产芯片，最常用
CP2102CP210x 驱动Silicon Labs 芯片
FT232FTDI 驱动FTDI 芯片

安装后，在设备管理器的"端口（COM 和 LPT）"中查看串口号（如 COM3）。

设备管理器中的 CH340 串口及 COM 端口号

2.2 MobaXterm 配置

  1. 下载并运行 MobaXterm

    官网下载

    https://mobaxterm.mobatek.net/download-home-edition.html

  2. 点击"Session" → "Serial"

  3. 选择串口号，设置波特率 1500000

    MobaXterm 串口选择及 1500000 波特率配置

  4. 点击"OK"连接

  5. 开发板上电后，终端窗口应显示 U-Boot 和内核启动日志；交互式调试方式以实际 Android 固件配置为准

    MobaXterm 显示开发板启动日志

MobaXterm 的优势在于内置多标签支持、图形化文件管理、X11 转发等。

2.3 串口功能验证

# 登录后查看系统信息
cat /proc/version

预期输出（具体版本号取决于固件）：

Linux version 6.1.x ...

3. ADB 工具配置

3.1 ADB 驱动安装

ADB 驱动下载位置

资料目录：31-M4-R2\01-开发资料(百度云盘)\02-软件工具
驱动压缩包：ADB_Driver.zip

USB-OTG 连接与上电顺序

必须先在开发板断电时，将 USB-OTG 接口连接到电脑，再接入电源给开发板上电。 按此顺序启动，开发板才能自动进入 ADB 模式，供电脑识别 ADB 设备。如果已经上电，请先断电，连接 USB-OTG 后重新上电。

  1. 下载 ADB_Driver.zip 并解压到电脑本地目录。

  2. 双击运行解压目录中的 Win10 adb驱动-UniversalAdbDriverSetup.msi，按照安装向导提示完成 ADB 驱动安装。

    ADB 驱动 MSI 安装程序

  3. 确保开发板已断电，使用 USB 数据线将开发板 USB-OTG 接口连接到电脑。

  4. 接入电源给开发板上电，等待 Android 系统启动并自动进入 ADB 模式。若提示 USB 调试授权，请在开发板上允许当前电脑连接。

  5. 在设备管理器中确认设备显示为“Android ADB Device”或“ADB Interface”；若已正常识别，可跳过驱动安装。

    设备管理器识别 Android ADB Interface

3.2 ADB 工具安装

ADB 工具下载位置

资料目录：31-M4-R2\01-开发资料(百度云盘)\02-软件工具
工具文件夹：adb_fastboot

将 adb_fastboot 文件夹下载到电脑，确认其中包含 adb.exe、AdbWinApi.dll 和 AdbWinUsbApi.dll，并将该文件夹的本地路径添加到系统 PATH 环境变量。

adb_fastboot 文件夹中的工具文件

3.3 ADB 功能验证

# 查看已连接的设备
adb devices

预期输出：

List of devices attached
0123456789abcdef	device
adb devices 显示已连接设备状态为 device
# 进入开发板的 shell
adb shell
通过 adb shell 进入开发板命令行
# 从开发板拉取文件
adb pull /sdcard/test.txt .
# 向开发板推送文件
adb push test.txt /sdcard/

3.4 ADB 常用命令

命令说明
adb devices查看已连接设备列表
adb shell进入设备 shell
adb push <local> <remote>推送文件到设备
adb pull <remote> <local>从设备拉取文件
adb reboot重启设备
adb reboot loader重启到烧录模式

4. 网络连接配置

4.1 连接网络

通过 Android 桌面的“设置”连接 WiFi，或使用网线将开发板接入路由器、交换机。确保电脑与开发板网络互通。

远程连接方式

当前产品未启用 SSH 子系统，不能直接使用 ssh root@板卡IP。
通过 WiFi 或网线远程调试时，请使用网络 ADB。

4.2 查看开发板 IP 地址

首次配置网络 ADB 时，必须先连接 USB ADB。按前文要求，先连接 USB-OTG，再给开发板上电，在电脑执行 adb devices，确认设备状态为 device。

在电脑执行以下命令查看 IPv4 地址：

adb shell ip -4 addr

也可以进入开发板命令行执行 ifconfig：

adb shell
ifconfig
exit

读取已连接网口或 WiFi 接口的 IPv4 地址，忽略回环地址 127.0.0.1。如下图中，eth0 的地址为 192.168.49.242，实际连接时请替换为你的开发板 IP。

通过 ifconfig 查看开发板以太网 IPv4 地址

4.3 通过网络 ADB 连接

保持 USB ADB 已连接，在电脑终端依次执行：

adb tcpip 5555
adb shell ip -4 addr
adb connect 板卡IP:5555

将 板卡IP 替换为实际地址，例如 adb connect 192.168.49.242:5555。看到 connected to 板卡IP:5555 后，可拔掉 USB 数据线，保持开发板供电和网络连接，再执行：

adb shell

若仍保持 USB 连接，可用 adb -s 板卡IP:5555 shell 指定网络设备，避免同时连接 USB 和网络设备时出现多个设备的提示。

启用 TCP 5555 端口并连接网络 ADB

图中前两次 device not found 表示当时 USB ADB 未连接；确认 USB 设备正常识别后再执行即可。开发板重启后若无法通过网络 ADB 连接，请重新连接 USB ADB 并执行上述步骤。

5. 文件传输

在电脑上通过 ADB 传输文件：

# 向开发板推送文件
adb push test.txt /sdcard/

# 从开发板拉取文件
adb pull /sdcard/test.txt .

6. 常见问题

6.1 串口乱码

现象： 串口终端输出乱码字符

原因： 波特率设置不正确或串口线 TX/RX 接反

解决方案：

  • 确认波特率设置为 1500000
  • 交换 TX/RX 接线
  • 检查 USB 转 TTL 模块是否支持 1500000 波特率

6.2 ADB 无法识别设备

现象： adb devices 显示为空

原因： ADB 驱动未安装或设备未切换到 ADB 模式

解决方案：

  • 重新安装 ADB 驱动
  • 在 Android 开发者选项中开启 USB 调试，并在弹窗中授权当前电脑
  • 更换 USB 线缆/端口

相关文档