homebridge-frontier-silicon-plugin 1.1.0 → 1.2.1

package/CHANGELOG.md

@@ -4,6 +4,17 @@ 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.0] – 2025-12-28
+
+### Added
+- Station selection via HomeKit using preset-based switches.
+- Optional native HomeKit Speaker service alongside Apple Home volume slider.
+- Configurable station list in Homebridge UI mapped to radio presets.
+
+### Improved
+- Better HomeKit usability for audio devices.
+- Volume control remains visible in Apple Home while supporting proper audio semantics.
+
 ## [1.1.0] – 2025-12-28
 
 ### Added

package/config.schema.json

@@ -3,7 +3,7 @@
   "pluginType": "accessory",
   "singular": false,
   "headerDisplay": "Frontier Silicon FSAPI radios",
-  "footerDisplay": "Tip: most devices use PIN 1234. If the device is offline, Homebridge will keep the last known state and recover automatically.",
+  "footerDisplay": "Presets must be saved on the radio first. The plugin switches between preset numbers.",
   "schema": {
     "type": "object",
     "required": ["name", "ip"],
@@ -45,13 +45,43 @@
         "title": "Expose Speaker service",
         "type": "boolean",
         "default": true,
-        "description": "Adds a native HomeKit Speaker service using the Volume characteristic. Some apps show this, Apple Home often does not."
+        "description": "Adds a native HomeKit Speaker service using the Volume characteristic."
       },
       "exposeVolumeSlider": {
         "title": "Expose Apple Home volume slider",
         "type": "boolean",
         "default": true,
         "description": "Adds a Lightbulb Brightness slider for volume control that is visible in the Apple Home app."
+      },
+      "autoPowerOnOnPreset": {
+        "title": "Power on when selecting a station",
+        "type": "boolean",
+        "default": true,
+        "description": "When you turn on a station switch, the radio will be powered on first."
+      },
+      "stations": {
+        "title": "Stations",
+        "type": "array",
+        "description": "List of station switches mapped to preset numbers. Save the stations to presets on the radio first.",
+        "items": {
+          "type": "object",
+          "required": ["name", "preset"],
+          "properties": {
+            "name": {
+              "title": "Station name",
+              "type": "string",
+              "default": "Radio 2"
+            },
+            "preset": {
+              "title": "Preset number",
+              "type": "integer",
+              "default": 1,
+              "minimum": 0,
+              "maximum": 99
+            }
+          }
+        },
+        "default": []
       }
     }
   },
@@ -62,10 +92,20 @@
     "pollIntervalSeconds",
     "enableVolume",
     "exposeSpeakerService",
-    "exposeVolumeSlider"
+    "exposeVolumeSlider",
+    "autoPowerOnOnPreset",
+    {
+      "key": "stations",
+      "type": "array",
+      "title": "Stations",
+      "items": [
+        "stations[].name",
+        "stations[].preset"
+      ]
+    }
   ],
   "display": {
     "name": "Frontier Silicon Radio",
-    "description": "Control power and volume via FSAPI."
+    "description": "Control power, volume, and station presets via FSAPI."
   }
 }

package/index.js

