简介：面向嵌入式硬件工程师与底层驱动开发者的CMT4522 GPIO应用笔记，聚焦GPIO工作模式与保护机制的工程落地，适合需要快速查阅寄存器行为、排查IO异常的中高级硬件人员。压缩包内为1份PDF文档，约612KB，内容涵盖特殊IO（TEST_MODE、P16/P17、P1、P2/P3）的功能划分、GPIO输出/输入/retention及上下拉电阻配置、中断与唤醒机制，并延伸至FULLMUX、ANALOG、KSCAN等复用模式。文档对Retention与Safe Fail保护逻辑作了专门解释，说明故障时如何将IO恢复至安全状态以避免持续误输出，同时附有内部结构与电路图，便于对照原理理解设计意图。典型应用章节给出输出、输入与retention的参考用法，可直接用于嵌入式系统、机器人与自动控制场景的IO设计核对。已有1280人学习，适合作为手边速查手册使用。

1. 拿到一份 GPIO 应用手册，先别急着翻寄存器

低功耗产品做到深睡唤醒那一步，十有八九会卡在同一个地方：休眠前明明把某个引脚拉高了，一进休眠，外部电路就掉电平，继电器误动作、传感器供电断掉、唤醒源自己先失效。翻遍代码也找不到问题，因为根子不在代码，在引脚休眠后的默认状态。这份 CMT4522 GPIO 应用手册解决的正是这类问题，它把 GPIO 输出、输入、retention、上下拉、中断唤醒、FULLMUX 复用、ANALOG、KSCAN 矩阵按键八种模式逐条拆开，还配了可直接抄的驱动调用示例和 4×4 矩阵按键的引脚分配图。适合正在用 4520/4550/4522/4552 系列做低功耗硬件设计的工程师，也适合刚接手这块板子、需要快速搞清楚哪些脚不能碰的人。硬件选型和原理图评审阶段先过一遍，比调试阶段返工便宜得多。

2. 特殊 IO 与上电默认态：哪些脚从原理图阶段就不能动

这份手册最值钱的部分不是 API 示例，而是开头那张 QFN32 上电默认属性表。它决定了芯片复位后、你的代码跑起来之前，每个引脚是什么状态。很多硬件问题在画原理图那一刻就埋下了，后面软件怎么调都是补救。

2.1 TEST_MODE 与 P24、P25 的组合逻辑

TEST_MODE 不是普通 GPIO，它和 P24、P25 一起编码芯片的工作状态。手册给的表很明确：TEST_MODE=0 时，P24、P25 随便，芯片进 Normal Mode 跑程序；TEST_MODE=1、P24=0、P25=0 时进 Program Mode 烧录；另外还有 Scan Mode 和 Bist Mode 两种组合。

这意味着两件事。第一，应用代码里绝对不能去操作 TEST_MODE，它不是给你用的。第二，硬件电路上这三个脚的电平组合必须落在 {0,,} 或 {1,0,0} 这两个合法集合里，否则芯片复位后可能直接进烧录模式或扫描模式，程序根本不跑。我见过一块板子把 P24 上拉、P25 下拉，结果每次上电都进不了 Normal Mode，查了两天才定位到是这两个脚的电平组合踩进了保留状态。

提示：原理图评审时把 TEST_MODE、P24、P25 三个网络单独圈出来，确认复位后的默认电平组合，别让外部上下拉把状态带偏。

2.2 P16、P17 是晶振专用脚，别打复用主意

P16 是 XTALI，P17 是 XTALO，默认接 32.768K 晶振加电容组成振荡电路。手册写得很死：目前应用代码不能把这两个脚做其他用途，即使系统里改用内部 RC 32K，P16、P17 也不可挪用。以后可能会支持 GPIO 和 IOMUX，但那是以后的事，当前版本别赌。

这条对硬件设计的约束很直接：如果你的方案需要省引脚，别指望从 P16、P17 上抠。低功耗场景下 32.768K 晶振往往是 RTC 和休眠定时的基准，这两个脚基本是锁死的。

2.3 P1 不支持 FULLMUX，P2、P3 接调试器时功能受限

P1 不支持 FULLMUX，也就是不能复用成 UART、I2C、PWM 这些外设功能，只能当普通 GPIO 用。P2 是 SWD_IO、P3 是 SWD_CLK，可以接调试器，但接了调试器之后这两个脚的非调试功能会受影响。

