CT 命令第 2 部分：可编程电动转盘的基础运动设置

1 命令集概览

• 2 首先，这组 CT 命令构成了基础运动配置命令集。相应地，你使用这些命令来定义转盘零点、返回原点、设置旋转方向、选择工作模式、定义旋转角度、调整暂停时长以及设置循环重复次数。
• 3 与此同时，这些命令适用于全系列的 ComXim 可编程电动转盘。而且，通信链路不会限制命令执行。USB、WiFi 和 BLE 蓝牙都支持发送这些指令。换句话说，无论你选择哪种通道，都使用完全相同的命令文本。
• 4 此外，这套命令集为自动化产品摄影和 3D 物体扫描奠定了底层基础。一旦与
• ComXim 可编程智能转盘,搭配使用，你就能构建一个无需人工操作的全自动拍摄工作流。5 具体来说，这套命令集带来了明确的核心优势。
• 6 第一，它提供了统一的命令语法。无论你使用哪种通信通道，命令文本都保持一致。
• 7 第二，它提供精细可控的参数。你可以自由自定义角度值、暂停时间和重复次数。
• 8 第三，它支持二次开发。因此，你可以把这些命令嵌入自定义脚本，批量完成多角度物体拍摄。
• 9 第四，它提供硬件零点标记支持。因此，它能为一再重复的扫描任务保持一致的角度基准。

10 详细适用场景

11 自动化电商产品摄影

• 12 首先，你希望转盘每一步旋转固定角度、暂停以供相机拍摄，并循环走完整圈。
• 13 因此，这个工作流非常适合独立站产品图片和亚马逊 Listing 照片。

14 3D 扫描与建模

• 15 接着，扫描软件要求转盘返回统一的零点。该设置消除了多次扫描会话之间的位置偏移。
• 16 相应地，你把每一次扫描都对齐到相同的起始角度。

17 自动展会展示

• 18 而且，展厅演示设备需要来回摆动或逐步旋转，且现场无操作员。
• 19 因此，这套命令集非常适合无人值守的展示场景。

20 自动化质量检验

21 同时，机器视觉系统需要固定的角度定位来批量检查工件表面的缺陷。

22 定制二次开发

23 此外，程序员编写上位机软件并调用这些命令，把转盘与自动相机快门触发联动起来。

24 命令语法与完整参数拆解

25 接下来，我们逐条拆解全部七条命令的语法、参数、有效取值范围和使用限制。

26 CT+SETZERO();

• 27 语法格式：CT+SETZERO();
• 28 这条命令不带任何输入参数。
• 29 功能说明：你把转盘当前的物理位置标记为系统零点。
• 30 执行逻辑：转盘不会旋转。相反，它只更新内部寄存器并把当前位置保存为 0 度基准。
• 31 使用注意：执行这条命令不会触发任何物理旋转。许多新用户会把 SETZERO 与 TOZERO 混淆。
• 32 格式限制：不要在括号内输入任何数字。一旦你添加了参数，转盘会拒绝该命令。

33 CT+TOZERO();

• 34 语法格式：CT+TOZERO();
• 35 这条命令不带任何输入参数。
• 36 功能说明：你驱动转盘物理旋转回到预先定义的零点位置。
• 37 执行逻辑：转盘在上电后读取已保存的零点；收到这条命令后，它才自动旋转。
• 38 使用注意：在回原点运动过程中，不要手动阻挡正在旋转的转盘。
• 39 格式限制：不要在括号内填入任何值，否则命令会返回错误。

40 CT+SETDIR(direction);

• 41 语法格式：CT+SETDIR(direction);
• 42 参数：direction，表示旋转方向的整数值。
• 43 有效取值：1 = 顺时针旋转，0 = 逆时针旋转。
• 44 功能说明：你设置后续所有转盘运动的旋转方向。
• 45 执行逻辑：在你设置方向之后，后续的角度步进和循环动作都遵循所选方向。
• 46 使用注意：SETDIR 只更新方向配置。它不会触发转盘旋转。
• 47 格式限制：该参数只接受 0 或 1。如果你输入其他整数，转盘会忽略该设置。

48 CT+SETMODE(turnMode);

