可编程电动转盘 CT 命令第 1 部分

1 这些 CT 命令概览

2

ComXim 可编程电动转盘依赖 CT 命令 集进行二次开发和自动化控制。本指南涵盖六条基础但必不可少的 CT 命令。你可以通过 USB 串口、WiFi TCP 套接字或 BLE 蓝牙发送这些命令。这些命令帮助你管理遥控锁定、蜂鸣器声音、参数保存、紧急停止和转速调节。3 所有这些命令都适用于大多数 ComXim 转盘型号，包括 MT、NT 和 UT 系列。这些基础命令构成了你自定义自动拍摄脚本的基础。当你构建自动化 360 度产品摄影系统时，会在运行多步旋转和自动快门拍摄之前频繁调用这些命令。

4 使用 CT 命令而非遥控器或桌面软件的最大优势是全自动化。你的自定义程序无需人工输入即可更改转盘设置。你可以锁定红外遥控以避免意外触发、在拍照期间静音蜂鸣声、保存自定义预设、立即停止旋转并实时调节转速。

5 常见应用场景

• 6 第一，考虑自动化影棚拍摄。当你进行无人值守的 360 度产品摄影时，随机的红外遥控干扰可能打断你的拍摄序列。CT+IRDISABLE(onOff); 命令禁用红外接收器，因此意外的按键无法中断你的任务。这适用于连续拍摄数十件商品的电商产品摄影棚。
• 7 第二，静音拍摄环境。许多产品摄影棚保持安静，以避免对麦克风或视频录制造成噪声干扰。CT+SPKMUTE(onOff); 命令关闭内置扬声器蜂鸣。转盘在收到命令时将不再发出提示音。这很适合珠宝、手表和小型文物扫描场景。
• 8 第三，保存自定义预设参数。如果你为某件特定产品测试出固定的转速和工作流，请使用 CT+SAVECONF();。它把你的当前配置写入转盘板载闪存。断电重启后设置仍然有效。这对重复的批量拍摄任务很有帮助。
• 9 第四，紧急停止集成。当你的自定义脚本检测到物品位置异常或安全风险时，发送 CT+SETSTOP();。这条命令会立即停止转盘旋转。你可以把它嵌入自动化程序中的安全检查逻辑。它广泛用于定制扫描装置和展会演示系统。
• 10 第五，旋转前的固定速度设置。CT+SETSPEED(speedGrade); 在启动旋转前设置固定速度档位。如果你拍摄陶瓷工艺品或玻璃瓶等易碎物品，可以设置较低的档位以保证平稳缓慢的旋转。这能减少振动并防止产品倾倒。
• 11 第六，旋转过程中的动态速度调节。CT+CHANGESPEED(speedUpOrDown); 实时调节速度。你无需先停止转盘。该功能适用于特殊拍摄需求，例如为创意 3D 预览视频实现慢启动、加速旋转。

12 命令语法与参数拆解

13 所有 CT 命令都遵循统一格式 CT+COMMAND(parameter);。结尾的分号标记单条命令行结束。发送命令时，你必须保持准确的大小写和标点。

1. 14 CT+IRDISABLE(onOff); 这条命令控制红外遥控功能开关。参数：onOff。它接受两个整数值。输入 1 禁用红外遥控接收器。输入 0 启用红外遥控接收器。当 onOff 等于 1 时，转盘忽略来自红外遥控器的所有信号。当 onOff 等于 0 时，红外遥控恢复正常。该参数为必需。不要省略括号内的值。
2. 15 CT+SPKMUTE(onOff); 这条命令控制内置蜂鸣器扬声器。参数：onOff。整数值。输入 1 静音扬声器，输入 0 取消静音。静音时，转盘在收到命令或状态切换时不会发出蜂鸣声。该参数为必需。
3. 16 CT+SAVECONF(); 这条命令把当前生效的配置保存到硬件闪存。无输入参数。保持括号为空。只有已经发送到转盘硬件的参数才会被保存。软件界面上的显示值不会自动保存。在完成所有设置调整后，务必运行 SAVECONF。
4. 17 CT+SETSTOP(); 这条命令触发立即停止旋转。无输入参数。保持括号为空。一旦收到，转盘无论当前处于何种运行模式都会立即停止旋转。它不会完成剩余的旋转步进。
5. 18 CT+SETSPEED(speedGrade); 这条命令设置固定的旋转速度档位。参数：speedGrade。表示预设速度档位的整数值。数值越低旋转越慢。数值越高旋转越快。该参数为必需。在启动旋转任务前设置它。它对正在进行的旋转不生效。
6. 19 CT+CHANGESPEED(speedUpOrDown); 这条命令在旋转过程中动态改变速度。参数：speedUpOrDown。表示速度调节步长的整数值。正值提高速度档位。负值降低速度档位。该参数为必需。你可以在转盘持续旋转时发送这条命令。

