Overview
The CamDirector® can be controlled using TCP by sending commands over an IP connection. Upon receiving commands, the CamDirector® or camera sends ACK (Acknowledgment) and COM (Completion) messages, confirming that the command has been received and executed.
The following sections document the TCP commands for controlling the CamDirector® and using VISCA commands via the WebInterface.
TCP over IP - Using CamDirector® Commands
The CamDirector® operates as a TCP server on port 1260. To control the CamDirector®, you'll need a TCP-supported application like Hercules SETUP Utility or Packet Sender. Follow these steps:
- Open the TCP Application.
- Enter the CamDirector® IP Address and TCP port 1260, then connect.
- Once the connection is established, the client can send PTZ (Pan-Tilt-Zoom) commands to the CamDirector® server, which will parse and execute them.
- Send Commands to the CamDirector®, and observe the return messages to verify successful execution.
- Check the WebInterface to confirm command execution.
Default Settings:
- TCP Port: 1260
- TCP Address: 1
Command Example: TCP (Focus Near)
The image below illustrates an example of a TCP command (Focus Near) and its return responses. In the Receive Message section, the green RX commands represent:
- ACK: Confirmation of command receipt.
- COM: Confirmation of command completion.
You can find a list of these commands in the CamDirector® Return Commands section.
CamDirector® Return Commands
All parameter values are in HEX. Here's an overview of ACK/Completion and Error Commands:
| Command | Function | Command Packet | Comments |
|---|---|---|---|
| ACK | Command accepted | 90 41 FF | Returned when the command is accepted. |
| Completion | Command executed | 90 51 FF | Returned after the command is executed successfully. |
| Syntax Error | Command format incorrect | 90 60 02 FF | Returned when illegal parameters are sent. |
| Command Buffer Full | Buffer occupied | 90 60 03 FF | Indicates two sockets are already in use. |
| Command Canceled | Command execution canceled | 90 61 04 FF | No completion message is returned for canceled commands. |
| No Socket | Invalid socket number | 90 61 05 FF | Returned when a command is executed on a non-existent socket. |
| Command Not Executable | Command not executable | 90 6y 41 FF | Occurs when conditions prevent command execution, such as receiving manual focus commands during autofocus. |
CamDirector® Control Commands
All parameter values are in HEX. Ensure you have the latest version of CamDirector® Teacher Tracker software (version 1.05 or higher) to use these commands. Update your software via the WebInterface (Settings > Status > Software), and click Update Now.
| Function | Command | Command Packet | Comments |
|---|---|---|---|
| Privacy Mode On | Enable Privacy Mode | 81 00 01 6F 01 FF | Activates Privacy Mode, displaying a black screen. |
| Privacy Mode Off | Disable Privacy Mode | 81 00 01 6F 00 FF | Deactivates Privacy Mode. |
| Manual Control On | Enable Manual Control | 81 01 01 6F 01 FF | Activates manual control of cameras. |
| Manual Control Off | Disable Manual Control | 81 01 01 6F 00 FF | Deactivates manual control of cameras. |
| Switch Streams | Switch camera streams | 81 01 01 6F 02 FF | Switches between overview and follow cameras. |
| Tracking On | Enable Tracking | 81 02 01 6F 01 FF | Activates tracking functionality. |
| Tracking Off | Disable Tracking | 81 02 01 6F 00 FF | Deactivates tracking functionality. |
| MultiShot On | Enable MultiShot | 81 20 01 04 00 02 FF | Activates MultiShot mode. |
| MultiShot Off | Disable MultiShot | 81 20 01 04 00 03 FF | Deactivates MultiShot mode. |
| Switch to Preset | Switch camera to preset position | 81 20 01 04 3F 02 <pp> FF | Switches to a preset (pp: 01-80 HEX, 1-128 DEC). |
| Reboot | Reboot MultiShot | 81 20 0A 01 06 01 FF | Reboots the MultiShot software. |
| Return Status | Retrieve MultiShot status | 81 20 09 04 00 FF | Returns the status of MultiShot. |
Licenses
A valid license is required to use some software modules. Check the licenses you have purchased in the WebInterface by navigating to Settings > Status > Licenses.
Notes
- Important: Ensure the latest CamDirector® Teacher Tracker software (version 1.05 or higher) is installed to utilize Teacher Tracker commands.
- Caution: Always verify you have the necessary updates via the WebInterface (Settings > Status > Firmware) and click Update Now if needed.