ioBroker.frontier_silicon

ioBroker adapter for Frontier SmartRadio

Tests:

Info

Provides support for media players, internet radios and SmartRadios equipped with a Frontier Silicon chipset using FSAPI.

NOTE: This adapter has been transferred to iobroker-community-adapters for maintenance. Thus planned features (see below) will not be implemented. Only important bug fixes and dependency updates will be released in the future. However PRs with bug fixes or feature enhancements are always welcome.

RELEASE NOTES:

Version 0.5.x includes a Breaking Change:

• node>=20, js-controller>=7.0.7 and admin>=7.6.17 required
  Upgrade your ioBroker to at least this software level, if you want to use this adapter

Version 0.4.x includes a Breaking Change:

• The type of "frontier_silicon.X.media.state" changed from "number" to "string" and readonly
  If you update this adapter from a previous version instead of a new installation, you may possibly find warnings in the ioBroker log like:
  State value to set for "frontier_silicon.0.media.state" has to be type "number" but received type "string"
  To prevent this from happening, the most simple solution is to stop the adapter in the instances tab of ioBroker, completely delete the object tree in the objects tab and then restart the adapter. This of course is only neccessary once after the update and is not required if you do a clean new installation.

Version 0.3.x includes some Breaking Changes:

• node>=18, js-contoller>=5 and admin>=6 required
  Upgrade your ioBroker to at least this software level, if you want to use this adapter

• PIN encryption and validity check of all parameters in config UI
  If you update this adapter from a previous version instead of a new installation, the adapter will not start, even if your PIN in your config is correct and has not been changed. To fix this, simply enter the same previous PIN once more in the config UI and store and close the config UI to restart the adapter. This of course is only neccessary once after the first start after the update.

• The type of "frontier_silicon.X.modes.selectPreset" changed from "string" to "number"
  If you update this adapter from a previous version instead of a new installation, you may possibly find warnings in the ioBroker log like:
  State value to set for "frontier_silicon.0.modes.selectPreset" has to be type "string" but received type "number"
  To prevent this from happening, the most simple solution is to stop the adapter in the instances tab of ioBroker, completely delete the object tree in the objects tab and then restart the adapter. This of course is only neccessary once after the update and is not required if you do a clean new installation.

• Synchronization of power, volume and mute states with the UNDOK App
  Synchronization with the UNDOK App here means that power, volume and mute settings changed by the UNDOK App will now also be updated in the states of this adapter. Due to the limitations of the FSAPI protocol the state synchronization of the UNDOK App with the adapter still is unreliable and will not be instantaneous but only happen when e.g. a preset or a mode is changed using the UNDOK App.

• Cyclic connection retry instead of disabling the adapter
  Previously the adapter was terminated after 10 session connection attempts when the device was unreachable due to long-lasting network problems like router restarts, LAN or WiFi outage. Now the adapter will retry after every session refresh interval until the device is reachable again. If you want to avoid log entries regarding these retries you have to stop the adapter manually. If your network problem is fixed while the retry period is still ongoing, simply restart the adapter.

Features

Implemented features

• Power control
• Mode selection
• Preset selection
• Notifications for several states
• Volume control
• Notifications
• Auto discovery

Planned features

• More states
• Translations
• More Exception handling
• Cleaner code
• Multi room features

Not planned features

• Changing system information

Known Bugs and Limitations

• The Media player must be on for preset discovery
• Due to limitations of the FSAPI protocol, parallel operation with the UNDOK App is not reliable and thus not supported. Use at own risk.
• Due to limitations of the FSAPI protocol, Radio station icons are not available in DAB+ mode.

Documentation

This adapter lets you control internet radios and media players based on Frontier Silicon chipsets. Many devices which can be controlled via UNDOK should work. Tested devices come from Revo, Sangean, Hama and SilverCrest, others should work, too.

After installation the device's IP and PIN must be entered in the configuration dialog. If the radio does not play DAB after switching on via the UNDOK App or this adapter try again with "DAB starts without sound" enabled.

When the adapter starts for the first time it collects information about the device. For that it needs to switch through all modes. During checking settings the device will be muted for a few seconds to avoid disturbing sounds.

Documentation of the states and objects as well as general FSAPI documentation can be found at
https://github.com/iobroker-community-adapters/ioBroker.frontier_silicon/blob/master/docs/en

Changelog

0.5.1 (2026-03-07)

• (copilot) Adapter requires admin >= 7.7.22 now
• (pdbjjens) Fixed: update release-script (#348)
• (mcm1957) Dependencies have been updated
• (pdbjjens) Fix: Add GitHub as npm Trusted Publisher
• (pdbjjens) Change: Update dependencies

0.5.0 (2025-08-28) - 2025H2 maintenance release

• (pdbjjens) Change: node>=20, js-controller>=7.0.7 and admin>=7.6.17 required
• (oelison) New: Read and write from daylight saving time
• (pdbjjens) Fix: UpdatePreset now handles empty presets correctly (#289)
• (pdbjjens) Change: Adapter and FSAPI documentation was moved to the docs folder (#281)
• (pdbjjens) Change: Cleanup devDependencies

0.4.0 (2025-02-01) - 2025H1 maintenance release

• (pdbjjens) Change: media state changed from number to string and readonly (#241)
• (pdbjjens) New: Added media control function "stop" (#241)
• (pdbjjens) New: Optimizations for responsive design (#244)
• (pdbjjens) Change: Migration to ESLint 9 (#253)
• (pdbjjens) Fix: Added button state acknowledgement
• (pdbjjens) Fix: Prevent warning on adapter stop

0.3.0 (2024-08-27) - 2024H2 maintenance release

• (pdbjjens) Change: node>=18, js-contoller>=5 and admin>=6 required
• (pdbjjens) Change: Removed .npmignore
• (pdbjjens) Change: Cyclic connection retry instead of disabling the adapter (#191)
• (pdbjjens) New: Updated dependencies
• (pdbjjens) Fix: Replace deprecated method "deleteChannel" by "delObject" (#224)

0.2.0 (2024-01-28)

• (pdbjjens) Change: Increase minor version number

Legal Notices

Frontier, Frontier Silicon, SmartRadio, UNDOK and associated logos are trademarks or registered trademarks of Frontier Smart Technologies Limited https://www.frontiersmart.com

All other trademarks are the property of their respective owners.

The authors are in no way endorsed by or affiliated with Frontier Smart Technologies Limited , or any associated subsidiaries, logos or trademarks.

License

MIT License

Copyright (c) 2026 iobroker-community-adapters [email protected]
Copyright (c) 2025 halloamt [email protected] & IoBroker-Community

Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.