Navigation:  Pandoras Box > External Control (DMX,Midi,...) > Input Protocols >


prev main next

Navigation:  Pandoras Box > External Control (DMX,Midi,...) > Input Protocols >


prev main next


This chapter describes how to control Pandoras Box via TCP/IP. For other input protocols, please refer to the main chapter.

The built-in TCP/IP interface allows to send basic commands to control the Pandoras Box sequence via Ethernet. The Sequence acts as a TCP Client that can connect to an external TCP Server and receive commands from it. In case you would like to use the (discontinued) Serial Link interface for that, please refer to the chapter Input Protocols > Serial Link.

To control a Sequence, please start a TCP Server on your external device first. The TCP/IP port must be set to 23 and cannot be changed in Pandoras Box.

Then go to the Pandoras Box master and open the Sequence Inspector. Enter the IP address from the control device (which should now show that a Client is connected) and change then the so called "Serial port" to "1".

Before sending the command to control the Sequence, the header information is requested. The header consists of the three bytes "FFh 00h 00h" followed by a forth byte that refers to the just mentioned serial port (or virtual port) which derives from the four Serial Link ports. If PB is set to "1", the hexadecimal value to address it would be "00". If it is set to the maximum port "4", the hexadecimal value is "03". In other words, you can control up to four Sequences via TCP. To make the following examples easier, we assume that the serial port in the Sequence Inspector of PB is set to "1". This results in the following hexadecimal values for the header:
FFh 00h 00h 00h

Once the connection is set up, the following commands are valid to control the Sequence:

ASCII command

Hexadecimal command


28 50 6C 61 79 29

Sets the sequence state to "Play".


28 50 61 75 73 65 29

Sets the sequence state to "Pause".


28 53 74 6F 70 29

Sets the sequence state to "Stop" which jumps to the time 00:00.

(CueID) e.g (Cue13)

28 43 75 65 31 33 29

Sets the timeline Nowpointer to the time of cue 13.

In this example, the header and the control command "Play" is sent. If sending several commands, you can send the header once and then your commands stand-alone or you can always include the header. The examples are based on the scripting commands TCPSend and TCPSendHex from Widget Designer. The command arguments are enclosed by round brackets. The first "1" refers to an internal ID for a TCP Server connection that was set up beforehand. The string to be sent is enclosed by quotation marks.

Examples for Widget Designer

TCPSend(1,"[hFF h00 h00 h00]") or
TCPSendHex(1,"FF 00 00 00")

Sends header alone as hexadecimal data

TCPSend(1,"[d255 d0 d0 d0]")

Sends header alone as decimal data


Sends command alone

TCPSendHex(1,"FF 00 00 00 28 50 6C 61 79 29")

Sends header and command as hexadecimal data

TCPSend(1,"[hFF h00 h00 h00] (Play)")

Sending header and command in combination of hexadecimal and ASCII data