This tool eases command sending in an automatic and recurrent way.
This interpreter reads and executes text files containing the commands to send, with also specific commands to configure the Links or to synchronize the commands.
This tool has been designed to optimize the command transmission. Thus, if multiple hosts are specified in a single file, they will be controlled in parallel.
Specific Commands
Lines starting with # are comments and are ignored.
Lines starting with * are commands to configure the Transmitter.
host
Selects the IP address that will be used to send following commands.
Example:
*host=192.168.0.24
port
Selects the TCP communication port (default is 3004 due to historical reasons. Please always use 3003 now).
Example:
*port=3003
multihost
Allows to send the same script to many Processors.
Syntax:
*multihost=< IPaddress> :< port >,< target >,< user >,< password >
port is optional.
If user and password are not specified, Login will be required in the command flow, else Login command is implicit.
Example 1: This command will be sent to both Processors
multihost=192.168.4.23 *multihost=192.168.4.24:3003 LOGIN admin,admin Bk.Src[1]=Analog
Example 2:
multihost=192.168.4.23,,admin,pass1 *multihost=192.168.4.25,09100001,admin,pass2 *multihost=192.168.4.25,09110022,admin,pass3 Bk.Src[1]=Analog
Will be sent to the 3 processors. Note that logins were all different on each host !
include
Used to insert the content of another file at the current file location.
Example:
*include=my_commands.s4las
Remark:
- if the included file was encrypted, the command is unchanged because the Link&Share Transmitter will automatically look for the right file to use (with s4lasx extension).
- if there is in a directory an encrypted file and a non encrypted file with the same name (except extension), priority is given to non encrypted file : the previous command first looks for “my_commands.s4las” non-encrypted file. If it does not exist, it will look for the “my_commands.s4lasc” non-encrypted file
loadfile
Used to load a binary file, to convert it in ASCII and affect it to a named buffer.
Syntax:
*loadfile=< name >,< filename >
The content may be called back later by starting the line with $ sign and using the buffer name surrounded with $ signs. Example:
loadfile=MyPreset,OnePreset.s4fm4 $PRESET.FORCEIMPORT=$MyPreset$
wait
Wait for the specified time in milliseconds.
Example:
*Wait=500
waitfor/*event
Used for synchronization : *event is used to send a named event to an host, *waitfor is used on another host to wait for this event.
Caution not to create dead-locks. Best use the *rendezvous where possible.
Syntax:
*event=eventname
*waitfor=eventname
Example:
host=localhost *port=3003 LOGIN 06010001,admin,admin *WaitFor=myevent RDS.PS=Tata1 *host=localhost *port=3003 LOGIN 06010002,admin,admin *event=myevent RDS.PS=Tata2
rendezvous
Used to synchronize many hosts, using a “Rendez-Vous” mechanism.
Syntax:
*rendezvous=< rendezvous_name >
Every host that contains this command will wait for the others. Caution, use a particular rendez-vous only once per host. Example:
host=localhost *port=3004 LOGIN 06010001,Admin,admin *RendezVous=myrdv RDS.PS=Tata1 *host=localhost *port=3004 LOGIN 06010002,Admin,admin *RendezVous=myrdv RDS.PS=Tata2
savenext
Save in a variable the next command result.
*savenext=buffername
Example: Request the PS (RDS Program Service name) and the RT (RDS RadioText) of a processor, and affect them to the RT of the other processor
host=localhost *port=3004 LOGIN 06010001,Admin,admin *SaveNext=myps RDS.PS? *SaveNext=myrt RDS.RT? *host=localhost *port=3004 LOGIN 06010002,Admin,admin $RDS.RT=$myps$ - $myrt$!
Set
Use to affect a value to a buffer. Then the value can be recalled easily.
Example:
set=PS_perso,My Radio $RDS.PS=$PS_perso$
Command line parameters
-version
Request the software version
- check-none
Configure the software not to verify the Servers replies. Useful for half-duplex links.
- check-full
Configure the software to verify all Servers replies, to retry in case of error, and finally to return an error code if one or many commands failed.
- check-back
Configure the software to return immediately et execute the commands in background. Errors will be visible only in the log file.
-host --port --cmd
Used to send commands directly without using a command file. ^ sign replaces the “Carriage Return” (end-of-line)
Example:
LinkAndShareTransmitter --host=localhost --port=3003 --cmd="LOGIN admin,admin^RDS.PS=My Radio"
-crypt
Used to encrypt a file so nobody can read it. A new file is created with the same name but a different extension.
Example:
LinkAndShareTransmitter –crypt MyFile.s4las-preset
This command creates an encrypted file named MyFile.s4lasc-preset.
Remark: Link&Share Transmitter does not provides a way to decrypt a file.
Typical use examples
RadioText configuration
host=localhost LOGIN admin,admin RDS.RT=My new text...
OnAir Preset Selection
host=localhost LOGIN admin,admin Preset.OnAir=4B - Rock Hot # Selects OnAir Preset
Backup mode Main Input configuration
host=localhost LOGIN admin,admin # Force to quit Mix Mode In.MixMode=0 # Force Backup mode Bk.Src[Main]=Analog # analog input is Main
Backup mode input order configuration
host=localhost LOGIN admin,admin Bk.Src=Analog:Digital:PCI:IP # Inputs in this order
Copy a preset from one processor to another
host=localhost # Source Processor LOGIN admin,admin *SaveNext=MyVariable Preset.Export=4B - Rock Hot *host=192.168.0.22 # Target Processor LOGIN admin,admin $Preset.ForceImport=4B - Rock Hot,$MyVariable$
Copy the OnAir preset from one processor to another
host=localhost # Source Processor LOGIN admin,admin # Gets the OnAir preset name *savenext=PresetName Preset.OnAir? # Get the OnAir preset config *SaveNext=BufferPreset $Preset.Export=$PresetName$ *host=192.168.0.22 # Target Processor LOGIN admin,admin # ForceImport allows to reconfigure even if the preset # is already OnAir, without renaming it $Preset.ForceImport=$PresetName$,$BufferPreset$ # Configure the OnAir preset if it was not already OnAir $Preset.OnAir=$PresetName$
Copy the RDS Program Service from one processor to two others
host=localhost # Source processor LOGIN admin,admin *SaveNext=MyVariable RDS.PS? *multihost=192.168.0.22,,admin,admin *multihost=192.168.0.23,,admin,admin $RDS.PS=$MyVariable$
Turning back an IP link
Suppose that 192.168.0.1 processor is encoding and emitting on its Link 1, and that 192.168.0.2 processor receives it on its Link 1. This script turns back the Link.
host=192.168.0.1 LOGIN admin,admin # Turns back Link 1 IP.Lk1.mode=RX IP.Lk1.enable=1 # just in case # Activate the decoder IP.dec.source=Link 1 IP.dec.enable=1 # Change the Process Input to use this stream Bk.Src[Main]=IP # Stops the encoder IP.Enc.enable=0 *host=192.168.0.2 LOGIN admin,admin # Change the process input before removing the source Bk.Src[Main]=Analog # Activate the encodur IP.enc.enable=1 # Turns back Link 1 IP.Lk1.source=Encoder IP.Lk1.mode=TX IP.Lk1.enable=1 # just in case # Stops the Decoder IP.Dec.enable=0