Skip to main content

System Management Actions

fastbeeAbout 3 min

System Management 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

  • System Management 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.

系统管理动作

动作类型

动作actionType说明
ACTION_SYS_RESTART6系统重启
ACTION_SYS_FACTORY_RESET7恢复出厂设置
ACTION_SYS_NTP_SYNC8NTP 时间同步
ACTION_SYS_OTA9OTA 升级

配置示例

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

外设执行页面如下。系统动作会影响设备状态，保存前重点核对触发条件，避免误重启、误恢复出厂或误触发 OTA。

示例1：系统重启

场景：平台下发重启命令后延时500ms重启

配置步骤：

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

  2. 点击 添加动作 按钮

  3. 填写动作配置：

    字段填写内容说明
    动作类型选择 系统重启重启设备
    执行延时500延时500ms让前置动作完成

  4. 点击 保存 按钮

💡 提示：系统重启强制同步执行，建议设置500ms延时让MQTT消息发送完毕

示例2：恢复出厂设置

场景：按键长按10秒后恢复出厂设置

配置步骤：

  1. 编辑规则，添加动作

  2. 填写：

    • 动作类型：选择 恢复出厂设置
    • 执行延时：0

  3. 点击 保存

⚠️ 警告：恢复出厂设置会将所有配置文件重置为默认值（device.json, network.json, protocol.json, users.json, roles.json, peripherals.json, periph_exec.json），WiFi 凭据将被清除，设备重启后进入 AP 模式，此操作不可逆！

示例3：NTP 时间同步

场景：定时触发NTP时间同步

配置步骤：

  1. 编辑规则，添加动作

  2. 填写：

    • 动作类型：选择 NTP时间同步

  3. 点击 保存

💡 提示：每日时间点触发模式需要NTP同步成功才会生效

示例4：OTA 升级

场景：平台下发升级命令后触发OTA

配置步骤：

  1. 编辑规则，添加动作

  2. 填写：

    • 动作类型：选择 OTA升级

  3. 点击 保存

💡 提示：OTA升级需要网络连接和预配置的OTA服务器地址

方式2：JSON配置文件导入

完整规则示例

按键长按 10 秒恢复出厂

{
  "id": "exec_factory_reset",
  "name": "长按恢复出厂",
  "enabled": false,
  "execMode": 0,
  "triggers": [
    {
      "triggerType": 4,
      "triggerPeriphId": "btn1",
      "operatorType": 0,
      "compareValue": "",
      "timerMode": 0,
      "intervalSec": 60,
      "timePoint": "",
      "eventId": "button_long_press_10s",
      "pollResponseTimeout": 1000,
      "pollMaxRetries": 2,
      "pollInterPollDelay": 100
    }
  ],
  "actions": [
    {
      "targetPeriphId": "",
      "actionType": 7,
      "actionValue": "",
      "useReceivedValue": false,
      "syncDelayMs": 0,
      "execMode": 0
    }
  ],
  "protocolType": 0,
  "scriptContent": "",
  "reportAfterExec": false
}

注意事项

  1. 同步强制：系统重启和恢复出厂动作强制同步执行，不进异步队列
  2. 不可逆：恢复出厂设置会重置所有用户配置为默认值，谨慎使用
  3. 恢复内容：
    • device.json - 恢复默认设备名和 NTP 配置
    • network.json - 清除 WiFi 凭据，恢复 AP 模式（SSID: fastbee-ap，密码: 12345678）
    • users.json - 恢复默认用户（admin/viewer）
    • roles.json - 恢复默认角色权限
    • protocol.json - 所有协议禁用
    • peripherals.json - 清空外设配置
    • periph_exec.json - 清空执行规则
  4. 重启前延时：建议设置 syncDelayMs 让 MQTT 消息发送完毕后再重启
  5. OTA 前提：OTA 需要网络连接和有效的升级服务器
fastbee
Copyright © 2026 fastbee