1. 课程导入与STM32MP平台概览

在嵌入式Linux产品开发中，STM32MP系列是ST将Cortex-A与Cortex-M两类内核集成在同一芯片上的异构处理器。它既保留了Linux在文件系统、网络协议栈、图形界面和复杂应用上的优势，又保留了MCU在实时响应、低功耗待机和硬实时外设控制上的能力。板级硬件适配与联调，正是把“芯片能跑”推进到“整块板卡能稳定工作”的关键环节：它既包含设备树、时钟、电源、引脚复用等底层描述，也包含启动链路、外设驱动、内核日志和实测信号的联合验证。

一、双核架构：A核与M核的分工

以STM32MP157为例，芯片内部包含两个Cortex-A7核（可运行Linux或双核SMP）和一个Cortex-M4核。A7侧通常承担系统管理、网络、显示、存储和上层业务；M4侧则用于电机控制、传感器采集、实时通信等对确定性要求高的任务。两核之间通过硬件信号量HSEM、IPCC中断通道和共享内存进行通信，常见形态是OpenAMP/rpmsg：A核创建virtio缓冲区，M核通过IPCC收发消息，共享内存中传递数据块。

理解这一点对板级适配很重要：M4固件往往需要独立加载，其运行地址、资源表、时钟和中断都要与A核Linux侧协调。若设备树中保留了M4使用的引脚或外设，Linux驱动可能抢占资源，导致M4固件启动后外设无响应。因此适配的第一步不是写驱动，而是先明确“哪些资源归A核、哪些归M核”。

二、板级硬件适配与联调的定义

板级硬件适配（Board Bring-up）是指针对具体PCB，把SoC内部资源与板上的晶振、PMIC、DDR、eMMC、PHY、连接器等实际器件对应起来，使BootROM、TF-A、U-Boot、Linux内核和根文件系统能够依次正确启动，并让各外设驱动在真实硬件上工作。联调则是在适配基础上，用示波器、逻辑分析仪、串口日志和内核调试接口，对启动失败、外设不识别、时序不满足、电源异常等问题进行定位和修正。

它和“写应用”有本质区别：应用层看到的是标准接口，而板级适配面对的是寄存器、时钟树、引脚编号和电气时序。一个典型的判断依据是：串口能打印U-Boot版本，说明DDR和时钟基本正确；内核能挂载根文件系统，说明存储和文件系统配置正确；dmesg中出现外设probe成功，说明设备树与驱动匹配。若卡在某一阶段，就要回到对应层级排查。

三、典型工作流程

实际项目中，板级适配通常按“先让系统起来，再让外设工作，最后做稳定性验证”的顺序推进。下面给出一个可参考的流程，具体阶段可根据板卡复杂度裁剪。

1. 硬件资料确认：拿到原理图、PCB、器件手册和SoC数据手册，标注电源域、复位、时钟源、启动模式引脚和调试串口。
2. 启动链路打通：确认BOOT引脚选择从eMMC/SD卡启动，用ST-Link或串口观察ROM Code输出，验证DDR初始化参数。
3. TF-A与U-Boot适配：修改DDR配置、串口引脚、PMIC电压和启动设备，使U-Boot能进入命令行并加载内核。
4. Linux设备树适配：按板卡实际连接编写/修改.dts，配置pinctrl、时钟、regulator、I2C/SPI/UART节点和状态。
5. 外设驱动验证：逐个使能外设，通过dmesg、/sys、i2cdetect、spidev_test等确认识别和通信。
6. 跨核与实时验证：加载M4固件，验证rpmsg通道、共享内存数据和中断响应时间。
7. 稳定性与回归：做高低温、反复上下电、长时间运行和压力测试，记录异常并回归修复。

四、开发环境搭建与工具链准备

STM32MP开发通常需要一套Linux主机环境。推荐使用Ubuntu 20.04/22.04 LTS，安装基础依赖后，通过ST官方Yocto或OpenSTLinux SDK获取交叉编译工具链。工具链前缀一般为arm-ostl-linux-gnueabi-，用于编译内核、U-Boot和用户态程序。M4固件则使用arm-none-eabi-工具链单独编译。

# 示例：安装基础依赖（Ubuntu）
sudo apt update
sudo apt install -y git build-essential gcc g++ make \
  bison flex libssl-dev bc libncurses5-dev \
  device-tree-compiler u-boot-tools

# 示例：设置交叉编译环境变量
export ARCH=arm
export CROSS_COMPILE=arm-ostl-linux-gnueabi-
export PATH=$PATH:/opt/st/stm32mp1/3.1-snapshot/sysroots/x86_64-ostl_sdk-linux/usr/bin

# 示例：编译设备树
make dtbs

# 示例：查看内核启动日志中的外设probe情况
dmesg | grep -i "i2c\|spi\|uart\|mmc"

调试工具方面，串口是板级联调最可靠的入口，通常使用115200-8-N-1；ST-Link用于M4固件下载和A核早期调试；示波器用于检查晶振、复位、电源上电时序和通信波形；逻辑分析仪用于抓取I2C/SPI/UART时序。建议在项目初期就固定调试串口和电源测量点，避免后期反复飞线。

五、本节小结与检查要点

本节建立了STM32MP平台的整体认知：A7负责Linux系统与复杂业务，M4负责实时任务，两者通过共享内存和IPCC协同；板级适配是把SoC资源与具体板卡硬件对应起来的过程，联调则是用日志和仪器定位问题的过程。开发环境需要Linux主机、交叉工具链、串口和调试器配合。