• 49 语法格式：CT+SETMODE(turnMode);
• 50 参数：turnMode，用于选择工作模式的整数。
• 51 取值定义：
• 52 0 = 连续模式（默认）
• 53 1 = 重复步进模式
• 54 2 = 摆动模式
• 55 功能说明：你切换转盘的运行模式。
• 56 执行逻辑：在你完成模式选择之后，角度、暂停和循环命令在该模式下生效。
• 57 使用注意：我们建议你在转盘静止时更改模式。
• 58 相反地，如果你在旋转过程中切换模式，运动可能会表现异常。
• 59 格式限制：你只能使用 0 到 4 的整数。其他值无法被识别；
• 60 因此，当前生效的模式保持不变。

61 CT+SETANGLE(angle);

• 62 语法格式：CT+SETANGLE(angle);
• 63 参数：angle，单步旋转角度，整数或浮点数。
• 64 有效范围：0 ~ 360。单位为度。
• 65 功能说明：你定义单次步进运动的旋转角度。
• 66 执行逻辑：它在单步、重复步进和多步一圈模式下生效；相比之下，连续旋转模式会忽略该角度参数。
• 67 使用注意：如果角度超过 360，转盘会把它限制为 360。不支持负角度。你要通过 SETDIR 切换旋转方向。
• 68 格式限制：绝不输入负数。一旦收到负值，硬件会直接丢弃负角度命令。

69 CT+SETPAUSETIME(seconds);

• 70 语法格式：CT+SETPAUSETIME(seconds);
• 71 参数：seconds，每一步旋转后的等待时间，仅限正整数。
• 72 有效范围：0 ~ 60。单位为秒。不支持小数值。例如，你可以输入 4 或 5，但不能输入 2.5。
• 73 功能说明：你设置转盘完成每一步旋转后的停留时间。
• 74 执行逻辑：该参数在重复步进、整圈多步进和摆动模式下激活；然而，连续旋转不会产生暂停间隔。
• 75 使用注意：这个暂停窗口承载自动快门触发。默认情况下，快门在暂停时段的第 2 秒触发。
• 76 格式限制：负值无效。一旦你输入超过 60 的值，设备会自动把它钳制为 60 秒。

77 CT+SETREPEATTIMES(times);

• 78 语法格式：CT+SETREPEATTIMES(times);
• 79 参数：times，总重复循环次数，整数。有效范围：0 ~ 999；0 表示无限循环。
• 80 功能说明：你设置整个步进序列重复多少次。
• 81 执行逻辑：重复步进、摆动和多步一圈模式会读取该参数。与此同时，当你把它设为 0 时，序列会持续运行，直到收到停止命令。
• 82 使用注意：当无限循环激活时，你必须发送停止命令才能让转盘停下。
• 83 格式限制：设备会直接丢弃负值输入。

84 分步实操教程

85 第一步：设备准备

86 首先，你为

ComXim 可编程智能转盘

连接电源并打开电源开关。接着你选择通信通道：USB、WiFi 或蓝牙。然后，你在电脑上打开 TurntableX 软件或网页控制台。

87 第二步：建立通信

88 接着，你核实心跳握手。只有在链路稳定之后，设备才能正确接收你的命令。

89 第三步：配置基础参数

90 然后，你依次发送 SETDIR、SETMODE、SETANGLE、SETPAUSETIME 和 SETREPEATTIMES 命令。在此阶段，转盘只保存参数，并不旋转。

91 第四步：启动转盘运动

92 完成参数设置后，你发送运行命令。然后转盘按你定义的参数执行运动。

93 第五步：监控执行反馈

94 同时，你监听转盘返回的消息，以确认每条命令都得到应答。如果任何命令报告错误，你立即排查该参数。

95 第六步：停止与复位

• 96 最后，你发送停止命令以暂停运行。如果你需要重新校准参考点，就再次运行 SETZERO();。
• 97 实用命令示例
• 98 用例：电商产品 360° 照片拍摄。顺时针旋转，一整圈 36 步，每步 10 度，每步暂停 4 秒，运行 36 个循环。
• 99 你按顺序发送以下命令：
• 100 CT+SETDIR(0);
• 101 CT+SETMODE(1);
• 102 CT+SETANGLE(10);
• 103 CT+SETPAUSETIME(4);
• 104 CT+SETREPEATTIMES(36);
• 105 CT+RUN();

106 说明：首先，你设置顺时针旋转并激活重复步进模式。其次，你每步旋转 10 度、保持 4 秒，并重复该序列 36 次以完成一整圈。所有参数配置完成后，你必须发送 CT+RUN(); 触发转盘启动完整工作流。

107 此外，你可以直接复制这个命令序列，用于你 WooCommerce 店铺的自动 360 度产品摄影，并搭配相机快门触发。

