Files
cantabile-ha-addons/cantabile_edge/CHANGELOG.md
T

116 lines
6.8 KiB
Markdown

# Changelog
Versions are `0.1.<n>`: n counts the commits of the Cantabile repository the
add-on was built from. The image's label `org.opencontainers.image.revision`
names the commit; the agent inside is the Edge Agent image of that commit.
## 0.1.x
- Invitations: when a building or an energy community invites your home,
the add-on's page shows the invitation with three buttons: Look at it
(what joining means for you), Join and Decline. Until now an invitation
waited unseen until it expired.
- My energy costs: a new view on the Cantabile dashboard with your own
prices, what the plan saved and your monthly cost so far; where a figure
is missing (for example fixed charges), a notice at the top says what is
missing instead of a guess.
- Shades the agent closed are opened again later (in the morning, or when
the sun has left the window); before, they stayed where the agent left
them.
- A building's battery follows the building's plan when the building sends
one; your own battery is planned with the value of the energy it still
holds at the plan's end, instead of always ending at least as full as it
started.
- In a building or community with tenant power, your home plans with the
price of the building's current offer for your flat (planned with, not
billed).
- The Devices page is clearer: the devices you use with Cantabile are a
short list, each with its state in words ("In use · reading on · control
on" or "Added · reading off"), its main values now ("21.5 °C, set to
22 °C, heating") and whether it is protected. Open a device to change it:
reading and control switch at once, what it reads is said in plain words
("room temperature (Living room), setpoint, heating/cooling state"), and
heating or cooling, room and window, indoor or outdoor and protection
each save on their own (Save shows once you change something). Removing
asks you to confirm. "Untested" profiles are marked with a small badge and
an "i" that explains it. Devices you can still add are listed apart,
below; a device in use is never offered again.
- Heat is shown as heat: a heat meter's or heat pump's heat is "Heat from
the building (thermal)" or "Heat delivered (thermal)", in kW and kWh, in
its own band below solar, home, grid and battery, never added to the
electricity. With your own heat pump its electric power and its COP are
shown beside the heat.
- Blinds, curtains, shutters and awnings: the Devices page offers any of
Home Assistant's covers (never a garage door, gate, door, damper or
window). You set the room it shades and which way the window faces.
Cantabile then moves it by the sun: in summer it closes it (partly, while
someone is home) when the sun is on that window and the room is warm or
dear hours are coming, and opens it again when the sun has gone; in
winter it opens it for the sun's warmth and closes it in the evening to
keep the warmth in, never opening it in the dark. It never moves between
22:00 and 07:00, at most once in 30 minutes, and after you move it by
hand it waits 4 hours. A new shade is protected: Cantabile does not move
it until you allow that on the Devices page (and only with your consent
to control, in auto mode). On the dashboard it is a tile with its
position slider (open and close for one without positions), and "Coming
up" says what is next in words ("Bedroom curtains: close to 30 % at
14:00, sun on the west facade").
- Temperature and humidity sensors: any such sensor (ESPHome, Zigbee,
Bluetooth) that has no profile of its own is offered, never Home
Assistant's or a device's own system temperatures. You choose indoor
(which room; a room that has a temperature already gets a second one) or
outdoor: then it is Cantabile's outside temperature, before the weather
service's. On the dashboard each is a small card with its temperature and
humidity.
- Weather: a weather service (met.no, OpenWeatherMap and others) is offered
as "Weather (forecast)": its hourly forecast plans solar, heating,
cooling and the shades, its temperature and humidity are the outside's
where no outdoor sensor measures them. With several, you choose the one
Cantabile plans with.
- Your consent at installation, in the add-on's configuration: sharing
energy data with Cantabile (needed: without it the add-on does not
connect, and its page says why) and, separately, control. The same texts
and version as a Cantabile Hub's setup; recorded with when and how it was
given and sent to Cantabile. With it, reading and control are switched on
per device on the Devices page.
- Both of the add-on's pages (Devices, Building or community) are for Home
Assistant's administrators only.
- The add-on's page "Devices": Home Assistant's devices with the Cantabile
device profile that fits each (specific profiles first, the generic
thermostat otherwise), what Cantabile would read and could control, and
**Use with Cantabile**: the device's mapping from its profile with reading
and control off, its protection as the profile says (the owner lifts or
sets it), heating or cooling for a thermostat that does both. The
proposal leaves a used device to its profile. The device appears on
Cantabile's dashboard and in the area "Cantabile" (without an area of its
own). The page and "Building or community" are one app, linked from the
dashboard; only Home Assistant's administrators can use them.
- The add-on's page in German or English, as the browser asks (Home
Assistant's own language is not changed).
- A reinstall is recognised: the add-on sends hashed hardware ids with its
enrolment (no serial leaves Home Assistant in clear). When Cantabile merges
it into the home's earlier site, it keeps that site, and its page offers the
earlier consents for the building's and the community's operator again,
given only with your yes.
- One dashboard "Cantabile" with views (overview, energy, heating & cooling,
devices, building) instead of one dashboard per subject; the add-on's
page leaves the sidebar and is linked from the dashboard.
- A mapping at the first start, proposed from Home Assistant's devices and
Cantabile's device profiles, and the import of an earlier install's
mapping from `/share/cantabile/mapping.yaml`; consent always off.
- First packaging as a Home Assistant add-on: the agent and its link to
Cantabile, the MQTT broker from the Mosquitto add-on, Cantabile's area,
device and dashboards in Home Assistant.
- The add-on's page: "Building or community". A home in no building joins
an energy community with a code or asks one nearby, after seeing its rules,
and chooses whether its operator receives the home's data.
- A community's rules on that page include the price of shared energy, its
amounts and penalties where set, and the notice period.
---
© 2026 Setti Solutions S.R.L, [www.setti.md](https://www.setti.md). All rights reserved.