Radiator Laser Synthesizer
User Manual
TCP Protocol
The TCP protocol is a simple string-based protocol which mimics the same features as the MIDI
protocol but over a network socket. A bi-directional connection is made to Radiator on TCP port 4815.
Radiator will send in-band "ping" messages (not to be confused with ICMP pings) so that the remote
software knows it is still connected. A maximum of 4 connections can be maintained at one time.
TCP message format:
•
all messages as sent as ASCII text strings
•
all strings must be newline terminated ('\n')
Message format:
Command
Format
Notes
ping
"p\n"
sent every 500ms by Radiator
encoder
"e XX Y\n"
encoder message
•
XX
- encoder number as decimal string (same as CC mapping)
•
Y
- step amount as decimal string
•
e.g.
"e 59 -2\n"
- decrement control 59 by 2
•
e.g.
"e 45 1\n"
- increment control 45 by 1
button
"s XX YYYY\n"
button message
•
XX
- button number as decimal string (same as CC mapping)
•
YYYY
- "true" = pressed, "false" = released
•
e.g.
"s 16 true\n"
- button 16 pressed
•
e.g.
"s 16 false\n"
- button 16 released
pot
"r XX Y.YYY\n"
pot message
•
XX
- pot number as decimal string (same as CC mapping)
•
Y.YYY
- value from 0.000 to 1.000 as decimal float
•
e.g.
"r 91 0.50\n"
- pot 91 at 50%
LED
"l XX YY\n"
LED message
•
XX
- LED number as decimal string (same as CC button mapping)
•
YY
- color as RRGGBB int value encoded as a decimal number
•
e.g.
"l 16 16711680\n"
- button 16 LED at full red (0xff0000)
Software ver. 1.0 and above - 2020-09-03
Page 45 of 66
www.neoncaptain.com
