modischfabrications/mqtt_switcher

MQTT_Switcher 镜像文档

镜像概述

MQTT_Switcher是一个基于Docker的服务，用于通过MQTT消息触发433MHz无线电插座。该服务仅运行在树莓派或具有相同GPIO访问能力和库支持的类似设备上，通过解析MQTT消息并控制GPIO连接的433MHz发射器模块，实现对远程控制插座的开关操作。

核心功能与特性

• MQTT消息解析：接收指定MQTT主题消息，触发433MHz信号发送
• GPIO控制：通过树莓派GPIO接口控制433MHz发射器模块
• 配置文件支持：通过config.yml自定义无线电插座编码，适配不同品牌设备
• Docker化部署：支持预构建镜像直接部署，简化安装流程
• 代码学习功能：可连接接收器学习远程控制代码（用于配置文件生成）

使用场景

适用于智能家居自动化场景，通过MQTT协议（如配合Home Assistant、OpenHAB等智能家居系统）远程控制433MHz无线电插座，实现灯光、家电等设备的开关控制。

使用方法

系统要求

• 树莓派（或兼容GPIO的设备）
• Docker及Docker Compose
• 433MHz发射器模块（接收器可选，用于代码学习）
• 网络连接（用于MQTT通信）

使用预构建镜像（推荐）

1. 获取docker-compose配置
   参考项目的docker-compose.yml，复制到本地并根据需求修改：

   yaml
   version: '3'
   services:
     mqtt_switcher:
       image: [Docker Hub镜像地址]
       volumes:
         - ./config.yml:/app/config.yml  # 挂载配置文件
       devices:
         - /dev/gpiomem:/dev/gpiomem  # 提供GPIO访问
       restart: always
   

2. 配置config.yml
   根据实际使用的无线电插座型号，修改配置文件中的编码参数（详见"代码配置"部分）。

3. 启动服务

   bash
   docker-compose up -d
   

构建自定义镜像（不推荐）

1. 克隆代码仓库：

   bash
   git clone [仓库地址]
   cd MQTT_Switcher
   

2. 构建并启动：

   bash
   docker-compose up --build -d
   

3. 按上述步骤配置config.yml。

手动执行（开发测试用）

注意：可能与系统Python环境冲突，不推荐生产环境使用

1. 克隆代码并切换分支：

   bash
   git clone [仓库地址]
   cd MQTT_Switcher
   git checkout dockerize
   

2. 安装依赖：

   bash
   pipenv install
   pipenv shell
   

3. 执行脚本：

   bash
   export PYTHONPATH=.
   python3 app/main.py -f config.yaml
   

硬件连接

发射器模块连接

接收器模块连接（可选，用于代码学习）

引脚布局参考：!树莓派引脚图

GPIO访问配置

仅需系统首次配置，可能已完成

1. 添加用户到GPIO组：

   bash
   usermod -aG gpio [用户名]
   

2. 重新登录或重启系统，使组权限生效。

3. 若出现RuntimeError: No access to /dev/mem错误，可尝试仅暴露/dev/gpiomem设备（在Docker配置中已包含）。

4. 配置树莓派启动时等待网络连接：

   bash
   sudo raspi-config  # 选择 "Boot" -> "Wait for Network at Boot"
   sudo reboot now
   

代码配置（WIP）

需通过config.yml配置无线电编码，以下为基于Brennenstuhl RCS 1000SN插座的示例分析（不同品牌可能有差异）：

编码规律（供参考）

• 系统ID（SYS）、设备ID（DEV）和开关状态（ON/OFF）共同决定发射编码
• 示例关系：
  • ["01010", "2"] ON → 4477265（协议1，脉冲长度308）
  • ["01010", "2"] OFF → 4477268（协议1，脉冲长度310）
  • ["01010", "1"] ON → 4474193（协议1，脉冲长度308）

配置方法

1. 连接接收器模块
2. 使用原始模式记录远程控制器发送的编码
3. 在config.yml中按格式填入系统ID、设备ID与对应编码的映射关系

开发者提示

开发限制

• 无法在桌面系统运行，依赖树莓派GPIO接口
• 开发时需注释GPIO相关导入并设置断点调试

依赖项

• paho-mqtt（MQTT客户端）
• rpi-rf（GPIO控制433MHz模块，https://github.com/milaq/rpi-rf%EF%BC%89

版本更新

bash
git reset --hard
git pull [origin dockerize]
pipenv update