20 你必须遵循的格式规则。始终在结尾添加分号。不要在命令名内插入额外空格。避免使用特殊字符。错误的语法会导致转盘拒绝整条命令。

21 分步实操操作教程

• 22 首先，完成设备准备。给你的
• 可编程电动转盘。上电。把转盘连接到你的控制设备。你可以使用 USB 串口连接、WiFi TCP 连接或 BLE 蓝牙连接。如果使用 USB 连接，请安装 CH340 驱动。在发送 CT 命令之前，确认通信通道正常工作。23 接着，准备你的命令发送工具。你可以使用串口调试软件、自定义 Python 脚本或自研控制面板。打开通信端口并与转盘建立稳定连接。
• 24 然后，按你预期的顺序逐条发送命令。例如，先禁用红外遥控、静音蜂鸣器、设置目标速度，然后启动旋转。发送每条完整命令字符串，包括结尾的分号。
• 25 发送每条命令后，等待转盘返回状态反馈。转盘会回送响应消息，告诉你命令是否成功执行。阅读这些反馈以核实配置变更。
• 26 如果你使用 SAVECONF()，请仅在所有参数设置生效之后再发送它。手动重启转盘，以测试已保存的设置能否在断电重启后保留。
• 27 每当你需要立即终止旋转时，使用 SETSTOP()。紧急停止后，你可以重置工作流并重新启动一个新的旋转任务。

28 可复用代码示例

29 示例 1：批量拍摄前锁定红外遥控并静音扬声器 CT+IRDISABLE(1); CT+SPKMUTE(1); CT+SETSPEED(3); CT+SAVECONF();

30 说明：该序列禁用红外遥控、静音蜂鸣器、把速度档位设为 3 级，并把所有设置保存到转盘闪存。该预设在断电重启后仍保留，便于重复的批量产品拍摄。

31 示例 2：动态速度调节与紧急停止 CT+SETSPEED(2); CT+CHANGESPEED(1); CT+SETSTOP();

32 说明：该脚本把基础速度设为 2 级，在旋转时提高一个速度档位，然后立即停止旋转。你可以把它嵌入安全监控逻辑。

33 示例 3：恢复默认遥控和扬声器 CT+IRDISABLE(0); CT+SPKMUTE(0); CT+SAVECONF();

34 说明：启用红外遥控并重新打开蜂鸣声，然后保存配置。在自动拍摄完成后使用它来恢复手动控制。

35 常见错误与故障排查

36 错误一：命令没有响应。检查命令字符串结尾是否缺少分号。同时核实命令名内是否有额外空格。确认你的串口或 WiFi 套接字连接保持存活。重建连接并重新发送命令。

37 错误二：运行 CT+IRDISABLE(1); 后红外遥控仍然有效。检查你是否发送了正确的整数值。确保你使用数字 1 而不是文本字符串 “1”。记住 IRDISABLE 只有在命令反馈返回成功后才生效。如果反馈显示失败，请检查硬件型号兼容性。一些入门级转盘版本不支持红外锁定功能。请访问我们的 可编程转盘

产品页面以确认硬件功能列表。38 错误三：静音设置在断电重启后重置。SPKMUTE 只对运行时状态有效。在你于静音命令之后运行 CT+SAVECONF(); 之前，它不会在断电重启后保留。许多新手开发者跳过了保存步骤，因此设置在断电后消失。务必执行 SAVECONF，把运行时更改写入闪存。

39 错误四：SETSPEED 命令没有改变旋转速度。CT+SETSPEED(speedGrade); 只对下一次旋转任务生效。它无法修改已经在运行中的运动速度。如果你想在旋转过程中实时修改速度，请改用 CT+CHANGESPEED(speedUpOrDown);。

40 错误五：SAVECONF() 无法保存已修改的参数。SAVECONF(); 只保存硬件已经收到的参数。仅显示在电脑软件界面上的参数不会被存储。在调用 CT+SAVECONF(); 之前，发送每一条设置命令并收到肯定反馈。

41 安全使用与设备维护注意事项

