Add New Object

When adding a new object, you have the option to create either a standard KNX object or a virtual object.

Virtual objects:

• Virtual objects are marked with icon.

• Their range starts from 32/1/1, and they cannot be sent to the KNX TP bus.

• Filtering is disabled for virtual objects.

• Virtual objects are useful for visualization purposes or communication with third parties (e.g., BACnet).

To create a new object, click the Add new object button located at the bottom left of the Objects tab and fill in the Add new object dialog fields:

1. Object properties:

   • Object name: Specify the name of the object.

   • Group address: Set the group address for your object.

   • Data type: Define the KNX data type for the object. This must be set once the controller sniffs the new object for it to function correctly.

   • Current value: Indicates the actual value of the object.

   • Tags: Assign the object to a tag, which can be used later in writing scripts.

   • Unit/Suffix: Add a unit or suffix to the object’s value. Units that cannot be created from the keyboard can be pasted from an external editor.

   • Log: Enable logging for this object (logs appear in the Object logs tab).

   • Export: Make the object visible for remote XML requests.

   • Read during start-up: The object’s actual value will be updated during the controller startup. The KNX object must have the read flag set.

   • Poll interval (seconds): Perform automatic object reads at the selected time interval.

   • KNX Data secure key: If you want encrypted group address communication, enter the encryption key (32 hexadecimal characters).
     Enabling the Import security key option during KNXPROJ file import (see Import KNXPROJ File) will automatically fill in the key.
     Leave this field blank if you don’t need encrypted communication for the group address. Objects with an encryption key have an S icon next to their number in the object list.

   • Object comments: Provide further descriptions for the object. These comments can also be used for filtering.

2. Configuration:

   • To adjust settings for existing or new objects, do the following:
     Click the specific object list entry → edit your object in the Edit object dialog → click OK.