Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Location: <WorkspaceDirectory>\DataFiles\nxaGatewayDefinitions.3540.dat

The gateway manager maintains the connections to the KNXnet/IP devices which are connected to the KNX system. The gateway definition table defines all the KNXnet/IP interfaces and routers that are used within the project.

Info
! No telegrams are sent to the offline gateways.


Info

! This definition file can also be generated using the ETS app import wizard (Studio → KNX → Inport NETx ETS App file ...) which generates the KNX gateway definitions from an exported ETS project.

The structure of the gateway definition file is as follows:'Syntax of the Gateway Definition Table:
'IP Address;Type;Port;Name;Locality;Description ;Options'
192.168.1.1;IGS;51000; GATE 1;Room 51;pre-defined Gateway 1
192.168.1.2;NETIP;3671;Gate2;;;;;;;
192.168.1.3;EIBNODE;1634;Gate3;;;;;;;

Each line – except comment lines that start with ' – defines a single KNXnet/IP gateway.

Info

! The virtual "BROADCAST" gateway is added by the system and must not be defined in the table.


Col#

...

Parameter 
 
Description
 
Scope
 
Unit
 
Default value
1IP Address
 This attribute specifies
Specifies the IP address of the KNXnet/IP gateway.
The IP address is also used to uniquely identify the gateway within the server. Therefore, it must be unique within the whole network.
IP addressNone
2Gateway Type
 

The type of the KNXnet/IP gateway.

"IGS" refers to ABB IG/S, EIBNODE to b.a.b - technologie eibnode, and NETIP to all other KNXnet/IP routers and interfaces.3UDP Port This attributes represents the UDP It is used to give the gateway a

Supported types are

  • SEC_NETIP: secure KNXnet/IP tunnelling
  • NETIP: native KNXnet/IP tunnelling
  • NETIP_ROUTING: native KNXnet/IP routing
SEC_NETIP, NETIP, NETIP_ROUTINGNone
3PortThe UDP or TCP port number which is used to connect to the gateway.UDP or TCP port numberNone
4Name
 
A unique human-readable name
(can be any user-defined string)
.StringNoneThe gateway's IP address.
5Locality
 
This attribute can be used to specify the location of the gateway (can be any user-defined string).StringNone
6Description
 
This attribute can be used to specify a human-readable text that further describes the gateway (can be any user-defined string).StringNone
7
Options If the gateway is of type "EIBNODE", the SenderNetID has to be specified here.8 - 11Path, Extended Data 1 - 3 These columns are for internal use only.

 

Source phys. KNX AddressThe physical KNX address used by the Core Server when sending telegrams. Only used for KNXnet/IP routing.KNX phys. addressNone
8Network Card IP AddressThe local network card IP address used by the Core Server. Only used for KNXnet/IP routing.IP addressNone
9Management CodeThe management code used for authentication to a secure KNXnet/IP tunnelling device. This must be identical to the code used within the ETS.StringNone
10Authentication CodeThe authentication code used for authentication to a secure KNXnet/IP tunnelling device. This must be identical to the code used within the ETS.StringNone