米联客F31-4EV(B) Linux开机测试完整流程（零基础手把手）
适用平台：米联客 F31-4EV(B)
系统版本：Ubuntu 20.04 原厂系统
操作环境：Windows串口工具 + 原厂Ubuntu虚拟机环境
适合人群：嵌入式Linux入门、FPGA+ARM架构新手、首次开机调试
CSDN标签：#米联客 #F31-4EVB #嵌入式Linux #Linux开机测试 #FPGA开发 #ARM Linux
一、实验概述
F31-4EV(B) 属于米联客高端MPSoC开发板，采用FPGA+ARM异构架构。在Linux开发流程中，所有 Vivado 工程修改、PL端逻辑更新、设备树修改，必须重新编译系统、重新烧录镜像才能生效。
原因：PL端比特流（bit）文件依赖 FSBL 启动阶段完成 FPGA 配置，若不重新移植系统，PL 端所有改动无法在 Linux 系统中加载。
本文为官方标准开机测试流程，包含硬件检查、拨码设置、串口登录、系统上电、账号登录、基础功能验证，首次开机必看。
二、实验硬件配件清单
完成本次开机测试需要如下配件：
- F31-4EV(B) 开发板 ×1
- 12V 电源适配器 ×1
- USB-mini 串口调试线 ×1
- TF SD卡 + 读卡器（≥16G）
- 以太网线、DP线（选配）
三、前置准备工作
3.1 软件环境
- Windows：PuTTY / Xshell 串口工具
- 虚拟机：米联客官方 uisrc-lab-xlnx Ubuntu 编译环境
- 镜像：F31-4EV(B) 专用 Ubuntu20.04 出厂镜像
3.2 串口驱动确认
将 USB-mini 线连接开发板与电脑，Windows 设备管理器查看「端口(COM)」，确认 CP210x 串口设备正常识别，记录 COM 编号。
3.3 串口参数配置
所有开机调试统一参数：
- 波特率：115200
- 数据位：8
- 停止位：1
- 校验位：无
- 流控：无
四、启动模式拨码说明（F31-4EV(B)专用）
板载 SW1 拨码开关控制启动介质，0=ON，1=OFF：
4.1 SD卡启动（调试/新系统烧录常用）
拨码组合：0011
PIN1=ON、PIN2=ON、PIN3=OFF、PIN4=OFF
用途：临时启动新系统、烧录 eMMC、系统调试
4.2 eMMC启动（正常出厂开机）
拨码组合：0101
PIN1=ON、PIN2=OFF、PIN3=ON、PIN4=OFF
用途：日常正式开机，读取板载固化系统
五、硬件接线步骤
严格按照顺序接线，避免带电插拔损坏硬件：
- 设置好 SW1 启动拨码；
- 插入烧录好系统的 SD 卡（SD启动模式必备）；
- 连接 USB-mini 串口线至电脑；
- 可选连接网线、DP显示器；
- 最后接入 12V 电源，打开电源开关上电。
六、PuTTY串口开机监控
- 打开 PuTTY，选择「串行」模式；
- 填写对应 COM 口与 115200 波特率；
- 点击打开，窗口待命；
- 开发板上电，自动打印 U-Boot、内核、设备树启动日志。
正常开机可看到：U-Boot 启动信息 → Linux 内核打印 → 文件系统挂载 → 登录提示。
七、系统账号登录（原厂默认）
系统启动完成后进入控制台登录界面：
- 普通用户：uisrc
- 密码：root（盲打输入）
登录成功后切换 root 最高权限：
bash |
八、开机自检基础验证
登录系统后执行基础自检，确认开机完全正常：
8.1 查看系统信息
bash |
正常输出 Linux 内核版本、Ubuntu20.04 系统信息。
8.2 查看磁盘挂载
bash |
可正常识别 SD 卡或 eMMC 分区，无挂载报错即为正常。
8.3 查看设备树加载信息
bash |
设备树加载无报错，代表硬件资源配置正常。
九、开机失败常见问题排查
问题1：上电无任何串口打印
- 排查拨码启动模式是否正确
- 检查串口线、COM口选择、115200波特率
- 确认电源供电正常
问题2：内核启动卡死
- 镜像与开发板型号不匹配
- SD卡损坏、镜像烧录不完整
问题3：无法登录系统/密码错误
原厂固定账号密码：用户 uisrc、密码 root，若修改过系统需恢复出厂镜像。
问题4：PL端修改后开机不生效
必须重新导出 XSA、编译设备树、打包系统镜像烧录，仅改 Vivado 工程无法生效。
十、开机测试总结
1. F31-4EV(B) 启动核心为拨码模式选择，SD模式用于调试烧录，eMMC模式用于正常开机；
2. 所有 FPGA 逻辑改动必须重新打包系统，Linux 才能加载 PL 配置；
3. 开机标准流程：硬件接线 → 串口监听 → 上电自检 → 账号登录 → 系统自检；
4. 开机无报错、内核正常启动、磁盘挂载正常，即为开机测试通过。
十一、配套资料
官方网站：https://www.uisrc.com
配套镜像：F31-4EV(B) Ubuntu20.04 出厂镜像
配套教程：米联客Linux开机测试、系统恢复出厂、系统二次开发教程