实际影响是：如果你打算把 P2、P3 复用成矩阵按键的列线或者别的外设，调试阶段就得在“能连调试器”和“外设正常工作”之间二选一。常见做法是硬件上留调试接口但不常焊，量产板去掉调试器后 P2、P3 才完全释放。手册里 4×4 矩阵按键的例子恰好把 P3 用作 col1，这就是典型的“调试完再启用”场景。

2.4 上电默认属性表怎么读

那张表列了每个引脚的 Default mode、Default IN_OUT、是否支持 IRQ/Wakeup、是否支持 FULLMUX、是否支持 ANA、是否支持 KSCAN，以及对应的 mk_in/mk_out 编号。读法上抓三个关键列就够了：默认方向、唤醒能力、复用能力。

比如 P00 默认是 GPIO 输入，支持中断唤醒和 FULLMUX，对应 mk_in[0]；P02 默认是 SWD_IO 输出，支持唤醒和 FULLMUX；P16、P17 默认是 ANA 模拟态，只支持 KSCAN 的 mk_out。做低功耗唤醒设计时，优先从“支持 IRQ/Wakeup”那一列打勾的脚里选，别选到 P16、P17 这种模拟脚上。

3. GPIO 六种工作模式：从输出到 KSCAN 的配置路径

模式选择是这份手册的主干。八种模式里，输出、输入、retention、上下拉、中断唤醒这五种是日常用得最多的，FULLMUX、ANALOG、KSCAN 属于按场景启用。下面按“什么时候用、怎么配、参数怎么设”的顺序过一遍，代码以 4522/4552 的 hal 接口为主，4520/4550 的 csi 接口在手册里也有对照。

3.1 GPIO 输出与输入：方向寄存器和数据寄存器

输出模式的本质是把方向寄存器 swporta_ddr 配成输出，然后往数据寄存器 swporta_dr 写 0 或 1。手册给了两套 API，4522/4552 用 hal 接口更简洁：

// 4522/4552：P0 配置为输出，循环翻转电平 static void gpio_output_demo(void) { gpio_pin_e pin = P0; hal_gpio_pin_init(pin, GPIO_OUTPUT); // 方向配成输出 while (1) { hal_gpio_fast_write(pin, 1); // 输出高 hal_gpio_fast_write(pin, 0); // 输出低 } }

hal_gpio_pin_init的第二个参数决定方向，GPIO_OUTPUT对应方向寄存器写输出位；hal_gpio_fast_write是带优化路径的写接口，适合高频翻转，普通场景用hal_gpio_write也行。输入模式反过来，方向配GPIO_INPUT，然后读：

// 4522/4552：P0 配置为输入并读取电平 static void gpio_input_demo(void) { gpio_pin_e pin = P0; bool value; hal_gpio_pin_init(pin, GPIO_INPUT); value = hal_gpio_read(pin); // 读输入寄存器 LOG("pin:%d value:%d\n", pin, value); }

这里有个容易忽略的点：输入模式下如果引脚是浮空的，读回来的值是不确定的，必须配合上下拉配置才有意义。手册在上下拉那一节专门强调了这点，后面会展开。

3.2 retention：休眠后保住输出电平的关键

retention 是这份手册里最容易被低估的功能。默认关闭。关闭时，系统一休眠，GPIO 从输出态恢复成默认输入态，你之前写的高电平就没了。打开后，休眠期间引脚的输出特性和输出值都保持不变。

手册举的例子很典型：P00 运行时配成输出且输出 1，休眠后变输入态，不再输出 1；想让它在休眠时也保持输出 1，就得在休眠前调 retention 注册。

// 4522/4552：P0 输出高，并开启 retention static void gpio_retention_demo(void) { gpio_pin_e pin = P0; hal_gpioretention_register(pin); // 开启该脚 retention // hal_gpioretention_unregister(pin); // 需要关闭时调这个 hal_gpio_write(pin, 1); // 输出高电平 }

注意调用顺序：先注册 retention，再写输出值。如果先写值再注册，中间那段窗口期引脚状态可能已经被休眠流程改掉。手册还解释了 retention 存在的物理原因：没有它的时候，休眠后引脚靠输入态加上下拉电阻维持外部电路电平，驱动能力很弱，带不动负载；retention 就是为增强驱动能力加的。所以凡是休眠期间要驱动继电器、MOS 管栅极、传感器使能脚的场景，retention 基本是必选项。

3.3 上下拉电阻：四种配置与硬件默认值

每个 GPIO 支持四种上下拉：浮空（高阻）、强上拉（上拉到 AVDD33，150kΩ，驱动电流大）、弱上拉（上拉到 AVDD33，1MΩ，驱动电流小）、下拉（下拉到地，150kΩ）。

