User`s manual

Add Device to Trust Center Gateway

In order to add a device to the Smart Energy network with the X2 gateway running as a

trust center (ESI coordinator), use the add_device RPC request (see

“add_device_response Parameters:” on page 73). This will add a device with the given

link key or installation code to the device table stored in the ESI. Joining will be enabled

for the specified amount of time (set in this example to 600 seconds). Fill in the

device_address and link_key as appropriate to match the joining device. If using an

installation code replace link_key with installation_code.

This request has the following format:

<add_device>

<device_address type="MAC">11:22:33:44:55:66:77:88</device_address>

<join_time>600</join_time>

<link_key type=”base16”>56777777777777777777777777777777</link_key>

</add_device>

Once the add_device RPC request has been sent, instruct the joining device to join the

network. Once a device joins the network, the gateway will return a message with the

following format:

ZDO_Device_Manager - Device 11:22:33:44:55:66:77:88 detected and marked as

active

</description>

</message>

Joining a Router Gateway

By default, router gateways (ESI router and Aux Gateway) will automatically try to join

any network on any channel on startup using their pre-configured installation code.

These joining parameters can be configured with the get_zigbee_network_configuration

RPC request (see “get_zigbee_network_configuration” on page 78). This request

configures the interval between join attempts, the scan channel mask for joining, the

installation code and the extended PAN ID.

<get_zigbee_network_configuration>

<extended_pan_id>0</extended_pan_id>

<installation_code type=”base16”>1234567890ABBA9E</installation_code>

<join_attempt_interval>120</join_attempt_interval>

<channel_mask>0xFFFF</channel_mask>

</get_zigbee_network_configuration>