#####################################################################################
##                         "my preset command.s4las-Process"                        ##
#####################################################################################

##-----------------------------------------------------------------------------------
## HOST CONFIGURATION (remove "##" before commands for configuration)
##-----------------------------------------------------------------------------------

    ##*host=localhost     ## Set here the IP (exemple: 192.168.0.50 or localhost...) 
    ##*port=3004          ## Set here the port (default is 3004)


##   IMPORTANT :
##       3004 port in Sound4 server must be configured with noreply="true"
##       For more information, read detailled explanations below

##-----------------------------------------------------------------------------------
## LINK&SHARE COMMANDS (remove "##" before commands for execution)
##-----------------------------------------------------------------------------------
    ##preset.onair=BY-PASS   ## Set the preset "BY-PASS" on air
    ##preset.onairid=10      ## Set the preset ID N°10 on air



#####################################################################################
##                                       END                                       ##
#####################################################################################



#####################################################################################
##---------------------------- Beginning of explanations --------------------------##
#####################################################################################

##-----------------------------------------------------------------------------------
## INTRODUCTION - SOUND4 - LINK&SHARE TRANSMITER COMMANDS INFORMATION
##-----------------------------------------------------------------------------------

##   The LinkAndShareTransmitter.exe is an executable used for transmit commands to 
##   Sound4 Products. The LinkAndShareTransmitter.exe can be used in commands line or 
##   directly execute a script defined in a .s4las file
##
##   For a friendly use .s4las files can be customised in 9 different extensions for
##   easily recognizing Icon's:
##       .s4las                      = default extension
##       .s4las-preset               = Customised for Preset commands
##       .s4las-inputs               = Customised for Inputs commands
##       .s4las-Outputs              = Customised for Ouputs commands
##       .s4las-stereogenerator      = Customised for Stereo Generator commands
##       .s4las-RDS                  = Customised for RDS commands
##       .s4las-Process              = Customised for Process commands
##       .s4las-Group                = Customised for group commands
##       .s4las-IP                   = Customised for IP commands
##
##   By default, the LinkAndShareTransmitter.exe use the port 3004 to communicate 
##   with the Sound4 Server
##
##       IMPORTANT - FOR SOUND4 SERVER (On the PC which host the Sound4 Board)
##           Opened port for Link&Share must be configured with noreply="true" 
##           Port configuaration is located in:
##               C:\Program Files\Sound4\Server\Data\BoardsConfig\Ports.xml
##        
##    See below an example of Ports.xml file: here the login is set directly in the Ports.xml
##    file; by this way it is not necessary to set Login in the Link&Share command list.
##       <?xml version="1.0" encoding="utf-8"?>
##       <ports>
##           <!-- Open port 3001 for Sound4 Remote Control on all interfaces -->
##           <RemoteControl port="3001" />
##           <!-- Open port 3002  for Sound4 Remote Control only in loopback (localhost) -->
##           <RemoteControl port="3002" host="127.0.0.1" />
##           <!-- Open port 3003 for LinkAndShare on all interfaces -->
##           <LinkAndShare port="3003" />
##           <!-- Open port 3004 for LinkAndShare on all interfaces noreply mode -->
##           <LinkAndShare port="3004" noreply="true">
##               LOGIN admin,admin
##           </LinkAndShare>
##       </ports>
##
##


##-----------------------------------------------------------------------------------
## COMMAND LINE USE
##-----------------------------------------------------------------------------------

##   LinkAndShareTransmitter.exe [-h] [--host=host] [--port=port] [--cmd=commands] [file]
##       -h show help
##       host is default localhost
##       port is default to 3004
##       commands is a list of commands separated by ^
##       file is the file containing commands to Send (.s4las file)
##   IMPORTANT:
##       Use either commands or file, not both !
##       --cmd must be in last position !
##
##   SOME SAMPLE OF COMMAND LINE USE:
##       LinkAndShareTransmitter.exe -cmd=LOGIN admin,admin^RDS.PS=MyRadio
##       LinkAndShareTransmitter.exe mycommands.s4las
##               with mycommands.s4las containing for instance:
##                   LOGIN admin,admin
##                   RDS.PS=MyRadio


##-----------------------------------------------------------------------------------
## .s4las or .s4las-preset FILE USE
##-----------------------------------------------------------------------------------

##   .s4las files send all commands saved in file when a user open the file
##   .s4las files contain two parts:
##       The Communication (host and port)
##           *host=your host (IP, localhost...)
##           *port=3004 (or an other one if defined in 
##       The commands
##           All link&Share commands (ex: preset.onair=my preset name)
##
##   NOTE: 
##       There is no limitation, you can use a list of 100 commands or more if you 
##       wants. For a readable use, place one command per line.
##       All Link&Share commands are detailled in the Link&Share HandBook
##   NOTE:
##       You can access to multiple processors in the same script by changing the
##       *host between commands.

##-----------------------------------------------------------------------------------
## LINUX USERS
##-----------------------------------------------------------------------------------
##   You can use the linkandsharetransmitter executable file.
##   Add the following first line to your .s4las file :
##           #!/usr/local/bin/linkandsharetransmitter
##   and change your script to executable (chmod +x myscript.las)

#####################################################################################
##------------------------------ End of  explanations -----------------------------##
#####################################################################################