硬件默认值要记牢：P03、P24、P25 默认下拉，其他 GPIO 默认浮空。这个默认值直接影响复位瞬间的外部电路状态。比如你把某个使能信号接到默认浮空的脚上，复位到代码配置之间那段窗口，外部电路处于不确定态，可能被误触发。

// 4522/4552：P0 配输入 + 强上拉后读取 static void gpio_pull_demo(void) { gpio_pin_e pin = P0; volatile bool value; hal_gpio_pull_set(pin, GPIO_PULL_UP_S); // 强上拉，150kΩ hal_gpio_pin_init(pin, GPIO_INPUT); value = hal_gpio_read(pin); LOG("pin:%d value:%d\n", pin, value); }

参数选择上，强上拉适合需要一定驱动能力又要确定电平的输入，比如按键上拉；弱上拉省电，适合休眠期间维持电平；下拉用于低有效信号。选错上下拉强度的典型后果是休眠功耗偏高或者电平被外部电路拉翻。

3.4 中断与唤醒：触发条件必须和当前电平匹配

除 TEST_MODE、P16、P17 外所有 GPIO 都支持中断和唤醒。中断支持电平触发和边沿触发，唤醒只支持边沿触发。这里有个硬约束：GPIO 做唤醒源时，必须配置内部上拉或下拉，不能是高阻态。

手册的示例逻辑值得抄：先读当前电平，如果当前是 0，就配上升沿触发；当前是 1，就配下降沿触发。这样保证触发边沿一定是“变化”的方向，不会因为配置时电平已经处于触发态而立刻误触发。

// 4522/4552：P0 输入，注册双边沿中断/唤醒回调 void posedge_int_wakeup_cb(GPIO_Pin_e pin, IO_Wakeup_Pol_e type) { if (type == POSEDGE) { LOG("int or wakeup(pos):gpio:%d type:%d\n", pin, type); } } void negedge_int_wakeup_cb(GPIO_Pin_e pin, IO_Wakeup_Pol_e type) { if (type == NEGEDGE) { LOG("int or wakeup(neg):gpio:%d type:%d\n", pin, type); } } static void gpio_irq_wakeup_demo(void) { gpio_pin_e pin = P0; hal_gpioin_register(pin, posedge_int_wakeup_cb, negedge_int_wakeup_cb); }

hal_gpioin_register一次把上升沿和下降沿两个回调都挂上，回调里的type参数告诉你这次是哪个边沿。唤醒场景下，休眠前要根据当前电平设置唤醒极性，手册 4520/4550 的示例用phy_gpio_wakeup_set(pin, POL_RISING)或POL_FALLING，逻辑和中断一致：当前低就等上升沿，当前高就等下降沿。

3.5 FULLMUX 复用：用完一定要关使能

除 TEST_MODE、P16、P17、P1 外，其他 GPIO 都支持 FULLMUX，可复用成 UART、I2C、PWM、SPI、旋转编码器、DMIC、天线选择等。手册给了完整的 FULLMUX 取值表，从 0 到 37，比如 FMUX_UART0_TX=4、FMUX_UART0_RX=5、FMUX_PWM0=10、FMUX_SPI_0_SCK=16。

典型用法是把 P9、P10 复用成 UART0，波特率 115200：

// 4522/4552：P9 复用 UART0_TX，P10 复用 UART0_RX #define CONSOLE_TXD P9 #define CONSOLE_RXD P10 #define CONSOLE_TXD_FUNC FMUX_UART0_TX #define CONSOLE_RXD_FUNC FMUX_UART0_RX drv_pinmux_config(CONSOLE_TXD, CONSOLE_TXD_FUNC); drv_pinmux_config(CONSOLE_RXD, CONSOLE_RXD_FUNC);

手册特别强调：不使用时一定要关闭 FULLMUX 使能。这条不是客套话。复用使能没关，引脚被外设模块占着，你后面想把它当普通 GPIO 读写会失效，而且这种失效往往不报错，只是读回值不对，排查起来很费时间。

3.6 ANALOG 与 KSCAN：模拟脚和矩阵按键

ANALOG 模式只对 P11、P14、P15、P16、P17、P18、P20、P23、P24、P25 开放。用途分三类：32.768K 晶振（P16、P17）、VOICE（AMIC 用 P18 pga+、P20 pga-、P15 mic bias、P23 可选参考电压）、ADC（单端 P11/P23/P24/P14/P15/P20，差分 P18P25、P23P11、P14P24、P20P15）。做模拟采集时，先对照这张清单确认引脚支持哪种接法，别把单端信号接到只支持差分的组合上。