• 108 常见错误与故障排查
• 109 无效的方向参数
• 110 问题：你发送 SETDIR(2)，但旋转方向保持不变。

111 根本原因：方向参数只接受 0 和 1。取值 2 视为无效；因此，设备丢弃该命令并保持原方向。

• 112 解决：你更新参数。使用 SETDIR(1) 表示顺时针，或 SETDIR(0) 表示逆时针旋转。
• 113 超出范围的模式编号
• 114 问题：你发送 SETMODE(5)，但工作模式保持不变。

115 根本原因：有效的 turnMode 取值范围是 0 到 4。数字 5 落在已定义的模式列表之外；因此，硬件拒绝该模式更新。

• 116 解决：你从 0 到 4 中选择模式编号。
• 117 负的暂停时间
• 118 问题：你发送 SETPAUSETIME(-3)，但暂停时间没有生效。

119 根本原因：暂停时间不能取负值。因此，设备会自动过滤负值输入。

• 120 解决：你输入大于或等于零的数字，例如 SETPAUSETIME(3)。
• 121 转盘无响应

122 问题：转盘对发送的任何命令都没有响应。

• 123 排查清单：第一，你检查通信通道。第二，确认 CH340 USB 驱动正确安装。第三，如果你使用 WiFi，核实你连接到了转盘热点。最后，你检查命令结尾的分号。缺少分号会导致解析失败。
• 124 角度超出限制
• 125 问题：你发送 SETANGLE(450)，但转盘不会旋转 450 度。

126 根本原因：最大角度限制为 360，硬件会自动把超过该限制的值钳制。

• 127 解决：你把角度值保持在 0 到 360 之间。
• 128 安全指南与设备维护
• 129 操作前，首先你把转盘放在平坦稳定的工作台上。不要超过额定扭矩限制。对于超大物品，你重新计算有效载荷。
• 130 操作期间，让你的手远离旋转表面。同时，绝不要强行阻挡旋转台面，否则你可能损坏内部步进电机。
• 131 如果你长时间运行无限连续循环，我们建议你每两小时暂停设备 10 分钟以散热。
• 132 同时，你保持通信端口干燥。防止灰尘和液体进入外壳连接器。

133 当你更改参数时，请在转盘静止时进行。相反地，运行期间频繁切换模式会导致运动紊乱。

• 134 最后，你定期检查电源适配器。使用原装匹配的电源，因为异常电压可能烧毁控制板。
• 135 常见问题解答

• 136 问题 1：SETZERO 与 TOZERO 的核心区别是什么？
• 137 答 1：SETZERO 在不旋转的情况下把当前位置标记为零点。相比之下，TOZERO 让转盘物理旋转到先前保存的零点。

• 138 问题 2：我在放入新物体后每次都需要运行 SETZERO 吗？
• 139 答 2：我们建议你在每个新的拍摄任务前运行 SETZERO。这样，它对齐基线并保证所有拍摄照片都有一致的起始角度。

• 140 问题 3：SETPAUSETIME 的暂停长度与相机快门触发有什么关系？
• 141 答 3：暂停间隔包含快门触发窗口。快门信号默认在第 2 秒触发。因此，要留出足够的暂停时间供相机对焦和成像。

• 142 问题 4：SETREPEATTIMES(0) 会启用无限循环。我怎样才能停止转盘？
• 143 答 4：你需要发送一条专用停止命令来结束运动。在那之前，转盘会持续循环，直到收到停止指令。

• 144 问题 5：这些 CT 命令能同时通过蓝牙和 WiFi 工作吗？
• 145 答 5：可以。换句话说，这套 CT 命令集对 USB、WiFi 和 BLE 蓝牙使用相同的语法。你不需要为不同通道重写命令文本。

• 146 问题 6：我可以在转盘旋转时修改 SETDIR 方向吗？
• 147 答 6：设备技术上可以接收该命令，但我们强烈建议不要这样做。根本原因：运行中改变方向会产生机械冲击并有损坏电机的风险。所以你要在转盘静止时调整方向。

• 148 问题 7：这些命令与 T 称重型号转盘兼容吗？
• 149 答 7：兼容。此外，零点和运动控制命令适用于 MT、NT、UT 系列，包括 T 称重变体。不过，称重功能使用本文之外的独立 CT 命令。

150 问题 8：在多步一圈模式下，我发送参数命令后转盘会立即开始旋转吗？

151 答 8：不会。换句话说，SETDIR 和 SETMODE 之类的配置命令只保存参数。你需要发送启动命令来触发完整的拍摄序列。