@homebridge-plugins/homebridge-govee 11.32.0-beta.2 → 11.32.0-beta.21

package/lib/homebridge-ui/public/index.html

@@ -23,10 +23,17 @@
       border-color: #444444;
       color: #eeeeee;
     }
+
+    .text-muted {
+      color: #aaaaaa !important;
+    }
   }
   .min-w-50 {
     min-width: 50px;
   }
+  .action-desc {
+    font-size: 0.85rem;
+  }
   select {
     background-image:
       linear-gradient(45deg, transparent 50%, gray 50%),
@@ -82,31 +89,57 @@
   </div>
   <div id="deviceInfo">
     <form>
-      <div class="form-group">
+      <div class="form-group mb-0">
         <select class="form-control" id="deviceSelect"></select>
       </div>
     </form>
-    <ul class="list-group mt-2 mb-3 mx-0" id="configActionList" style="display: none;">
+    <ul class="list-group mt-4 mb-4 mx-0" id="configActionList" style="display: none;">
       <li class="list-group-item">
         <div class="d-flex justify-content-between align-items-center">
-          <span class="pr-2">Adds all devices to the config.</span>
-          <button type="button" class="btn btn-primary m-0 ml-3 py-1 min-w-50" id="addAllBtn">Add All</button>
+          <div class="pr-2">
+            <div>Add All Devices</div>
+            <div class="text-muted action-desc">Add all devices to the config that are not already in the config.</div>
+          </div>
+          <button type="button" class="btn btn-primary m-0 ml-3 py-1 min-w-50" id="addAllBtn" aria-label="Add all devices to the config">
+            <i aria-hidden="true" class="fas fa-arrow-right"></i>
+          </button>
         </div>
       </li>
       <li class="list-group-item">
         <div class="d-flex justify-content-between align-items-center">
-          <span class="pr-2" id="deviceConfigText">Adds this device to the config.</span>
-          <button type="button" class="btn btn-primary m-0 ml-3 py-1 min-w-50" id="deviceConfigBtn">Add</button>
+          <div class="pr-2">
+            <div>Remove All Devices</div>
+            <div class="text-muted action-desc" id="removeAllText">Remove every device from the plugin config.</div>
+          </div>
+          <button type="button" class="btn btn-primary m-0 ml-3 py-1 min-w-50" id="removeAllBtn" aria-label="Remove all devices from the config">
+            <i aria-hidden="true" class="fas fa-arrow-right"></i>
+          </button>
         </div>
       </li>
       <li class="list-group-item">
         <div class="d-flex justify-content-between align-items-center">
-          <span class="pr-2" id="hideDeviceText">Hide this device from HomeKit.</span>
-          <button type="button" class="btn btn-primary m-0 ml-3 py-1 min-w-50" id="hideDeviceBtn">Hide</button>
+          <div class="pr-2">
+            <div id="deviceConfigTitle">Add This Device</div>
+            <div class="text-muted action-desc" id="deviceConfigText">Add this device to the plugin config.</div>
+          </div>
+          <button type="button" class="btn btn-primary m-0 ml-3 py-1 min-w-50" id="deviceConfigBtn" aria-label="Add this device to the config">
+            <i aria-hidden="true" class="fas fa-arrow-right"></i>
+          </button>
+        </div>
+      </li>
+      <li class="list-group-item">
+        <div class="d-flex justify-content-between align-items-center">
+          <div class="pr-2">
+            <div id="hideDeviceTitle">Hide This Device</div>
+            <div class="text-muted action-desc" id="hideDeviceText">Hide this device from HomeKit. This adds the device to the config if needed.</div>
+          </div>
+          <button type="button" class="btn btn-primary m-0 ml-3 py-1 min-w-50" id="hideDeviceBtn" aria-label="Hide this device from HomeKit">
+            <i aria-hidden="true" class="fas fa-arrow-right"></i>
+          </button>
         </div>
       </li>
     </ul>
-    <table class="table w-100 mt-3" id="deviceTable" style="display: none;">
+    <table class="table w-100 mt-0" id="deviceTable" style="display: none;">
       <thead>
         <tr class="table-active">
           <th scope="col" style="width: 40%;">Device Name</th>
@@ -197,138 +230,69 @@
     </table>
   </div>
 </div>
-<div id="pageSupport" class="mt-4" style="display: none;">
+<div id="pageSupport" class="mt-4" style="display: none">
   <p class="text-center lead">Thank you for using <strong>homebridge-govee</strong></p>
-  <p class="text-center">The links below will take you to our GitHub wiki</p>
-  <h4>Setup</h4>
-  <ul>
-    <li>
-      <a href="https://github.com/homebridge-plugins/homebridge-govee/wiki/Installation" target="_blank"
-        >Installation</a
-      >
-    </li>
-    <li>
-      <a href="https://github.com/homebridge-plugins/homebridge-govee/wiki/Configuration" target="_blank"
-        >Configuration</a
-      >
-    </li>
-    <li>
-      <a href="https://github.com/homebridge/homebridge/wiki/How-to-Install-Alternate-Plugin-Versions" target="_blank"
-        >Beta Version</a
-      >
-    </li>
-    <li>
-      <a href="https://github.com/homebridge-plugins/homebridge-govee/wiki/Node-Version" target="_blank"
-        >Node Version</a
-      >
-    </li>
-  </ul>
-  <h4>Features</h4>
+  <h5>Plugin Information</h5>
+<ul>
+  <li>This plugin allows you to view and control your Govee devices within HomeKit. The plugin:</li>
   <ul>
-    <li>
-      <a href="https://github.com/homebridge-plugins/homebridge-govee/wiki/Supported-Devices" target="_blank"
-        >Supported Devices</a
-      >
-    </li>
-    <li>
-      <a href="https://github.com/homebridge-plugins/homebridge-govee/wiki/Connection-Methods" target="_blank"
-        >Connection Methods</a
-      >
-    </li>
-    <ul>
-      <li>
-        <a href="https://github.com/homebridge-plugins/homebridge-govee/wiki/LAN-Control" target="_blank"
-        >LAN Control</a
-        >
-      </li>
-      <li>
-        <a href="https://github.com/homebridge-plugins/homebridge-govee/wiki/API-Control" target="_blank"
-          >API Control</a
-        >
-      </li>
-      <li>
-        <a href="https://github.com/homebridge-plugins/homebridge-govee/wiki/AWS-Control" target="_blank"
-          >AWS Control</a
-        >
-      </li>
-      <li>
-        <a href="https://github.com/homebridge-plugins/homebridge-govee/wiki/Bluetooth-Control" target="_blank"
-          >BLE Control</a
-        >
-      </li>
-    </ul>
-    <li>
-      <a href="https://github.com/homebridge-plugins/homebridge-govee/wiki/Scene%2C-Music%2C-DIY-Modes" target="_blank"
-        >Scene, Music, DIY Modes</a
-      >
-    </li>
+    <li>supports Govee OpenAPI discovery/state/control when an OpenAPI key is provided</li>
+    <li>requires your Govee credentials for most Cloud/AWS/BLE connections</li>
+    <li>can control certain models locally via LAN control without any Govee credentials</li>
+    <li>may use different connection methods depending on device model and account capabilities</li>
   </ul>
-  <h4>Help/About</h4>
+</ul>
+  <h5>Prerequisites</h5>
+<ul>
+  <li>To use this plugin, you will need to already have:</li>
   <ul>
-    <li>
-      <a href="https://github.com/homebridge-plugins/homebridge-govee/wiki/Common-Errors" target="_blank"
-        >Common Errors</a
-      >
-    </li>
-    <li>
-      <a href="https://github.com/homebridge-plugins/homebridge-govee/issues/new/choose" target="_blank"
-        >Support Request</a
-      >
-    </li>
-    <li>
-      <a href="https://github.com/homebridge-plugins/homebridge-govee/blob/latest/CHANGELOG.md" target="_blank"
-        >Changelog</a
-      >
-    </li>
-    <li><a href="https://github.com/sponsors/bwp91" target="_blank">About Me</a></li>
+    <li><a href="https://nodejs.org" target="_blank">Node</a>: latest version of <code>v22</code> or <code>v24</code> - any other major version is not supported.</li>
+    <li><a href="https://homebridge.io" target="_blank">Homebridge</a>: <code>v1.6</code> or above - refer to link for more information and installation instructions.</li>
+    <li>For bluetooth connectivity, it may be necessary to install extra packages on your system, see <a href="https://github.com/homebridge-plugins/homebridge-govee/wiki/Bluetooth-Control" target="_blank">Bluetooth Control</a>. Bluetooth works best when using a Raspberry Pi, not been tested on Windows, and Mac devices are unsupported.</li>
   </ul>
-  <h4>Credits</h4>
+</ul>
+  <h5>Setup</h5>
+<ul>
+  <li><a href="https://github.com/homebridge-plugins/homebridge-govee/wiki/Installation" target="_blank">Installation</a></li>
+  <li><a href="https://github.com/homebridge-plugins/homebridge-govee/wiki/Configuration" target="_blank">Configuration</a></li>
+  <li><a href="https://github.com/homebridge-plugins/homebridge-govee/wiki/Beta-Version" target="_blank">Beta Version</a></li>
+  <li><a href="https://github.com/homebridge-plugins/homebridge-govee/wiki/Node-Version" target="_blank">Node Version</a></li>
+</ul>
+  <h5>Features</h5>
+<ul>
+  <li><a href="https://github.com/homebridge-plugins/homebridge-govee/wiki/Supported-Devices" target="_blank">Supported Devices</a></li>
+  <li><a href="https://github.com/homebridge-plugins/homebridge-govee/wiki/Connection-Methods" target="_blank">Connection Methods</a></li>
   <ul>
-    <li>To all users who have shared their devices to enable functionality.</li>
-    <li>
-      To the creator/owner of the
-      <a href="https://www.npmjs.com/package/govee-led-client" target="_blank">govee-led-client</a>
-      library which made the bluetooth connection possible.
-    </li>
-    <li>
-      To the creator/owner of the
-      <a href="https://github.com/towlerj/govee_api" target="_blank">govee_api</a>
-      library which made the AWS connection possible.
-    </li>
-    <li>
-      To <a href="https://github.com/alboiuvlad29" target="_blank">@alboiuvlad29</a> who made the LAN connection possible.
-    </li>
-    <li>
-      To <a href="https://github.com/JeremyDunn" target="_blank">@JeremyDunn</a> for his code from
-      <a href="https://github.com/JeremyDunn/homebridge-govee-water-detectors" target="_blank"
-        >homebridge-govee-water-detectors</a
-      >
-      for leak sensor support.
-    </li>
-    <li>
-      To the creator/owner of the
-      <a href="https://www.npmjs.com/package/govee-bt-client" target="_blank"
-        >govee-bt-client</a
-      >
-      library which made the BLE connection to sensors possible.
-    </li>
-    <li>
-      To the creator of the awesome plugin header logo:
-      <a href="https://www.instagram.com/keryan.me" target="_blank">Keryan Belahcene</a>.
-    </li>
-    <li>
-      To the creators/contributors of
-      <a href="https://homebridge.io" target="_blank">Homebridge</a> who make this plugin possible.
-    </li>
-  </ul>
-  <h4>Disclaimer</h4>
-  <ul>
-    <li>
-      I am in no way affiliated with Govee and this plugin is a personal project that I maintain in
-      my free time.
-    </li>
-    <li>Use this plugin entirely at your own risk - please see licence for more information.</li>
+    <li>OpenAPI Control</li>
+    <li><a href="https://github.com/homebridge-plugins/homebridge-govee/wiki/LAN-Control" target="_blank">LAN Control</a></li>
+    <li><a href="https://github.com/homebridge-plugins/homebridge-govee/wiki/AWS-Control" target="_blank">AWS Control</a></li>
+    <li><a href="https://github.com/homebridge-plugins/homebridge-govee/wiki/Bluetooth-Control" target="_blank">BLE Control</a></li>
   </ul>
+  <li><a href="https://github.com/homebridge-plugins/homebridge-govee/wiki/Scene%2C-Music%2C-DIY-Modes" target="_blank">Scene, Music, DIY Modes</a></li>
+</ul>
+  <h5>Help/About</h5>
+<ul>
+  <li><a href="https://github.com/homebridge-plugins/homebridge-govee/wiki/Common-Errors" target="_blank">Common Errors</a></li>
+  <li><a href="https://github.com/homebridge-plugins/homebridge-govee/issues/new/choose" target="_blank">Support Request</a></li>
+  <li><a href="https://github.com/homebridge-plugins/homebridge-govee/blob/latest/CHANGELOG.md" target="_blank">Changelog</a></li>
+  <li><a href="https://github.com/sponsors/bwp91" target="_blank">About Me</a></li>
+</ul>
+  <h5>Credits</h5>
+<ul>
+  <li>To all users who have shared their devices to enable functionality.</li>
+  <li>To the creator/owner of the <a href="https://www.npmjs.com/package/govee-led-client" target="_blank">govee-led-client</a> library which made the BLE connection possible.</li>
+  <li>To the creator/owner of the <a href="https://github.com/towlerj/govee_api" target="_blank">govee_api</a> library which made the AWS connection possible.</li>
+  <li>To <a href="https://github.com/alboiuvlad29" target="_blank">@alboiuvlad29</a> who made the LAN connection possible.</li>
+  <li>To <a href="https://github.com/JeremyDunn" target="_blank">@JeremyDunn</a> for his code from <a href="https://github.com/JeremyDunn/homebridge-govee-water-detectors" target="_blank">homebridge-govee-water-detectors</a> for leak sensor support.</li>
+  <li>To the creator/owner of the <a href="https://www.npmjs.com/package/govee-bt-client" target="_blank">govee-bt-client</a> library which made the BLE connection to sensors possible.</li>
+  <li>To the creator of the awesome plugin header logo: <a href="https://www.instagram.com/keryan.me" target="_blank">Keryan Belahcene</a>.</li>
+  <li>To the creators/contributors of <a href="https://homebridge.io" target="_blank">Homebridge</a> who make this plugin possible.</li>
+</ul>
+  <h5>Disclaimer</h5>
+<ul>
+  <li>I am in no way affiliated with Govee and this plugin is a personal project that I maintain in my free time.</li>
+  <li>Use this plugin entirely at your own risk - please see licence for more information.</li>
+</ul>
 </div>
 <script>
   ;(async () => {
@@ -355,6 +319,7 @@
       let pickerAccessories = []
       let pickerModelMap = {}
       let removeConfirmTimer
+      let removeAllConfirmTimer
 
       // Compare device ids ignoring case, colons and underscores, so an entry
       // typed by hand in a different format still counts as the same device
@@ -381,13 +346,19 @@
         return null
       }
 
+      // The action buttons always show the settings-page arrow; the row text
+      // (and the button's aria-label) says what the arrow will do
+      const actionArrow = '<i aria-hidden="true" class="fas fa-arrow-right"></i>'
+
       const setHideControl = hidden => {
         const btn = document.getElementById('hideDeviceBtn')
         btn.dataset.hidden = hidden ? 'yes' : 'no'
-        btn.innerHTML = hidden ? 'Show' : 'Hide'
+        btn.innerHTML = actionArrow
+        btn.setAttribute('aria-label', hidden ? 'Show this device in HomeKit' : 'Hide this device from HomeKit')
+        document.getElementById('hideDeviceTitle').innerHTML = hidden ? 'Show This Device' : 'Hide This Device'
         document.getElementById('hideDeviceText').innerHTML = hidden
-          ? 'Show this device in HomeKit.'
-          : 'Hide this device from HomeKit.'
+          ? 'Show this device in HomeKit again. The config entry is kept.'
+          : 'Hide this device from HomeKit. This adds the device to the config if needed.'
       }
 
       const setConfigButton = inConfig => {
@@ -397,10 +368,12 @@
         btn.dataset.state = inConfig ? 'remove' : 'add'
         btn.classList.remove('btn-danger')
         btn.classList.add('btn-primary')
-        btn.innerHTML = inConfig ? 'Remove' : 'Add'
+        btn.innerHTML = actionArrow
+        btn.setAttribute('aria-label', inConfig ? 'Remove this device from the config' : 'Add this device to the config')
+        document.getElementById('deviceConfigTitle').innerHTML = inConfig ? 'Remove This Device' : 'Add This Device'
         document.getElementById('deviceConfigText').innerHTML = inConfig
-          ? 'Removes this device from the config.'
-          : 'Adds this device to the config.'
+          ? 'Remove this device from the plugin config.'
+          : 'Add this device to the plugin config.'
       }
 
       const addDeviceToConfig = (config, acc) => {
@@ -453,8 +426,9 @@
               btn.dataset.confirm = 'yes'
               btn.classList.remove('btn-primary')
               btn.classList.add('btn-danger')
-              btn.innerHTML = 'Confirm'
-              document.getElementById('deviceConfigText').innerHTML = 'This entry has extra settings which will be lost - click again to remove it.'
+              btn.innerHTML = actionArrow
+              btn.setAttribute('aria-label', 'Confirm removing this device from the config')
+              document.getElementById('deviceConfigText').innerHTML = 'This entry has extra settings which will be lost. Click again to remove it.'
               removeConfirmTimer = setTimeout(() => setConfigButton(true), 5000)
               return
             }
@@ -546,6 +520,57 @@
           homebridge.toast.error(err.message, 'Error')
         }
       })
