CT Command – Turntable Control Commands Part3: START, TURNSINGLE and RUN Command Guide

Overview of Commands

• The CT command set acts as universal communication protocol for ComXim programmable electric turntables.
• You can send these commands over USB serial port, WiFi or BLE Bluetooth connection to control the turntable.
• This tutorial covers three related commands: CT+START, CT+TURNSINGLE and CT+RUN.
• CT+START serves as an all‑in‑one integrated command. One single line configures rotation mode, direction, auto shutter, rotation angle, pause time and repeat cycles.
• CT+TURNSINGLE controls one single fixed rotation step. It is the official recommended standard single‑rotation command.
• CT+RUN works as an independent trigger command. You set separate parameters first, then call this command to activate turntable movement.
• All three commands work for ComXim electric turntables with CT enabled firmware, including MT, NT and UT series.
• They fit product 3D scanning, e‑commerce automatic object photography and cultural relic digital collection perfectly.
• With these commands, developers build automated photo pipelines quickly and cut redundant coding work.

Detailed Applicable Scenarios

• First, automatic e‑commerce product 360 photography. You want the turntable to rotate at fixed angle, pause and trigger camera capture after each step. CT+START handles all settings in one command. It supports auto loop and shutter trigger and becomes your top choice.
• Second, simple single angle positioning. You only need the turntable to rotate a defined angle and stop directly, without loops or shutter action. Use CT+TURNSINGLE directly. The command is short and logic stays simple.
• Third, segmented parameter configuration for development. Your program sets direction, rotation mode and shutter separately before starting rotation. Send configuration commands one by one, then call CT+RUN to execute rotation.

Command Syntax and Full Parameter Breakdown

CT+START(direction,turnMode,shutter,angle,seconds,times);

Syntax: CT+START(direction,turnMode,shutter,angle,seconds,times);

1. direction: rotation direction Accepts 0 or 1. 0 = clockwise rotation. 1 = counter‑clockwise rotation. Mandatory parameter.
2. turnMode: rotation mode Accepts 0, 1, or 2. 0 = continuous rotation. 1 = intermittent step rotation. 2 = swing mode, not supported for now. Mandatory parameter.
3. shutter: auto shutter switch Accepts 0 or 1. 0 = disable auto shutter trigger. 1 = enable auto photo capture. Mandatory parameter.

Only hardware models marked S or PS support shutter output. You may review the ComXim Electric Turntable Selection Guide to confirm shutter capability of your unit. Ordinary models ignore shutter=1 even if you set this value.

4. angle: rotation angle per step Positive floating‑point number, unit degree. Examples:10,22.5,30.0. Mandatory parameter.
5. seconds: pause duration after each step Positive integer, unit second. The waiting time after turntable reaches target angle. Mandatory parameter.
6. times: total repeat cycles Positive integer, unit times. Total execution rounds of the whole task. Mandatory parameter.

CT+TURNSINGLE(direction,angle);

• Syntax: CT+TURNSINGLE(direction,angle);
• Recommended standard single rotation command, supported from firmware V2R04C001 and newer.
• It contains only two mandatory parameters.
• direction: 0 clockwise, 1 counter‑clockwise.
• angle: positive floating‑point value in degrees, single rotation target angle.
• Execution logic: turntable rotates to target angle and stops automatically. No pause, no shutter, no loop.

CT+RUN();

• Syntax: CT+RUN();
• This command takes no parameters. It will not modify any configuration value. Its function is to apply previously saved parameters and launch turntable rotation. It fits segmented workflow: set direction, mode and angle separately before triggering CT+RUN.

Step‑by‑Step Practical Operation Guide

• Step 1: Hardware and software preparation.
• Connect power supply to ComXim programmable turntable and power the device on. Build communication channel via USB serial, WiFi hotspot or BLE Bluetooth. Check turntable firmware version and confirm command compatibility.

• Step 2: Prepare command sending tool.
• You can use official TurntableX serial console, web debug tool or custom serial program. Verify serial baud rate, WiFi IP address and Bluetooth channel. Confirm device returns ACK response normally.

• Step3: Write and transmit CT commands.
• Case A: Use CT+START for full parameter setup at once. Send the complete START command directly. Turntable receives the command and runs full cyclic capture task following your settings.
• Case B: Single fixed rotation with CT+TURNSINGLE. Send TURNSINGLE command. Turntable rotates to target angle and stops automatically.
• Case C: Set parameters separately then trigger rotation. Send independent configuration commands for direction, mode and angle. Send CT+RUN(); in the end to activate movement.

• Step4: Listen for device feedback messages.
• Turntable returns ACK when it receives valid command.
• It returns NACK for invalid parameters or syntax error.
• When task completes, turntable pushes event report message to inform your program. If you are new to response mechanism, check out ComXim Turntable CT Command Basic Tutorial covering stop commands and ACK response logic.

