|
| 1 | +--- |
| 2 | +layout: page |
| 3 | +title: "Frontier Silicon Internet Radios" |
| 4 | +description: "Instructions how to integrate Frontier Silicon Internet Radios into Home Assistant." |
| 5 | +date: 2017-02-04 00:01 |
| 6 | +sidebar: true |
| 7 | +comments: false |
| 8 | +sharing: true |
| 9 | +footer: true |
| 10 | +ha_category: Media Player |
| 11 | +ha_iot_class: "Local Push" |
| 12 | +ha_release: 0.40 |
| 13 | +--- |
| 14 | + |
| 15 | +This component provides support for Internet Radios based on the [Frontier Silicon chipset]. Some of the manufacturers which offer products based on these chips include: Hama, Medion, Slivercrest, Auna, Technisat, Revo, Pinnel, etc. These devices will be usually controlled by the [UNDOK] app. |
| 16 | + |
| 17 | +## {% linkable_title Supported Models %} |
| 18 | +* Hama: [IR110], [DIR3110] |
| 19 | +* Medion: [Medion Radios] |
| 20 | +* Silvercrest: [SIRD 14 C2] |
| 21 | +* Some models from: Auna, Technisat, Revo, Pinell |
| 22 | + |
| 23 | +This component was developed and tested with a Hama [DIR3110] and a Medion [MD 87466]. |
| 24 | + |
| 25 | +## Configuration |
| 26 | + |
| 27 | +Your Frontier Silicon based device should be automatically discovered by home assistant. The auto-discovery service assumes that the device uses the default PIN code: *1234*. If you have changed the PIN code, the auto-discovery will fail as home assistant will not be able to connect to the device. You can set the PIN code of your device (depending on manufacturer) under: |
| 28 | + |
| 29 | +*MENU button > Main Menu > System setting > Network > NetRemote PIN setup* |
| 30 | + |
| 31 | +If your device was not automatically discovered or you have changed the PIN you can alternatively add the following to your `configuration.yaml` file: |
| 32 | + |
| 33 | +```yaml |
| 34 | +# Example configuration.yaml entry |
| 35 | +media_player: |
| 36 | + - platform: frontier_silicon |
| 37 | + host: IP_ADDRESS |
| 38 | +``` |
| 39 | +
|
| 40 | +Configuration variables: |
| 41 | +
|
| 42 | +- **host** (*Required*): The host name or the IP address of the device. Defaults to 192.168.1.11. |
| 43 | +- **port** (*Optional*): The port number. Defaults to 80. |
| 44 | +- **password** (*Optional*): PIN code of the Internet Radio. Defaults to 1234. |
| 45 | +
|
| 46 | +In case your device (friendly name) is called *badezimmer*, an example automation can look something like this: |
| 47 | +
|
| 48 | +```yaml |
| 49 | +# Example configuration.yaml automation |
| 50 | +alias: "Bathroom Motion Detected" |
| 51 | +trigger: |
| 52 | + platform: state |
| 53 | + entity_id: binary_sensor.motion_sensor_166d0001171111 |
| 54 | + |
| 55 | + from: 'off' |
| 56 | + to: 'on' |
| 57 | + state: 'on' |
| 58 | +action: |
| 59 | + service: media_player.turn_on |
| 60 | + data: |
| 61 | + entity_id: "media_player.badezimmer" |
| 62 | +``` |
| 63 | +
|
| 64 | +## Screenshots: |
| 65 | +Overview DAB+ (Badezimmer) and Spotify (Küche): |
| 66 | +<p class='img'> |
| 67 | +<img src='/images/screenshots/frontier_silicon_overview.png' /> |
| 68 | +</p> |
| 69 | +
|
| 70 | +Overview of the info dialog: |
| 71 | +<p class='img'> |
| 72 | +<img src='/images/screenshots/frontier_silicon_info_dialog.png' /> |
| 73 | +</p> |
| 74 | +
|
| 75 | +## Development |
| 76 | +
|
| 77 | +Support is provided through the Python [fsapi] module. The Python module was developed by using the documentation provided by [flammy] and |
| 78 | +is based on [tiwillam]'s fsapi project. Special thanks to both developers, this component would have not been possible without their work. |
| 79 | +
|
| 80 | +## Notes and Limitations |
| 81 | +
|
| 82 | +<p class='note warning'> |
| 83 | +The Frontier Silicon API does not provide a multi-user environment. There is always a single user (session) controlling a device, which means that once home assistant connects to a device all other sessions will be invalidated. This renders the usage of [UNDOK] almost impossible, as the home assistant component polls the device state every 30 seconds or issues a command by creating a new session. |
| 84 | +*If you want to prevent home assistant to auto connect to your device, simply change the PIN code of the device to something else than: 1234* |
| 85 | +</p> |
| 86 | +
|
| 87 | +[Frontier Silicon chipset]: http://www.frontier-silicon.com/digital-radio-solutions |
| 88 | +[Medion Radios]: http://internetradio.medion.com/ |
| 89 | +[IR110]: https://www.hama.com/00054823/hama-ir110-internet-radio-internet-radio-multi-room-app-control |
| 90 | +[DIR3110]: https://www.hama.com/00054824/hama-digitalradio-dir3110-internetradio-dab+-fm-multiroom-app-steuerung |
| 91 | +[MD 87466]: https://www.medion.com/de/shop/internet-dab-radios-medion-kuechen-internetradio-medion-p83302-md-87466-50051273a1.html |
| 92 | +[SIRD 14 C2]: https://www.lidl.de/de/silvercrest-stereo-internetradio-sird-14-c2/p233545 |
| 93 | +[fsapi]: https://github.com/zhelev/python-fsapi |
| 94 | +[UNDOK]: http://www.frontier-silicon.com/undok |
| 95 | +[flammy]: https://github.com/flammy/fsapi/ |
| 96 | +[tiwillam]: https://github.com/tiwilliam/fsapi |
| 97 | +
|
0 commit comments