识别条件#
项目明确使用立创·天猛星,或 .syscfg、封装信息与板卡资料相互印证。
LQFP-64 开发板,常见板载 OLED、LSM6DS3 IMU、WS2812、无线模块、蜂鸣器和编码器。
系统引脚与板载资源#
下表由 boards/tianmengxing.json 自动生成。级别为 blocked 的引脚不可分配,confirm 需要用户确认,release 需要先确认板载功能已释放。
| 引脚 | 功能 | 级别 | 注意事项 |
|---|---|---|---|
| PA3 | 32.768 kHz LFXT 晶振 | blocked | 使用低频晶振时保留,不得分配给普通外设。 |
| PA4 | 32.768 kHz LFXT 晶振 | blocked | 使用低频晶振时保留,不得分配给普通外设。 |
| PA5 | 40 MHz HFXT 晶振 | blocked | 不得分配给普通外设。 |
| PA6 | 40 MHz HFXT 晶振 | blocked | 不得分配给普通外设。 |
| PA19 | SWDIO | blocked | 保留调试接口。 |
| PA20 | SWCLK | blocked | 保留调试接口。 |
| PA18 | BSL 入口/按键 | confirm | 复位时拉高会进入 BSL;输出复用前必须确认上电电平。 |
| PA10, PA11 | UART0 / CH340E | confirm | 板载串口共享引脚。 |
| PA27, PA28 | LSM6DS3 IMU I2C | confirm | 复用前确认 IMU 是否仍需使用。 |
| PB6, PB7, PB8, PB9 | 板载 SPI Flash | confirm | 复用前确认 Flash 是否仍需使用。 |
| PB17, PB18 | 无线模块 UART7 | confirm | 复用前确认无线模块是否仍需使用。 |
| PB21 | ENTER 按键,低有效 | confirm | 注意上拉和按键状态。 |
| PB22 | 板载 LED,低有效 | confirm | 低电平点亮,常用 PWM/GPIO 示例引脚。 |
| PB23 | 无线链路状态输入 | confirm | 注意输入默认电平。 |
| PB26 | WS2812 RGB / TIMA1 CCP0 | confirm | 复用会影响板载 RGB。 |
| PB27 | 蜂鸣器 / TIMG6 CCP1 | confirm | 复用会影响板载蜂鸣器。 |
| PA29, PA30 | QEI 编码器 PHA/PHB | release | 可释放,但应先确认编码器是否使用。 |
| PA31 | 编码器按键 | release | 可释放,但应先确认编码器是否使用。 |
选择引脚的规则#
优先排除 blocked 引脚;对 confirm 和 release 引脚,必须先说明板载功能和复用影响,再根据用户确认继续。自定义板的真实连接以用户原理图和当前 .syscfg 为准。
验证要求#
修改引脚后运行 python scripts/check_syscfg.py