Step5: Stop and reset turntable. Send stop command to interrupt running task anytime. You can reboot the turntable by power cycle to clear cached parameters.

Practical Command Examples for Direct Copy

• Example1: CT+START clockwise, intermittent mode, shutter enabled, rotate 10 degrees each step, pause 4 seconds, repeat 36 cycles.
• Command: CT+START(0,1,1,10,4,36);
• Explanation: Clockwise intermittent rotation. It turns 10 degrees each time, pauses 4 seconds and triggers photo capture automatically. 36 cycles finish a full 360‑degree product photo capture. Ideal for e‑commerce 360 image collection.

• Example2: CT+TURNSINGLE counter‑clockwise single rotation for 60 degrees.
• Command: CT+TURNSINGLE(1,60.0);
• Explanation: Turntable rotates counter‑clockwise by 60 degrees and stops after movement. No shutter trigger and no loop. Great for manual step capture in 3D scanning.

• Example3: Segmented workflow, call CT+RUN() after parameter setup.
• Send separate parameter configuration commands first. Send CT+RUN(); finally.
• Turntable reads cached parameters and starts rotation task. Suitable for complex custom sequence development.

Common Error and Troubleshooting Guide

1. Command returns NACK and turntable does not move. Cause 1: Parameter out of valid range, for example direction=2 or negative angle value. Cause2: Firmware version too old to support this command. Cause3: Typing mistake. Using Chinese full‑width comma or bracket. Solution: Check parameter range carefully. Upgrade turntable firmware. Use English half‑width punctuation for all commands.
2. CT+START runs rotation but auto shutter does not fire. Cause: Your turntable model lacks S/PS shutter hardware module, no shutter output port. Solution: Verify hardware model. Or check shutter cable connection and Bluetooth shutter pairing.
3. TURNSINGLE command is unrecognizable. Cause: Turntable firmware older than V2R04C001. Solution: Upgrade firmware to V2R04C001 or newer release.
4. Turntable stays still after sending CT+RUN(). Cause: You have not sent configuration parameters before. No valid rotation setting saved in buffer. Solution: Set direction, mode and angle first before calling CT+RUN(); For extra serial communication fixes, refer to <strong>ComXim Turntable Troubleshooting Manual</strong>.

Safety Rules and Device Maintenance Notes

• First, keep load within specification. Place object center aligned with turntable axis. Recalculate maximum load with torque formula for oversized items. Overload causes step loss, overheated motor and permanent hardware damage.
• Second, never touch rotating surface during operation. Do not block rotation by hand or tools while turntable runs. It may cause pinch injury or damage transmission gear.
• Third, give cooling break after long continuous work. Stop the device for 10 minutes after more than 2 hours continuous capture to protect stepper motor.
• Fourth, use stable power supply. Use original factory power adapter. Voltage fluctuation triggers command failure and inaccurate positioning.
• Fifth, keep device away from dust and moisture. Avoid long time operation in humid or dusty environment. Dust will wear internal gear structure.

FAQ Section

• Q1: Why turnMode swing option in CT+START is marked unsupported?
• A: Current firmware does not finish underlying swing logic. Value 2 will not trigger swing movement. This function will unlock in later firmware update.

• Q2: What is the core difference between CT+TURNSINGLE and intermittent mode in CT+START?
• A: TURNSINGLE executes only one rotation step and stops after completion. START intermittent mode loops automatically, adds pause after each step and supports auto shutter trigger for batch photography.

• Q3: Do I write these three CT commands differently over WiFi and USB serial?
• A: No. The CT command set is independent of communication channel. WiFi, USB and BLE Bluetooth share identical command text. You only need a healthy communication link.

• Q4: If I input a large value for times parameter, will turntable run infinitely?
• A: times defines total execution rounds. If times=100, turntable runs 100 cycles and stops. For unlimited loop, resend the command once task finishes in your program.

• Q5: I set shutter=1 in CT+START, but camera receives no capture signal?
• A: Two checks needed. First confirm hardware with S/PS shutter module. Second confirm shutter cable matches your camera model and connection stays tight.

• Q6: Can I combine CT+RUN() with CT+START?
• A: Not recommended. CT+START triggers task execution by itself. CT+RUN belongs to separate parameter configuration workflow. Mixing both systems leads to parameter conflict.

• Q7: Is there any difference between angle=22.5 and angle=22.50?
• A: No difference. Turntable firmware reads floating‑point value, trailing zero does not change rotation angle.

Full Article Summary

• CT+START works as integrated all‑in‑one command for automatic photo capture and 3D scanning workflow.
• CT+TURNSINGLE is recommended standard single rotation command with clean and stable code.
• CT+RUN fits segmented parameter setup workflow to trigger pre‑defined rotation task.
• Combined, these three commands meet most demands of automated photography and digital scanning development.
• Developers use CT+START for cyclic automatic shooting and CT+TURNSINGLE for simple single angle positioning.
• Manage firmware version properly and use firmware V2R04C001 or above to get full command support。