ECG Naming

The ECG driver automatically constructs a display name for each device based on several data sources. The name is built using the following components, in order of priority:

1. Manual Rename - If the device has been manually renamed in Composer, the manual name always takes priority and overrides all automatic naming.
2. Product Name - Derived from the device's EAN/GTIN code. If the EAN is recognised in the internal product database, the name is constructed from the manufacturer company, brand, and product label (e.g. "zencontrol Smart relay"). If the EAN is not recognised, a generic name is used (e.g. "Generic Relay").

3. Device Type Suffix - An optional suffix appended to the product name indicating the device type. This can be toggled on/off via the controller's "Toggle Device Type Name Visibility" action. The suffix is determined by the device's control gear type and colour capabilities:

   Device Type	Suffix
   DALI Group	(Group)
   Relay	(Relay)
   Colour with RGBWAF channels	(Colour RGB)
   Colour with XY coordinates	(Colour XY)
   Colour with TC (tunable white)	(Colour Tc)
   Colour (unrecognised mode)	(Colour)
   LED (no colour control)	(LED)
   Other	(Light)

4. Location Label - The location label from the zencontrol controller. When both the product name and location label are shown, they are combined with a dash separator (e.g. "zencontrol Smart relay (Relay) - Kitchen"). The location label visibility can be toggled via the controller's "Toggle Location Label Visibility" action.
5. Fitting Number - When enabled, the fitting number is prepended to the name (e.g. "0.2: zencontrol Smart relay (Relay)"). This can be toggled via the controller's "Toggle Fitting Number Visibility" action.
6. Group Controller Suffix - DALI Group devices have " - Group Controller" appended to the name.

The final name format is: [FittingNumber: ]ProductName[ (Type)][ - LocationLabel][ - Group Controller]

Examples:

• 0.2: zencontrol Smart relay (Relay)
• 0.10: zencontrol Wireless 4-CH PWM dimmer (Colour Tc)
• 0.4: zencontrol Wireless 4-CH PWM dimmer (Colour RGB)
• 0: Unknown Group (Group) - Group Controller
• 0.101: zencontrol Smart Touch Switch 6 Button (Push Switch)

Native Driver Naming

When an ECG is converted to a native driver (relay, blind, or fan), the native driver's name is constructed from the ECG's current name with the device type suffix replaced by the native type suffix:

• Relay: ProductName (Gate Relay), ProductName (Lift Relay), etc.
• Blind: ProductName (Shade), ProductName (Curtain), etc.
• Fan: ProductName (Fan)

The native driver's name is set at conversion time and is preserved across syncs. Syncing with the zencontrol controller will not overwrite the native driver's name.