+      const resetRemoveAllButton = () => {
+        const btn = document.getElementById('removeAllBtn')
+        clearTimeout(removeAllConfirmTimer)
+        delete btn.dataset.confirm
+        btn.classList.remove('btn-danger')
+        btn.classList.add('btn-primary')
+        btn.innerHTML = actionArrow
+        btn.setAttribute('aria-label', 'Remove all devices from the config')
+        document.getElementById('removeAllText').innerHTML = 'Remove every device from the plugin config.'
+      }
+
+      document.getElementById('removeAllBtn').addEventListener('click', async () => {
+        try {
+          const btn = document.getElementById('removeAllBtn')
+          const blocks = await getConfigBlocks()
+          const config = blocks[0]
+          let total = 0
+          deviceArrayKeys.forEach((key) => {
+            if (Array.isArray(config[key])) {
+              total += config[key].length
+            }
+          })
+          if (total === 0) {
+            resetRemoveAllButton()
+            homebridge.toast.info('There are no devices in the config.', 'Nothing To Remove')
+            return
+          }
+          if (btn.dataset.confirm !== 'yes') {
+            // Removing everything always asks for a second click, since any
+            // settings on the entries would be lost
+            btn.dataset.confirm = 'yes'
+            btn.classList.remove('btn-primary')
+            btn.classList.add('btn-danger')
+            btn.innerHTML = actionArrow
+            btn.setAttribute('aria-label', 'Confirm removing all devices from the config')
+            document.getElementById('removeAllText').innerHTML = 'Any settings on these entries will be lost. Click again to remove all ' + total + (total === 1 ? ' entry.' : ' entries.')
+            removeAllConfirmTimer = setTimeout(resetRemoveAllButton, 5000)
+            return
+          }
+          deviceArrayKeys.forEach((key) => {
+            delete config[key]
+          })
+          await homebridge.updatePluginConfig(blocks)
+          resetRemoveAllButton()
+          setConfigButton(false)
+          setHideControl(false)
+          homebridge.toast.success(total + ' device entr' + (total === 1 ? 'y' : 'ies') + ' removed - press Save to apply.', 'Removed From Config')
+        } catch (err) {
+          homebridge.toast.error(err.message, 'Error')
+        }
+      })
       // ===== End device picker =====
 
       showIntro = () => {

package/lib/homebridge-ui/server.js

@@ -31,6 +31,12 @@ const categoryToArray = {
   template: 'lightDevices',
 }
 
+// Models whose category does not say what the device actually is, so the
+// picker would file them in the wrong config section without an override
+const modelOverrides = {
+  H5085: 'switchDevices', // dual smart plug, in the template category
+}
+
 class PluginUiServer extends HomebridgePluginUiServer {
   constructor() {
     super()
@@ -44,6 +50,7 @@ class PluginUiServer extends HomebridgePluginUiServer {
           modelToArray[model] = arrayKey
         })
       })
