Repository navigation
Home
Welcome to the documentation hub for the Austria Smartmeter custom integration
(domain asm). It retrieves energy data from Austrian grid operator web portals and
publishes it into Home Assistant.
This wiki documents two lines of the integration at the same time. Use the tables below to pick the right document — or go straight to Current (1.2.x) or Archived (1.1.8).
| Your situation | Read |
|---|---|
You run the pre-release 1.2.0-beta.1 from branch HA2026_09_dev (Home Assistant 2026.9+) |
Current documentation |
You run v1.1.8 from main, or any older release |
Archived documentation |
| You want to understand why something is built the way it is | Architecture Design Document |
| You want to understand how it works module by module | Software Design Document |
| You want to see the flows and diagrams | Workflow Diagrams |
| You want to add another grid operator | Adding a New Provider |
Branch HA2026_09_dev · version 1.2.0-beta.1 (pre-release) · requires
Home Assistant 2026.9+
| Document | Contents |
|---|---|
| 📐 Architecture Design Document (ADD) | Requirements, system context, component decomposition, 12 architectural decisions (AD-1…AD-12), cross-cutting concerns, deltas vs. 1.1.8, quality attributes, risks and the roadmap. |
| 🧩 Software Design Document (SDD) | Module inventory, class diagram, the three interface contracts, component-by-component design, sequence diagrams, error handling matrix, localisation, build/verify/release process, traceability. |
| 🗺️ Workflow Diagrams | The GitDiagram repository map (17 components, 23 connections) plus the setup, update, login, entity-creation and state-class workflows. |
| 🛠️ Adding a New Provider | Step-by-step developer guide for the current architecture, with a full adapter skeleton and a test checklist. |
- Netz Niederösterreich works: the login endpoint typo is fixed, the modern metering point API is used (with automatic legacy fallback), readings are parsed from the real response shape and converted from kWh to Wh.
-
Home Assistant 2026.9 compatibility:
entry.runtime_data,ConfigFlowResult, read-onlyOptionsFlow.config_entry,integration_type. -
Correct statistics semantics: period-based consumption is no longer declared as a
cumulative
total_increasingmeter reading. - Brand images shipped inside the integration (icon + logo, light + dark).
- Diagnostics with credential redaction, downloadable from the integration page.
-
Smaller dependency surface: only
lxmlremains;requestsandpython-dateutilcome from Home Assistant Core.
Branch main · version 1.1.8 · Home Assistant 2025.12 era
These pages are kept unchanged for reference. They describe the design before the 2026.9 modernisation and still contain the Netz NÖ login defect that was fixed on the current line.
| Document | Notes |
|---|---|
| 🗄️ Design Documentation 1.1.8 (ACD + SDD) | The former front page of this wiki, preserved verbatim, with an added list of known defects. |
| 🗄️ Extend the integration to support a new energy provider | The former provider guide for the 1.1.8 architecture. |
Migrating from 1.1.8 to 1.2.x is a breaking change: 1.2.x needs Home Assistant 2026.9 or newer.
hacs.jsonpinshomeassistant: 2026.9.0, so HACS only offers the release to compatible systems. Existing entity ids and unique ids are unchanged.
| Provider | 1.1.8 | 1.2.x |
|---|---|---|
| Wiener Netze | ✅ | ✅ |
| Netz Niederösterreich (EVN) | ❌ login broken | ✅ |
| Stromnetz Graz | 🚧 planned | 🚧 planned |
| e-netze.at (issue #3) | ❌ | ❌ requested |
| energiedaten.at (issue #4) | ❌ | ❌ requested |
| Repository | https://github.com/acdcnow/AustrianSmartMeter-for-Home-Assistant |
| Releases | https://github.com/acdcnow/AustrianSmartMeter-for-Home-Assistant/releases |
| Latest pre-release | 1.2.0-beta.1 |
| Issues | https://github.com/acdcnow/AustrianSmartMeter-for-Home-Assistant/issues |
| Pull requests | https://github.com/acdcnow/AustrianSmartMeter-for-Home-Assistant/pulls |
| README — current line 1.2.x (installation, entities, troubleshooting) | README.md @ HA2026_09_dev |
| README — archived line 1.1.8 | README.md @ main |
| Design documents — archived line 1.1.8 | Archive-1.1.8-Design-Documentation |
- Home Assistant developer docs — Config entries, Fetching data, Brand images.
- Repository architecture map generated with GitDiagram.
This is a community project and is not affiliated with any Austrian grid operator.
🟢 Current — 1.2.x
(branch HA2026_09_dev, HA 2026.9+)
🗄️ Archived — 1.1.8
(branch main)
🔗 Links