创客工坊设备照明管理：怎样将1路照明控制开关集成到项目中_解决方案

CATALOG

创客工坊对照明控制的需求往往不只是“开”和“关”——焊接工位需要防烫保护、3D打印 enclosure 需要定时断电、调试时需要脉冲式通断测试。芯步的1路智能墙壁开关配合开放HTTP接口，正好可以用低成本方式把这些场景需求落地。以下是完整的集成方案：

创客工坊设备照明管理：集成“1路照明控制开关”解决方案

一、背景与选型

在创客工坊（Makerspace）中，工作工位、3D打印区或焊接台通常需要独立的照明及设备电源管理。传统机械开关无法实现远程控制和自动化联动。

选用设备： 芯步 智能墙壁开关1路 （86型标准安装）。推荐理由：

零改动替换：可直接替换工位原有墙壁开关，支持 220V 市电直连。
双控兼容：具备“状态保持”功能，适合工位上既有物理按键习惯，又需远程干预的场景。
接口开放：提供标准 HTTP API，支持局域网（LAN）和公网控制，适合集成到创客自建的 Home Assistant、Node-RED 或自写 Python/Node.js 控制台中。

二、硬件连接与部署

在开始软件集成前，需完成基础的硬件安装与配网。

接线安装
- 零火线接法：通常“L”接火线，“N”接零线，“L1”接照明灯或工位插座的火线。
- 注意：若控制220V交流设备（如风扇、小机床），请确保负载功率不超过开关额定功率。
设备配网
- 下载“芯步”小程序或登录物联网控制台。
- 将设备设置为配网模式（长按开关5秒直至指示灯闪烁）。
- 通过“登记网络”功能，将设备连接到工坊的 2.4G WiFi 网络。
获取凭证
- 在控制台的“设备列表”中获取该开关的唯一标识符：Device ID（如：1000456789）。
- 获取 AppID、sign（签名）和 ts（时间戳）的生成规则，这是后续 API 调用的钥匙。

三、核心 API 接口详解

开关集成到项目的核心是通过 HTTP 协议下发 order 命令。接口地址格式如下：

POST https://api.thingboot.com/{AppId}/device/control/?sign={sign}&ts={ts}

请求体（JSON）参数说明

参数	类型	说明	示例值
`device`	String	设备的唯一ID	`"1000456789"`
`order`	Object	控制指令（JSON对象）	`{"power1":"1"}`

order 详细指令表（针对1路开关）：

功能场景	指令内容	JSON 示例	适用场景
基础开关	线路1 开启	`{"power1":"1"}`	开启照明或通用插座
线路1 关闭	`{"power1":"0"}`	离开工位时关闭
创客专用：点动模式	先通后断（脉冲）	`{"point1":"2000"}`	3D打印机排烟：开启2秒后自动关
先断后通（复位）	`{"reset1":"1000"}`	警报测试：先断电1秒再重启
防误触模式	锁定保持开	`{"power1":{"keep":"1","revert":"3"}}`	公共区域展示：用户手动关灯，3秒后自动强制开启
锁定保持关	`{"power1":{"keep":"0","revert":"5"}}`	危险区域：用户误开，5秒后自动关闭

四、项目集成实战（代码级）

创客们可以根据自己擅长的语言，将上述接口封装成驱动模块。

1. Python 集成（适用于 Raspberry Pi / Orange Pi 控制中心）

import requests
import time
import hashlib

class YoyoSwitch:
    def __init__(self, app_id, device_id, sign_key):
        self.app_id = app_id
        self.device_id = device_id
        self.sign_key = sign_key
        self.base_url = f"https://api.thingboot.com/{app_id}/device/control/"

def _gen_sign(self):
        # 简化逻辑:实际需按官方文档生成 sign + ts
        ts = int(time.time())
        sign = hashlib.md5(f"{self.sign_key}{ts}".encode()).hexdigest()
        return ts, sign

def control(self, action="on", mode="basic", delay_ms=0):
        ts, sign = self._gen_sign()
        url = f"{self.base_url}?sign={sign}&ts={ts}"
        
        if mode == "pulse":  # 点动脉冲模式
            order = {"point1": str(delay_ms)}
        elif mode == "lock":  # 锁定保持模式
            order = {"power1": {"keep": "1" if action == "on" else "0", "revert": str(delay_ms//1000)}}
        else:  # 普通模式
            order = {"power1": "1" if action == "on" else "0"}

payload = {"device": self.device_id, "order": order}
        response = requests.post(url, json=payload)
        return response.status_code

# 使用示例
switch = YoyoSwitch("AppID_123", "Device_456", "YourKey")
switch.control("on")                     # 开启照明
switch.control("off", mode="pulse", delay_ms=5000)  # 关闭，若是有人打开，5秒后自动再关

2. 微信小程序集成（移动端便捷管理）通过小程序调用云函数或直接 HTTPS 请求，可以实现工坊移动端控制面板。

3. Shell 脚本（快速测试与自动化）适合通过 crontab 定时任务控制工位电源。

五、进阶玩法：传感器联动

结合芯步生态中的“智能人体存在传感器”或温湿度传感器，可以构建更聪明的创客工坊环境。

第一种场景：人来灯亮，人走延时灭
- 逻辑设定：利用 Node-RED 或自建 Python 脚本接收传感器的“有人/无人”状态。
- 执行：当传感器上报 {"radar_enable":"1"}（检测到人）时，脚本自动调用上述 API 下发 {"power1":"1"}；当上报无人且超过 5 分钟，下发 {"power1":"0"}。
- 价值：解决创客专注于项目时忘记关灯关风扇的能源浪费问题。
第二种场景：3D 打印机联动排烟
- 逻辑设定：通过 OctoPrint 插件（或打印机 GPIO）检测打印完成状态。
- 执行：打印完成 -> HTTP 请求 -> 下发 {"point1":"30000"} —— 开启排风扇吹 30 秒后自动关闭，既散热又省电。

六、总结

通过集成芯步 1 路智能开关，创客工坊的照明管理从单纯的“通断”升级为“可编程、可触发、可自治”的智能系统。该方案的优点是：

低成本：无需购买昂贵的 PLC 或复杂继电器模组，直接用 WiFi 模块连接。
高灵活性：无论是点动脉冲（point1）用于测试，还是状态保持用于公共区域，API 均已覆盖。
私有化潜力：若工坊对数据安全有要求，芯步产品支持纯局域网运行，可将 API 请求指向本地服务器，完全脱离外网。

创客可以利用这些接口，快速将物理开关上云，从而有更多精力聚焦于核心项目的创造。