RS232 Protocol, Version 0.9

RS232 Settings: 115k Baud, 8 Datenbits, No Parity, 1 Stopbit

Every RS232 command consists of a ASCII string with following Carriage Return (CR) 
and Linefeed (LF). 
All numbers are in Hex-Format: 0, 1, 2, ..F, 10, 11, ... 1F, 20, ... . 
These Hex numbers must be written in capitals. All response messages are also capitals 
and must be finished with CR, LF.

Wrong entries (Synthax) or not executable commands get the response 
"Error AAAA_XX" AAAA=Net-Adresse XX ErrorCode).

Only after the aknowledgement of the last command, the next command will be excepted. 
All commands start with a 3-letter code, followed by a space. 

The following devices are defined:
Syslink 1..4: 	0x00 ... 0x03
AD-Converter:	0x10
DA-Converter:	0x11
Mixer			0x12
Delay			0x13
EQ_5Band		0x14
Hardware		0x16
PEQ_7Band		0x17


The following error-codes are defined:
Error 00: timeout on the serial connection
Error 01: timeout network
Error 02: RS232 format error (spelling,...)
Error 03: network message error
Error 04: general network error
Error 05: hardware failure
Error 06: routing failure
Error 07: parameter failure
Error 08: RS232 overflow
Error 09: timeout signal transfer


PAR AAAAvBBdCCsDDpEEFFFFFFFFGG	
BB: Device#, CC: Kanal#, DD: Code, EE:Code, FF:Name, GG: 00
RMS AAAAvBBrCCCCCCCCCCCCCCCC	; Ci: 8x 2 characters
SYS AAAAvBBdXXXXXXXXXXXXXXXX		
Save info to the actual preset (1. 8 Bytes)





 
The following commands are defined:

Commands, which communicate with the network:
These commands have a 3-character command code, followed by the data code

PC-command Log in/out (must be the first command):
	
Command:	LOG XXX			Login/logout XXX: ON, OFF
  Reply:	LOG XXX


PC-Command Get Syslink Address:
Address of the network node with the active serial connection (counting from the master 00...3F)
	
Command:	GSA ?			
  Reply:	GSA XXYYZZ		

XX: 10, YY:00..3F (hex, Master=00), ZZ: number of nodes in the network


PC Command Store Syslink Adress:
Every board in the network stores its node position as the network address. 
This command must be executed once after installing a network and before any other 
commands.  
	
Command:	GSA s			
	
	Reply (1 Syslink on the board):  GSA sAABB		

AA: 10, BB:Low Byte node address
	
	Reply (2 Syslinks on the board):  GSA sAABBsCCDD	

AA: 10, BB: Low Byte node 1, CC: 10, DD: Low Byte node 2, ...
	
	...
	

PC-Command Preset:
	PRE lXX		
Load actual parameter set of Preset#XX 
	Reply:
	PRE lXX		

	PRE sXX		
Store actual parameter set of Preset#XX
	Reply:
	PRE sXX		
XX: actual Preset

	PRE bXX		
Definition of the "Boot Preset" (Preset, that will be loaded after booting the system) 
	Reply:
	PRE bXX		
XX: actual boot preset

	PRE ?		
Gives the Preset# of the actual parameter set	
Reply:
	PRE XX		
XX: actual preset

	PRE vXXXXXX		
24 bit version code of the preset setup
	PRE v?			
Gives the code version of the preset setup



PC-Command Mute:
	MTE X		
X=?: actual mute status: X=1: mute on, X=0: mute off
	Reply:
	MTE XX		
XX: Mute-Status
	



Commands communicating with the network nodes directly:

