Skip to main content

GPIO Output Actions

fastbeeAbout 3 min

GPIO Output Actions

Synchronized Device Documentation

This page corresponds to the synchronized Chinese source. Commands, JSON examples, API paths, field names, and screenshots are kept aligned with the Chinese device-side source documentation.

What This Page Covers

  • GPIO Output Actions context and expected reader workflow.
  • Configuration, verification, and release-readiness details.
  • Source-aligned implementation notes, screenshots, and troubleshooting references.

Source Reference

The detailed operational source is preserved below so implementation details stay exact while the English navigation, titles, and reading path remain available.

GPIO 输出动作

概述

GPIO 输出动作用于控制数字输出外设（继电器、LED、蜂鸣器等）的电平状态和灯效。

动作类型

动作actionType说明
ACTION_HIGH0设置高电平
ACTION_LOW1设置低电平
ACTION_HIGH_INVERTED13逻辑高（物理低电平）
ACTION_LOW_INVERTED14逻辑低（物理高电平）
ACTION_BLINK2闪烁（actionValue=间隔ms）
ACTION_BREATHE3呼吸灯（actionValue=周期ms）

参数说明

字段说明
targetPeriphId目标 GPIO 输出外设 ID
actionType动作类型编号
actionValue动作参数（闪烁间隔/呼吸周期，单位ms）
useReceivedValuetrue 时用触发接收值替代 actionValue
syncDelayMs执行前延时（ms，最大 10000）

配置示例

方式1：Web界面配置（推荐）

外设执行页面如下。GPIO 动作配置时重点核对目标外设、有效电平和是否需要反转模式。

示例1：输出高电平（开灯/开继电器）

场景：打开继电器或LED灯

配置步骤：

  1. 在外设执行管理页面编辑规则

  2. 点击 添加动作 按钮

  3. 填写动作配置：

    字段填写内容说明
    动作类型选择 高电平输出高
    目标外设选择 relay1GPIO输出外设
    执行延时0立即执行

  4. 点击 保存 按钮

示例2：输出低电平（反转模式，适合低电平触发继电器）

场景：控制低电平触发的继电器模块

配置步骤：

  1. 编辑规则，添加动作

  2. 填写：

    • 动作类型：选择 逻辑高（反转）
    • 目标外设：选择 relay1
    • 说明：逻辑“开”，物理输出LOW

  3. 点击 保存

💡 提示：低电平触发继电器模块需要反转模式，逻辑“开”对应物理LOW

示例3：LED 闪烁（500ms 间隔）

场景：报警时LED闪烁提示

配置步骤：

  1. 编辑规则，添加动作

  2. 填写：

    • 动作类型：选择 闪烁
    • 目标外设：选择 led1
    • 闪烁间隔：填写 500（500毫秒）

  3. 点击 保存

示例4：呼吸灯（2秒周期）

场景：LED柔和渐变效果

配置步骤：

  1. 编辑规则，添加动作

  2. 填写：

    • 动作类型：选择 呼吸灯
    • 目标外设：选择 led_pwm（需PWM输出外设）
    • 呼吸周期：填写 2000（2000毫秒=2秒）

  3. 点击 保存

💡 提示：呼吸灯需要PWM输出外设（type: 17），普通数字输出不支持

方式2：JSON配置文件导入

反转模式说明

对于低电平触发的继电器模块：

  • 开启继电器 = 物理低电平 → 使用 ACTION_HIGH_INVERTED(13)（逻辑"开"，物理LOW）
  • 关闭继电器 = 物理高电平 → 使用 ACTION_LOW_INVERTED(14)（逻辑"关"，物理HIGH）

注意事项

  1. 外设类型匹配：targetPeriphId 必须指向 GPIO_DIGITAL_OUTPUT(12) 类型的外设
  2. 闪烁/呼吸前提：需要外设支持 PWM 功能（闪烁可用于纯数字输出，呼吸需 PWM）
  3. 延时编排：通过 syncDelayMs 实现多动作顺序执行的时序控制
fastbee
Copyright © 2026 fastbee