Frontier Silicon Radio Binding - Osray/openhab GitHub Wiki

The Frontier Silicon Radio binding allows control of internet radios based the chipset manufactured by "Frontier Silicon".

At the moment the following devices are tested and known to work:

• Hama Internetradio "IR110"
• Medion P85040 (MD 86988) Internet-Radio

(Note: if you test new devices, please add them to the above list)

Caution: For proper operation of the binding, please make sure that the network interface of the radio is not turned off, when the radio is in standby. This can be configured in the radios network setting menu. Otherwise the radio may not be switched on remotely.

The binding needs to be configured in the openhab.cfg as follows:

 ############################### Silicon Frontier Radio Binding ###################################
 #
 # Refresh/polling rate of the binding in ms
 # (optional, default is 1000 ms)
 #frontiersiliconradio:refreshInterval=<refresh interval in ms>

 # First Radio
 # Hostname/IP of the first radio to control
 frontiersiliconradio:<device-ID>.host=<IP-address or hostname>
 
 # PIN access code of the radio (as configured in the radio menu)
 frontiersiliconradio:<device-ID>.pin=<access PIN>
 
 # Portnumber of the radio to control (optional, defaults to 80)
 #siliconfrontierradio:<device-ID>.port=<Portnumber>

refreshInterval is the time between polling the radio status. If you experience load problems due to the polling frequency, increase this time to. e.g. 10000 = 10s. Default is 1000 ms => poll once every second.

device-ID is the identifier of the radio, e.g. "sleepingroom". You may add more then one radio (not yet tested!)

host is the hostname or the IP-adress of the radio, e.g. "192.168.2.42"

pin is the remote access pin of the radio, a 4 digit number. It may be configured in the radio settings.

port is the portnumber of the radio, usually 80. Its an optional parameter, only configure this, if you are using NAT portforwarding or other special setups.

Example for a binding configuration:

 ############################### Silicon Frontier Radio Binding ###################################
 #
 # Hostname/IP of the radio to control
 frontiersiliconradio:radio.host=192.168.2.137

 # PIN access code of the radio (default: 1234)
 frontiersiliconradio:radio.pin=1234

The syntax for the item configuration is as follows:

 { frontiersiliconradio="<device-ID>:<parameter>" }

The device-id identifies the radio and must match one of the IDs from the bindings configuration section (in openhab.cfg).

The parameter identifies the parameter/property to bind the the item. The following parameters are currently supported:

• POWER, read-write: turns on/off the radio
• PRESET, write-only: tune to a radio station from the radios preset list
• MODE, read-write: switch the radios operating mode. Currently supported modes are: 0="Internet Radio", 1=Spotify, 2=Player, 3="AUX IN"
• MUTE, read-write: mute/unmute the volume
• VOLUME, read-write: adjust the radios volume from 0 - 100 percent
• PLAYINFONAME, read-only: a string containing the currently active radio station name
• PLAYINFOTEXT, read-only: a string containing the radio info text, e.g. the name of the song currently playing

Example of a items definition:

 Switch HamaRadio               "Radio Power" (gRadio) { frontiersiliconradio="radio:POWER" }
 Number HamaMode                "Radio Mode [%d]" (gRadio) { frontiersiliconradio="radio:MODE" }
 Switch HamaRadioMute           "Radio Mute" (gRadio) { frontiersiliconradio="radio:MUTE" } 
 Dimmer HamaRadioVolDimmer      "Radio Volume [%d %%]" (gRadio) { frontiersiliconradio="radio:VOLUME" } 
 String HamaPlayInfoName        "Play Info Name [%s]" (gRadio) { frontiersiliconradio="radio:PLAYINFONAME" }
 String HamaPlayInfoText        "Play Info Text [%s]" (gRadio) { frontiersiliconradio="radio:PLAYINFOTEXT" }
 Number HamaPreset              "Preset" (gRadio) { frontiersiliconradio="radio:PRESET" }

The items may be added to sitemap as follows (TODO: not yet complete!)

 Frame label="Radio Control" {
     Selection item=HamaPreset mappings=[0=1Live, 1=WDR2, 2=SWR3]
     Selection item=HamaMode mappings=[0="Internet Radio", 1=Spotify, 2=Player, 3="AUX IN"]
 }