如何在 ComXim 可编程转盘上编写自定义多动作旋转序列

1 附 3 步复合循环示例的完整实操指南

2 前言

3 许多电商拍摄工作室、展览运营方和自动化实验室场景，已不再满足于简单的单向旋转或基础的左右摆动，而是需要将连续旋转、间歇步进与往复摆动组合成自动循环。

4 普通红外遥控器和简易手机 App 只支持单一旋转模式，无法在多种动作类型之间自动切换。本文基于 ComXim 原生的 CT 指令系统，分享两套经过验证的方案：面向普通用户的零代码 Windows 软件循环方案，以及面向开发者的可编程自动化方案。二者共同完美实现如下目标动作序列：

5 顺时针 90° → 逆时针间歇 270°（停顿 4 秒）→ 顺时针 170° 往复摆动一轮，无限重复。

6 1. 基础术语与动作拆解

7 1.1 统一参数定义（CT 指令标准）

8 旋转方向：0 = 顺时针（左转），1 = 逆时针（右转）
9 旋转模式代码：0 = 单向连续固定角度，1 = 间歇步进，2 = 摆锤振荡
10 设备反馈标志：CR+EVENT=TB_END;——表示当前完整动作已完成，会自动触发序列中的下一条指令
Two core control commands:
- CT+TURNSINGLE(direction, angle); – single continuous rotation, stops immediately after reaching the set angle
- 11 CT+START(direction, mode, shutter, angle, pause_seconds, repeat_count);——复合模式启动指令

12 1.2 一个完整循环的拆解（三个依次执行的动作）

13 步骤	14 动作说明	15 对应 CT 指令	16 执行逻辑
17 第 1 步	18 顺时针 90° 连续旋转	19 `CT+TURNSINGLE(0,90);`	20 一次性顺时针旋转 90°，在位置处停止，无停顿
21 第 2 步	22 逆时针间歇 270°，停顿 4 秒，执行一次	23 `CT+START(1,1,0,270,4,1);`	24 逆时针转 270° → 停留 4 秒——这一段仅运行一次
25 第 3 步	26 170° 的摆锤振荡（以当前位置为中心），一轮	27 `CT+START(0,2,0,170,4,1);`	28 在最大 170° 范围内左右摆动，两端各停顿 4 秒，完成一次完整的往复循环后停止

29 三步全部完成后，转盘会回传动作结束反馈，软件／程序随即从头自动重新开始循环。

30 2. 方案一：Windows TurntableX 软件——零代码循环

31 适用对象：电商图片编辑、展览运营方与摄影工作室——无需编程。可视化操作，支持 USB 或 Wi-Fi 连接，适配所有 ComXim 转盘系列。

32 前提条件

33 硬件连接：通过 USB 线连接，或连接转盘内置的 Wi-Fi 热点（密码：88889999）。
34 驱动安装：下载并安装 CH340 驱动；确认设备管理器中已出现 COM 端口。
35 软件准备：解压 TurntableX，选择正确的 COM 端口或 IP 地址，点击连接，并确认已读取到设备。
36 速度调节（可选）：发送 CT+CHANGESPEED(0) 减速，或发送 CT+CHANGESPEED(1) 加速。

37 逐步操作

38 在指令输入框中粘贴三条完整的 CT 指令，每条各占一行：CT+TURNSINGLE(0,90); CT+START(1,1,0,270,4,1); CT+START(0,2,0,170,4,1);
39 勾选输入框下方的两个选项：自动发送与循环。
40 点击发送按钮即可启动完整循环。
41 运行逻辑：软件持续监听转盘的反馈 CR+EVENT=TB_END;。当一个动作完成后，会自动发送下一条指令。三步全部完成后，队列重置，循环无限重复。

42 替代方案：网页控制台

43 对于 Mac 用户，或无法使用 Windows 客户端时，可使用官方在线网页控制台（无需安装）：

44 打开 https://comxim.com/web-device-console
45 选择对应的 COM 端口并连接。
46 粘贴三条 CT 指令，启用循环发送，然后点击发送。

47 扩展功能：快门控制（带 S/PS 的型号）

48 如果你的转盘支持相机／手机快门，可将快门参数（第三位数字）从 0 改为 1，以便在停顿阶段触发自动对焦与快门释放：

CT+TURNSINGLE(0,90);
CT+START(1,1,1,270,4,1);
CT+START(0,2,1,170,4,1);

49 3. 方案二：CT 指令二次开发——可编程自动化

50 适用对象：实验室设备、工业视觉系统与自定义上位机软件。可通过 USB、Wi-Fi 或蓝牙工作，兼容 Python、C#、JavaScript、Java 及任何其他编程语言。

51 核心通信原理

52 上位机应用持续读取串口／TCP 数据流。当检测到 CR+EVENT=TB_END; 标志时，就发送队列中的下一条指令。整个队列执行完毕后，索引重置，从而实现永久循环。

53 简易 Python 伪代码示例

# Define the three‑action command queue
action_list = [
    "CT+TURNSINGLE(0,90);",
    "CT+START(1,1,0,270,4,1);",
    "CT+START(0,2,0,170,4,1);"
]
current_index = 0

# Continuously listen to serial/Wi‑Fi data
while True:
    rec_data = read_turntable_data()   # read feedback from turntable
    # Check if the current action has completed
    if "CR+EVENT=TB_END;" in rec_data:
        send_command(action_list[current_index])   # send the next command
        # Advance to the next command, reset when reaching the end
        current_index += 1
        if current_index >= len(action_list):
            current_index = 0

54 可自定义参数

55 调整停留时间：修改第 5 个参数，例如 CT+START(1,1,0,270,6,1); 表示停顿 6 秒。
56 单个动作的重复次数：修改最后一位数字（例如 2 表示将该步进重复两次）。
57 全局速度：在循环开始前发送 CT+CHANGESPEED(0/1)。
58 回零复位：添加 CT+SETZERO(); 与 CT+TOZERO();，以确保起始位置一致。

59 4. 其他控制方式的局限

60 红外遥控器：仅支持单一模式（纯连续／纯间歇／纯摆锤），无法在三种动作类型之间自动切换——不适合无人值守的自动循环。
61 Android 演示 App（TurntablePlus/TurntableBLE）：没有批量指令队列，只能手动逐条发送。可用于演示，但不建议用于长期自动化。
62 Mac 系统：没有官方 TurntableX 客户端。请使用网页控制台或二次开发方案。

63 5. 实用优化建议

64 卡顿或模式冲突：如果出现问题，发送 CT+SETSTOP(); 清除当前动作，然后重新启动循环。
65 高精度定位（3D 扫描／文化遗产）：在循环开始前发送 CT+SETZERO();。对于带 Y 轴零点标记的型号，这可确保每个循环都从完全相同的角度开始。
66 贵重展品保护（T 型称重）：带负载称重的型号可上报重量数据。在自定义代码中加入重量异常检查，一旦重量发生意外变化，就停止循环并触发警报。
67 中断与重启：点击软件中的停止按钮，或按遥控器上的停止键，即可立即终止所有动作。再次点击发送即可从头重新开始。