-
Notifications
You must be signed in to change notification settings - Fork 0
Frontier Silicon Radio Binding
Documentation of the Frontier Silicon Radio binding for Internet Radios based on the Frontier Silicon chipset.
This binding has been developed and tested with the Hama IR110 and Medion MD87180 internet radios. The MEDION® P85040 (MD 86988) and the Pinell Supersound II are also supported.
You can easily check if your IP radio is supported:
- Figure out the IP of your radio (e.g. by looking it up in your router)
- Figure out the PIN that is configured for the radio (somewhere hidden in the radio's on-screen menu); or try the default pin
1234
- Go to your web browser and enter:
http://<IP>/fsapi/CREATE_SESSION?pin=<PIN>
- If the response is similar to
FS_OK 6836164442
, your radio is most likely compatible with this binding - If you radio works with this binding, please add it to the list above by Editing this page!
For installation of the binding, please see Wiki page Bindings.
The Frontier Silicon Radio binding is included since openHAB 1.7.0.
Configuration is done in the openhab.cfg file (in the folder ${openhab_home}/configurations
):
############################### Frontier Silicon Radio Binding ###################################
#
# Hostname/IP of the radio to control
#frontiersiliconradio:radio.host=192.168.0.100
# PIN access code of the radio (default: 1234)
#frontiersiliconradio:radio.pin=1234
# Portnumber of the radio to control (optional, defaults to 80)
#frontiersiliconradio:radio.port=80
# The number of milliseconds between checks of the radio
# (optional, defaults to 60 seconds).
#frontiersiliconradio:refreshInterval=60000
# Cache the state for n minutes so only changes are posted (optional, defaults to 0 = disabled)
# Example: if period is 60, once per hour all states are posted to the event bus;
# changes are always and immediately posted to the event bus.
# The recommended value is 60 minutes.
#frontiersiliconradio:cachePeriod=60
Some notes:
- 'radio' is an identifier that can be replaced with your custom identifier, e.g. 'bedroom' or 'radio-kitchen'. This allows to use the binding also for multiple radios.
- The pin may vary from radio to radio, you can typically look it up in the radio settings.
- 'refreshInterval' and 'cachePeriod' are global settings that apply to all radios.
There are different types of item bindings, all of them are qualified with the device's identifier used in the openhab.cfg
file:
frontiersiliconradio="<identifier>:<property>"
Example for the power state of a device with identifier radio
:
Switch RadioPower "Radio Power" { frontiersiliconradio="radio:POWER" }
A list of all properties and their possible item types is given below:
item | item type | purpose | changeable |
---|---|---|---|
POWER |
Switch | power state | yes |
MODE |
Number | radio mode (details about mapping below) | yes |
VOLUME |
Number | volume | yes |
MUTE |
Swtich | mute | yes |
PLAYINFONAME |
String | title of current playback, e.g. radio station | no |
PLAYINFOTEXT |
String | additional information, e.g. current song | no |
PRESET |
Number | select preset, e.g. configured radio stations | yes |
The radio mode property is just a number that specifies the radio mode which may differ for each radio. This is why there is no fixed mapping implemented. For radios listed above, the mapping is as follows (please add your radio mapping, if it differs!):
radio mode | Hama IR110 | Medion MD87180 | Medion MD 86988 | Pinell Supersound II |
---|---|---|---|---|
0 | Internet Radio | Internet Radio | Internet Radio | Internet Radio |
1 | Spotify | Music Player (USB, LAN) | Music Player | Spotify |
2 | Player | DAB Radio | FM Radio | Player |
3 | AUX in | FM Radio | AUX in | DAB Radio |
4 | - | AUX in | - | FM Radio |
5 | - | - | - | AUX in |
Items:
Switch RadioPower "Radio Power" (gRadio) { frontiersiliconradio="radio:POWER" }
Number RadioMode "Radio Mode [%d]" (gRadio) { frontiersiliconradio="radio:MODE" }
Switch RadioMute "Radio Mute" (gRadio) { frontiersiliconradio="radio:MUTE" }
Number RadioVolDimmer "Radio Volume [%d %%]" (gRadio) { frontiersiliconradio="radio:VOLUME" }
String RadioPlayInfoName "Play Info Name [%s]" (gRadio) { frontiersiliconradio="radio:PLAYINFONAME" }
String RadioPlayInfoText "Play Info Text [%s]" (gRadio) { frontiersiliconradio="radio:PLAYINFOTEXT" }
Number RadioPreset "Preset" (gRadio) { frontiersiliconradio="radio:PRESET" }
Sitemap (presets and mode are radio-specific, this is why their mapping is specified here):
Frame label="Radio Control" {
Switch item=RadioPower
Selection visibility=[RadioPower==ON] item=RadioPreset mappings=[0="1Live", 1="WDR2", 2="SWR3"]
Selection visibility=[RadioPower==ON] item=RadioMode mappings=[0="Internet Radio", 1="Spotify", 2="Player", 3="AUX IN"]
Slider visibility=[RadioPower==ON] item=RadioVolDimmer
Switch visibility=[RadioPower==ON] item=RadioMute
Text visibility=[RadioPower==ON] item=RadioPlayInfoName
Text visibility=[RadioPower==ON] item=RadioPlayInfoText
}
If you would like to extend this binding and contribute further functionality, here is some technical information about it. The communication with the radio is realized via simple HTTP requests. Unfortunately, there is no official documentation of the API for the frontier silicon chipset, but there are some sources around the internet (flammy/fsapi on github, for example). Until now, only the following requests are implemented:
- netRemote.sys.power
- netRemote.sys.mode
- netRemote.sys.audio.volume
- netRemote.sys.audio.mute
- netRemote.nav.action.selectPreset
- netRemote.play.info.text
- netRemote.play.info.name
If you like to add further actions, have a look at FrontierSiliconRadio.java.
###Linux / OS X
###Windows
- Cosm Persistence
- db4o Persistence
- Exec Persistence
- InfluxDB Persistence
- JDBC Persistence
- JPA Persistence
- Logging Persistence
- mapdb Persistence
- MongoDB Persistence
- MQTT Persistence
- my.openHAB Persistence
- MySQL Persistence
- rrd4j Persistence
- Sen.Se Persistence
- SiteWhere Persistence
- AlarmDecoder Binding
- Anel Binding
- Arduino SmartHome Souliss Binding
- Asterisk Binding
- Astro Binding
- Autelis Pool Control Binding
- BenQ Projector Binding
- Bluetooth Binding
- Bticino Binding
- CalDAV Binding
- Comfo Air Binding
- Config Admin Binding
- CUL Binding
- CUL Intertechno Binding
- CUPS Binding
- DAIKIN Binding
- Davis Binding
- Denon Binding
- digitalSTROM Binding
- DMX512 Binding
- DSC Alarm Binding
- DSMR Binding
- eBUS Binding
- Ecobee Binding
- EDS OWSever Binding
- eKey Binding
- Energenie Binding
- EnOcean Binding
- Enphase Energy Binding
- Epson Projector Binding
- Exec Binding
- Freebox Binding
- Freeswitch Binding
- Frontier Silicon Radio Binding
- Fritz AHA Binding
- Fritz!Box Binding
- FS20 Binding
- Global Cache IR Binding
- GPIO Binding
- HAI/Leviton OmniLink Binding
- HDAnywhere Binding
- Heatmiser Binding
- Homematic / Homegear Binding
- HTTP Binding
- IEC 62056-21 Binding
- IHC / ELKO Binding
- ImperiHome Binding
- Insteon Hub Binding
- Insteon PLM Binding
- IPX800 Binding
- IRtrans Binding
- jointSPACE-Binding
- KNX Binding
- Koubachi Binding
- LCN Binding
- LightwaveRF Binding
- Leviton/HAI Omnilink Binding
- Lg TV Binding
- Logitech Harmony Hub
- MailControl Binding
- MAX!Cube-Binding
- MAX! CUL Binding
- MiLight Binding
- MiOS Binding
- Modbus TCP Binding
- MPD Binding
- MQTT Binding
- MQTTitude binding
- Neohub Binding
- Nest Binding
- Netatmo Binding
- Network Health Binding
- Network UPS Tools Binding
- Nibe Heatpump Binding
- Nikobus Binding
- Novelan/Luxtronic Heatpump Binding
- NTP Binding
- One-Wire Binding
- Onkyo AV Receiver Binding
- Open Energy Monitor Binding
- OpenPaths presence detection binding
- OpenSprinkler Binding
- OSGi Configuration Admin Binding
- Panasonic TV Bindung
- panStamp Binding
- Philips Hue Binding
- Piface Binding
- pilight Binding
- Pioneer-AVR-Binding
- Plex Binding
- Plugwise Binding
- PLCBus Binding
- Primare Binding
- Pulseaudio Binding
- RFXCOM Binding
- RWE Smarthome Binding
- Sager WeatherCaster Binding
- Samsung AC Binding
- Samsung TV Binding
- Serial Binding
- Sallegra Binding
- Satel Alarm Binding
- Sinthesi Sapp Binding
- Snmp Binding
- Somfy URTSI II Binding
- Sonos Binding
- Squeezebox Binding
- Swegon ventilation Binding
- System Info Binding
- TA CMI Binding
- TCP/UDP Binding
- Tellstick Binding
- TinkerForge Binding
- Tivo Binding
- VDR Binding
- Velleman-K8055-Binding
- Wago Binding
- Wake-on-LAN Binding
- Waterkotte EcoTouch Heatpump Binding
- Weather Binding
- Wemo Binding
- Withings Binding
- XBMC Binding
- xPL Binding
- Yamahareceiver Binding
- Zibase Binding
- Z-Wave Binding
- Asterisk
- Google Calendar
- Linux Media Players
- ROS Robot Operating System
- Telldus Tellstick
- Zoneminder
- Wink Hub (rooted)
- Wink Monitoring
- Transformations
- XSLT
- JSON
- REST-API
- Security
- Service Discovery
- Voice Control
- BritishGasHive-Using-Ruby
- Dropbox Bundle
A good source of inspiration and tips from users gathered over the years. Be aware that things may have changed since they were written and some examples might not work correctly.
Please update the wiki if you do come across any out of date information.
- Comfo Air Binding
- Ecobee Examples
- Nest Examples
- Rollershutter Bindings
- Squeezebox
- WAC Binding
- WebSolarLog
- Alarm Clock
- Convert Farenheit to Celcius
- The mother of all lighting rules
- Reusable Rules via Functions
- Combining different Items
- Items, Rules and more Examples of a SmartHome
- Google Map
- Controlling openHAB with Android
- Usecase examples
- B-Control Manager
- Spell checking for foreign languages
- Flic via Tasker
- Chromecast via castnow