1. 课程导入与平台认知
在嵌入式与网络设备开发领域，Marvell 芯片平台长期占据重要位置，从早期的 Armada 系列到近年的 OCTEON、CN9xxx、Alaska 以太网 PHY 以及 88E6xxx 交换芯片，其产品线覆盖了从接入、汇聚到核心处理的完整链路。本课程讨论的“Bring-up”与“系统调试”，正是围绕这些芯片从“裸片/裸板”走向“可运行系统”的关键工程活动。理解平台架构与调试流程，是后续所有实操章节的基础。
一、Marvell 芯片平台的典型架构
以一颗典型的 Marvell 网络处理器（如 OCTEON TX2 或 CN913x）为例，其平台架构通常由以下几个层次构成：
- 计算核心层：包含多个 Arm 或 MIPS 架构 CPU 核，部分型号还集成专用加速单元（如 DPI、加密引擎、正则表达式加速器）。
- 互连与内存子系统：通过 CCN、CCU 或交叉开关连接 CPU、DDR 控制器、L2/L3 缓存及外设，决定数据通路的带宽与延迟。
- 网络接口层：包括以太网 MAC、PCS、SerDes 以及外部 PHY/交换芯片接口，常见速率从 1G 到 100G 不等。
- 外设与启动层：涵盖 SPI Flash、eMMC、UART、I2C、GPIO、PCIe 控制器以及 BootROM 启动逻辑。
- 电源与时钟层：多路 PMIC、晶振、PLL 和复位管理，是 Bring-up 阶段最先需要确认的物理基础。
这些层次并非孤立存在，而是通过寄存器空间、中断路由和时钟域相互耦合。例如，SerDes 的参考时钟若未正确配置，不仅网络接口无法 link，还可能影响 PCIe 枚举。因此，Bring-up 的本质是“按依赖顺序逐层点亮并验证”。
二、Bring-up 与系统调试的定义与边界
Bring-up（点亮/启动）指从硬件上电开始，逐步使芯片各功能模块进入可工作状态的过程。它关注的是“能不能跑起来”：电源是否正常、时钟是否锁定、DDR 是否训练成功、BootROM 是否能从 Flash 读取有效镜像、串口是否输出第一行日志。Bring-up 的终点通常是系统能够稳定进入 U-Boot 或 Bootloader 命令行。
系统调试（System Debug）则发生在 Bring-up 之后或与之交织，关注的是“跑得对不对、稳不稳、快不快”。它包括驱动适配、外设功能验证、网络吞吐测试、中断延迟分析、功耗与温度监控、多核调度优化以及故障复现与根因定位。系统调试的终点是系统满足产品规格并具备可量产的一致性。
三、目标与交付物
Bring-up 的核心目标可以概括为三点：可上电、可启动、可通信。对应的交付物通常包括：
- 上电时序检查表与电源轨实测记录（示例：VDD_CORE 0.85V、VDD_DDR 1.2V、VDD_IO 1.8V/3.3V）。
- 时钟树配置表与 PLL 锁定状态日志。
- DDR 训练报告（含眼图余量、Vref 扫描结果，示例值仅作教学假设）。
- BootROM 启动日志与 U-Boot 环境变量备份。
- 串口、网口、PCIe 等最小外设的连通性验证记录。
系统调试的交付物则更偏向性能与可靠性：
- 各外设驱动加载日志与功能测试用例结果。
- 网络吞吐/时延测试报告（如 iperf3 双向 10G 线速示例）。
- 中断统计与 CPU 占用率分析。
- 功耗-温度曲线与散热策略验证。
- 已知问题清单与规避措施（Errata 对照表）。
四、完整流程概览
一个典型的 Marvell 平台 Bring-up 与调试流程，可以按以下阶段推进。注意，这些阶段并非严格线性，实际项目中常出现回退与迭代。
| 阶段 | 关键活动 | 典型工具/接口 | 通过判据（示例） |
|---|---|---|---|
| 硬件检查 | 电源轨阻抗、短路、上电时序 | 万用表、示波器 | 各轨电压在 ±5% 以内，无短路 |
| 时钟与复位 | 晶振起振、PLL 锁定、复位释放 | 示波器、寄存器读取 | 参考时钟频偏 < 50ppm，PLL lock 置位 |
| DDR 初始化 | DDR 训练、Vref 扫描、眼图评估 | Marvell DDR 工具、串口日志 | 训练通过，读写测试无错误 |
| BootROM 启动 | 启动介质选择、镜像加载 | SPI/eMMC、UART | 串口输出 BootROM 版本与跳转信息 |
| Bootloader | U-Boot 移植、环境变量、网络下载 | UART、TFTP、MDIO | 进入命令行，可 ping 通主机 |
| 内核与驱动 | 设备树适配、驱动加载、根文件系统 | Linux 内核、DTS、initramfs | 内核启动到 shell，外设 probe 成功 |
| 系统调试 | 性能、稳定性、功耗、故障注入 | iperf3、perf、ftrace、温箱 | 满足规格书指标，长稳测试无异常 |
五、教学示例：一次典型的 DDR 训练观察
假设我们在一块搭载 CN9130 的参考板上进行 Bring-up。上电后串口无输出，首先用示波器确认 VDD_CORE 为 0.85V、VDD_DDR 为 1.2V，均正常；再测 25MHz 晶振，起振正常。随后通过 JTAG 读取 PLL 状态寄存器，发现 DDR PLL 未锁定。检查发现参考时钟选择位配置错误，修正后 PLL 锁定。再次上电，串口输出 BootROM 日志，但 DDR 训练报错。
此时使用 Marvell 提供的 DDR 训练工具，读取训练报告，发现 DQ 眼图余量在 byte1 上仅 0.12UI（示例值），低于建议的 0.25UI。调整驱动强度与 ODT 设置后重新训练，余量提升至 0.31UI，训练通过。系统继续启动进入 U-Boot。这个过程中，我们依次验证了电源、时钟、DDR 和启动通路，体现了 Bring-up 的依赖顺序。
六、本课程的学习路径
后续章节将沿着上述流程逐步展开：从硬件检查与电源时序，到时钟与复位，再到 DDR 训练、BootROM 与 Bootloader 移植、Linux 内核与驱动适配，最后进入网络性能、中断优化、功耗管理与故障排查。每一节都会结合具体的寄存器、命令、日志和判断依据，帮助读者建立“可操作、可复现、可验证”的工程能力。
在开始动手之前，请先建立两个基本习惯：第一，任何操作前先确认电源和时钟；第二，任何结论都要有可观察的证据（日志、寄存器值、波形）。这两点将贯穿整个 Bring-up 与系统调试过程。