开发环境搭建

1. 概述

1.1 功能简介

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

1.2 开发环境总览

工具	用途	推荐平台
串口终端（PuTTY/MobaXterm）	调试串口连接	Windows
ADB 工具	设备调试与文件传输	Windows/Linux
SSH 客户端	远程登录开发板	Windows/Linux
NFS/TFTP	网络文件传输	Linux（开发用）
VSCode	代码编辑	Windows/Linux
Samba	文件共享	Windows

2. 串口终端配置

2.1 安装串口驱动

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

芯片型号	驱动名称	备注
CH340/CH341	CH340 驱动	国产芯片，最常用
CP2102	CP210x 驱动	Silicon Labs 芯片
FT232	FTDI 驱动	FTDI 芯片

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

2.2 PuTTY 配置

下载并运行 PuTTY（免安装）
配置参数：

参数	值
连接方式	Serial
串口行	COM3（根据实际端口号修改）
波特率	1500000
数据位	8
停止位	1
校验位	None
流控制	None

点击"Open"打开串口
开发板上电后，终端窗口应显示 U-Boot 和内核启动日志
登录提示符出现后，输入默认账户：Debian 镜像为 linaro/linaro，Ubuntu 镜像为 root/123456

2.3 MobaXterm 配置

下载并运行 MobaXterm
点击"Session" → "Serial"
选择串口号，设置波特率 1500000
点击"OK"连接

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

2.4 串口功能验证

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

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

Linux version 6.1.x ...

3. ADB 工具配置

3.1 ADB 驱动安装

下载 Google USB Driver 或使用 360 手机助手等工具安装 ADB 驱动
将开发板通过 USB Type-C 线连接到电脑（OTG 口 J6）
在设备管理器中确认设备显示为"Android ADB Device"或"ADB Interface"

3.2 ADB 工具安装

将 ADB 工具（adb.exe、AdbWinApi.dll、AdbWinUsbApi.dll）解压到任意目录，并将该目录添加到系统 PATH 环境变量。

3.3 ADB 功能验证

# 查看已连接的设备
adb devices

预期输出：

List of devices attached
0123456789abcdef	device

# 进入开发板的 shell
adb shell

# 从开发板拉取文件
adb pull /etc/os-release .

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

3.4 ADB 常用命令

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

4. 网络连接配置

4.1 有线网络（以太网）

使用网线连接开发板以太网口（J3）到路由器或交换机
开发板默认使用 DHCP 自动获取 IP 地址
查看 IP 地址：

# 查看网络接口信息
ip addr show eth0

预期输出：

2: eth0: <BROADCAST,MULTICAST,UP,LOWER_UP> mtu 1500 ...
    inet 192.168.1.100/24 brd 192.168.1.255 scope global eth0

4.2 SSH 连接

确认开发板 SSH 服务已启动（系统默认开启）

# 检查 SSH 服务状态
systemctl status sshd

在电脑上使用 SSH 客户端连接：

# Debian 镜像
ssh linaro@192.168.1.100

# Ubuntu 镜像
ssh root@192.168.1.100

配置免密登录（可选）：

# 在电脑上生成 SSH 密钥对
ssh-keygen -t rsa -b 4096

# 将公钥复制到开发板
ssh-copy-id root@192.168.1.100

4.3 无线网络（WiFi）

底板支持可选 WiFi 模块（RTL8821CS 等），如已装配可通过以下方式连接：

# 查看无线网卡
ip link show wlan0

# 启用无线网卡
ip link set wlan0 up

# 扫描可用网络
iw dev wlan0 scan | grep SSID

# 使用 nmcli 连接 WiFi
nmcli device wifi connect "SSID" password "密码"

WiFi 模块为可选配置，出厂未装配时本节命令不可用。

5. 文件传输

5.1 SCP 传输

基于 SSH 的文件传输：

# 从电脑上传文件到开发板
scp local_file.txt root@192.168.1.100:/tmp/

# 从开发板下载文件到电脑
scp root@192.168.1.100:/etc/os-release .

5.2 NFS 挂载

在电脑上配置 NFS 服务器后，开发板可挂载电脑目录：

# 在开发板上挂载 NFS 共享目录
mkdir -p /mnt/nfs
mount -t nfs 192.168.1.2:/path/to/share /mnt/nfs -o nolock

5.3 TFTP 传输

# 从 PC 的 TFTP 服务器下载文件
tftp -g -r filename.txt 192.168.1.2

5.4 Samba 共享

在开发板上安装 Samba 服务，可在 Windows 网络邻居中直接访问开发板文件系统。

6. 开发工具安装（VSCode）

6.1 安装 VSCode

从 code.visualstudio.com 下载 VSCode 安装包
运行安装程序，按默认选项安装
安装完成后启动 VSCode

6.2 推荐插件

插件名称	用途
C/C++（ms-vscode.cpptools）	C/C++ 代码智能提示与调试
Remote - SSH	通过 SSH 远程编辑开发板文件
GitLens	Git 版本控制增强
YAML	YAML 语法支持（设备树文件）
Hex Editor	二进制文件查看