GPIO 数字输出

type 12 用于输出高低电平，例如指示灯、继电器控制输入和有源蜂鸣器。GPIO 不能直接供电给电机、继电器线圈或大电流负载，应使用符合模块电平和电流要求的驱动电路。

配置与初始状态

下面是低电平有效继电器的禁用草稿，GPIO26 仅为经典 ESP32 的接线示例：

json

{
  "id": "relay1",
  "name": "低电平有效继电器",
  "type": 12,
  "enabled": false,
  "pinCount": 1,
  "pins": [26],
  "params": { "initialState": 1 }
}

initialState: 0 是低电平，1 是高电平。低电平有效模块通常以高电平释放；实际电路、常开/常闭触点和负载状态须实测。该字段决定启用初始化时的输出，不保证上电至固件接管前的电平。普通数字输出无需添加 PWM 参数，也没有通用 invert 参数改变物理电平语义。

保存禁用草稿，检查接线和资源，再单独启用并测量输出。开发者模式默认关闭，写配置及手动输出前按页面要求使用当前密码启用；已有设备保留自己的设置。

低电平有效继电器的释放动作：

json

{
  "targetPeriphId": "relay1",
  "actionType": 0,
  "actionValue": "",
  "useReceivedValue": false,
  "syncDelayMs": 0,
  "execMode": 0
}

呼吸动作需要 PWM 输出，不能把普通数字输出当作调光输出。无源蜂鸣器需要 passive 模式和 PWM 参数，其受检控制路径见无源 PWM 控制。

普通数字输出由既有资源仲裁及受检写入处理。写入失败不能报告成功；失败清理可能保留消费者与 cleanupPending 记录，禁用并不总意味着资源已经释放。页面状态表示软件确认的设置结果，不能代替电平、触点或负载反馈。

引脚允许范围受芯片、Flash/PSRAM、板级保留资源及运行时占用共同限制，不能套用另一芯片的编号。接线与资源说明见外设配置指南及外设管理。