Link and Share HDFM Examples

Warning: the commands listed here may change depending on the product, its version, and the authorized login access level. To have a list of what you can do, either download the XML documentation from SOUND4 Remote Control in About->Download L&S Doc, or connect with a telnet client, login and type help.

Input Management

There are two groups for input management : In (for Input) and Bk (for Backup).

Caution: input settings depends on mode. When in Mix mode, changing Backup source will not have any impact. In the other way, when not in Mix mode, setting Mix Level for Analog Input will not have any effect. Moreover, some presets may have their setting forced !

For more details, see the following commands:

• Backup Mode
  • Bk.Mode (Off, Backup or Priority)
  • Bk.Src (Array of 4 inputs, each may be Analog, Digital, PCI or IP)
  • Bk.FadeIn (0 to 5 sec)
  • Bk.FadeOut (0 to 5 sec)
• Mix Mode (cards only)
  • In.MixMode (0 or 1)
  • In.AnaMix (-100 to 0dB)
  • In.AesMix (-100 to 0dB)
  • In.PciMix (-100 to 0dB)
  • In.IpMix (-100 to 0dB)
  • In.MixFadeIn
  • In.MixFadeOut

Preset management

Presets are identifies either with their name or their identifier. For the last case, function ending with ID are used.

Preset.OnAir

Choose the Preset to set “On Air”, or return the “On Air” preset name.

Example: returns the “On Air” preset name

Preset.OnAir?

Example: set the “On Air” Preset

Preset.OnAir=4B – Rock Hot

Preset.List

Returns the Preset list defined in the Processor (Preset.List?) or request an asynchronous notification for Preset adding or removing (Preset.List!).

Example:

Preset.List?

Preset.Import et Preset.Export

Used to import (to the Processor) or export (to the client) a preset. The preset definition is binary converted into a hexadecimal text (type preset.import to see and understand).

Example: preset import

Preset.Import=4B - Rock Hot

Example: preset export

Preset.Export=4B - Rock Hot,0170737453344D4325 ...

This Preset format is understood by Sound4 Remote Control.

RDS

• RDS.On (0,1) Get/Set the RDS On or Off
• RDS.AFOn (0,1) Get/Set the RDS Alternative Frequencies (AF) On or Off
• RDS.PS Get/Set the RDS Program Service Name (PS)
• RDS.RT Get/Set the RDS Radio Text (RT)
• RDS.TA (0,1) Get/Set the RDS Traffic Announcement (TA) (RT)

SOUND4IP Links

A single command file may reconfigure a complete IP network.

We recommend, for simplicity reasons, to pre-configure all the Links using the Sound4 Remote Control software, and to manage only routing and activation via the L&S.

Decoders, Encoders and Links may be named for ease-of-use. Once defined, the name may be used to identify the entity.

Main commands are:

• Decoder
  • IP.dec.enable (0 or 1)
  • IP.dec.Source (Decoder Source, may be any IP Link)
• Encoder
  • IP.enc.enable (0 or 1)
  • IP.enc.bitrate (depends on codec)
  • IP.enc.codec (Linear, LD, LD Low Lat)
• Links (examples with Link 1)
  • IP.lk1.enable (0 or 1)
  • IP.lk1.source (encoder or another link)
  • IP.lk1.mode (RX, TX or Duplex)

Emergency Player (box only)

• EPlayer.Play Start playing
• EPlayer.Stop Stop playing
• EPlayer.current Get/Set currently playing song name
• EPlayer.autostart Enable/Disable AutoStart

Issues

12.0dBr Preset name

On an IMPACT and a PULSE, when Preset « MPX Power Target » is max (12.0 dBr), Preset name shown in caption is displayed « –.- dBr - PRESETNAME ». For example « 12.0 dBr - Rock » is displayed « –.- dBr - Rock ». But the real name of the preset is « 12.0 dBr - Rock ».

To use Preset in Link&Share, full name of the preset must be use.

For example to set a preset OnAir: PRESET.ONAIR=12.0 dBr - Rock

"PRESET.ONAIR=Rock" will not work