homebridge-frontier-silicon-plugin 1.2.1 → 1.2.3

package/CHANGELOG.md

@@ -4,6 +4,26 @@ All notable changes to this project are documented in this file.
 
 The format is based on Keep a Changelog, and this project follows Semantic Versioning.
 
+## [1.2.2] – 2025-12-28
+
+### Fixed
+- Fixed station preset switches not turning off previously selected stations.
+- Ensured station switches behave as an exclusive selector (radio-style behavior).
+- Improved internal state handling to keep HomeKit UI in sync when switching stations.
+
+### Improved
+- More robust preset switching logic for Frontier Silicon radios using navigation-based FSAPI.
+
+
+## [1.2.1] – 2025-12-28
+
+### Fixed
+- Corrected preset numbering by mapping Homebridge presets (1-based) to Frontier Silicon FSAPI keys (0-based).
+- Fixed incorrect preset selection where presets were offset by one position on the radio.
+
+### Improved
+- Reliable DAB+ / preset switching using the required navigation-based FSAPI calls.
+
 ## [1.2.0] – 2025-12-28
 
 ### Added

package/README.md

@@ -30,49 +30,92 @@ This plugin is designed as a modern replacement for older Frontier Silicon Homeb
 
 Most internet radios from brands such as Roberts, Ruark, Revo, Hama and similar use Frontier Silicon firmware and are compatible.
 
-## Installation
+## Tested and Compatible Radios
+
+This plugin is designed for radios based on the **Frontier Silicon FSAPI (NetRemote API)**.
+It has been tested or is known to work on a wide range of internet and DAB+ radios using this platform.
+
+### Known compatible brands and models (non-exhaustive)
+
+**Hama**
+- IR100
+- IR110
+- DIR3100 / DIR3110 series
+
+**Medion**
+- MD87180  
+- MD86988  
+- MD86955  
+- MD87528  
+
+**Roberts**
+- Stream 83i  
+- Stream 93i  
+
+**Ruark**
+- R2  
+- R5  
 
-Install the plugin globally using npm
+**Revo**
+- SuperConnect  
 
-    npm install -g homebridge-frontier-silicon-plugin
+**Auna**
+- Connect 150  
+- Connect CD  
+- KR200  
 
-After installation, restart Homebridge.
+**TechniSat**
+- DIGITRADIO 350 IR  
+- DIGITRADIO 850  
+- VIOLA series  
 
-## Configuration
+**Silvercrest (Lidl)**
+- SMRS18A1  
+- SMRS30A1  
+- SMRS35A1  
+- SIRD series  
 
-Add the accessory to your Homebridge configuration.
+**Dual / Teufel**
+- Dual IR 3a  
+- Teufel 3sixty  
 
-### Example configuration
+### Important note
 
-    {
-      "accessory": "frontier-silicon",
-      "name": "Living Room Radio",
-      "ip": "192.168.1.50",
-      "pin": "1234",
-      "pollIntervalSeconds": 5,
-      "enableVolume": true
-    }
+This list is **not complete**.  
+Many internet and DAB+ radios use the same Frontier Silicon platform under different brand names.
 
-## Configuration options
+If your radio responds to the following URL:
+
+    http://<radio-ip>/fsapi/GET/netRemote.sys.info.friendlyName
+
+then it is very likely compatible with this plugin.
+
+If you successfully use this plugin with a radio that is not listed above, please consider opening an issue or pull request to help extend this list.
+
+
+## Installation
 
-name  
-Displayed name in HomeKit  
+### Recommended: Install via Homebridge UI
 
-ip  
-IP address of the radio  
+This plugin can be installed and configured entirely through the **Homebridge Config UI X**.
+No manual JSON editing is required.
 
-pin  
-FSAPI PIN code  
-Default is 1234 on most devices  
+1. Open the Homebridge UI in your browser
+2. Go to **Plugins**
+3. Search for **homebridge-frontier-silicon-plugin**
+4. Click **Install**
+5. After installation, go to **Settings → Accessories**
+6. Add a new accessory and select **Frontier Silicon Radio**
+7. Fill in the required fields:
+   - Name
+   - IP address of the radio
+   - FSAPI PIN (default is usually `1234`)
+8. (Optional) Configure volume options and station presets via the UI
+9. Save the configuration and **restart Homebridge**
 
-pollIntervalSeconds  
-Polling interval in seconds  
-Minimum value is 2  
-Default value is 5  
+After the restart, the radio and its controls will appear in the Apple Home app.
 
-enableVolume  
-Enable volume control  
-Default is true  
+---
 
 ## HomeKit behaviour
 

package/index.js

