GPIO 数字输入

数字输入用于按键、开关、门磁及输出数字电平的传感器；电平必须满足目标芯片的输入要求。GPIO 与模块共地，电源脚和信号脚分别连接，5V 输出先确认电平转换。

类型与参数

type	功能
11	普通数字输入
13/14	上拉/下拉输入
18/19/20	上升沿/下降沿/电平变化中断输入
49	雷达数字输入，带雷达状态处理
21	触摸输入枚举预留，当前没有通用初始化实现

{
  "id": "button1",
  "name": "上拉按键",
  "type": 13,
  "enabled": false,
  "pinCount": 1,
  "pins": [25],
  "params": {
    "inputMode": 2,
    "invertLogic": true,
    "debounceMs": 50,
    "reportMode": 0
  }
}

示例 GPIO25 仅适用于核对后的板卡。按键一端连接 GPIO，另一端连接 GND；invertLogic: true 把低电平按下映射成逻辑高。不要将上拉按键直接连到 5V。

字段	语义
inputMode	0=按类型自动、1=浮空、2=上拉、3=下拉
invertLogic	用户逻辑值反相；中断边沿按逻辑电平匹配
debounceMs	消抖时间；0 使用安全默认 50ms
reportMode	0=变化上报、1=周期上报、2=仅规则事件
pairedInputId、pairDebounceMs	互补输入配对，按页面要求在一侧配置

软件消抖不能取代必要的硬件滤波、屏蔽及电平保护。上拉/下拉能力与输入专用引脚限制按目标芯片和板级资源核对。

读取与联动

保存禁用草稿后检查接线，再启用，确认输入变化和日志。通过外设执行的 GPIO/事件触发器实现联动，平台触发器响应云端下发，不等同于本地输入变化。不同触发器的比较值与数据格式见 外设执行。

IO 扩展器子通道使用 ioSource、providerId、channel；该通道号不是本地 GPIO，引脚与功能限制不能套用原生 GPIO 中断能力。启用父驱动、子外设和运行时功能均成功后才可读取。

禁用后若受检清理失败，资源登记可能保留。外设列表状态和资源占用说明见 外设管理。