KSCAN 是内置硬件矩阵按键扫描，适合按键多的场景。手册的 4×4 例子用 4 根 row（mk_in[0..3] 对应 P0、P2、P15、P25）和 4 根 col（mk_out[0..3] 对应 P1、P3、P14、P24），支持 16 个按键，比常规一对一接法省一半 IO。按键时产生中断，把行列信息 mk_in[m]、mk_out[n] 的 m、n 报给上层。注意手册表 4 里 S16 写的是 row 4、col 3，而 4×4 矩阵 row 只有 0 到 3，这处应该是笔误，实际按 row 3、col 3 处理，抄表的时候别被带偏。

4. 避坑清单：五个让板子起不来的细节

这一节按“现象 → 原因 → 解决”整理，都是这份手册里点到、但实际调试中最容易翻车的地方。

现象一：休眠后继电器掉电、传感器使能失效。原因：GPIO 配了输出但没开 retention，休眠后引脚恢复默认输入态，输出电平丢失。解决：休眠流程前对需要保持的引脚调hal_gpioretention_register，并且先注册再写值。

现象二：配置了唤醒但系统睡下去就醒不来。原因：唤醒源引脚处于高阻态，边沿检测没有确定的参考电平。手册明确要求唤醒脚必须配内部上拉或下拉。解决：hal_gpio_pull_set配强上拉或下拉，再设唤醒极性，极性要和当前电平相反。

现象三：上电后程序不跑，连调试器也连不上。原因：TEST_MODE、P24、P25 的电平组合落进了 Program Mode 或 Scan Mode。解决：核对原理图这三个脚的外部上下拉，确保复位后组合是 {0,,}；如果确实需要进烧录模式，用 TEST_MODE=1、P24=0、P25=0 的组合。

现象四：复用成 UART 的脚后来当 GPIO 用，读写全不对。原因：FULLMUX 使能没关，引脚还被外设模块占着。解决：切换用途前先关 FULLMUX 使能，再按 GPIO 模式重新初始化方向和上下拉。

现象五：按键矩阵个别键识别错位。原因：KSCAN 的 mk_in/mk_out 编号和实际 GPIO 对应关系没查表 1，或者照抄了手册表 4 里 S16 那处笔误。解决：以表 1 的 mk_in/mk_out 与 GPIO 对应关系为准，逐键核对行列编号，S16 按 row 3、col 3 处理。

注意：P2、P3 接调试器时非调试功能受影响，如果这两个脚被复用成矩阵列线或外设，调试阶段和量产阶段的硬件配置要分开考虑。

5. 从手册到板子：一套可复用的验证顺序

手册给的是单点示例，真正落到板子上，我一般按固定顺序走一遍，能把大部分问题挡在量产前。这套顺序的核心思路是：先确认引脚身份，再确认电平状态，最后才验证功能。

第一步，拿到原理图后先做引脚清单核对。把每个用到的引脚对着表 1 填四列：默认方向、是否支持唤醒、是否支持 FULLMUX、是否支持 ANA。填完立刻能看出两类问题——把模拟脚当数字脚用的，把不支持复用的 P1 规划成 UART 的。这一步纯纸面工作，十分钟能省两天调试。

第二步，上电后先不跑业务代码，用最小程序把每个关键引脚的方向和上下拉配好，逐个读回电平，和原理图预期比对。特别是默认浮空的脚，确认外部电路在复位窗口期不会误动作。这一步能抓出上下拉强度和外部电阻分压不匹配的问题。

第三步，单独验证 retention。让系统进一次休眠再唤醒，用万用表或示波器量保持脚的电平，确认休眠期间没有掉。别只在代码里看寄存器值，寄存器对不代表引脚对。

第四步，验证唤醒链路。把唤醒极性按“当前电平取反”的原则配好，然后人为制造边沿，确认回调被调用、type参数正确。这里常见的翻车是回调挂了但极性配反，边沿来了不触发，或者一配好就立刻触发一次。

第五步，FULLMUX 和外设联调。复用配置完先做回环测试，UART 自发自收、SPI 短接 MOSI/MISO，确认复用通道通了再接外部器件。用完记得关使能，把这条写进代码规范。

这套顺序里，第三步和第四步是最容易被跳过、也最容易在客户现场爆雷的。血泪经验是：retention 和唤醒这两件事，代码跑通不等于板子跑通，必须上仪器量。从那以后我每次做低功耗板子，都会把这张表打印出来贴在工位上，逐项打勾才允许进下一阶段。希望帮到你。

本文还有配套的精品资源，点击获取