@@ -24,26 +24,20 @@ function FrontierSiliconAccessory(log, config) {
 
   this.enableVolume = config.enableVolume !== false;
 
-  // Keep both by default
   this.exposeSpeakerService = config.exposeSpeakerService !== false;
   this.exposeVolumeSlider = config.exposeVolumeSlider !== false;
 
-  // When selecting a station, power on first
   this.autoPowerOnOnPreset = config.autoPowerOnOnPreset !== false;
 
-  // Stations: [{ name: "Radio 2", preset: 0 }, ...]
-  // Important: preset numbers refer to the radio preset slots.
-  // If the radio says "empty preset", store that station to that preset slot on the radio first.
+  // stations: [{ name: "Radio 2", preset: 2 }, ...]
+  // preset is 1 based like the radio UI, internally we convert to 0 based presetKey for FSAPI
   this.stations = Array.isArray(config.stations) ? config.stations : [];
 
   this.lastKnownPower = null;
-
-  // Store last known RADIO volume on device scale 0..100
   this.lastKnownRadioVolume = null;
 
-  // We cannot reliably read current preset index on all firmwares.
-  // We track what we last selected via HomeKit and sync switches accordingly.
-  this.lastKnownPresetIndex = null;
+  // 0 based FSAPI preset key that we last selected via HomeKit
+  this.lastKnownPresetKey = null;
 
   this.isUpdatingStationSwitches = false;
 
@@ -62,14 +56,12 @@ function FrontierSiliconAccessory(log, config) {
     .setCharacteristic(Characteristic.Model, "FSAPI Radio")
     .setCharacteristic(Characteristic.SerialNumber, this.ip || "unknown");
 
-  // Power switch
   this.switchService = new Service.Switch(this.name);
   this.switchService
     .getCharacteristic(Characteristic.On)
     .on("get", this.handleGetPower.bind(this))
     .on("set", this.handleSetPower.bind(this));
 
-  // Volume services
   if (this.enableVolume) {
     if (this.exposeSpeakerService) {
       this.speakerService = new Service.Speaker(this.name + " Speaker");
@@ -102,7 +94,6 @@ function FrontierSiliconAccessory(log, config) {
     }
   }
 
-  // Station switches
   this.stationServices = [];
   this.buildStationServices();
 
@@ -118,14 +109,16 @@ FrontierSiliconAccessory.prototype.buildStationServices = function () {
     if (!s || typeof s !== "object") continue;
 
     const stationName = String(s.name ?? "").trim();
-    const preset = Number(s.preset);
+    const presetUi = Number(s.preset);
 
     if (!stationName) continue;
-    if (!Number.isFinite(preset)) continue;
+    if (!Number.isFinite(presetUi)) continue;
 
-    const p = Math.trunc(preset);
-    const subtype = "preset_" + String(p);
+    // Convert 1 based UI preset number to 0 based FSAPI key
+    const presetKey = Math.trunc(presetUi) - 1;
+    if (presetKey < 0) continue;
 
+    const subtype = "preset_" + String(presetKey);
     if (seenSubtypes.has(subtype)) continue;
     seenSubtypes.add(subtype);
 
@@ -133,14 +126,18 @@ FrontierSiliconAccessory.prototype.buildStationServices = function () {
 
     sw.getCharacteristic(Characteristic.On)
       .on("get", (cb) => {
-        const isOn = this.lastKnownPresetIndex === p;
-        cb(null, isOn);
+        cb(null, this.lastKnownPresetKey === presetKey);
       })
       .on("set", (value, cb) => {
-        this.handleSetStationPreset(p, !!value, cb);
+        this.handleSetStationPreset(presetKey, !!value, cb);
       });
 
-    this.stationServices.push({ preset: p, name: stationName, service: sw });
+    this.stationServices.push({
+      presetKey,
+      presetUi: Math.trunc(presetUi),
+      name: stationName,
+      service: sw
+    });
   }
 };
 
@@ -183,9 +180,7 @@ FrontierSiliconAccessory.prototype.handleGetVolume = async function (callback) {
   try {
     const radioVol = await this.client.getVolume();
     this.lastKnownRadioVolume = radioVol;
-
-    const homekitVol = radioToHomekitVolume(radioVol);
-    callback(null, homekitVol);
+    callback(null, radioToHomekitVolume(radioVol));
   } catch (err) {
     this.log.warn("Volume get failed, returning last known level.", toMsg(err));
     const fallbackRadio = this.lastKnownRadioVolume ?? 0;
@@ -206,18 +201,24 @@ FrontierSiliconAccessory.prototype.handleSetVolume = async function (value, call
   }
 };
 
-FrontierSiliconAccessory.prototype.handleSetStationPreset = async function (preset, turnOn, callback) {
+FrontierSiliconAccessory.prototype.handleSetStationPreset = async function (presetKey, turnOn, callback) {
   if (this.isUpdatingStationSwitches) {
     callback(null);
     return;
   }
 
+  // Exclusive selector behaviour
+  // Turning OFF does not change the radio, we snap back to the current selection
   if (!turnOn) {
     callback(null);
-    this.syncStationSwitchesFromPreset(this.lastKnownPresetIndex);
+    this.syncStationSwitchesFromPresetKey(this.lastKnownPresetKey);
     return;
   }
 
+  // Optimistic UI update so previous station immediately turns off
+  this.lastKnownPresetKey = presetKey;
+  this.syncStationSwitchesFromPresetKey(presetKey);
+
   try {
     if (this.autoPowerOnOnPreset) {
       try {
@@ -229,27 +230,26 @@ FrontierSiliconAccessory.prototype.handleSetStationPreset = async function (pres
       }
     }
 
-    await this.client.setPresetIndex(preset);
-
-    this.lastKnownPresetIndex = preset;
-    this.syncStationSwitchesFromPreset(preset);
+    await this.client.setPresetKey(presetKey);
 
     callback(null);
   } catch (err) {
     this.log.warn("Preset set failed.", toMsg(err));
     callback(null);
-    this.syncStationSwitchesFromPreset(this.lastKnownPresetIndex);
+
+    // Keep UI consistent with the last selection we know about
+    this.syncStationSwitchesFromPresetKey(this.lastKnownPresetKey);
   }
 };
 
-FrontierSiliconAccessory.prototype.syncStationSwitchesFromPreset = function (presetIndex) {
+FrontierSiliconAccessory.prototype.syncStationSwitchesFromPresetKey = function (presetKey) {
   if (!this.stationServices || this.stationServices.length === 0) return;
 
   this.isUpdatingStationSwitches = true;
 
   try {
     for (const s of this.stationServices) {
-      const shouldBeOn = presetIndex === s.preset;
+      const shouldBeOn = presetKey === s.presetKey;
       s.service.getCharacteristic(Characteristic.On).updateValue(shouldBeOn);
     }
   } finally {
@@ -278,7 +278,6 @@ FrontierSiliconAccessory.prototype.startPolling = function () {
         const radioVol = await this.client.getVolume();
         if (this.lastKnownRadioVolume !== radioVol) {
           this.lastKnownRadioVolume = radioVol;
-
           const homekitVol = radioToHomekitVolume(radioVol);
 
           if (this.speakerService) {
@@ -294,10 +293,8 @@ FrontierSiliconAccessory.prototype.startPolling = function () {
       }
     }
 
-    // Preset polling is intentionally not implemented for this firmware,
-    // because netRemote.sys.preset.index does not exist.
-    // If you want full sync from the radio front panel later,
-    // we can add alternative detection based on play.info nodes.
+    // Preset readback is not implemented for this firmware
+    // We keep station switch states based on the last selected presetKey via HomeKit
   };
 
   tick();
@@ -335,10 +332,10 @@ FsApiClient.prototype.setVolume = async function (volume) {
   await this.fetchText("/fsapi/SET/netRemote.sys.audio.volume?value=" + v);
 };
 
-// DIR3010 style preset selection via navigation state
-FsApiClient.prototype.setPresetIndex = async function (preset) {
-  const p = Math.trunc(Number(preset));
-  if (!Number.isFinite(p)) throw new Error("Invalid preset");
+// DIR3010 style preset selection using nav.state and selectPreset
+FsApiClient.prototype.setPresetKey = async function (presetKey) {
+  const p = Math.trunc(Number(presetKey));
+  if (!Number.isFinite(p)) throw new Error("Invalid preset key");
 
   await this.fetchText("/fsapi/SET/netRemote.nav.state?value=1");
   await this.fetchText("/fsapi/SET/netRemote.nav.action.selectPreset?value=" + encodeURIComponent(String(p)));
@@ -405,7 +402,6 @@ function toMsg(err) {
   return String(err);
 }
 
-// Non linear volume mapping
 function homekitToRadioVolume(homekitValue) {
   const x = clampInt(Number(homekitValue), 0, 100) / 100;
   return clampInt(Math.round(Math.pow(x, 2) * 100), 0, 100);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "homebridge-frontier-silicon-plugin",
-  "version": "1.2.1",
+  "version": "1.2.3",
   "description": "Homebridge plugin for Frontier Silicon FSAPI devices, power and volume with safe polling",
   "license": "ISC",
   "main": "index.js",