+      Object.assign(modelToArray, modelOverrides)
       return modelToArray
     })
 

package/lib/platform.js

@@ -1444,6 +1444,18 @@ export default class {
         accessory.context.hasOpenApiControl = true
         accessory.context.useOpenApiControl = !!this.openApiClient
         accessory.context.openApiCapabilities = device.openApiInfo.byInstance || {}
+
+        // Log what Govee says this device can do. Working out whether a model
+        // exposes something like a night light otherwise means reverse
+        // engineering its status messages, when the answer is right here
+        const instances = Object.entries(accessory.context.openApiCapabilities)
+          .map(([instance, capability]) => `${instance} (${capability?.type ?? 'unknown type'})`)
+        this.log.debug(
+          '[%s] openapi category [%s] capabilities [%s].',
+          accessory.displayName,
+          device.openApiInfo.category || 'unknown',
+          instances.join(', ') || 'none',
+        )
       }
 
       // Create the instance for this device type
@@ -1988,6 +2000,26 @@ export default class {
 
     const data = parseDeviceUpdate(params, accessory.context)
 
+    // The payload above logs the device's own status codes as base64 buried in
+    // a large JSON blob, which is unreadable when working out what a device can
+    // do. Decode them so a code like `aa 36 01 01` can be spotted by eye, and
+    // matched to the `33 36 01 01` needed to set it. Codes with no handler yet
+    // are exactly the ones worth seeing, so log them all rather than guessing
+    // which are already understood
+    const statusCodes = (Array.isArray(data.commands) ? data.commands : [])
+      .map((command) => {
+        try {
+          return base64ToHex(command)
+        } catch {
+          return ''
+        }
+      })
+      .filter(hexString => hexString.startsWith('aa'))
+      .map(hexString => hexString.replace(/../g, '$& ').trim())
+    if (statusCodes.length > 0) {
+      accessory.logDebug(`[${params.source}] ${platformLang.statusCodes}:\n  ${statusCodes.join('\n  ')}`)
+    }
+
     // Log if kelvin was out of range before clamping
     if (data.kelvinOutOfRange) {
       accessory.logDebug(`govee provided a kelvin out of range [${params.state?.colorTemInKelvin}]`)

package/lib/utils/constants.js

@@ -229,6 +229,7 @@ export default {
       'H60B0',
       'H60B1',
       'H60B2',
+      'H60B3',
       'H60C1',
       'H6101',
       'H6102',
@@ -506,8 +507,11 @@ export default {
       'R16D0',
       'R1741',
     ],
-    switchSingle: ['H5001', 'H5080', 'H5081', 'H5083', 'H5086', 'H7014'],
-    switchDouble: ['H5082'],
+    // H5901 is a water timer, controlled only through the OpenAPI - it has no
+    // usable AWS, BLE or LAN path, so it needs an API key configured. Set
+    // showAs to 'valve' or 'tap' for a more fitting HomeKit tile (#1324)
+    switchSingle: ['H5001', 'H5080', 'H5081', 'H5083', 'H5086', 'H5901', 'H7014'],
+    switchDouble: ['H5082', 'H5089'],
     switchTriple: ['H5160'],
     sensorLeak: ['H5054', 'H5058', 'H5059'],
     sensorThermo: [
@@ -562,7 +566,6 @@ export default {
       'H5042', // https://github.com/homebridge-plugins/homebridge-govee/issues/849
       'H5043', // https://github.com/homebridge-plugins/homebridge-govee/issues/558
       'H5085', // https://github.com/homebridge-plugins/homebridge-govee/issues/951
-      'H5089', // https://github.com/homebridge-plugins/homebridge-govee/issues/1242
       'H5111', // https://github.com/homebridge-plugins/homebridge-govee/issues/1117
       'H5121', // https://github.com/homebridge-plugins/homebridge-govee/issues/913
       'H5124', // https://github.com/homebridge-plugins/homebridge-govee/issues/1119

package/lib/utils/functions.js

@@ -106,9 +106,44 @@ function statusToActionCode(statusCode) {
   return Buffer.from(generatedCode, 'base64').toString('hex')
 }
 
+/**
+ * Convert a HomeKit RotationSpeed percentage into a device speed step.
+ *
+ * `steps` is the number of REAL speeds the model has, excluding auto (8 on the
+ * H7100 family, 12 on the H7105/H7107/H1370). A percentage of 0 means "off" and
+ * is handled by the caller, so this always returns a usable step in 1..steps.
+ *
+ * Auto is deliberately NOT reachable from here. Auto is a mode, not a speed, so
+ * 100% means maximum speed. Exposing auto at the top of the slider is what made
+ * the previous behaviour surprising - dragging to full would silently select
+ * auto instead of full power.
+ */
+function hkPercentToFanSpeed(percent, steps) {
+  return Math.max(1, Math.min(steps, Math.round((percent * steps) / 100)))
+}
+
+/**
+ * Convert a device speed step into a HomeKit RotationSpeed percentage.
+ *
+ * When the device reports auto, HomeKit is shown 100%, but callers should keep
+ * their own cache at `autoSpeed`. That lets the plugin tell "the device is in
+ * auto" apart from "the user asked for maximum speed", and so avoid echoing a
+ * redundant command straight back to the device.
+ */
+function fanSpeedToHkPercent(speed, steps, autoSpeed) {
+  if (autoSpeed !== undefined && speed === autoSpeed) {
+    return 100
+  }
+  if (!speed || speed < 1) {
+    return 0
+  }
+  return Math.min(100, Math.round((speed / steps) * 100))
+}
+
 export {
   base64ToHex,
   cenToFar,
+  fanSpeedToHkPercent,
   farToCen,
   generateCodeFromHexValues,
   generateRandomString,
@@ -117,6 +152,7 @@ export {
   hexToBase64,
   hexToDecimal,
   hexToTwoItems,
+  hkPercentToFanSpeed,
   nearestHalf,
   parseDeviceId,
   parseError,

package/lib/utils/lang-en.js

@@ -133,5 +133,6 @@ export default {
   syncFail: 'sync failed as',
   syncStillRunning: 'skipping this sync as the previous one has not finished yet',
   viaAL: 'via adaptive lighting',
+  statusCodes: 'device status codes',
   unknownCommand: 'unknown command in payload received',
 }

package/package.json

@@ -2,7 +2,7 @@
   "name": "@homebridge-plugins/homebridge-govee",
   "alias": "Govee",
   "type": "module",
-  "version": "11.32.0-beta.2",
+  "version": "11.32.0-beta.21",
   "description": "Homebridge plugin to integrate Govee devices into HomeKit.",
   "author": {
     "name": "bwp91",
@@ -38,6 +38,7 @@
   "keywords": [
     "homebridge",
     "homebridge-plugin",
+    "supports-hap",
     "homebridge-govee",
     "hoobs",
     "hoobs-plugin",
@@ -62,21 +63,24 @@
     "mqtt": "^5.15.2",
     "node-persist": "^4.0.4",
     "node-rsa": "^2.0.0",
-    "p-queue": "^9.3.1",
+    "p-queue": "^9.3.3",
     "patch-package": "^8.0.1",
     "pem": "^1.14.8"
   },
   "optionalDependencies": {
     "@stoprocent/bluetooth-hci-socket": "^2.2.6",
-    "@stoprocent/noble": "^2.5.7"
+    "@stoprocent/noble": "^2.5.9"
   },
   "devDependencies": {
-    "@antfu/eslint-config": "^9.1.0"
+    "@antfu/eslint-config": "^9.2.0"
   },
   "allowScripts": {
     "@stoprocent/bluetooth-hci-socket@2.2.6": true,
-    "@stoprocent/noble@2.5.7": true,
+    "@stoprocent/noble@2.5.9": true,
     "usb@2.18.0": true,
     "@serialport/bindings-cpp@12.0.1": true
+  },
+  "overrides": {
+    "help-me": "^5.0.0"
   }
 }