2、开发环境搭建：基于STM32H743平台，配置CubeMX + MDK + VSCode开发链，搭建ToF模组调试的硬件平台（I2C/SPI/UART接口）与逻辑分析仪抓取工具
说实话，做ToF驱动开发这么多年，我踩过最大的坑反而不是代码本身，而是环境没搭好就开始写。你想想看，一个I2C波形不对，你怀疑是驱动问题，结果折腾半天发现是逻辑分析仪没接地——这种事我至少遇到过三次。所以这一章，咱们把地基打牢。
2.1 硬件平台选型：为什么是STM32H743？
选STM32H743，说白了就三个理由：快、接口多、生态好。我最早用F103做ToF调试，I2C频率跑到400kHz就卡得不行，后来换了H743，直接上1MHz，波形干净得像教科书。
| 外设 | STM32H743特性 | ToF模组需求 |
|---|---|---|
| I2C | 6路独立，支持1MHz | 配置寄存器，通常≤400kHz |
| SPI | 6路，最高100MHz | 高速数据流，典型10-50MHz |
| UART | 8路，最高12.5Mbps | 调试日志输出 |
| DMA | 双总线架构，支持MDMA | 批量数据搬运，不占CPU |
嗯，这里要注意：H743的I2C有个小脾气——它的SCL/SDA引脚默认是开漏输出，外部必须上拉。我见过有人直接拿杜邦线怼上去，结果波形像锯齿。建议用4.7kΩ上拉电阻，如果走线超过10cm，换成2.2kΩ。
2.2 开发链配置：CubeMX + MDK + VSCode
这套组合拳，我个人习惯是：CubeMX生成底层，MDK做编译调试，VSCode写代码。为什么这么分？因为CubeMX的代码生成器太方便了，但编辑器体验一般；MDK的编译器优化好，但界面丑；VSCode写代码舒服，但调试配置麻烦。各取所长嘛。
2.2.1 CubeMX配置要点
打开CubeMX，选STM32H743ZITx。时钟配置这里我多说一句：H743的HSE外部晶振建议用25MHz，然后PLL倍频到480MHz。为什么？因为ToF模组的高速SPI需要精确时钟，480MHz可以整数分频出50MHz、25MHz这些常用频率。
// 时钟树配置（关键参数）
HSE_VALUE = 25000000 // 外部晶振25MHz
PLL1_M = 5 // 分频系数
PLL1_N = 192 // 倍频系数
PLL1_P = 2 // 系统时钟分频
SYSCLK = 480MHz // 最终主频2.2.2 MDK工程设置
MDK这里其实没什么玄学，但有个细节：优化等级别开太高。我建议调试阶段用-O0，发布时再开到-O2。为什么？因为-O3优化会把一些变量优化掉，你调试时看变量值全是"optimized out"，那叫一个抓狂。
2.2.3 VSCode集成
VSCode我主要用来写业务逻辑。装这几个插件就够了：C/C++ IntelliSense、Cortex-Debug、GitLens。注意，Cortex-Debug需要配合JLink或ST-Link的GDB Server使用。
2.3 ToF模组硬件接口：I2C/SPI/UART
ToF模组通常有三种接口：I2C用于配置，SPI用于数据流，UART用于调试。我见过有些方案只用I2C，但实测帧率上不去——因为I2C是半双工，读一帧深度数据要来回切换方向，效率太低。
2.3.1 I2C接口
I2C主要用于读写寄存器。以VL53L1X为例，它的I2C地址是0x52（7位地址）。读寄存器时，先发地址，再发寄存器索引，最后读数据。写寄存器类似。
// I2C读寄存器示例（HAL库）
uint8_t reg_val;
uint8_t reg_addr = 0x01; // 比如读设备ID寄存器
HAL_I2C_Master_Transmit(&hi2c1, 0x52, ®_addr, 1, 100);
HAL_I2C_Master_Receive(&hi2c1, 0x52, ®_val, 1, 100);2.3.2 SPI接口
SPI用于高速数据传输。ToF模组通常支持SPI模式0（CPOL=0, CPHA=0），时钟极性空闲时为低，数据在第一个边沿采样。注意，SPI的CS片选信号要软件控制，不要用硬件自动控制——因为有些模组要求CS在传输结束后保持高电平一段时间。
// SPI读取深度数据（DMA方式）
uint8_t rx_buffer[1024];
HAL_SPI_Receive_DMA(&hspi1, rx_buffer, 1024);
// 在DMA完成回调中处理数据
void HAL_SPI_RxCpltCallback(SPI_HandleTypeDef *hspi) {
if (hspi->Instance == SPI1) {
process_tof_data(rx_buffer);
}
}2.3.3 UART调试接口
UART我一般用来打印调试信息。波特率设115200或921600。注意，如果打印太频繁，会影响ToF的帧率。我建议用环形缓冲区+定时打印的方式，不要每帧都printf。
2.4 逻辑分析仪抓取工具
做驱动开发，逻辑分析仪就是你的眼睛。我推荐用Saleae Logic 8，便宜好用。如果预算有限，用国产的DSLogic也行，但采样深度差一些。
2.4.1 抓取I2C波形
把逻辑分析仪的通道0接SCL，通道1接SDA，地线接GND。采样率设2MHz以上（I2C 400kHz的话，4倍采样就够了）。触发条件设成SCL下降沿，这样能抓到完整的通信过程。
2.4.2 分析SPI时序
SPI抓取时，把CS、SCLK、MOSI、MISO分别接到四个通道。重点看CS拉低后，SCLK的第一个边沿是否稳定。我见过有些模组在CS拉低后需要一小段延迟才能开始传输，这个延迟在数据手册里叫"CS to SCLK setup time"。
2.4.3 常用抓取技巧
- 触发设置： 抓I2C起始条件（SCL高时SDA下降沿），抓SPI用CS下降沿
- 解码设置： Saleae软件自带I2C/SPI解码器，设好时钟极性和数据位宽就行
- 导出数据： 可以把波形导出成CSV，用Python做自动化分析
2.5 硬件平台搭建实战
好了，理论说完了，咱们动手。我建议按这个顺序来：
- 焊接底板： 把H743核心板焊到转接板上，引出所有IO口
- 连接ToF模组： 用杜邦线或排线连接I2C/SPI/UART
- 上电测试： 先测电源，3.3V和1.8V（如果模组需要）
- 跑个例程： 用CubeMX生成的I2C例程，读一下模组的设备ID
- 抓波形： 用逻辑分析仪确认通信正常
嗯，到这里，开发环境就搭好了。你可能会问：为什么不用现成的开发板？我的回答是：自己做底板，你能更清楚每个信号是怎么走的。以后出了问题，排查起来心里有数。
这张图把整个硬件平台的关系画清楚了。STM32H743是大脑，通过I2C/SPI/UART和ToF模组通信，逻辑分析仪挂在总线上抓波形，电源模块提供稳定供电。你搭建的时候，按这个架构来，不会乱。