Configuration Options from within PADapult

 

Destination Setup

Pressing the Destination Setup button on the Main Screen will open and display Configuration options for that Destination. Up to ten Destinations can configured. All of the information entered here can also be found within the INI file under the [CONFIG #] sections. 

When in the Destination Setup screen, one can only modify a field section when that section has been selected via it's checkbox. When another section has been checked, the original data enter will be saved but grayed out. 
A IP Socket based Destination information. One sets the IP Address and PORT for IP Sockets. Total Bytes sent is shown to the right. 

You can select the option for Close IP Socket after each Send if the Destination receiver either has a requirement for Open / Closed Sockets or has issues with keeping a Socket open.

The Bytes Sent field keeps track of the total bytes sent. This counter can be reset via the checkbox option Reset Bytes Sent. [see item G]

 
B UDP Datagram based Destination information. One sets the IP Address and PORT for UDP Datagrams. Total Bytes sent is shown to the right. 

There is also a checkbox to allow PADapult to send Program Service Data (PSD) directly to an High Definition Importer. One must select this option if PADapult will be communicating directly to an iBiquity based unit. 

 When sending PSD to an Exporter for the Main Program Channel, enter the IP Address and Port (commonly 11000) and select the HDR checkbox.

When sending PSD to an importer, one should use the IP address of the importer with Port 10010 for SPS1 (HD2) and Port 10011 for SPS2 (HD3).  These port numbers are the default settings in the audio capture clients, which can be changed to any available port, but choose the port number carefully to avoid conflicts. 

NOTE: PADapult uses the Ibiquity PSDGen API version 4.5 which supports HDP 1.0 and 2.0 (pre Version 4).
When used with an HD Radio Importer, one must ensure that the Importer is running least version 2.1.5P1 with a SPS Capture Client_v3p0 or higher. Exciters must be running OS Version 7.1 and IRSS version 2.3.3 or later. One should contact the equipment manufacturer for more details concerning Importer / Exporter / Exciter software versions

For Pre-Version 4 versions one can check the Pre-V4. This allows data to be sent using Pre-4 methods. 

To output the XML data to multiple receivers, one should select the Checkbox and press the Receiver List Button.  This will open the Addresses#.INI file for the Destination. This file contains a list of IP Address or Websites that data will be sent to. For Example: 

[Addresses]
10.44.44.44=
10.44.44.45=
rama.enco.com=
;rama-0000.enco.com=
;rama-wxyz.enco.com=

 
C Here one can upload an XML file directly to a FTP site or to a Local drive. One would enter the Server and Directory. One must also enter the FTP User Name and Password. Enter the filename to be created along with the File Style. Supported file styles are:
  • SAGA: A custom XML file out for SAGA. 
  • SIMPLE: Provides 13 basic DAD fields within the XML file. 
  • FULL: Provides for 23 DAD Fields plus StationID, StationSlogan, Comments and TimeStamp. 
  • HISTORY: Creates an XML file containing the past few cuts sent through PADapult. This file uses the [AUTO INFO] Event History=X line within the INI file.

There is a checkbox option for FTP server that use Passive Mode. Checking this option allows you to also enter a PORT (the standard FTP port is 21). This mode will use the PASV instead of the PORT command directing the server into Passive mode where connections are initiated only by the client.

 
D The Output Format Template allows you to set the Default Output string to be sent to this Destination. This is the Default output string that will be used unless replaced via the Groups Format or Scheduled Messages. 

The RAW XML checkbox option allows for PADapult to output the actual XML data (Tags and Data) as a raw XML data stream. 

One can delay the output of data via the Output Delay field. The value of time entered in milliseconds will delay the output of data by the amount entered. This can be used to keep data and audio in sync. 

The checkbox for Force UPPERCASE will force the field data such as [title] to be output in all caps. 

The Group Formats button allows one to define Group mappings for having specific data sent for specific groups. If a Group does not match any entered in the Groups Formats, then the Output Format Template will be used. 

 
E Serial COM Ports are configured via this section. Here one can select the checkbox option for Serial to enable Serial communications. The field below this checkbox is for the physical COMM port number. The Baud Rate, Parity, Data Bits and Stop Bits are all defined in the Format field. Another Bytes Sent field displays information about the amount of data sent. 

 
F HTTP Messages allow one to send the data to either FriendFeed or Shoutcast. 

One will enter the Nickname / RemoteKey for FriendFeed or Password and the URL for Shoutcast. When an event is triggered, PADapult will send the Default Output string to these sites. 

NOTE: Because of changes made to Twitter - you must use FriendFeed to post tweets.

G Accept saves any changes made.

Destination Name displays the name on the Destination button. 

Process Scheduled Messages option allows one to have PADapult process the messages in the Scheduled messages screen. When unchecked, it will not process these messages.

Reset Bytes Sent reset all Byte Sent counters. 

Initialize I/O on Accept will reinitialize the Port (close and open) when the users press Accept. 

 

PADapult.INI Options 

 

One can modify the INI file by pressing the CONFIG button from the main PADapult screen. The following is an example INI file. 

Field Header Values and Examples Description of use
[GENERAL]
TITLEBAR Station A One is allowed to enter up to 20 characters as a description displayed within the TitleBar of the PADapult application. This can be used to identify multiple copies.  
[AUTO INFO]  
EVENT HISTORY 5 This value set the number of entries in the History XML file. Maximum value is 50.
USE PAD LENGTH FALSE / TRUE When TRUE - PADapult will use the duration of the cut to determine when to stop sending data. 

FALSE - PADapult will continue to send the Default Output until another cut's information is recieved.

STATE AUTO / MANUAL

AUTO - When in AUTO mode, data from the automation system will be automatically sent to the enabled streams. 

 

MANUAL  - When in MANUAL mode, users can enter their own data and send it to any enabled stream.
COMMENT Hello World!  One can enter text comment strings via the Comment field in the main application. 
STATIONID Example: K-ENCO

One can enter a predefined Station ID here. This will be send out to the data stream when one uses the STATIONID tag. This entry follows the state of the STATION ID pull-down menu on the main screen. 

 

NOTE: STATIONID can be entered into the Output Data string by entering [STATIONID] as a field. 
STATIONSLOGAN Example: DAD is your best bet! One can enter a predefined Station Slogan here. This will be send out to the data stream when one uses the STATIONSLOGAN tag. This entry follows the state of the STATION SLOGAN pull-down menu on the main screen. 

NOTE: STATIONSLOGAN can be entered into the Output Data string by entering [SLOGAN] as a field. 
INPUT MODE

Options are:

IP, UDP, FILE, SERIAL, HTTP, TELNET and NONE

 

 		 This defines which mode PADapult should use.

 

NOTE: This can be controlled via the Auto Inputs button or via a Send Text DCL from DAD:

SEND TEXT A '<COMMAND>ENABLE INPUT HTTP_C24</COMMAND>'
SEND TEXT A '<COMMAND>ENABLE INPUT XML_IP</COMMAND>'
     
FILENAME   Example: C:\DAD\PBK1.xml

Path for the XML file created by the automation system. 

 
FILEINTERVAL 5

Length of time in seconds between scans for the above XML file. Once the file has been scanned, it will be consumed and deleted by PADapult. 

 
FILEFORMAT Options are:

DAD_XML, Wide Orbit (xml), Dalet (xml), Maestro(xml) or Digilink(xml)

The File Format to be used.
      
IPPORT Example: 2004

Enter the IP PORT used by the automation system to communicate to PADapult.

 
IPFORMAT Options are:

DAD_XML, DAD_SENDTEXT, ABC, AV, AV2, RCS, SCOTT_C, SCOTT_D, DIAL_GLOBAL, WIDE_ORBIT, DALET_XML, MAESTRO_XML, DIGILINK_TEXT, DIGILINK_XML  

Defines the IP Format from the automation system. 

 

 
 
UDPPORT Example: 2002

Enter the UDP PORT used by the automation system to communicate to PADapult.

 
UDPFORMAT Options are:

DAD_XML, DAD_SENDTEXT, ABC, AV, AV2, RCS, SCOTT_C, SCOTT_D, DIAL_GLOBAL, WIDE_ORBIT, DALET_XML, MAESTRO_XML, DIGILINK_TEXT, DIGILINK_XML  

Defines the UDP Format from the automation system. 

 
 
HTTPFORMAT Options are:

C24, SOMAFM

 One defines the HTTP data format to be used.  
HTTPURL For Example:

http://www.publicbroadcasting.net/c24/.guidenocode?fetch=4

or

http://somafm.com/recent/npr-gs.tre.xml

One defines the web address for access to Classical 24 data or SOMAFM.

 

NOTE: The C24 link is often out of sync with the actual audio stream.

 
HTTPINTERVAL 5000 Value in milliseconds to check for updates from Classical 24.

5000 should be the minimum amount of time used.

 
TELNETADDRESS Example: 10.20.30.40 Enter the IP Address to be used by PADapult to communicate to another system via Telnet.  
TELNETPORT Example: 21 Enter the PORT to used by PADapult.
TELNETFORMAT Supported Telnet options are:

MAESTRO

Defines the UDP Format from the automation system. 

 
 
COMMAND SERIAL PORT 1 COM Port number to be used to receive Command Strings for controlling PADapult.
COMMAND SERIAL SETTING

Example: 9600, n, 8, 1

 

 Baud Rate settings for the above Command Serial Port.
COMMANDPORT 8041

This port is used to communicate to PADapult.

 
Users should be careful about changing this port as DAD or RAMA could loose communications with PADapult. 

PADapult can accepts a serial input from an automation system.  For example an older DAD system that doesn’t have Playback State XML capability could use serial based Send Text Rules to feed PADapult. The Send Text Rule must conform to a specific format for PADapult to recognize it.  

[Cut] [124] [Title] [124] [Artist] [124] [Album] [124] [UserDef] [124] [SongID] [124] [AlbumID] [013]

For example:

12345|Bohemian Rhapsody|A Night at the Opera|70’s Rock|14253646|674733<cr>

SERIAL PORT 2 COM Port to be used by PADapult to receive data from the automation system. 
SERIAL SETTING 9600 N 8 1    Serial Port initialization string <baud> <parity> <data bits> <stop bits>

Example: 9600 N 8 1 
SERIAL FORMAT Supported formats are:

DAD, AV2, ABC   

 One defines the Serial Format for the automation system to communicate to PADapult

 

DAD

When set to DAD, one can use any DAD Library Database field. 

For example:

[ARTIST] [124] [TITLE] [124] [ALBUM]

When using type: DAD, one must define the serial Delimiter along with the [Serial Fields]. 
AV2

Looks for only CurrentEvent: of any kind. 

Also, items sent as: NextEvent will be skipped and ignored. 

For example:

CurrentEvent:Detroit Rock City, Kiss
ABC

If the string after the colon IS NOT a valid ABC category – then we process the Title after the 1st comma, Artist after 
the 2nd comma.  
For example: 

CurrentEvent:C1043,CARE ONE/CREDIT,SOMEMORE HERE


If the string after the colon IS one of the user wanted categories – we process the Title after the 2nd comma, Artist after the 3rd comma. 

For example:

CurrentEvent:TRO,TR1015-81,Silly Love Songs,Paul McCartney & Wings

If the string after the colon IS NOT one of the user wanted categories, but is a valid ABC category – we ignore it
SERIAL DELIMITER Example: [124]    

Enter the Serial String delimiter. This value is expressed in decimal encapsulated in square brackets. 

 

 

For your information: 

" - " = [045]

" ^ " = [094]

" _ " = [095]

" | " = [124]

" ~ " = [126]

 
[ABC Categories]  

CAT01=
CAT02=
CAT03=
CAT04=
CAT05=
CAT06=
CAT07=

CAT08=
CAT09=
CAT010=

COM

HAC

HOL

INT 

OLD

 

 

 

 

 One can enter the ABC Music Format designator to be used. 

PADapult knows all the valid ABC categories from ABCcats.ini

A maximum of 10 fields are allowed. 

See ABC Notes below. 
          
[SERIAL FIELDS]

FIELD1=
FIELD2=

FIELD3=

FIELD4=

FIELD5=
FIELD6=
FIELD7=
FIELD8=
FIELD9=
FIELD10=

 CUTID
TITLE
ARTIST
ALBUM
USERDEF
AGENCY
OUTCUE
GROUP
SONGID
ALBUMID		 One can enter any valid DAD Library database field name. A maximum of 10 fields are allowed. 
          
[MANUAL INFO]  
ARTIST    Manually entered information will be saved to the INI file and sent out to the enabled Destinations when the PADapult My Data button is pressed. 

   

  

  
TITLE    
ALBUM   
GENRE   
STATIONID   
STATIONSLOGAN   
COMMENTS   
        
[UFID]
STOREFRONT ID Stations will enter the ID that has been assigned to them for iTunes tagging. 
AFFILIATE ID Stations will enter the ID that has been assigned to them for iTunes tagging. 
DEFAULT SONG ID This data will be populated by the SONGID field in the Automation Systems Library database. 
[DESTINATIONS]  
NAME1=

NAME2=

NAME3=

 HD Radio

Web Site

RDS

 The values entered here will directly relate to the displayed name for the Config buttons on the Main screen and in the RAMA web portal. One can add a new 'name#' to add a new button. One may have up to ten total NAME entries. 
 
[STATION IDS]    
 

ID1=

ID2=

ID3=

ID4=

 

 KWIC 107.9 Houston. 

KWIC, More Great Classic Rock... ALL DAY LONG. 107.9 Houston. 

STATION ID 3

STATION ID 4

 The ID's entered here will show up in the pull- down menu from the main screen when using Auto or Manual. When a Station ID is selected, PADapult will use that selection in both AUTO and in MANUAL mode when the OUTPUT FORMAT has been written to use [STATIONID]. 

One is limited to a maximum of 12 Station ID's The total character limit for any single entry is a maximum of 80 characters. 
      
[STATION SLOGANS]  
 

SLOGAN1=

SLOGAN2=

SLOGAN3=

SLOGAN4=

 

 Great Classic Rock All Day Long. 107.9 KWIC

STATION SLOGAN NUMBER 2

STATION SLOGAN NUMBER 3

STATION SLOGAN NUMBER 4

 The Slogans entered here will show up in the pull-down menu from the main screen when using Auto or Manual. When a Station Slogan is selected, PADapult will use that selection in both AUTO and in MANUAL mode when the OUTPUT FORMAT has been written to use [SLOGAN]. 

One is limited to a maximum of 12 Station Slogans. The total character limit for any single entry is a maximum of 80 characters. 
       

NOTE: HDP Fields are 'fixed'. One can however associate a field in the XML data to the HDP field. For example, one might desire to send the Station ID and have it displayed on the HD Radio unit in the Genre Field. HDP Fields only output when in AUTO Mode. 
[HDP FIELDS]  
TITLE [TITLE] Data will be sent to the TITLE field display on the HD unit.  
ARTIST [ARTIST] Data will be sent to the ARTIST field display on the HD unit.  
ALBUM [ALBUM] Data will be sent to the ALBUM field display on the HD unit.  
GENRE [STATIONID] Data will be sent to the GENRE field display on the HD unit.  
COMMENTS TITLE [URL]    
COMMENTS DESC [COMMENTS] This is the Comments field in the main PADapult screen where users can enter text. [COMMENTS] is a PADapult field not a database field. 
COMMERCIAL PRICE [USERDEF] Used for iTunes tagging 
COMMERICAL SELLERNAME [AGENCY] Used for iTunes tagging
UFID [SONGID] Used for iTunes tagging
UFIDOWNER [STATIONID] Used for iTunes tagging
      
[SCHEDULED MESSAGES]  
INTERLEAVE PAD DATA TRUE  / FALSE

TRUE - Scheduled Messages will be displayed between the normal Output PAD data string. 

FALSE - Only Output Data strings will be sent and displayed. 

Details on Scheduled Messages can be found here. 
INTERVAL  4 Time value in seconds between the Scheduled Message and the Output Format data strings. . 
      

NOTE: The numbered Config sections relate directly to the numbered Named Destinations. For example Config 1 relates Destination Name 1. Many of the settings below can also be modified by the graphical Destination Setup Screen. Config 1 through Config 10 all have the same options available.  
[CONFIG 1]
DESTINATION NAME Example:  RDS Encoder This is used for reference only allowing one to determine the association for the Config and Destination. 
IPSOCKET 0

0 - IPSockets are disabled. 

1 - IPSockets are enabled and in use.   

NOTE: One can use either IPSockets or UDPDatagrams but not both at the same time for the same Destination. 
IPADDRESS 10.44.44.144   IP Address to be used with the IPPort for IPSockets. The Address given will be the Destination address.
IPPORT 4444 The port number entered here will be the port used by the receiving device. 
INIT TCP ON EACH SEND 0

0 - Disabled. 

1 - Enabled.   

 

NOTE: When enabled, PADapult will initialize the connection each time data is sent. This can help re-establish a connection in the event it is lost. 
UDPDATAGRAM 1 0 - IUDPDatagrams are disabled. 

1 - UDPDatagrams are enabled and in use.   

NOTE: One can use either IPSockets or UDPDatagrams but not both at the same time for the same Destination. 
UDPADDRESS 10.44.44.144   IP Address to be used with the UDP Port or with HDP PSD.   
UDPPORT 4445 The port number entered here will be the port used by the receiving device.  
IPHDP TRUE  

TRUE - Enabled allowing data to be sent to the UDP Address and formatted for a HD Importer

FALSE - Disabled. 

NOTE: This should only be checked when sending to a HD device such as an Importer. 
HDP PRE V4 TRUE

TRUE - Allows the data to be sent using Pre-version 4 methods. 

FALSE - Disabled.

 

MULTI RECEIVERS 0

0 - Disabled. 

1 - Enabled.   

 

NOTE: When checked, PADapult will send the XML data to all addresses listed in the Addresses#.INI file. 
SERIAL 0  

0 - Serial output is disabled. 

1 - Serial output is enabled and in use.   

NOTE: One can use either Serial or an IP based destination but not both at the same time for the same Destination.   
SERIALPORT 1   COMM Port to be used to send data to the receiving device.   
SERIALFORMAT 9600,N,8,1   COMM Port settings. These must be set to match the receiving device. Values are set as follows: <baud> <parity> <data bits> <stop bits> 
OUTPUTFORMAT Now Playing [TITLE]   The Output Format defined here should be considered the Default output format. More details about defining the Output Format can be found here.  
OUTPUTDELAY 0 The value of time entered in milliseconds will delay the output of data by the amount entered. This can be used to keep data and audio in sync. 
RAW XML 0

0 - Disabled. 

1 - Enabled.   

 

NOTE: When checked, PADapult will send the XML data out as RAW data (which would include the XML Tags and XML Data. This allows PADapult to act as a pass-through device. 
UPPERCASE 0

1 - Field data will be sent as Uppercase.

0 - Field data will be sent as formatted. 
ENABLED 1  

1 - This Destination is enabled.

0 - This Destination is disabled. 

 

NOTE: This is linked with the Checkbox to the left of the Destination button on the main screen. When checked, PADapult will send data to this destination. 

FTP 0

0 - Disabled. 

1 - Enabled. 
FTPSERVER For example:  FTP.ENCO.com Enter the FTP Server name.
FTPDIRECTORY For example: Incoming Enter the Directory name the file should be created in. 
FTPFILENAME For example: DAD.XML Enter the File name to be created.
FTPUSERNAME For example:  enco Enter the FTP Login Username. 
FTPPASSWORD For example:  enco Enter the FTP Login Password
FTPFILESTYLE
  • SAGA: A custom XML file out for SAGA. 
  • SIMPLE: Provides 13 basic DAD fields within the XML file. 
  • FULL: Provides for 23 DAD Fields plus StationID, StationSlogan, Comments and TimeStamp. 
  • HISTORY: Creates an XML file containing the past few cuts sent through PADapult. This file uses the [AUTO INFO] Event History=X line within the INI file.

Enter the Style of XML file to create. 

 
FTPPASSIVE 0 This mode will use the PASV instead of the PORT command directing the server into Passive mode where connections are initiated only by the client.
FTPPORT 21 The FTP Port to be used. Commonly 21.
LOCALFILE 1 When enabled, PADapult will create a file on the local drive using the Directoy and File Name fields.
HTTP 0

0 - Disabled. 

1 - Enabled. 
FRIENDFEED 0

0 - Disabled. 

1 - Enabled. 
SHOUTCAST 0

0 - Disabled. 

1 - Enabled. 
HTTPUSERNAME Enter the Username for Twitter or Nickname for FriendFeed. 
HTTPPASSWORD Enter the Password for Twitter or RemoteKey for FriendFeed. 
HTTPURL   Enter the URL for Shoutcast.
PROCESS SCHEDULED MESSAGES 0  

1 - Processing of additional Scheduled Messages is enabled.

0 - Scheduled Messages will not be sent.

 

Details on Scheduled Messages can be found here. 

 

 

 

ABC NOTES on using Serial Format = ABC

When using ABC, one must create an ABCcats.INI file that lives in the \PADapult directory with the application. 

An sample of the file is below: 

A copy of the file can be found here. 


[All ABC Categories]
Cat001=ACF
Cat002=ACJ
Cat003=ACH
Cat004=ACL
Cat005=ACM
Cat006=ACO
Cat007=BCA
Cat008=BCF
Cat009=BCH
...

Cat108=VTN


There is a maximum number of entries in this file of 110 categories.