ReefBeat 技能

对 Red Sea ReefBeat 设备的直接 HTTP 控制。完整 API 参考见 references/api.md。

快速开始

python3 scripts/reefbeat.py discover /24   # 查找所有设备
python3 scripts/reefbeat.py  info                   # 设备信息及型号
python3 scripts/reefbeat.py  status                 # 获取 /dashboard 数据
python3 scripts/reefbeat.py  get /endpoint
python3 scripts/reefbeat.py  post /endpoint '{"key":"value"}'
python3 scripts/reefbeat.py  put /endpoint '{"key":"value"}'

设备发现

运行设备发现命令，自动查找本地网络中的所有 ReefBeat 设备：

python3 scripts/reefbeat.py discover /24

按请求类型划分的常用操作

ReefLED — 照明控制

# 查询当前灯光状态
python3 scripts/reefbeat.py  get /manual

# 设置白光/蓝光强度（G1 型号：RSLED90）
python3 scripts/reefbeat.py  post /manual '{"white": 60, "blue": 80}'

# 启动定时手动模式（30 分钟后自动恢复原计划）
python3 scripts/reefbeat.py  post /manual '{"white": 60, "blue": 80, "duration": 30}'

# 切换月相模式
python3 scripts/reefbeat.py  post /moonphase '{"enabled": true, "moon_day": 14}'

# 启动渐进式光照适应（Acclimation）
python3 scripts/reefbeat.py  post /acclimation '{"enabled": true, "duration": 50, "start_intensity_factor": 30}'

# 查看周一（第 1 天）的自动计划
python3 scripts/reefbeat.py  get /auto/1

# 关闭 LED 灯 / 恢复计划运行
python3 scripts/reefbeat.py  delete /off

ReefRun — 水泵 / 蛋白质分离器

# 查询水泵状态
python3 scripts/reefbeat.py  status
python3 scripts/reefbeat.py  get /pump/settings

# 手动开关水泵（由 schedule_enabled 字段控制）
python3 scripts/reefbeat.py  put /pump/settings 
  '{"pump_2": {"id":2,"name":"skimmer","type":"skimmer","model":"rsk-300","sensor_controlled":true,"schedule_enabled":false,"schedule":[{"st":0,"ti":0,"pd":0}]}}'

# 将回流泵强度设为 70%
python3 scripts/reefbeat.py  put /pump/settings 
  '{"pump_1": {"id":1,"name":"Return pump","type":"return","model":"return-6","sensor_controlled":false,"schedule_enabled":true,"schedule":[{"st":0,"ti":70,"pd":0}]}}'

# 切换过量刮藻保护（over-skimming protection）
python3 scripts/reefbeat.py  put /pump/settings 
  '{"overskimming": {"enabled": true, "threshold": 10}}'

ReefATO+ — 自动补液系统

# 查询 ATO 状态（液位、温度、补液次数等）
python3 scripts/reefbeat.py  status
python3 scripts/reefbeat.py  status

# 在异常或 pump_timeout 后恢复运行
python3 scripts/reefbeat.py  post /resume

# 启用 / 禁用自动补液
python3 scripts/reefbeat.py  put /configuration '{"auto_fill": true}'

# 手动启动 / 停止补液
python3 scripts/reefbeat.py  post /manual-pump
python3 scripts/reefbeat.py  post /stop

# 设置储水罐容积（单位：mL）
python3 scripts/reefbeat.py  post /update-volume '{"volume": 10000}'

ReefMat — 过滤滚筒

# 查询滚筒状态
python3 scripts/reefbeat.py  status   # 水族箱 1 的滚筒
python3 scripts/reefbeat.py  status   # 水族箱 2 的滚筒

# 手动推进滚筒
python3 scripts/reefbeat.py  post /advance

# 注册全新滚筒（ReefMat250，最大外径 11.1 cm）
python3 scripts/reefbeat.py  post /new-roll 
  '{"external_diameter": 11.1, "name": "New Roll", "thickness": 0.3, "is_partial": false}'

# 注册已使用过的滚筒
python3 scripts/reefbeat.py  post /new-roll 
  '{"external_diameter": 8.5, "name": "Started Roll", "thickness": 0.3, "is_partial": true}'

# 切换自动推进功能
python3 scripts/reefbeat.py  put /configuration '{"auto_advance": true}'

ReefWave — 涌浪泵

# 查询涌浪泵状态
python3 scripts/reefbeat.py  status

# 启动预览模式（交替模式：前进 5 分钟 / 后退 5 分钟，强度 80%，总时长 5 分钟）
python3 scripts/reefbeat.py  post /preview 
  '{"type":"st","frt":5,"rrt":5,"fti":80,"rti":80,"duration":300000,"sn":5,"pd":10}'

# 停止并保存当前预览设置
python3 scripts/reefbeat.py  delete /preview

快捷操作（适用于所有设备）

# 启动喂食模式
python3 scripts/reefbeat.py  post /maintenance   # 或 /emergency

# 结束维护模式
python3 scripts/reefbeat.py  delete /maintenance

网络行为说明

• 自动发现（discover 命令）会打开一个 UDP socket 连接至 8.8.8.8（不发送任何数据，此为检测本机网络接口的标准方法），随后在指定子网内主动通过 HTTP 请求 /device-info 和 /description.xml 探测所有主机。完成接口识别后，其余探测过程完全限定于本地网络范围内。
• 本技能不执行任何云端身份验证，也不调用外部 API。
• 所有设备控制均基于本地 HTTP（端口 80，无需认证）。

注意事项

• G1 系列 LED（RSLED50/90/160）：支持白光 + 蓝光双通道调节（0–100%）
• G2 系列 LED（RSLED60/115/170）：支持色温（10000–20000 K）与亮度（0–100%）独立调节
• ReefDose 配置类请求耗时约为 7–9 秒，属正常现象
• ReefWave 的本地设置变更将与官方 App 显示不同步，此为预期行为
• ATO 出现 pump_timeout 或 malfunction 状态后，需发送 POST 请求至 /resume 清除错误
• 修改水泵配置前，请务必先读取 /pump/settings，以确保未修改字段得以保留