A-OK 奥科窗帘电机 RS485 地址设置工具

通过 USB 转 RS485 转换器，在 macOS / Linux / Windows 上为奥科（A-OK）窗帘管状电机设置 RS485 地址（ID）和频道，无需 Windows 专属上位机软件。

适用型号：AM24C / AM25 / AM35 等带 RS485 接口的奥科（A-OK）管状电机，用于电动窗帘、卷帘、罗马帘、百叶帘等场景。

English version → README_EN.md

---

适用场景

• 更换新窗帘电机后，需要将其 RS485 ID 设置为原有配置对应的地址
• 首次安装奥科 A-OK RS485 窗帘电机，需要分配地址和频道
• 配合 KNX / 智能家居网关（如广州尚舍 IMGW 0485）控制电动窗帘
• 配合 Home Assistant、SmartThings 等智能家居平台使用

硬件要求

物品	说明
USB 转 RS485 转换器	需用户自备，普通杂牌即可（CH340 / CP2102 / FT232 芯片均支持）
奥科 RS485 管状电机	型号如 AM24C-1/34-EL-II 等，电机上有两芯 RS485 信号线
已通电的电机	电机需单独供电（24VDC），RS485 信号线接转换器 A/B 端

接线说明：将电机的 RS485 两芯线接到转换器的 A / B 端子。
如果不确定极性，接上后通信失败时对调两根线即可（不会损坏设备）。

软件要求

• Python 3.7+
• pyserial

pip install pyserial

使用方法

中文界面（默认）

python3 setup_motor.py

英文界面

python3 setup_motor.py --lang en

指定目标 ID（跳过交互式输入）

python3 setup_motor.py --id 2

跳过通信测试（已确认线路正常时）

python3 setup_motor.py --id 2 --skip-test

操作流程

第一步  通信测试   → 发群控指令，确认 RS485 线路正常
第二步  设置 ID    → 断电重启电机，上电瞬间发送 ID 设置命令
第三步  验证       → 逐频道发上行指令，确认电机正确响应

关键：第二步中，电机上电后约 2 秒内需收到设置命令。
脚本会在你按下 Enter 后立即连续发送 10 次，覆盖编程窗口。

RS485 协议说明

详见 docs/protocol.md

常见问题

Q：找不到串口？
A：确认 USB 转 RS485 已插入，驱动已安装。macOS 下端口通常为 /dev/cu.usbserial-*。

Q：通信测试失败（电机没动）？
A：对调 A / B 两根线后重试。

Q：ID 设置后验证无响应？
A：可能上电和按 Enter 之间间隔过长（超过 2 秒）。重新断电，上电的同时按 Enter。

Q：电机响应的频道不是 1？
A：频道由设置命令决定。本工具默认设置 ID=2 频道=2（即命令 9A 02 02 00 AA AA 00）。
若需要频道 1，可在验证阶段选择对应频道，或联系我提交 Issue。

相关关键词

奥科电机 · A-OK Motor · 窗帘电机 RS485 · 管状电机地址设置 · 电动窗帘 KNX · roller blind motor · tubular motor RS485 · curtain motor smart home · A-OK AM24 · Home Assistant curtain · KNX RS485 gateway

许可证

MIT License — 详见 LICENSE