Python-eq3bt 完整使用指南python-eq3bt是专门用于控制 EQ3 蓝牙智能恒温阀的 Python 第三方库支持通过蓝牙低功耗BLE直接连接、控制 EQ3/CC-RT-BLE 系列恒温阀无需网关可实现本地自动化温控、状态读取、模式切换等核心功能。它是智能家居、Python 蓝牙控制、暖通自动化的常用工具仅支持 Linux 系统树莓派、Ubuntu 等不支持 Windows/macOS依赖 Linux 蓝牙栈 bluez。一、核心功能设备发现扫描附近的 EQ3 蓝牙恒温阀状态读取温度、模式、电池、阀门开度、锁定状态等温控控制设置目标温度、手动/自动/假日模式切换设备管理开关恒温阀、温度偏移校准、窗口模式、定时功能本地自动化结合 Python 脚本实现定时温控、联动控制二、环境要求与安装1. 系统要求系统Linux树莓派、Ubuntu、Debian蓝牙支持 BLE蓝牙4.0需安装bluezPython3.62. 依赖安装必须先执行# 安装蓝牙依赖sudoapt-getupdatesudoapt-getinstallbluez bluez-tools python3-pip libglib2.0-dev# 启动蓝牙服务sudosystemctlenablebluetoothsudosystemctl start bluetooth3. 安装 python-eq3bt# 标准安装pip3installpython-eq3bt# 若权限不足使用用户级安装pip3install--userpython-eq3bt4. 验证安装eq3cli--help# 若输出帮助信息说明安装成功三、核心语法、命令与参数python-eq3bt提供两种使用方式命令行工具eq3cli快速操作Python 代码 API编程开发1. 命令行语法eq3cli基础格式eq3cli[参数]蓝牙MAC地址[命令]常用参数参数作用-h, --help查看帮助-d, --debug开启调试日志--scan扫描附近 EQ3 设备核心命令命令功能示例info读取设备完整状态eq3cli AA:BB:CC:DD:EE:FF infotemp 数值设置目标温度4.5–30°Ceq3cli AA:BB:CC:DD:EE:FF temp 21auto切换自动模式跟随定时eq3cli ... automanual手动模式固定温度eq3cli ... manualoff关闭恒温阀eq3cli ... offon打开恒温阀eq3cli ... onboost开启/关闭 boost 模式eq3cli ... boostlock锁定设备面板eq3cli ... lockunlock解锁面板eq3cli ... unlockoffset 数值温度校准-3.5 ~ 3.5°Ceq3cli ... offset 0.52. Python 代码 API 语法基础使用模板fromeq3btimportThermostat# 1. 初始化设备填入你的恒温阀 MACthermoThermostat(AA:BB:CC:DD:EE:FF)# 2. 更新设备状态必须执行thermo.update()# 3. 读取状态print(当前温度:,thermo.target_temperature)print(电池状态:,thermo.low_battery)print(阀门开度:,thermo.valve)print(工作模式:,thermo.mode)# 4. 控制设备thermo.set_temperature(21)# 设置温度thermo.modemanual# 切换模式thermo.boostTrue# 开启增压常用属性只读属性说明thermo.target_temperature目标温度thermo.low_battery低电量True/Falsethermo.valve阀门开度百分比thermo.mode模式auto/manual/away/boostthermo.locked面板锁定状态thermo.window_open窗口开启状态常用方法方法作用update()刷新设备状态set_temperature(temp)设置温度set_mode(mode)设置模式四、8 个实际应用案例可直接运行案例 1扫描 EQ3 恒温阀获取 MAC 地址# 命令行扫描sudoeq3cli--scan输出示例Found EQ3 device: AA:BB:CC:DD:EE:FF (LivingRoom)案例 2Python 读取恒温阀完整状态fromeq3btimportThermostat# 替换为你的设备 MACdevThermostat(AA:BB:CC:DD:EE:FF)dev.update()print( 设备状态 )print(f目标温度:{dev.target_temperature}°C)print(f电池低电量:{dev.low_battery})print(f阀门开度:{dev.valve}%)print(f当前模式:{dev.mode})print(f面板锁定:{dev.locked})案例 3一键设置温度命令行# 设置卧室恒温阀为 22°Ceq3cli AA:BB:CC:DD:EE:FF temp22案例 4Python 定时温控白天/夜间自动切换fromeq3btimportThermostatimporttime thermoThermostat(AA:BB:CC:DD:EE:FF)whileTrue:nowtime.localtime()hournow.tm_hour# 白天 7:00-22:00 → 21°Cif7hour22:thermo.set_temperature(21)# 夜间 → 17°C 节能else:thermo.set_temperature(17)print(已调整温度)time.sleep(600)# 每10分钟检查一次案例 5切换手动/自动/关闭模式fromeq3btimportThermostat thermoThermostat(AA:BB:CC:DD:EE:FF)# 手动模式thermo.modemanual# 自动模式跟随设备定时thermo.modeauto# 关闭设备thermo.modeoff案例 6电池低电量告警fromeq3btimportThermostatimporttime thermoThermostat(AA:BB:CC:DD:EE:FF)whileTrue:thermo.update()ifthermo.low_battery:print(⚠️ 警告恒温阀电量过低)time.sleep(3600)# 每小时检查一次案例 7温度偏移校准解决测温不准# 设备显示偏高调低 0.5°Ceq3cli AA:BB:CC:DD:EE:FF offset-0.5# 设备显示偏低调高 1.0°Ceq3cli AA:BB:CC:DD:EE:FF offset1.0案例 8多房间恒温阀批量控制fromeq3btimportThermostat# 定义多个房间设备rooms{客厅:AA:BB:CC:DD:EE:FF,卧室:11:22:33:44:55:66,书房:AA:AA:BB:BB:CC:CC}# 批量设置为 20°Cforname,macinrooms.items():try:thermoThermostat(mac)thermo.set_temperature(20)print(f{name}已设置为 20°C)exceptExceptionase:print(f{name}控制失败{e})五、常见错误与解决方案错误 1BluetoothError: Cant connect原因蓝牙未开启、距离过远、MAC 错误、设备被占用解决确认 MAC 地址正确设备距离电脑3米重启蓝牙sudo systemctl restart bluetooth取消其他设备的连接错误 2Permission denied原因蓝牙操作需要 root 权限解决sudoeq3cli...# 或 Python 脚本用 sudo 运行sudopython3 thermostat.py错误 3No backend available原因缺少 bluez 依赖解决sudoapt-getinstallbluez libglib2.0-dev错误 4设备无响应原因设备休眠、蓝牙信号差解决手动按一下恒温阀按钮唤醒缩短控制距离重试命令错误 5温度设置无效原因温度超出范围4.5–30°C解决仅使用 4.5、5.0、5.5…30 的合法值六、使用注意事项系统限制仅支持 LinuxWindows/macOS 无法使用权限蓝牙操作必须用sudo管理员权限距离BLE 有效距离 3–5 米隔墙会降低稳定性温度范围仅支持4.5°C ~ 30°C步长 0.5°C设备唤醒设备休眠时需先按键唤醒再控制稳定性不要高频操作建议间隔≥5秒电池低电量会导致连接失败及时更换电池MAC 格式必须是XX:XX:XX:XX:XX:XX大写格式总结python-eq3bt是 Linux 下专用的EQ3 蓝牙恒温阀控制库支持命令行 Python 代码两种使用方式可实现状态读取、温度控制、模式切换、自动化定时等功能8 个案例覆盖日常使用、定时控制、告警、批量管理等场景核心注意必须 Linux 系统 sudo 权限 有效蓝牙距离《动手学PyTorch建模与应用:从深度学习到大模型》是一本从零基础上手深度学习和大模型的PyTorch实战指南。全书共11章前6章涵盖深度学习基础包括张量运算、神经网络原理、数据预处理及卷积神经网络等后5章进阶探讨图像、文本、音频建模技术并结合Transformer架构解析大语言模型的开发实践。书中通过房价预测、图像分类等案例讲解模型构建方法每章附有动手练习题帮助读者巩固实战能力。内容兼顾数学原理与工程实现适配PyTorch框架最新技术发展趋势。