homebridge-frontier-silicon-plugin 1.0.0 → 1.0.2

package/CHANGELOG.md

@@ -0,0 +1,38 @@
+# Changelog
+
+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.0.2] – 2025-12-28
+
+### Changed
+- Improved volume handling using a non-linear volume curve.
+- Low volume levels are now significantly softer, allowing precise control at the bottom of the HomeKit slider.
+- Higher volume levels ramp up faster to maintain full output range.
+
+### Improved
+- Volume control now feels more natural and audio-appropriate.
+- Better alignment between HomeKit slider behaviour and perceived loudness on Frontier Silicon radios.
+- Overall usability of volume control in daily use.
+
+## [1.0.1] – 2025-12-28
+
+### Fixed
+- Fixed FSAPI SET request formatting so power and volume changes are correctly applied to the radio.
+- Resolved issue where HomeKit could read state changes but not write them back to the device.
+- Improved reliability of write operations across Frontier Silicon devices.
+
+## [1.0.0] – 2025-12-28
+
+### Added
+- Initial stable release of the Homebridge Frontier Silicon plugin.
+- Power control via HomeKit using native FSAPI communication.
+- Volume control with safe polling and automatic recovery when the device is unreachable.
+- Configurable polling interval.
+- Direct HTTP communication without external or native dependencies.
+
+### Fixed
+- Eliminated crashes when the radio becomes temporarily unreachable.
+- Removed dependency on legacy wifiradio and request modules.
+- Replaced legacy polling mechanisms with safe async polling.

package/config.schema.json

@@ -0,0 +1,29 @@
+{
+  "name": "homebridge-frontier-silicon-plugin",
+  "version": "1.0.0",
+  "description": "Homebridge plugin for Frontier Silicon FSAPI devices, power and volume with safe polling",
+  "license": "ISC",
+  "main": "index.js",
+  "keywords": [
+    "homebridge-pluginconfig.schema.json",
+    "homebridge",
+    "frontier",
+    "silicon",
+    "fsapi",
+    "internet-radio"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/boikedamhuis/homebridge-frontier-silicon"
+  },
+  "bugs": {
+    "url": "https://github.com/boikedamhuis/homebridge-frontier-silicon/issues"
+  },
+  "author": {
+    "name": "Boike Damhuis"
+  },
+  "engines": {
+    "node": ">=18.0.0",
+    "homebridge": ">=1.6.0"
+  }
+}

package/index.js

