homebridge-eliot-smart-control 1.3.0 → 1.5.0

package/CHANGELOG.md

@@ -6,6 +6,91 @@ adheres to [semantic versioning](https://semver.org/spec/v2.0.0.html).
 
 ## [Unreleased]
 
+## [1.5.0] — 2026-09-21
+
+### Fixed
+
+- **A new target while the desk is moving now works.** Cancelling a move sent
+  `STOP` and then a step command, as insurance for a control box too old to
+  know `STOP`. On a box driving a `GOTO_HEIGHT` that step starts a small move
+  of its own, and the replacement target arrives in the middle of it — which is
+  a command arriving mid-move, the one thing this box answers by giving up. The
+  desk took the 4 mm step and ignored where it had been told to go, so setting
+  the slider to 65% moved it by one. `STOP` alone now, followed by a pause long
+  enough for the desk to finish coasting before it is given somewhere new.
+- **The idle poll no longer cancels a move.** It skipped polling while the
+  plugin was driving the desk, but not while the *control box* was — which is
+  precisely the case that must not be polled, because `SETTINGS` is a command
+  and one arriving mid-move makes the box abandon it. The move died, the desk
+  stopped short, and the box then looked like one that had never understood
+  `GOTO_HEIGHT`, so the step-command fallback took over and the position
+  jumped. Dragging the slider was where this showed.
+- **Service names are back, and the room can be changed.** `ConfiguredName` is
+  what the Home app displays for a bridged accessory's services — without it
+  every switch shows as "Schalter 1", "Schalter 2" and so on — but Switch,
+  MotionSensor and WindowCovering do not list it, so it has to be declared with
+  `addOptionalCharacteristic` before it is set. Setting it undeclared made
+  Homebridge warn on every start and left an accessory the Home app would not
+  fully edit. It is also written only when empty, so a name given in the Home
+  app stays.
+
+### Added
+
+- **Automatic sit/stand movement.** Set a sitting height, a standing height, an
+  interval and the hours it applies to, and the desk alternates between them.
+  It arrives switched off behind an **Auto Movement** switch in the Home app,
+  because starting to move somebody's furniture on the strength of a config
+  file being saved is not a good first impression.
+- **A *Desk Move Soon* sensor**, tripped a few minutes before each move. It is
+  a motion sensor because HomeKit gives an accessory no way to send a
+  notification and a sensor is the one thing the Home app will offer to notify
+  about; turning that on is a one-time step in the Home app that nothing here
+  can do for you.
+- **The settings page checks the pairs of values the schema cannot.** A warning
+  that is not shorter than the interval, a sitting height above the standing
+  one, and a working-hours entry that is not a time range are all said while
+  they are being typed, rather than in the Homebridge log after a restart where
+  nobody is looking.
+- **A warning of 0 turns the warning off** and takes the *Desk Move Soon*
+  sensor out of the Home app with it. A motion sensor that can never report
+  motion is a thing in somebody's house that does nothing and cannot be
+  explained.
+- **Moving the desk by hand restarts the timer**, which makes a nudge on the
+  handset the snooze: the warning says it is about to move, you touch the
+  handset, and you have another interval.
+
+### Changed
+
+- **Slider targets are allowed to settle before one is acted on.** A drag is
+  dozens of them, and each taken literally meant stopping the desk, waiting out
+  its coast and handing it somewhere new. Seven targets now make one command.
+- **A target the desk is already at is not a move.** The Home app sends the
+  current position the moment the slider is touched, and the desk was setting
+  off towards where it already was — the small movement before the real one.
+- **The settings page says less, and says it once.** Field hints had grown into
+  paragraphs and the sit/stand section said the same thing twice. What was cut
+  is in the README, where the long version belongs.
+- **The dongle is no longer described as advertising under one particular
+  name.** It carries whatever name the desk was given in the Eliot app, which
+  on many units is nothing useful. The scan always matched the service UUID
+  instead, which does not depend on what anybody called it.
+
+## [1.4.0] — 2026-09-21
+
+### Changed
+
+- **Eco mode now means travel speed 20**, not 28. 28 was where the Eliot app
+  stops offering, which turned out to be a fact about the app rather than the
+  control box — the desk here was found storing 21, a value no version of the
+  app could have written, and took 21 back without complaint. Eco mode that is
+  barely slower than no eco mode is not worth resetting a desk to switch on.
+- **Switches are called what they are** — *Memory 1*, *Child Lock* — instead of
+  carrying the desk's name in front of them. The Home app already shows which
+  accessory a switch belongs to, and *Schreibtisch Memory 1* said it twice.
+  Switches named by an earlier version are renamed on the next start, but only
+  where the name is still exactly what that version wrote: anything else is
+  yours, including a rename that happens to begin with the desk's name.
+
 ## [1.3.0] — 2026-09-21
 
 ### Removed
@@ -261,7 +346,9 @@ First release.
   verified against hardware, including the measured travel speed and stopping
   distance.
 
-[Unreleased]: https://github.com/rummeyer/homebridge-eliot-smart-control/compare/v1.3.0...HEAD
+[Unreleased]: https://github.com/rummeyer/homebridge-eliot-smart-control/compare/v1.5.0...HEAD
+[1.5.0]: https://github.com/rummeyer/homebridge-eliot-smart-control/compare/v1.4.0...v1.5.0
+[1.4.0]: https://github.com/rummeyer/homebridge-eliot-smart-control/compare/v1.3.0...v1.4.0
 [1.3.0]: https://github.com/rummeyer/homebridge-eliot-smart-control/compare/v1.2.0...v1.3.0
 [1.2.0]: https://github.com/rummeyer/homebridge-eliot-smart-control/compare/v1.1.0...v1.2.0
 [1.1.0]: https://github.com/rummeyer/homebridge-eliot-smart-control/compare/v1.0.0...v1.1.0

package/README.md

@@ -67,11 +67,11 @@ your other accessories.
 desks**.
 
 This is the part worth having help with. The dongle does not announce itself:
-it appears as **`Schreibtisch`**, with no manufacturer name, and many units
-have nothing printed on them — in a scan list it sits among forty anonymous
-phones with nothing to tell them apart. The page looks for the Bluetooth
-service the desk actually speaks, so a result marked *confirmed* is the right
-device and not a good guess.
+it advertises under whatever name the desk was given in the Eliot app, carries
+no manufacturer name, and many units have nothing printed on them — in a scan
+list it sits among forty anonymous phones with nothing to tell them apart. The
+page looks for the Bluetooth service the desk actually speaks, so a result
+marked *confirmed* is the right device and not a good guess.
 
 Press **Use this** next to yours, name it, and save.
 
@@ -92,6 +92,7 @@ dongle for five seconds.
 | **Memory switches** | on | Offer your stored positions as buttons. Rename them in the Home app |
 | **Child lock switch** | on | Offer the desk's child lock |
 | **Eco mode** | leave alone | Eco mode and travel speed, as a pair. Takes effect only after the desk is reset by hand |
+| **Automatic sit/stand** | off | Move between two heights on a timer, during configured hours |
 
 Or by hand, in `config.json`:
 
@@ -100,7 +101,7 @@ Or by hand, in `config.json`:
   "platform": "EliotSmartControl",
   "desks": [
     {
-      "name": "Schreibtisch",
+      "name": "Desk",
       "mac": "E5:11:22:33:44:55",
       "ecoMode": "off"
     }
@@ -108,6 +109,31 @@ Or by hand, in `config.json`:
 }
 ```
 
+## Automatic sit/stand
+
+Configure it, and the desk gains an **Auto Movement** switch. Nothing moves
+until you turn that on — the switch is the feature's on/off, so that turning it
+off is somewhere obvious rather than in a config file.
+
+Once on, inside the hours you have set, the desk alternates between your
+sitting and standing heights. It always heads for whichever of the two it is
+further from, so a desk parked halfway still does the right thing.
+
+**Moving the desk yourself restarts the timer.** That is the snooze: when the
+warning says it is about to move and you are mid-call, nudge the desk with the
+handset and you have bought another interval. It is also simply true — the
+timer measures time spent at a height, and that clock restarts when the height
+does.
+
+**Getting told about it takes one step you have to do yourself.** HomeKit gives
+a plugin no way to send a notification, so the warning is a motion sensor
+called **Desk Move Soon**. Open it in the Home app, and under *Status and
+Notifications* turn notifications on. Nothing here can do that for you, and if
+you never do it the feature still works, silently.
+
+Outside the configured hours nothing moves and no warning is raised — a phone
+buzzing at 17:05 about a move that will never happen is worse than silence.
+
 ## Things worth knowing
 
 **Positions land exactly.** The desk is handed a height and drives there on its
@@ -128,6 +154,18 @@ its button appears the next time the plugin connects.
 and the plugin names them only once, when it first creates them, so whatever
 you rename them to survives restarts.
 
+**Eco mode is stored now and takes effect later.** The control box keeps
+running whatever it was last reset with, so the settings it reports back can
+differ from the speed it is visibly travelling at. A reset by hand — run the
+desk to the bottom and hold the down key until it re-homes — is what makes a
+stored setting live. No command over this connection can do it.
+
+**The idle refresh is only for what happens between moves.** The control box
+streams its height for as long as it is driving itself, so nothing needs asking
+then. It is also why the poll must stay in seconds: a request arriving while
+the box is moving makes it abandon the move, which looks exactly like a desk
+that stops a centimetre after it starts.
+
 **The desk's own safety features are untouched.** Anti-collision and the soft
 limits live in the control box. The plugin adds limits of its own on top: it
 gives up if the desk stops making progress, if a move takes longer than the

package/config.schema.json

@@ -3,7 +3,7 @@
   "pluginType": "platform",
   "singular": true,
   "headerDisplay": "Control an Eliot sit-stand desk with the Smart Dongle from the Home app, over Bluetooth. Requires Linux — the plugin talks to BlueZ.",
-  "footerDisplay": "The dongle advertises as **Schreibtisch** and has no vendor name, so it can be hard to spot. Run `node tools/eliot-probe.js scan` on the Homebridge host to find its address.\n\nThe desk appears as a window covering: 0% is the lowest height it is set to allow, 100% the highest. Those come from the desk's own limits, so changing them on the handset changes what 0% and 100% mean.",
+  "footerDisplay": "The dongle advertises under whatever name the desk has been given in the Eliot app, and carries no manufacturer name, so there is often nothing in a scan list to pick it out by. The scan above matches on the Bluetooth service it speaks instead, which is the same whatever it is called.\n\nThe desk appears as a window covering: 0% is the lowest height it is set to allow, 100% the highest. Those come from the desk's own limits, so changing them on the handset changes what 0% and 100% mean.",
   "schema": {
     "type": "object",
     "properties": {
@@ -23,8 +23,8 @@
               "title": "Name",
               "type": "string",
               "required": true,
-              "default": "Schreibtisch",
-              "placeholder": "Schreibtisch",
+              "default": "Desk",
+              "placeholder": "Desk",
               "description": "What the desk is called in the Home app."
             },
             "mac": {
@@ -40,19 +40,19 @@
               "type": "integer",
               "default": 30,
               "minimum": 0,
-              "description": "How often to ask a standing desk for its height. The desk reports by itself while the control box is driving, so this only catches the handset being used. 0 turns it off. Leave it in seconds, not milliseconds: asking mid-move cancels the move."
+              "description": "How often to ask a standing desk for its height, which is how the handset being used gets noticed. 0 turns it off; keep it in seconds, not milliseconds."
             },
             "memorySwitches": {
               "title": "Memory switches",
               "type": "boolean",
               "default": true,
-              "description": "Offer the desk's memory positions as switches. They spring back after being pressed, like a scene. Only positions the desk actually has are shown, so an unused memory gets no switch. Rename them in the Home app if \"Memory 1\" is not what you want."
+              "description": "Offer the desk's memory positions as switches. Only positions the desk actually has appear."
             },
             "childLockSwitch": {
               "title": "Child lock as a switch",
               "type": "boolean",
               "default": true,
-              "description": "Offer the desk's child lock in the Home app. It is the only setting the control box reports back, so it is the only one that can be shown honestly rather than remembered."
+              "description": "Offer the desk's child lock in the Home app. It is the one setting the control box reports back, so it is the one that can be shown honestly."
             },
             "ecoMode": {
               "title": "Eco mode",
@@ -66,19 +66,94 @@
                   ]
                 },
                 {
-                  "title": "On - slow and quiet",
+                  "title": "On - slow and quiet (speed 20)",
                   "enum": [
                     "on"
                   ]
                 },
                 {
-                  "title": "Off - about twice as fast",
+                  "title": "Off - about twice as fast (speed 40)",
                   "enum": [
                     "off"
                   ]
                 }
               ],
-              "description": "Eco mode and travel speed, set as a pair. Measured on an Eliot desk: 22.6 mm/s with eco on, 42.4 mm/s with it off.\n\n**Takes effect only after the desk is reset.** Run the desk to the bottom and hold the down key until it re-homes. Until then it keeps its old speed, whatever this says.\n\n*Leave the desk as it is* writes nothing. The plugin logs what the desk has stored each time it connects, if you want to know where it stands."
+              "description": "Eco mode and travel speed, set as a pair: about 22 mm/s against 42 mm/s.<br><br><b>Takes effect only after the desk is reset by hand</b> — run it to the bottom and hold the down key until it re-homes. Until then it keeps its old speed, whatever this says."
+            },
+            "autoMove": {
+              "type": "object",
+              "description": "Move the desk between two heights on a timer. Adds an <b>Auto Movement</b> switch to the Home app, and nothing moves until you turn it on.",
+              "properties": {
+                "sittingMm": {
+                  "title": "Sitting height (mm)",
+                  "type": "integer",
+                  "default": 800,
+                  "minimum": 650,
+                  "maximum": 1280,
+                  "description": "Clamped to the desk's own limits if it will not go that far."
+                },
+                "standingMm": {
+                  "title": "Standing height (mm)",
+                  "type": "integer",
+                  "default": 1200,
+                  "minimum": 650,
+                  "maximum": 1280,
+                  "description": "Must be above the sitting height."
+                },
+                "intervalMinutes": {
+                  "title": "Move every (minutes)",
+                  "type": "integer",
+                  "default": 30,
+                  "minimum": 1,
+                  "description": "Must be longer than the warning."
+                },
+                "warnMinutes": {
+                  "title": "Warn before (minutes)",
+                  "type": "integer",
+                  "default": 5,
+                  "minimum": 0,
+                  "description": "A <b>Desk Move Soon</b> sensor trips this long before each move; turn on its notifications in the Home app to be told. 0 turns the warning off and removes the sensor."
+                },
+                "windows": {
+                  "title": "Working hours",
+                  "type": "array",
+                  "default": [
+                    "08:00-12:00",
+                    "13:00-16:00"
+                  ],
+                  "items": {
+                    "type": "string",
+                    "title": "Window",
+                    "placeholder": "08:00-12:00",
+                    "pattern": "^\\s*\\d{1,2}:\\d{2}\\s*-\\s*\\d{1,2}:\\d{2}\\s*$"
+                  },
+                  "description": "Outside these hours nothing moves and nothing warns."
+                },
+                "days": {
+                  "title": "Days",
+                  "type": "array",
+                  "default": [
+                    "mon",
+                    "tue",
+                    "wed",
+                    "thu",
+                    "fri"
+                  ],
+                  "uniqueItems": true,
+                  "items": {
+                    "type": "string",
+                    "enum": [
+                      "mon",
+                      "tue",
+                      "wed",
+                      "thu",
+                      "fri",
+                      "sat",
+                      "sun"
+                    ]
+                  }
+                }
+              }
             }
           }
         }
@@ -100,7 +175,42 @@
         "desks[].idlePollSeconds",
         "desks[].ecoMode",
         "desks[].childLockSwitch",
-        "desks[].memorySwitches"
+        "desks[].memorySwitches",
+        {
+          "key": "desks[].autoMove",
+          "type": "fieldset",
+          "expandable": true,
+          "expanded": false,
+          "title": "Automatic sit/stand",
+          "items": [
+            "desks[].autoMove.sittingMm",
+            "desks[].autoMove.standingMm",
+            "desks[].autoMove.intervalMinutes",
+            "desks[].autoMove.warnMinutes",
+            {
+              "key": "desks[].autoMove.windows",
+              "type": "array",
+              "orderable": false,
+              "buttonText": "Add window",
+              "items": [
+                "desks[].autoMove.windows[]"
+              ]
+            },
+            {
+              "key": "desks[].autoMove.days",
+              "type": "checkboxes",
+              "titleMap": {
+                "mon": "Monday",
+                "tue": "Tuesday",
+                "wed": "Wednesday",
+                "thu": "Thursday",
+                "fri": "Friday",
+                "sat": "Saturday",
+                "sun": "Sunday"
+              }
+            }
+          ]
+        }
       ]
     }
   ],