ETS6 project structure: group addresses, topologies and export
A well-structured ETS6 project is the difference between a clean handover and months of maintenance calls. Get the topology, individual addresses, group address scheme and export workflow right from the first device, and every engineer who touches the installation afterwards will thank you.
Project creation: selecting a topology
When you create a new ETS6 project, the first decision is the physical medium. KNX supports four media types, and each creates a different topology structure in the project tree.
| Medium | ETS6 code | Max devices/line | Typical use |
|---|---|---|---|
| TP (Twisted Pair) | TP | 64 | Standard wired installation — residential and commercial |
| IP (KNXnet/IP) | IP | Unlimited (IP network) | IP backbone, virtual backbone over LAN |
| RF (Radio Frequency) | RF | 255 (per RF domain) | Retrofit installations, listed buildings, no cable access |
| PL (Power Line) | PL | 255 | Rare — uses existing mains wiring; slower, noisier |
For commercial KNX projects, the project always starts with TP topology, even if an IP backbone will be used later. The IP backbone layer is added by inserting KNXnet/IP routers as line couplers in the topology tree — they appear as devices on the backbone and connect to individual TP lines below them.
Maximum theoretical installation size: 15 areas × 15 lines × 255 devices = 57,375 device address slots. In practice, ETS6 enforces 64 TP devices per line (current limit), which gives 15 × 15 × 64 = 14,400 addressable TP devices. Large installations use IP routers as area couplers to connect multiple TP lines via IP backbone.
Individual address assignment (Area.Line.Device)
Every KNX device receives a unique physical address (PA) in the format Area.Line.Device. This address maps the device to a physical location in the topology hierarchy. ETS6 assigns the address by downloading to the device via the programming button.
Individual address rules — Area.Line.Device
Addressing rules:
Area: 1–15 (0 = backbone)
Line: 1–15 (0 = line coupler connection to area)
Device: 1–255 (0 = line coupler itself; 255 reserved for line coupler PA)
First device on every new line:
1.1.255 → Line coupler physical address (always .255 by convention)
Actual end devices start from 1.1.1
Device numbering within a line:
1.1.1 → First end device (sensor, actuator, push button)
1.1.2 → Second end device
...
1.1.64 → Maximum 64 end devices per KNX TP line (IEC 14543-3)
Multi-line example — 8-floor office:
1.1.x → Floor 1 lighting and blinds
1.2.x → Floor 1 HVAC and presence
1.3.x → Floor 2 lighting and blinds
2.1.x → Wing B, Floor 1 lighting (different area)
0.0.0 → Unaddressed factory default — bus will not respondAddress 0.0.0 — never leave in production
Devices ship with address 0.0.0 (factory default). Two unaddressed devices on the same line cause bus collisions. Always assign a unique PA before connecting to the live bus. ETS6 will warn if duplicates are detected during download.
Line coupler always .0 and .255
The line coupler occupies two addresses: X.Y.0 on the upstream (backbone or area) side, and X.Y.255 on the downstream (line) side. Both addresses belong to the same physical device. Never assign .255 or .0 to an end device.
Group address structures
Group addresses (GAs) define the logical communication links between KNX devices. ETS6 supports three GA structures. The choice of structure is permanent per project and affects how many GAs are available and how they are organised.
| Structure | Format | Max GAs | Typical use |
|---|---|---|---|
| 3-level (standard) | Main/Middle/Sub (0–15 / 0–7 / 0–255) | ~65,000 | EU commercial — recommended for all projects over 20 GAs |
| 2-level | Main/Sub (0–15 / 0–2047) | ~32,000 | Simple residential, legacy projects |
| Free structure | Single integer 0–65535 | 65,535 | BMS export, OPC UA integration, programmatic GA assignment |
Why 3-level is standard in EU commercial projects
The 3-level structure (Main.Middle.Sub) is the industry default across German, Austrian and Swiss KNX integrators for a reason: the Main group maps to the system function, the Middle group maps to the physical zone or floor, and the Sub group maps to the individual data point. This makes the GA table immediately readable to any engineer joining the project.
Recommended 3-level group address topology
Main group → System function: 1/x/x → Lighting (switching, dimming, status) 2/x/x → Blinds and solar shading (up/down, position, slat angle) 3/x/x → HVAC (setpoint, actual temp, fan speed, valve position) 4/x/x → Security (alarm zones, motion, door/window contacts) 5/x/x → Energy (meter readings, demand, power factor) 6/x/x → Scenes (recall, store, all-off) 7/x/x → Emergency (lighting test, alarm routing) 8/x/x → Audio and media control 9/x/x → Access control (lock/unlock, bell, camera) 10/x/x → System (time, date, presence master, fault summary) Middle group → Zone or floor: x/0/x → Building-wide (global commands) x/1/x → Floor 1 / Zone 1 x/2/x → Floor 2 / Zone 2 ... x/7/x → Floor 7 / Zone 7 Sub group → Individual data point: x/x/1 → Switch command (write) x/x/2 → Switch status feedback (transmit) x/x/3 → Relative dimming (write) x/x/4 → Absolute brightness value (write) x/x/5 → Brightness status feedback (transmit)
Group address naming convention
A consistent GA naming convention is the single most important quality control measure in ETS6. The table below shows a 20-row example for a floor lighting system using 3-level GA structure with DPT assignments and flag configuration.
| Group Address | Name | DPT | W | R | T | Notes |
|---|---|---|---|---|---|---|
| 1/1/1 | F1 Office A — Lights Switch | 1.001 | Y | N | N | Push button → actuator channel 1 |
| 1/1/2 | F1 Office A — Lights Status | 1.001 | N | Y | Y | Actuator → visualization |
| 1/1/3 | F1 Office A — Lights Dim Rel | 3.007 | Y | N | N | Push button hold → actuator |
| 1/1/4 | F1 Office A — Lights Dim Abs | 5.001 | Y | N | N | Visualization → actuator |
| 1/1/5 | F1 Office A — Lights Brightness | 5.001 | N | Y | Y | Actuator feedback → visualization |
| 1/1/6 | F1 Office A — All Off | 1.001 | Y | N | N | Master off command |
| 1/2/1 | F1 Meeting Rm — Lights Switch | 1.001 | Y | N | N | Push button → actuator channel 2 |
| 1/2/2 | F1 Meeting Rm — Lights Status | 1.001 | N | Y | Y | Actuator → visualization |
| 1/2/3 | F1 Meeting Rm — Lights Dim Rel | 3.007 | Y | N | N | Relative dimming |
| 1/2/4 | F1 Meeting Rm — Lights Dim Abs | 5.001 | Y | N | N | Absolute brightness 0–100% |
| 1/2/5 | F1 Meeting Rm — Brightness Status | 5.001 | N | Y | Y | Feedback for touchpanel |
| 1/0/1 | F1 All Lights — Switch | 1.001 | Y | N | N | Floor-level all-on/all-off |
| 1/0/6 | F1 All Lights — All Off | 1.001 | Y | N | N | Alarm integration output |
| 6/1/1 | F1 Scene Recall | 18.001 | Y | N | N | Scene 1–8 recall command |
| 6/1/2 | F1 Scene Store | 18.001 | Y | N | N | Scene store command |
| 3/1/1 | F1 Office A — Room Setpoint | 9.001 | Y | N | N | Thermostat setpoint write |
| 3/1/2 | F1 Office A — Room Actual Temp | 9.001 | N | Y | Y | Temperature sensor transmit |
| 3/1/3 | F1 Office A — Fan Speed | 5.001 | Y | N | N | Fan coil speed 0–100% |
| 10/0/1 | Building — Time of Day | 10.001 | Y | N | N | NTP master → all clock objects |
| 10/0/2 | Building — Date | 11.001 | Y | N | N | NTP master → all date objects |
W = Write flag (command input), R = Read flag (value can be polled), T = Transmit flag (device sends on change). A correctly set flag configuration prevents unnecessary bus load and ensures BMS polling works correctly.
Application import: ETS online catalogue vs offline .knxprod
Before you can program parameters into a device, ETS6 needs the device application — the parameterisation template and communication object definitions for that specific firmware version. Applications can be loaded from two sources:
ETS Online Catalogue
- Access via ETS6 → Catalogue panel → Search by manufacturer
- Always downloads the latest published application version
- Requires internet connection on the commissioning laptop
- Risk: latest catalogue version may not match firmware on installed devices — causes parameter mismatch error during download
Offline .knxprod import
- Download .knxprod file from manufacturer website before site visit
- Import via ETS6 → Catalogue → Import
- Works offline — essential for sites with no internet
- Match application version to device firmware version exactly
- Store versioned .knxprod files alongside the .knxproj in your project archive
MDT Gen5 vs Gen6 pitfall: MDT Switch Actuator SAX-04M.02 (Gen5) and the newer SAX-0800.03 (Gen8) have completely different ETS6 applications — they share no communication objects. If you update a device from Gen5 to Gen6 firmware, you must re-import the matching .knxprod and re-program all parameters from scratch. Never apply a Gen6 application to a Gen5-firmware device: ETS6 will reject the download with a firmware version mismatch error.
Parameter programming: MDT Switch Actuator SAX-04M.02
The MDT Switch Actuator SAX-04M.02 is one of the most widely deployed KNX actuators in European commercial installations. Understanding its key ETS6 parameters prevents the most common commissioning mistakes.
| Parameter | Location in ETS6 | Options | Recommendation |
|---|---|---|---|
| Channel type | Channel A → General | Switching / Shutter / Dimmer (via ext. module) | Set per load type — never leave on default Switching if load is shutter |
| KNX safety priority | Channel A → Safety | Off / Low / High | High for fire alarm override, Low for security shutter control |
| Cyclic sending interval | Channel A → Status | Disabled / 1s – 24h | 60 minutes for visualization status; disable for pure switching |
| Staircase timer | Channel A → Time functions | Off / 1s – 1h | Set to expected occupancy time + 10%; use with PIR presence detector |
| Reaction on bus voltage restore | General | No change / On / Off / Last value | Last value — restores state after power cut |
| Manual operation | General | Allowed / Locked | Locked in production; enable only for commissioning |
ETS6 Group Monitor for live telegram tracing
The ETS6 Group Monitor captures all telegrams on the KNX bus in real time and decodes them by group address, DPT and value. It is available in all ETS6 licence tiers (including the free ETS6 Demo) and requires only an active IP interface or USB connection.
ETS6 Group Monitor — useful filter patterns
Filter by group address: 1/* → All lighting group addresses (Main group 1) 1/1/* → All Floor 1 Office A group addresses 1/1/2 → Exactly one GA — lighting status for Office A Filter by source individual address: 1.1.5 → All telegrams sent by device 1.1.5 (e.g. a push button) 1.1.* → All telegrams from area 1, line 1 Useful during commissioning: Step 1: Press physical push button → telegram should appear Step 2: Verify Source = push button PA, Destination = correct GA Step 3: Verify DPT and value match expected (e.g. 1.001 = 1/On) Step 4: Verify actuator sends status feedback telegram on correct GA Common errors visible in Group Monitor: - Wrong GA assigned → telegram goes to 0/0/1 instead of 1/1/1 - Flag missing → Write flag off → telegram rejected, no bus traffic - Wrong DPT → value decoded as 0 when physical value is 100% - Flooding → cyclic telegram every 1s from misconfigured sensor
Export: .knxproj archive, CSV, XML and OPC UA
ETS6 supports several export formats for different handover and integration purposes. Understanding which format each integration partner needs prevents last-minute conversion work on site.
.knxproj — ETS project archive
The complete ETS6 project including all device parameters, GA assignments, building structure and individual addresses. Password-protected. This is the primary backup and handover file. The client or maintenance engineer opens it in ETS6 to modify or re-download any device.
Group address export — CSV
ETS6 → Group Addresses → Export → CSV. Contains all GAs with name, address, DPT and linked communication objects. Required by BMS integrators (Crestron, Savant, Loxone, KNX2PDF). Include in every project handover package.
Group address export — XML (ETS)
More structured than CSV — includes object name, flags and device association. Accepted by Weinzierl BAOS modules and some Modbus/KNX gateways for automatic GA import.
OPC UA export via KNX-OPC UA gateway
Not a native ETS6 export — requires a KNX/OPC UA gateway (e.g. MDT SCN-OPC.01 or Anybus X-gateway). Import the GA CSV into the gateway configuration tool; the gateway maps GAs to OPC UA nodes. Required for Siemens Desigo CC, Honeywell EBI and other enterprise BMS platforms.
Backup discipline
A lost ETS6 project means re-commissioning an entire installation from scratch — potentially weeks of work on a large commercial project. The following discipline is non-negotiable.
ETS6 backup procedure
Rule 1: Export .knxproj before any firmware update → Firmware update may reset device to factory defaults → Without a backup, all parameters are lost Rule 2: Keep 3 project generations → ProjectName_v1_YYYY-MM-DD.knxproj (initial commissioning) → ProjectName_v2_YYYY-MM-DD.knxproj (first modification) → ProjectName_v3_YYYY-MM-DD.knxproj (latest — always current) → Delete v1 when v4 is created (rolling 3-version window) Rule 3: Store backups in 3 locations → Company NAS (primary) → Cloud storage with version history (secondary) → USB key left inside the panel (on-site emergency access) Rule 4: Export GA CSV with each backup → GA CSV is readable without ETS6 — useful for BMS support calls → Filename convention: ProjectName_GA_YYYY-MM-DD.csv Rule 5: Document ETS6 project password in secure password manager → Never use project password = "knx" or "1234" → Client must receive the password at handover
ETS6 keyboard shortcuts for commissioning
| Shortcut | Action | Notes |
|---|---|---|
| F5 | Download selected device(s) | Downloads parameters and GA links to highlighted device(s) |
| F6 | Download application | Full application download — use after firmware update |
| Ctrl + D | Open Group Monitor | Live telegram trace — available with IP or USB interface |
| Ctrl + B | Open Bus Monitor | Low-level telegram monitor — requires ETS Pro license |
| Ctrl + E | Export group addresses | Opens export dialog — choose CSV or XML format |
| Ctrl + Alt + P | Project properties | Password, project info and backup settings |
| Ctrl + F | Find device or GA | Search across entire project by name or address |
| F2 | Rename selected item | Rename device, line, GA or building location |
| Ctrl + Z | Undo last parameter change | Works in parameter editor — not in topology view |
| Ctrl + Shift + S | Save project as | Save copy with new filename — use for version backup |
| Alt + F4 | Close project | Saves automatically before closing in ETS6 |
| Ctrl + G | Go to individual address | Navigate directly to a device by typing its PA |
Need a KNX panel commissioned to spec?
We build and fully commission KNX panels — ETS6 project configured, group address table documented, and test certificate issued before the panel leaves our factory.
Request a quote →