GPIO 开发参考

本文档深入介绍 GPIO 外设开发中的优化策略和高级功能，是 GPIO 配置教程 的进阶补充。

GPIO 表结构

GPIO 配置界面以表格形式呈现，表头定义了每一列的类型和行为：

{
  name: {
    label: 'Pin',
    type: 'text'              // 文本类型，只读
  },
  user_label: {
    label: 'User Label',
    type: 'input',            // 输入框，用户可编辑
    placeholder: 'Enter label'
  },
  mode: {
    label: 'Mode',
    type: 'select',
    options: [
      { label: 'analog input', value: 'AIN' },
      { label: 'floating input', value: 'IN_FLOATING' },
      { label: 'pull-down input', value: 'IPD' },
      { label: 'pull-up input', value: 'IPU' },
      { label: 'output open-drain', value: 'OUT_OD' },
      { label: 'output push-pull', value: 'OUT_PP' },
      { label: 'alternate open-drain', value: 'AF_OD' },
      { label: 'alternate push-pull', value: 'AF_PP' },
      { label: 'IT Rising Edge', value: 'IT_Rising' },
      { label: 'IT Falling Edge', value: 'IT_Falling' },
      { label: 'IT Both Edge', value: 'IT_Both' },
      { label: 'Event Rising Edge', value: 'EVT_Rising' },
      { label: 'Event Falling Edge', value: 'EVT_Falling' },
      { label: 'Event Both Edge', value: 'EVT_Both' },
      { label: 'n/a', value: 'NA' }
    ]
  },
  speed: {
    label: 'Speed',
    type: 'select',
    options: [
      { label: '10MHZ', value: 'GPIO_OSPEED_10MHZ' },
      { label: '2MHZ', value: 'GPIO_OSPEED_2MHZ' },
      { label: '50MHZ', value: 'GPIO_OSPEED_50MHZ' },
      { label: 'n/a', value: 'NA' }
    ]
  },
  level: {
    label: 'OutputLevel',
    type: 'select',
    options: [
      { label: 'Low', value: 'Low' },
      { label: 'High', value: 'High' },
      { label: 'n/a', value: 'NA' }
    ]
  },
  alternate: {
    label: 'Alternate',
    type: 'text'              // 显示复用功能名称
  }
}

手动选择引脚

当用户手动点击引脚并选择复用功能时，系统调用 headPeripheralPinAf 函数。

函数签名

headPeripheralPinAf(pin, af)

参数说明

pin — 引脚对象：

{
  dir: 'left',
  num: 4,
  name: 'PE5',
  port: 'GPIOE',
  pin: 'GPIO_PIN_5',
  af: [
    { name: 'Reset_State', value: '-1' },
    { name: 'GPIO_Input', value: 'GPIO_Input' },
    { name: 'GPIO_Output', value: 'GPIO_Output' },
    { name: 'SYS_TRACED2', value: 'GPIO_ALTERNATE_TRACED2' },
    { name: 'TIM8_CH0', value: 'GPIO_REMAP_TIM8_CH0' }
  ]
}

af — 复用功能对象：

{
  name: 'GPIO_Output',
  value: 'GPIO_Output'
}

处理逻辑

headPeripheralPinAf(pin, af) {
  // 1. 如果是 Reset_State
  if (af.name === 'Reset_State') {
    // 从 GPIO 表中删除该引脚
    // 引脚视图恢复为未选择状态
    return
  }

  // 2. 获取该复用功能的默认参数
  const params = getPinParameter(af)

  // 3. 如果该复用功能是唯一的（不支持多引脚）
  if (isUniqueAlternate(af)) {
    // 删除原来绑定该功能的引脚
    deletePinByAlternate(af.name)
  }

  // 4. 更新当前引脚的复用功能
  updatePinByAlternate(pin, af)
}

自动选择引脚

系统通过 auto_set_pins 函数自动管理引脚：

auto_set_pins(target, name) {
  if (target) {
    // 启用外设功能时
    // 查找支持该功能的空闲引脚并自动添加
    addPinByAlternate(name)
  } else {
    // 禁用外设功能时
    // 删除未锁定的引脚
    if (!hasPinByAlternate(name)) return
    const pins = getPinsByAlternate(name)
    pins.forEach(pin => {
      if (!pin._locked) {
        deletePinByName(pin.name)
      }
    })
  }
}

GPIO 数据合并

在生成初始化代码时，相同 PORT 且配置相同的引脚可以合并为一条语句。

