棋牌室分房远程控电系统・完整部署 & 使用说明书

一、这套系统是干嘛的
1.远程控制每个房间电源（开灯 / 开麻将机 / 断电）
2.手机、电脑都能控制
3.支持单独房间开 / 关
4..稳定不崩溃、指令失败自动重试
二、需要安装的环境
1.Python 3.8 ~ 3.11（安装时勾选 Add Python to PATH）
2.两个必须库，打开 PowerShell 分别运行：

pip install pymodbus==2.5.3
pip install paho-mqtt

三、核心配置信息（不要外泄）
·MQTT 服务器
1.地址：43.137.8.230
2.端口：1883
3.用户名：wmjk
4.密码：88888888
5.主题：cashier/power/set/1
·继电器模块
1.IP：192.168.0.7
2.端口：8234
3.从站 ID：1

四、必须的 3 个文件

全部放在桌面文件夹：棋牌室控电

1. relay_control.py主程序，负责接收指令、控制继电器
2. 启动控电程序.bat一键启动脚本，双击运行
3. room_control.html手机网页控制面板，浏览器打开就能用

五、新电脑完整部署步骤
装 Python
装上面两个依赖库
把三个文件放到 棋牌室控电 文件夹
双击 启动控电程序.bat 运行
看到：
Modbus 连接成功
MQTT 连接成功
即可正常使用

六、如何控制房间 方式

1：手机网页（最方便）

打开 room_control.html

点对应房间 → 打开电源 / 关闭电源

方式 2：电脑 MQTTX 发送 JSON 格式：

{
  "roomId": "r1",
  "roomName": "1号房",
  "power": "on",
  "slaveId": 1,
  "coil": 0
}

·power: on / off
·coil: 0、1、2、3… 对应不同房间
七、房间与线圈对应（可自己改）
线圈 0 → 1 号房
线圈 1 → 2 号房
线圈 2 → 3 号房
线圈 3 → 4 号房

八、开机自动启动（推荐）

1. 按 Win+R 2. 输入：shell:startup

3. 把 启动控电程序.bat 放进打开的文件夹下次开机自动运行

九、常见问题
1.报错 slave 参数
→ 必须用 pymodbus==2.5.3
2.Modbus 连接失败
→ 检查继电器 IP：192.168.0.7
→ 电脑和继电器在同一个网络
3.MQTT 连不上
→ 检查网络、账号密码、服务器地址
4.能开不能关
→ 使用我给的最终版代码，已支持 off