These commands have a 3-character command code, followed by the 4 character address 
(e.g. ROU AAAA...: routing in network node AAAA. AAAA is a hardware address 
between 0000 and FFFF (in hex).
The small characters between the data code indicate the following: 
v=Device, d=Destination, s=Source, p=Parameter, r=RMS.


PC-Command Get Routing: 
Indicates the source device and the source index. 

	Command:	ROU AAAAvBBdCC?		

BB: Device-Number, CC: Target-Number
(e.g. ROU 1234v56d78?: routing in the node "1234" in Device "56" with 
the target "78" should be indicated)

	Reply:	ROU AAAAvBBdCCvDDsEE	

BB: Device-Number, CC: Target-Number, DD: Source-Device, Source-Index



PC-Command Set Routing: 
The routing in the node AAAA will be executed.
	
Command:	ROU AAAAvBBdCCvDDsEE	

BB: Device-Number, CC: Target-Number, DD: Source-Device, Source-Index
z.B. ROU 1234v56d78v9AsBC: Execute routing in the node "1234" in the 
device "56" with the target "78". 
	
Reply:	ROU AAAAvBBdCCvDDsEE	

BB: Device-Number, CC: Target-Number, DD: Source-Device, Source-Index

If SourceIndex == 0xff routing will be switched off. 


	
 
PC-Kommando Get Parameter:

AD-Converter: input name (8 characters), input configuration (4 character code) 
(HP, Phantom Power, Amplification, Calibration)

DA-Converter: output name (8 characters), output configuration (4 character code) 
(Relais, Mute)
	
Command:	PAR AAAAvBBdCCsDD?			

BB: Device#, CC: Channel#, DD: Section#
	
	Reply:	PAR AAAAvBBdCCsDDpEEFFFFFFFF	

(Device AD/DA-Converter)
BB: Device#, CC: Channel#, DD: Code, EE: Code, FF: Name 

Device Delay:
	PAR AAAAvBBdCCsDDpEEEEEEFF	

BB: Device#, CC: Channel#, DD: 00, EEEEEE: Delay-Time in 20usec-Incr., FF: Delay-Code

Device param EQ:
	PAR AAAAvBBdCCsDDpEEFFGG	

BB: Device#, CC: Channel#, DD: Section#, EE: Bandwidth, FF: Frequency, GG: Volume

Device graph. EQ:
	PAR AAAAvBBdCCsDDpEE		

BB: Device#, CC: Channel#, DD: Section#, EE: Volume

Device VM5080:
	PAR AAAAvBBdCCsDDpEE		

BB: Device#, CC: Channel#, DD: Parameter 1, EE: Parameter 2

	
PC-Command Set Parameter:

AD-Converter: input name (8 characters), input configuration (2 character code) 
(HP, Phantom, Amplification, Calibration)

DA-Converter: output name (8 characters), output configuration (2 character code) 
(Relais, Mute)

Device AD/DA-Wandler:
	PAR AAAAvBBdCCsDDpEEFFFFFFFFGG	

BB: Device#, CC: Channel#, DD: Code, EE: Code, FF: Name, GG: 00

Device Delay:
	PAR AAAAvBBdCCsDDpEEEEEEFF	

BB: Device#, CC: Channel#, DD: 00, EEEEEE: Delay-Time in 20usec-Incr., FF: Delay-Code

Device graph. EQ:
	PAR AAAAvBBdCCsDDpEE		

BB: Device#, CC: Channel#, DD: Section#, EE: Volume

Device param. EQ:
	PAR AAAAvBBdCCsDDpEEFFGG	

BB: Device#, CC: Channel#, DD: Section#, EE: Bandwidth, FF: Frequency, GG: Volume

Device ADVM (Voice-Matic subboard):

	PAR AAAAvBBdCCsDDpEE		

BB: Device#, CC: Channel#, DD: Parameter 1, EE: Parameter 2

	


As acknowledgement, any command will be answered in the same form as the command itself. 	




Frequency-Parameter
	Freq(x) = 15.625*2^(x/12), x=0..120; Bandwidth (x) = 0.1*(x+1), x=0..29

Some EQs are not able to process all frequencies / volumes / bandwidths. 



PC-Kommando Get RMS (Level)

RMS-Code: CC is a log. value: 0=CLIP, 1=+20dBu, 2=+17dB, 
3=+14dB, ... 17=-oodB
	
Command:	RMS AAAAvBB?		

BB: Device-Number
e.g. RMS 1234v10?: asks the Level (RMS) in the node "1234" in the device
AD-converter

	Reply:	RMS AAAAvBBrCCCCCCCCCCCCCCCC	; Ci: 8x 2 characters



PC-Kommando Get Volume

	Command:	VOL AAAAvBBcCCrDD?		

BB: Device-Number, CC: Column, DD: Row

	Reply:	VOL AAAAvBBcCCrDDvEE	

BB: Device-Number, CC: Column, DD: Row, EE: Volume


PC-Kommando Set Volume

	Command:	VOL AAAAvBBcCCrDDvEE	

BB: Device-Number, CC: Column, DD: Row, EE: Volume

	Reply:	VOL AAAAvBBcCCrDDvEE	

BB: Device-Number, CC: Column, DD: Row, EE: Volume (may be limited)




Volume-Code:

EE = Hex-Code, Range +18..-19dB: 1dB steps, -20..-58dB: 2dB steps, -60..-100dB: 10 dB steps

Vol-Code 0..3F:	

Vol-Code 0: -oodB; 
Vol-Code 1..5: -100dB..-60dB: 
Vol-Code 6..19: -58dB..-20dB; 
Vol-Code 1A..3F: -19dB..+18dB


Vol-Code 40..7F:	Mute with Volume-Code
Vol-Code 80..BF:	Phase inv. with Volume-Code
Vol-Code C0..FF:	Mute + Phase inv. with Volume-Code

Most faders end at 0dB, here the maximum volume code is 0dB. 
	
Decimal Code:

Code 0..63: 
	
Code 0: 		-oodB; 
Code 1..5: 		-100dB..-60dB: 
Code 6..25: 	-58dB..-20dB; 
Code 26..63: 	-19dB..+18dB



PC-Kommando Get System Info

	Command:	SYS AAAAvBB?        	

BB: Device-Number

	Reply DA-Converter:	SYS AAAAvBBdCCDDEEFFGGHHII	

BB: Device#, CC: cfg-Word, DD: 5VA, EE: 5VD, FF: +15, GG: -15, HH: 3.3V, II: Test-Connector

	Reply AD-Converter:	SYS AAAAvBBdCCDDEEFFGGHHII	

BB: Device#, CC: cfg-Word, DD: 5VA, EE: 5VD, FF: +15, GG: -15, HH: 00, II: 00


SYS AAAAvBBdXXXXXXXXXXXXXXXX		
Save Info to the actual Preset (1. 8 Bytes)
	
SYS AAAAvBB?						
Output Info to the actual Preset (1. 8 Bytes)
	
Reply:	SYS AAAAvBBdXXXXXXXXXXXXXXXX






With "Store Preset", all parameters are taken over and stored.