summaryrefslogtreecommitdiff
path: root/doc
AgeCommit message (Collapse)Author
2 daysdoc: api: future: Simplify with mDNSxengineering
Removing the full configurability of the device and replacing everything with (m)DNS makes the API way easier. There is no need for HTTP, settings parsing and storage and all related efforts. Instead the device finds updates via a hard-coded domain name, and all local services via mDNS. Configuration might come later for security (setting a TLS-PSK key or similar) or for fine-tuning but is in general not required.
2025-07-30doc: api: future: Switch to `mqtt/url` settingxengineering
2025-07-30doc: api: future: Switch to `set` topic suffixxengineering
If a writable topic should correlate to a readable topic the new convention is a suffix (`my/topic/set`) instead of the old prefix (`request/my/topic`). This keeps the alphabetical ordering the same.
2025-07-30doc: api: future: Order MQTT topic by alphabetxengineering
2025-07-30doc: api: future: Remove update automationxengineering
With the change to MQTT the device will not be usable anymore without server infrastructure. This design change allows to reduce the complexity of configuration and implementation here significantly. The device only supports MQTT-triggered HTTP pull updates and the server should take care of regularly triggering this via MQTT.
2025-07-27doc: api: future: Update MQTT APIxengineering
2025-07-26doc: api: future: Introduce device info conceptxengineering
This reduces the HTTP endpoints and overhead.
2025-07-26doc: api: future: Switch to pull updatesxengineering
2025-07-24doc: api: Add README.md and flatten future.md structurexengineering
This makes it later possible to diff the planned `current.md` with the `future.md`. When the firmware is feature-complete the diff should be empty.
2025-07-24doc: api: future: Add first draftxengineering
2025-07-24doc: Add CC-BY-SA licensexengineering