ETS6 · KNX · Commissioning · 9 min read

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.

MediumETS6 codeMax devices/lineTypical use
TP (Twisted Pair)TP64Standard wired installation — residential and commercial
IP (KNXnet/IP)IPUnlimited (IP network)IP backbone, virtual backbone over LAN
RF (Radio Frequency)RF255 (per RF domain)Retrofit installations, listed buildings, no cable access
PL (Power Line)PL255Rare — 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 respond

Address 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.

StructureFormatMax GAsTypical use
3-level (standard)Main/Middle/Sub (0–15 / 0–7 / 0–255)~65,000EU commercial — recommended for all projects over 20 GAs
2-levelMain/Sub (0–15 / 0–2047)~32,000Simple residential, legacy projects
Free structureSingle integer 0–6553565,535BMS 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 AddressNameDPTWRTNotes
1/1/1F1 Office A — Lights Switch1.001YNNPush button → actuator channel 1
1/1/2F1 Office A — Lights Status1.001NYYActuator → visualization
1/1/3F1 Office A — Lights Dim Rel3.007YNNPush button hold → actuator
1/1/4F1 Office A — Lights Dim Abs5.001YNNVisualization → actuator
1/1/5F1 Office A — Lights Brightness5.001NYYActuator feedback → visualization
1/1/6F1 Office A — All Off1.001YNNMaster off command
1/2/1F1 Meeting Rm — Lights Switch1.001YNNPush button → actuator channel 2
1/2/2F1 Meeting Rm — Lights Status1.001NYYActuator → visualization
1/2/3F1 Meeting Rm — Lights Dim Rel3.007YNNRelative dimming
1/2/4F1 Meeting Rm — Lights Dim Abs5.001YNNAbsolute brightness 0–100%
1/2/5F1 Meeting Rm — Brightness Status5.001NYYFeedback for touchpanel
1/0/1F1 All Lights — Switch1.001YNNFloor-level all-on/all-off
1/0/6F1 All Lights — All Off1.001YNNAlarm integration output
6/1/1F1 Scene Recall18.001YNNScene 1–8 recall command
6/1/2F1 Scene Store18.001YNNScene store command
3/1/1F1 Office A — Room Setpoint9.001YNNThermostat setpoint write
3/1/2F1 Office A — Room Actual Temp9.001NYYTemperature sensor transmit
3/1/3F1 Office A — Fan Speed5.001YNNFan coil speed 0–100%
10/0/1Building — Time of Day10.001YNNNTP master → all clock objects
10/0/2Building — Date11.001YNNNTP 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.

ParameterLocation in ETS6OptionsRecommendation
Channel typeChannel A → GeneralSwitching / Shutter / Dimmer (via ext. module)Set per load type — never leave on default Switching if load is shutter
KNX safety priorityChannel A → SafetyOff / Low / HighHigh for fire alarm override, Low for security shutter control
Cyclic sending intervalChannel A → StatusDisabled / 1s – 24h60 minutes for visualization status; disable for pure switching
Staircase timerChannel A → Time functionsOff / 1s – 1hSet to expected occupancy time + 10%; use with PIR presence detector
Reaction on bus voltage restoreGeneralNo change / On / Off / Last valueLast value — restores state after power cut
Manual operationGeneralAllowed / LockedLocked 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

ShortcutActionNotes
F5Download selected device(s)Downloads parameters and GA links to highlighted device(s)
F6Download applicationFull application download — use after firmware update
Ctrl + DOpen Group MonitorLive telegram trace — available with IP or USB interface
Ctrl + BOpen Bus MonitorLow-level telegram monitor — requires ETS Pro license
Ctrl + EExport group addressesOpens export dialog — choose CSV or XML format
Ctrl + Alt + PProject propertiesPassword, project info and backup settings
Ctrl + FFind device or GASearch across entire project by name or address
F2Rename selected itemRename device, line, GA or building location
Ctrl + ZUndo last parameter changeWorks in parameter editor — not in topology view
Ctrl + Shift + SSave project asSave copy with new filename — use for version backup
Alt + F4Close projectSaves automatically before closing in ETS6
Ctrl + GGo to individual addressNavigate 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 →
Loading...
Back to top