• 42 第一，不要在极短的间隔内频繁发送突发 CT 命令。在两条独立命令之间保持合理的延时。过度快速地注入命令可能导致转盘通信缓冲区溢出。
• 43 第二，CT+SETSTOP(); 提供立即的硬件停止。它适用于安全保护场景。但在重载工况下，你仍不应频繁触发紧急停止。反复的突然停止会增加你的360 度照片转盘的机械磨损。
• 44 第三，确认参数值落在有效范围内。错误的参数输入会被转盘固件丢弃。速度档位不能超过你的硬件型号所支持的最大等级。
• 45 第四，在参数保存过程中保持电源稳定。运行 CT+SAVECONF(); 时绝不要切断电源。意外断电可能损坏板载闪存芯片。
• 46 第五，对于长时间无人值守的自动化工作，请定期检查载荷状态。遵循官方规格，让实际工作载荷保持在最大额定载荷的百分之八十以下。

47 常见问题高频问答区

• 48 问题 1：我可以对 NT 系列转盘使用 CT+IRDISABLE(1); 和 CT+SPKMUTE(1); 吗？
• 49 答 1：可以。NT 系列、MT 系列和 UT 系列的新固件版本都支持这两条命令。较旧的硬件版本可能缺少部分功能。通过命令读取设备固件版本以检查兼容性。

• 50 问题 2：CT+SETSPEED(speedGrade); 中的 speedGrade 我应该使用什么取值范围？
• 51 答 2：确切范围因硬件型号而异。大多数主流型号接受 1 到 10 的整数值。数值越低旋转越慢。在正式批量拍摄前，务必用实际样品测试速度档位。

• 52 问题 3：当我的转盘正在旋转时，我可以发送 CT+SAVECONF(); 吗？
• 53 答 3：技术上你可以在旋转期间发送它。但最佳实践建议你在静止空闲状态下运行保存命令。运动时保存会带来极小的闪存写入异常风险。先完成所有旋转任务，然后再触发 SAVECONF。

• 54 问题 4：CT+SETSTOP(); 与通过遥控按钮停止旋转有什么区别？
• 55 答 4：CT+SETSTOP(); 是由命令流触发的硬件级立即停止。遥控停止按钮通过红外信号工作。在 IRDISABLE 启用状态下，遥控停止按钮失去作用，但 CT+SETSTOP(); 仍然优先并正常工作。

• 56 问题 5：CHANGESPEED 可以使用负数吗？
• 57 答 5：当然可以。输入负整数进行降速操作。例如 CT+CHANGESPEED(-1); 会在正在进行的旋转中把当前速度档位降低一级。

• 58 问题 6：运行 CT+IRDISABLE(1); 之后，有没有办法在不使用 CT 命令的情况下恢复红外功能？
• 59 答 6：通常不能。当红外接收器被锁定时，只有发送 CT+IRDISABLE(0); 才能重新打开红外接收。如果你失去了对上位机工具的控制，完全断电重启会把红外遥控恢复到出厂默认启用状态。

• 60 问题 7：SAVECONF() 会保存转盘的每一个参数吗？
• 61 答 7：它会保存所有运行时生效的参数，包括速度档位、静音状态、红外锁定状态、原点位置和暂停时间。诸如当前旋转角度之类的临时运行时状态不会写入闪存。

• 62 问题 8：如果我在单行中发送多条 CT 命令，转盘能正确处理它们吗？
• 63 答 8：你应该把每条命令分开，逐条发送。不要把多条 CT 指令拼接在一个传输包内。在命令之间加入短暂延时，以避免转盘固件端的解析错误。

64 全文总结

65 这六条基础 CT 命令构成了可编程电动转盘二次开发控制的核心基础。CT+IRDISABLE(onOff); 管理红外遥控锁定，CT+SPKMUTE(onOff); 处理蜂鸣器静音，CT+SAVECONF(); 持久化存储参数，CT+SETSTOP(); 提供即时硬件停止，CT+SETSPEED(speedGrade); 配置静态预设速度，CT+CHANGESPEED(speedUpOrDown); 支持实时动态速度调节。

66 电商商家、影棚开发者和定制扫描方案构建者广泛使用这些指令进行 360 度产品拍摄。发送后务必检查命令反馈。当你希望设置在断电重启后保留时，运行 SAVECONF。任务前速度设置选择 SETSPEED，如果需要在旋转时切换速度则选择 CHANGESPEED。掌握这些指令，你就能用 ComXim 转盘搭建稳定可靠的自动化拍摄工作流。