合并规则

合并条件（所有条件必须同时满足）：

1. 引脚属于相同 PORT（如都在 GPIOE）
2. Mode 相同
3. Speed 相同

以下字段不影响合并判断：

• User Label
• Level
• Alternate

合并效果对比

不合并（每个引脚单独初始化）：

gpio_init(GPIOE, GPIO_MODE_OUT_OD, GPIO_OSPEED_10MHZ, GPIO_PIN_2);
gpio_init(GPIOE, GPIO_MODE_OUT_OD, GPIO_OSPEED_10MHZ, GPIO_PIN_3);
gpio_init(GPIOE, GPIO_MODE_OUT_OD, GPIO_OSPEED_10MHZ, GPIO_PIN_4);

合并后（合并为一条）：

gpio_init(GPIOE, GPIO_MODE_OUT_OD, GPIO_OSPEED_10MHZ,
          GPIO_PIN_2 | GPIO_PIN_3 | GPIO_PIN_4);

合并优化方向

不同芯片的合并规则可能不同（PORT 固定），可以指定用于判断合并规则的参数：

// 可配置的合并规则
mergeRules: {
  required: ['port', 'mode', 'speed'],  // 必须相同的字段
  ignored: ['user_label', 'level', 'alternate']  // 忽略的字段
}

用户标签宏

GPIO 的用户标签用于对引脚进行宏定义，提高代码可读性：

示例场景

PE2 → LED1 灯控制
PE3 → LED2 灯控制
PE4 → LED3 灯控制

生成的宏定义

#define LED1_Port GPIOE
#define LED1_Pin  GPIO_PIN_2

#define LED2_Port GPIOE
#define LED2_Pin  GPIO_PIN_3

#define LED3_Port GPIOE
#define LED3_Pin  GPIO_PIN_4

代码中的应用

// 使用宏替代硬编码
gpio_init(LED1_Port, GPIO_MODE_OUT_OD, GPIO_OSPEED_10MHZ, LED1_Pin);
gpio_init(LED2_Port, GPIO_MODE_OUT_OD, GPIO_OSPEED_10MHZ, LED2_Pin);
gpio_init(LED3_Port, GPIO_MODE_OUT_OD, GPIO_OSPEED_10MHZ, LED3_Pin);

// 合并后也可使用宏
gpio_init(GPIOE, GPIO_MODE_OUT_OD, GPIO_OSPEED_10MHZ,
          LED1_Pin | LED2_Pin | LED3_Pin);

get_ip_gpios 函数详解

这是 GPIO 数据生成的核心函数，内部执行以下步骤：

function get_ip_gpios(gpioTypes) {
  // 1. 根据 gpioTypes 过滤所有符合要求的引脚
  const filtered = filterPinsByType(allPins, gpioTypes)

  // 2. 生成引脚描述数据（用于代码注释）
  const pins_des = generatePinDescriptions(filtered)

  // 3. 根据 PORT 分组
  const portGroups = groupByPort(filtered)

  // 4. 对相同 PORT 下的引脚按配置分组
  const configGroups = portGroups.map(group =>
    groupPinsByConfig(group.pins)
  )

  // 5. 检查是否有 EXTI 中断
  const has_exti = checkEXTI(configGroups)

  // 6. 生成初始化代码数据
  const initData = generateInitData(configGroups)

  return {
    has_exti: has_exti,
    has_gpio: filtered.length > 0,
    ports: Object.keys(portGroups),
    pins: configGroups,
    pins_des: pins_des,
    resetPins: generateResetPins(configGroups),
    setPins: generateSetPins(configGroups)
  }
}

set_gpio_define_map 函数

将 GPIO 参数转换为特定固件平台的宏定义：

function set_gpio_define_map(defineMap, firmware, pins) {
  pins.forEach(pin => {
    // 根据固件类型映射 mode
    pin.mode = defineMap.GPIO.mode[pin.mode] || pin.mode

    // 根据固件类型映射 speed
    pin.speed = defineMap.GPIO.speed[pin.speed] || pin.speed
  })
}

EXT1 中断配置

当引脚配置了中断模式（IT_Rising、IT_Falling、IT_Both）时，需要额外生成 EXTI 配置代码：

// EXTI 中断配置
if (has_exti) {
  // 生成中断线配置
  const extiLines = getEXTILines(pins)
  // 生成 NVIC 配置
  const nvicConfig = getNVICConfig(extiLines)
}