@@ -24,7 +24,9 @@ function FrontierSiliconAccessory(log, config) {
   this.enableVolume = config.enableVolume !== false;
 
   this.lastKnownPower = null;
-  this.lastKnownVolume = null;
+
+  // This stores the last known radio volume (0..100, device scale)
+  this.lastKnownRadioVolume = null;
 
   if (!this.ip) {
     this.log.warn("No ip configured, accessory will not work.");
@@ -44,11 +46,13 @@ function FrontierSiliconAccessory(log, config) {
     .on("set", this.handleSetPower.bind(this));
 
   if (this.enableVolume) {
+    // Volume is exposed as a separate slider using Lightbulb Brightness
     this.volumeService = new Service.Lightbulb(this.name + " Volume");
+
     this.volumeService
       .getCharacteristic(Characteristic.On)
       .on("get", (cb) => cb(null, true))
-      .on("set", (val, cb) => cb(null));
+      .on("set", (_val, cb) => cb(null));
 
     this.volumeService
       .getCharacteristic(Characteristic.Brightness)
@@ -96,21 +100,25 @@ FrontierSiliconAccessory.prototype.handleSetPower = async function (value, callb
 
 FrontierSiliconAccessory.prototype.handleGetVolume = async function (callback) {
   try {
-    const vol = await this.client.getVolume();
-    this.lastKnownVolume = vol;
-    callback(null, vol);
+    const radioVol = await this.client.getVolume();
+    this.lastKnownRadioVolume = radioVol;
+
+    const homekitVol = radioToHomekitVolume(radioVol);
+    callback(null, homekitVol);
   } catch (err) {
     this.log.warn("Volume get failed, returning last known level.", toMsg(err));
-    callback(null, this.lastKnownVolume ?? 0);
+    const fallbackRadio = this.lastKnownRadioVolume ?? 0;
+    callback(null, radioToHomekitVolume(fallbackRadio));
   }
 };
 
 FrontierSiliconAccessory.prototype.handleSetVolume = async function (value, callback) {
-  const vol = clampInt(Number(value), 0, 100);
+  // Non linear mapping so low slider values are much softer
+  const radioVol = homekitToRadioVolume(value);
 
   try {
-    await this.client.setVolume(vol);
-    this.lastKnownVolume = vol;
+    await this.client.setVolume(radioVol);
+    this.lastKnownRadioVolume = radioVol;
     callback(null);
   } catch (err) {
     this.log.warn("Volume set failed, keeping last known level.", toMsg(err));
@@ -131,24 +139,26 @@ FrontierSiliconAccessory.prototype.startPolling = function () {
         this.switchService.getCharacteristic(Characteristic.On).updateValue(power);
       }
     } catch (err) {
-      this.log.debug ? this.log.debug("Polling power failed.", toMsg(err)) : this.log("Polling power failed.");
+      if (this.log.debug) this.log.debug("Polling power failed.", toMsg(err));
     }
 
     if (this.enableVolume && this.volumeService) {
       try {
-        const vol = await this.client.getVolume();
-        if (this.lastKnownVolume !== vol) {
-          this.lastKnownVolume = vol;
-          this.volumeService.getCharacteristic(Characteristic.Brightness).updateValue(vol);
+        const radioVol = await this.client.getVolume();
+        if (this.lastKnownRadioVolume !== radioVol) {
+          this.lastKnownRadioVolume = radioVol;
+          const homekitVol = radioToHomekitVolume(radioVol);
+          this.volumeService
+            .getCharacteristic(Characteristic.Brightness)
+            .updateValue(homekitVol);
         }
       } catch (err) {
-        this.log.debug ? this.log.debug("Polling volume failed.", toMsg(err)) : this.log("Polling volume failed.");
+        if (this.log.debug) this.log.debug("Polling volume failed.", toMsg(err));
       }
     }
   };
 
   tick();
-
   this.pollTimer = setInterval(tick, intervalMs);
 };
 
@@ -169,7 +179,8 @@ FsApiClient.prototype.getPower = async function () {
 
 FsApiClient.prototype.setPower = async function (on) {
   const v = on ? 1 : 0;
-  await this.fetchText("/fsapi/SET/netRemote.sys.power&value=" + v);
+  // Important: SET must start query with ?value= so pin can be appended with &
+  await this.fetchText("/fsapi/SET/netRemote.sys.power?value=" + v);
 };
 
 FsApiClient.prototype.getVolume = async function () {
@@ -180,12 +191,18 @@ FsApiClient.prototype.getVolume = async function () {
 
 FsApiClient.prototype.setVolume = async function (volume) {
   const v = clampInt(Number(volume), 0, 100);
-  await this.fetchText("/fsapi/SET/netRemote.sys.audio.volume&value=" + v);
+  // Important: SET must start query with ?value= so pin can be appended with &
+  await this.fetchText("/fsapi/SET/netRemote.sys.audio.volume?value=" + v);
 };
 
 FsApiClient.prototype.fetchText = async function (pathAndQuery) {
   const joiner = pathAndQuery.includes("?") ? "&" : "?";
-  const url = this.baseUrl + pathAndQuery + joiner + "pin=" + encodeURIComponent(this.pin);
+  const url =
+    this.baseUrl +
+    pathAndQuery +
+    joiner +
+    "pin=" +
+    encodeURIComponent(this.pin);
 
   const controller = new AbortController();
   const t = setTimeout(() => controller.abort(), this.timeoutMs);
@@ -242,3 +259,17 @@ function toMsg(err) {
   if (err instanceof Error) return err.message;
   return String(err);
 }
+
+// Non linear volume mapping
+// HomeKit slider 0..100 is mapped to device volume 0..100
+// Low slider values become much softer, high end remains reachable
+
+function homekitToRadioVolume(homekitValue) {
+  const x = clampInt(Number(homekitValue), 0, 100) / 100;
+  return clampInt(Math.round(Math.pow(x, 2) * 100), 0, 100);
+}
+
+function radioToHomekitVolume(radioValue) {
+  const x = clampInt(Number(radioValue), 0, 100) / 100;
+  return clampInt(Math.round(Math.sqrt(x) * 100), 0, 100);
+}

package/package.json

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