Skip to content
GitHub

HotLoop core 4.23.1 release notes

This release carries everything 4.23.0’s notes list. Weather and energy, the web UI in thirteen more languages, screens that move between installs as files, and the first commands to a UniFi console. Built for amd64 only; the multi-arch build follows as the next version.

  • A weather station is one entity. Built from the tags a roof station already publishes (temperature, humidity, pressure, wind, rain, solar), with the dew point, heat index and wind chill worked out on the box. A sensor the station was not given has no row, and one that stopped answering reads Unavailable, never zero. No cloud service is called. See Weather.
  • Energy meters. A meter is a tag read as a quantity used (a cumulative counter such as kWh, gas, water or air, or a power). What it used is kept in 15 minute buckets, so a restart loses nothing and a shift, a day or a month is a sum. A tariff gives each bucket a cost when the bucket is made, so a price changed later does not change what last month cost, and the cost of a unit made is worked out from a production meter. There is an Energy screen, the API and MCP tools. See Energy.
  • The web UI comes in thirteen more languages beside English: Spanish, French, Italian, German, Norwegian, Bulgarian, Greek, Korean, Japanese, Vietnamese, Hindi, Simplified Chinese and Arabic, laid out right to left. Pick one in the top bar or on the sign-in card. See Languages.
  • A dashboard exports to a file and imports into another install. A customer’s screens are theirs and never part of the product: the file lists every tag, device, script and recipe it names, and an import reports every problem at once, with a mapping for names that differ, before anything is saved. Export and Import are buttons on the Dashboards screen, and screen_export and screen_import are MCP tools. See Screen files.
  • MCP reads that go with its writes, the editors’ dry runs, and the CODESYS alarm import.
  • The first commands to a UniFi console. Five kinds of point can be commanded, each read-only until a person arms that tag, through the write gate like any tag: a device’s locate LED, a device restart, a switch port’s PoE power cycle, a wireless network on or off, a watched client blocked or let back, and a port’s PoE mode. A power cycle is held to a 15 minute cooldown that is kept in the database, so a restart does not forget it, and a port that carries the network (an uplink, a switch, a gateway, a 5G backup, a peer the console does not list) is never cycled. The console account HotLoop signs in with has to be a local Administrator for these; a View Only account is refused by the console and HotLoop says so. A built-in blueprint cycles a silent device’s port once and then raises an alarm. See UniFi Network.
  • The OPC UA server answers HistoryRead from the history the Gateway keeps, raw and processed.
  • OPC UA PubSub delta frames, as an option. HOTLOOP_UADP_PUBLISH_DELTA_FRAMES=true sends only the fields that changed between key frames. Off by default.
  • A picture card on a panel page fits its card and no longer sets the row height.
  • The database upgrade unit of a Quadlet install skips itself when the volume has nothing to upgrade, because Podman 5.7 will not start a container with nothing to run, and the bundled database’s name is fitted to the 52 characters a StatefulSet can have.
  • The charts keep their credentials Secret on uninstall, like the database’s volume: a reinstall of the same name used to generate a new password the kept database refused. To start clean, delete the Secret by hand with the volume.
  • The Kafka output waits on the broker for a topic made a moment ago for as long as its connect allows, and the Edge Relay’s documented outage queue figures are the measured ones (about two minutes at 2,000 readings a second).
  • Fixes found by the test suite: the OPC UA test users are hashed at bcrypt’s lowest cost, so a login in the suite no longer outgrows what the test client waits on a slow runner (the server and its login are unchanged), the live feed forgets what it sent the moment its last page leaves, the OPC UA server says when its listener holds the port, and several tests no longer sleep for things that happen on their own time.

Two, each only adds: 0028_unifi_port_cycles (when each switch port was last power cycled) and 0029_energy (three tables for meters and their buckets). Both are in backups. A backup taken on 4.22.1 restores here, and one taken here does not restore onto an older release.

New routes: GET /api/energy/meters, POST /api/energy/meters, GET, PUT and DELETE /api/energy/meters/{id}, GET /api/energy/summary and /api/energy/summary/{period}, GET /api/energy/series and /api/energy/series/{meter}/{period}/{step}, GET /api/dashboards/{id}/export, POST /api/dashboards/import, and GET /api/entities/composites. Two new permissions: energy.read, which every role has, and energy.write, which an admin has. New MCP tools for each. A weather station is a new entity domain, weather. See the HTTP API.

A plain helm upgrade. The migrations run at the first start and add tables; no new secret. Nothing is turned on that was off.

  • The other commands have not been run against a real console.
  • Weather and energy were run against recordings, a Modbus rig and Emberburn’s simulated counters, not against a real roof station or a plant’s meters.
  • The thirteen new language catalogs were written from the shared glossary and no native speaker has reviewed them.