3、移植前的准备工作：原方案SDK分析（ESP8266/ESP32为例）、硬件原理图对比、关键外设差异梳理（GPIO、SPI、UART、I2C）
好，咱们正式开始移植前的准备工作。这一步做扎实了，后面能省掉80%的调试时间。我个人习惯，拿到一个新项目，先不急着看代码，而是把原方案的SDK和硬件原理图翻个底朝天。
今天咱们就拿ESP8266和ESP32当靶子，看看怎么分析原方案，怎么对比硬件差异。说白了，就是搞清楚“原来怎么干的”和“现在要换成什么”。
3.1 原方案SDK分析——以ESP8266/ESP32为例
先说说SDK分析。很多人一上来就翻代码，其实不对。我建议你先看三样东西：芯片手册、SDK目录结构、启动流程。
3.1.1 芯片手册怎么看？
ESP8266和ESP32的datasheet，乐鑫官网上都有。我重点看这几个部分：
- 电源域与复位：ESP8266是3.3V单电源，ESP32多了个RTC域。嗯，这里要注意，国产芯片的电源域划分可能完全不同。
- 时钟树：ESP8266主频80MHz/160MHz，ESP32可以到240MHz。国产芯片的PLL配置方式往往不一样。
- 内存映射：ESP8266的iRAM只有64KB，dRAM 96KB。ESP32的SRAM有520KB。这个差异直接影响代码移植时的内存分配策略。
核心观点：SDK分析不是读代码，而是读芯片的“脾气”。你摸清了芯片的脾气，移植起来才能顺风顺水。
3.1.2 SDK目录结构——别被文件夹吓到
打开ESP-IDF或者ESP8266_RTOS_SDK，目录确实不少。但我只看这几个关键目录：
| 目录/文件 | 作用 | 移植时关注点 |
|---|---|---|
| components/ | 外设驱动、协议栈、库函数 | 重点关注hal层和driver层 |
| main/ | 用户应用程序 | 这是我们要移植的主体 |
| sdkconfig | 编译配置 | 注意freertos配置、内存分配 |
| Kconfig | 菜单配置项 | 国产芯片的配置项要重新定义 |
我记得第一次移植ESP8266到国产芯片时，光看components目录就花了三天。后来学乖了，直接找components/driver/和components/hal/，这两个目录才是外设驱动的核心。
3.1.3 启动流程——从reset到main()
ESP32的启动流程大致是：ROM bootloader → 一级bootloader → 二级bootloader → app_main。ESP8266简单一些，直接从flash加载到iRAM执行。
为什么会这样？因为ESP32的flash加密和安全启动机制更复杂。国产芯片如果也有类似的安全需求，启动流程就得重新设计。
小技巧：在SDK里搜“startup”或者“entry”，能找到启动相关的代码。ESP32的启动代码在components/esp_system/port/下。
3.2 硬件原理图对比——别只看引脚编号
硬件原理图对比，很多人只盯着引脚编号看。其实更重要的是电气特性和功能复用。
3.2.1 电源与复位对比
| 项目 | ESP8266 | ESP32 | 国产芯片（示例） |
|---|---|---|---|
| 工作电压 | 3.0V~3.6V | 2.3V~3.6V | 需确认 |
| IO电平 | 3.3V | 3.3V（部分1.8V） | 注意电平兼容性 |
| 复位引脚 | CHIP_EN | EN | 可能叫RST或NRST |
| RTC电源 | 无 | VDD_RTC | 部分国产芯片有 |
我曾经在一个项目里，直接把ESP32的复位电路照搬到国产芯片上，结果芯片死活不启动。后来发现国产芯片的复位引脚是低电平有效，而ESP32是上拉高电平有效。嗯，这种坑踩一次就够了。
3.2.2 时钟与晶振
ESP8266和ESP32都使用40MHz晶振。但国产芯片有的用26MHz，有的用24MHz。这个差异会影响WiFi射频的校准参数，不能随便改。
警告：晶振频率不同，WiFi的RF前端匹配电路也要调整。别指望直接替换晶振就能工作，我试过，结果WiFi灵敏度掉了10dBm。
3.3 关键外设差异梳理——GPIO、SPI、UART、I2C
外设差异是移植中最容易出问题的地方。咱们一个一个说。
3.3.1 GPIO差异
| 特性 | ESP8266 | ESP32 | 移植注意事项 |
|---|---|---|---|
| GPIO数量 | 17个 | 34个 | 国产芯片可能更少 |
| 中断触发 | 上升/下降/双边沿 | 同上+高/低电平 | 注意电平中断的支持 |
| 上拉/下拉 | 软件可配 | 软件可配 | 部分国产芯片需硬件外接 |
| 驱动能力 | 12mA | 40mA | 驱动LED等负载时注意 |
我个人习惯，移植GPIO驱动时，先写一个gpio_config()的封装函数，把原SDK的API映射到国产芯片的API上。比如ESP32的gpio_set_level()，映射到国产芯片的hal_gpio_write()。
3.3.2 SPI差异
SPI这块坑比较多。ESP32有4个SPI控制器，ESP8266只有1个。而且ESP32的SPI支持DMA，ESP8266不支持。
- 时钟极性/相位：ESP32的SPI模式配置在
spi_device_interface_config_t里，国产芯片可能叫spi_cfg_t。注意mode0~mode3的对应关系。 - 数据长度：ESP32支持8~64位数据长度，国产芯片可能只支持8位或16位。如果原方案用了32位SPI传输，移植时得拆成多次8位传输。
- CS控制：ESP32的CS可以由硬件自动控制，国产芯片可能需要软件手动拉CS。这个性能差异要注意。
避坑指南：我曾经移植一个SPI驱动LCD的项目，原方案用ESP32的DMA传输，换成国产芯片后没有DMA，帧率从30fps掉到5fps。后来改用双缓冲+中断才勉强救回来。
3.3.3 UART差异
UART相对简单，但也有一些细节：
| 特性 | ESP8266 | ESP32 | 移植注意事项 |
|---|---|---|---|
| UART数量 | 2个 | 3个 | 注意波特率范围 |
| FIFO深度 | 128字节 | 128字节 | 国产芯片可能只有16字节 |
| 硬件流控 | 支持 | 支持 | 注意RTS/CTS引脚映射 |
| 奇偶校验 | 支持 | 支持 | 一般没问题 |
嗯，这里要注意，ESP32的UART有uart_driver_install()函数，里面有个queue_size参数。国产芯片的UART驱动可能没有这个队列机制，需要自己实现环形缓冲区。
3.3.4 I2C差异
I2C移植时，我最关注的是时钟频率和超时处理。
- 时钟频率：ESP32的I2C支持100kHz和400kHz，部分国产芯片可能只支持100kHz。如果原方案用了400kHz，移植后要降速。
- 超时机制：ESP32的I2C驱动有超时检测，国产芯片可能没有。我建议移植时加上软件超时，防止I2C总线卡死。
- 从机地址：ESP32支持7位和10位地址，国产芯片可能只支持7位。这个在移植前就要确认。
个人经验：I2C移植最容易出问题的是时序。我一般用逻辑分析仪抓一下原方案的I2C波形，然后对比国产芯片的波形。SCL高电平宽度、SDA建立时间这些参数，差一点就可能通信失败。
3.4 移植前的检查清单
最后，我整理了一个检查清单，移植前逐项确认：
- 芯片手册是否读完？电源、时钟、复位、GPIO复用表。
- SDK目录结构是否理清？hal层、driver层、app层。
- 原理图是否对比过？电源、晶振、复位、下载电路。
- 外设差异是否列出？GPIO、SPI、UART、I2C。
- 是否有逻辑分析仪/示波器？调试必备。
做完这些准备工作，你心里就有底了。下一章咱们开始动手移植，先从GPIO驱动开始。