SmartWire Studio v0.5.2

Released: 6 August 2026

This update deepens KNX group-address planning — guided setup, richer block-engine options, and safer ETS export editing — while adding a Villa Grande demo project, zone overview exports, and an accessibility pass across the app.

🧭 KNX group-address setup wizard

Guided assistant: New step-by-step wizard for initial GA configuration — address style, block engine vs. schema mode, hierarchy, naming, and optional extensions.
Contextual recommendations: Warns when room or floor counts exceed ETS middle-group limits; explains block vs. schema trade-offs in plain language.
Preview banner: KNX address preview prompts you to run the assistant when settings are still at defaults.

🔌 Block engine & schema planning

GA template preview: Room functions and the trades table show which KOs will be generated per variant — answers the classic forum question “which addresses do I need?”
Extended schema slots: Optional toggle reserves lock, diagnose, operating-mode, and climate KOs in blocks (HVAC uses a unified 15-slot block size).
Plan as dimmable: Reserve dimming slots even for switch-only circuits — unused addresses stay free for later upgrades.
Block grid alignment: Optional 10-address grid (0, 10, 20…) for block start addresses, matching common integrator practice.
Reserve rows in preview: Empty KO offsets inside a block appear as Reserve rows — gaps are visible without exporting phantom GAs to ETS.
MDT jalousie profile: Built-in MDT JAL-0810.02 (Blind 14-KO) vendor profile for 14-object blind actuators and ETS6 multi-linking.

📋 KNX address preview & export

Per-address export toggle: Exclude individual GAs from ETS XML/CSV; excluded count shown in the toolbar; toggles persist correctly across preview refreshes.
Stable address IDs: Export inclusion state no longer breaks when the preview regenerates — accordion sections stay open while you edit.
Reset address structure: Clear all locked GAs and block metadata to fix duplicate ETS imports and start a clean re-export.
No duplicate growth: Re-export no longer accumulates duplicate addresses in ETS import files.
Clearer toolbar: Search, filter (all / included / excluded), and export actions grouped for faster QA before ETS import.

📦 Exports & demo content

Zone overview PDF: New wiring export summarising power supplies, controllers, circuits, loads, and unassigned lights per zone.
Villa Grande scenario: Large KNX demo — 4 floors, 32 rooms, spa, cinema, all trades, 4 bus lines, 215+ functions — for exploring block engine and dashboard at scale.
QA fixtures: Updated ETS6 sample XML/CSV plus Villa Grande JSON fixtures under docs/qa/fixtures/.

🏠 Dashboard & vendor profiles

Trades at a glance: Lighting now appears alongside shading, HVAC, and other trades — with assignment progress and quick actions in the expanded row.
Clearer labels: “Assigned” and “Needs attention” replace technical wording on installer dashboard sections.
Vendor profile editor: Saves without re-rendering all KNX settings; icons refresh consistently after edits.

♿ Accessibility

Form fields app-wide: Inputs and selects now get matching id, name, and associated labels across detail panels, wizards, and tables — including Trades, Lighting table, and Light detail.
Shared helpers: FormGroup, Textarea, and table control utilities for screen readers and autofill.
Dialogs & panels: Improved keyboard and assistive-tech support in confirm dialogs and side panels touched in this release.

🐛 Fixes & reliability

Missing icons: Added Castle and MoreHorizontal Lucide icons used in KNX settings and menus.
Demo scenarios: Empty-home scenario cards click reliably again (E2E smoke tests).
Cloud projects: Hardened project codec when saving and loading from the cloud API.
Detail panels: Additional EN/DE strings for wiring and device fields.

🌐 Languages

New wizard, block-engine, export, dashboard, and accessibility strings in English and German.

💡 Tips for installers

Open KNX Addresses → run the Setup assistant if the preview banner appears.
Review GA requirements on a room function before assigning actuators — check variant and block size.
Use exclude from export for reserve or placeholder GAs you do not want in ETS yet.
If ETS shows duplicates after re-import, use Reset address structure, then export fresh XML/CSV.
Try the Villa Grande demo from the start screen to explore block engine, trades dashboard, and zone overview at scale.

Sample ETS import: docs/qa/fixtures/knx-block-engine-ets6-sample.xml
Runbook: docs/qa/knx-block-engine-ets6.md
Block engine reference: docs/knx-block-engine.md