PTZ云台控制系统：业余无线电爱好者的Pelco协议解决方案 📡🔧

项目背景 🎯

Ham Radio Deluxe（HRD）是业余无线电领域广受欢迎的控制软件🌟，但其旋转器模块支持协议有限，无法直接操控Pelco-D协议的云台设备⚙️。传统方案依赖硬件转换器🔌，成本高且灵活性差。
本系统的目标：通过纯软件实现协议转换🔄，让业余爱好者用HRD直接控制Pelco云台，省去额外设备开销💰！

---

核心功能亮点 ✨

1. 双向协议实时转换 🔄

• HRD指令 → Pelco指令
  • 解析HRD的C2查询命令📨，转换为Pelco-D的方位角/俯仰角查询帧（0x51/0x53指令）🔢。
  • 将HRD的W123 45设置指令🎯，精准映射为Pelco的0x4B/0x4D控制指令，精度达0.01度⚡。
• Pelco响应 → HRD兼容格式
  • 将二进制角度数据转换为HRD可读的AZ=xxx EL=xxx文本格式✅，无缝适配HRD界面。

2. 多通信模式支持 🌐

• 即插即用
  • 串口模式🔌：自动检测COM端口，支持常见波特率（9600-115200），亦可手动填写，即插即用⚡。
  • 网络模式🌍：通过TCP实现跨房间/跨楼层远程控制，适合家庭电台室布局📶。
• 抗干扰设计
  • 指令超时（3秒⏳）自动跳过，防止软件卡死；断线自动重连🔄，保障通联稳定性🔒。

3. 极简操作界面 🖥️

• 一键配置⚙️
  • 动态界面自动切换串口/TCP参数输入，新手也能快速上手🚀。
• 日志系统📝
  • 分级显示：🟢运行状态 / 🟠警告提示 / 🔴错误报警，支持一键清空🗑️。
• 低资源占用
  • 轻量化设计（CPU占用<2%），老旧电脑或树莓派📦均可流畅运行。

---

技术亮点 🔩

1. 业余场景优化设计

• 天线安全保护⚠️
  • 关闭系统时自动发送停止指令✋，防止云台因意外指令失控。
• 低成本兼容💰
  • 支持二手Pelco工业云台改造，通过地址码修改适配业余设备🔧。

2. 高精度控制 🎯

• 整数精度处理🔢
  • 角度值×100后传输（如123.45°→12345），避免浮点误差，满足卫星追踪需求🛰️。
• 缓冲区管理🧹
  • 每次查询前清空硬件缓存，确保返回数据为实时状态⚡。

3. 开源扩展性 🌟

• 协议自由修改📄
  • MIT许可证开源，可调整Pelco地址码、指令集，适配非标云台🎚️。
• 模块化协议框架📦
  • 插件式架构，低耦合设计，易于扩展。提供标准协议接口（ProtocolBase类），新增协议只需实现指令解析与封装方法🔧。
  • 示例：已内置Pelco-D和GS-232B协议模板，快速参考开发新协议（如VISCA、Onvif）🚀。
• 热加载支持🔥
  • 通过配置文件导入自定义协议，无需修改核心代码即可扩展📄。
• 开源协议库🌐
  • GitHub仓库提供协议开发指南与完整代码：
    PTZ-Control-System 📂
  • 包含协议测试用例和模拟器工具，加速开发流程⚡。

---

典型应用场景 📡

1. 卫星通联 🛰️

• 自动追踪卫星
  • 通过HRD的轨道预测数据📡，驱动Pelco云台实时对准AO-91、SO-50等业余卫星。

2. 应急通信 🚨

• 快速部署⚡
  • 车载安装时，通过手机热点+TCP模式实现远程控制，适应漫游野架等场景📶。
• 多协议兼容🔌
  • 可使用HRD同时控制Pelco云台和电台，简化野外设备复杂度🎒。

---

快速上手指南 🚀

1. 安装依赖📦

   pip install ttkbootstrap pyserial  # 仅需2个轻量库  
   

2. 硬件连接🔌

   • Pelco云台接线至电脑串口/USB转串口（或配置网络参数📡）。
   • HRD软件选择“虚拟串口”或TCP连接本系统。

3. 启动控制💻

   python main.py  # 启动后选择通讯协议→填写参数→点击“启动系统”🟢  
   

   

   • 观察日志显示“硬件初始化成功”✅，即可在HRD发送指令！

4. 常用指令示例📨

   • 查询角度：HRD发送C2 → 返回AZ=120 EL=45
   • 设置角度：HRD发送W123.5 45.2 → 云台转动至方位角123.5°、俯仰角45.2°

---

总结 🎉

这套系统为业余无线电爱好者架起了一座桥梁🌉，让尘封的Pelco工业云台在HRD控制下重获新生✨！开源代码已托管至：
🔗 GitHub - PTZ-Control-System

无论是卫星追踪🛰️、应急通信🚨，还是协议扩展🔧，都能以近乎零成本💰实现精准控制。欢迎提交PR或Issue，共同完善业余无线电工具生态！🚀