@@ -24,17 +24,29 @@ function FrontierSiliconAccessory(log, config) {
 
   this.enableVolume = config.enableVolume !== false;
 
-  // In 1.1.0 we expose both by default
-  // Speaker service is for correct semantics
-  // Lightbulb slider is for Apple Home app usability
+  // 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.
+  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;
+
+  this.isUpdatingStationSwitches = false;
+
   if (!this.ip) {
     this.log.warn("No ip configured, accessory will not work.");
   }
@@ -50,13 +62,14 @@ function FrontierSiliconAccessory(log, config) {
     .setCharacteristic(Characteristic.Model, "FSAPI Radio")
     .setCharacteristic(Characteristic.SerialNumber, this.ip || "unknown");
 
-  // Power as Switch
+  // 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");
@@ -66,8 +79,6 @@ function FrontierSiliconAccessory(log, config) {
         .on("get", this.handleGetVolume.bind(this))
         .on("set", this.handleSetVolume.bind(this));
 
-      // Optional mute placeholder, kept non functional by design
-      // Some radios support mute through FSAPI, but that endpoint differs per model
       if (Characteristic.Mute) {
         this.speakerService
           .getCharacteristic(Characteristic.Mute)
@@ -77,7 +88,6 @@ function FrontierSiliconAccessory(log, config) {
     }
 
     if (this.exposeVolumeSlider) {
-      // Slider that works in Apple Home app
       this.volumeSliderService = new Service.Lightbulb(this.name + " Volume");
 
       this.volumeSliderService
@@ -92,15 +102,56 @@ function FrontierSiliconAccessory(log, config) {
     }
   }
 
+  // Station switches
+  this.stationServices = [];
+  this.buildStationServices();
+
   this.startPolling();
 }
 
+FrontierSiliconAccessory.prototype.buildStationServices = function () {
+  if (!Array.isArray(this.stations) || this.stations.length === 0) return;
+
+  const seenSubtypes = new Set();
+
+  for (const s of this.stations) {
+    if (!s || typeof s !== "object") continue;
+
+    const stationName = String(s.name ?? "").trim();
+    const preset = Number(s.preset);
+
+    if (!stationName) continue;
+    if (!Number.isFinite(preset)) continue;
+
+    const p = Math.trunc(preset);
+    const subtype = "preset_" + String(p);
+
+    if (seenSubtypes.has(subtype)) continue;
+    seenSubtypes.add(subtype);
+
+    const sw = new Service.Switch(stationName, subtype);
+
+    sw.getCharacteristic(Characteristic.On)
+      .on("get", (cb) => {
+        const isOn = this.lastKnownPresetIndex === p;
+        cb(null, isOn);
+      })
+      .on("set", (value, cb) => {
+        this.handleSetStationPreset(p, !!value, cb);
+      });
+
+    this.stationServices.push({ preset: p, name: stationName, service: sw });
+  }
+};
+
 FrontierSiliconAccessory.prototype.getServices = function () {
   const services = [this.informationService, this.switchService];
 
   if (this.enableVolume && this.speakerService) services.push(this.speakerService);
   if (this.enableVolume && this.volumeSliderService) services.push(this.volumeSliderService);
 
+  for (const s of this.stationServices) services.push(s.service);
+
   return services;
 };
 
@@ -155,6 +206,57 @@ FrontierSiliconAccessory.prototype.handleSetVolume = async function (value, call
   }
 };
 
+FrontierSiliconAccessory.prototype.handleSetStationPreset = async function (preset, turnOn, callback) {
+  if (this.isUpdatingStationSwitches) {
+    callback(null);
+    return;
+  }
+
+  if (!turnOn) {
+    callback(null);
+    this.syncStationSwitchesFromPreset(this.lastKnownPresetIndex);
+    return;
+  }
+
+  try {
+    if (this.autoPowerOnOnPreset) {
+      try {
+        await this.client.setPower(true);
+        this.lastKnownPower = true;
+        this.switchService.getCharacteristic(Characteristic.On).updateValue(true);
+      } catch (_e) {
+        // ignore
+      }
+    }
+
+    await this.client.setPresetIndex(preset);
+
+    this.lastKnownPresetIndex = preset;
+    this.syncStationSwitchesFromPreset(preset);
+
+    callback(null);
+  } catch (err) {
+    this.log.warn("Preset set failed.", toMsg(err));
+    callback(null);
+    this.syncStationSwitchesFromPreset(this.lastKnownPresetIndex);
+  }
+};
+
+FrontierSiliconAccessory.prototype.syncStationSwitchesFromPreset = function (presetIndex) {
+  if (!this.stationServices || this.stationServices.length === 0) return;
+
+  this.isUpdatingStationSwitches = true;
+
+  try {
+    for (const s of this.stationServices) {
+      const shouldBeOn = presetIndex === s.preset;
+      s.service.getCharacteristic(Characteristic.On).updateValue(shouldBeOn);
+    }
+  } finally {
+    this.isUpdatingStationSwitches = false;
+  }
+};
+
 FrontierSiliconAccessory.prototype.startPolling = function () {
   if (!this.ip) return;
 
@@ -174,28 +276,28 @@ FrontierSiliconAccessory.prototype.startPolling = function () {
     if (this.enableVolume) {
       try {
         const radioVol = await this.client.getVolume();
-
         if (this.lastKnownRadioVolume !== radioVol) {
           this.lastKnownRadioVolume = radioVol;
 
           const homekitVol = radioToHomekitVolume(radioVol);
 
           if (this.speakerService) {
-            this.speakerService
-              .getCharacteristic(Characteristic.Volume)
-              .updateValue(homekitVol);
+            this.speakerService.getCharacteristic(Characteristic.Volume).updateValue(homekitVol);
           }
 
           if (this.volumeSliderService) {
-            this.volumeSliderService
-              .getCharacteristic(Characteristic.Brightness)
-              .updateValue(homekitVol);
+            this.volumeSliderService.getCharacteristic(Characteristic.Brightness).updateValue(homekitVol);
           }
         }
       } catch (err) {
         if (this.log.debug) this.log.debug("Polling volume failed.", toMsg(err));
       }
     }
+
+    // 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.
   };
 
   tick();
@@ -233,6 +335,16 @@ 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");
+
+  await this.fetchText("/fsapi/SET/netRemote.nav.state?value=1");
+  await this.fetchText("/fsapi/SET/netRemote.nav.action.selectPreset?value=" + encodeURIComponent(String(p)));
+  await this.fetchText("/fsapi/SET/netRemote.nav.state?value=0");
+};
+
 FsApiClient.prototype.fetchText = async function (pathAndQuery) {
   const joiner = pathAndQuery.includes("?") ? "&" : "?";
   const url = this.baseUrl + pathAndQuery + joiner + "pin=" + encodeURIComponent(this.pin);
@@ -293,6 +405,7 @@ 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.1.0",
+  "version": "1.2.1",
   "description": "Homebridge plugin for Frontier Silicon FSAPI devices, power and volume with safe polling",
   "license": "ISC",
   "main": "index.js",