Device Table#

sl_zigbee_af_device_table_cli_index_send#

void sl_zigbee_af_device_table_cli_index_send (uint16_t index)

Send a message using the device table.

Sends the current framework ZCL command to the device specified by an index.

sl_zigbee_af_device_table_send#

void sl_zigbee_af_device_table_send (sl_802154_long_addr_t eui64, uint8_t endpoint)

Send a message using the device table.

Sends the current framework ZCL command using a device specified by the EUI64 and endpoint.

sl_zigbee_af_device_table_cli_index_send_with_endpoint#

void sl_zigbee_af_device_table_cli_index_send_with_endpoint (uint16_t index, uint8_t endpoint)

Send a CLI command based on an index and an endpoint.

Sends the current framework ZCL command using a device indexed in the device table.

sl_zigbee_af_device_table_command_index_send#

void sl_zigbee_af_device_table_command_index_send (uint16_t index)

Send an internally-generated command.

Sends an internally-generated command, such as generated by the sl_zigbee_af_fill_command_on_off_cluster_on(); command. Note: this is different from the above send command, which works with the CLI-generated outgoing commands.

sl_zigbee_af_device_table_command_send_with_endpoint#

void sl_zigbee_af_device_table_command_send_with_endpoint (sl_802154_long_addr_t eui64, uint8_t endpoint)

Send an internally-generated command.

Sends an internally-generated command, such as generated by the sl_zigbee_af_fill_command_on_off_cluster_on(); command. Note: this is different from the above send command, which works with the CLI-generated outgoing commands.

sl_zigbee_af_device_table_command_index_send_with_endpoint#

void sl_zigbee_af_device_table_command_index_send_with_endpoint (uint16_t index, uint8_t endpoint)

Send an internally-generated command.

Sends an internally-generated command, such as generated by the sl_zigbee_af_fill_command_on_off_cluster_on(); command. Note: this is different from the above send command, which works with the CLI-generated outgoing commands.

sl_zigbee_af_device_table_get_eui64_from_node_id#

bool sl_zigbee_af_device_table_get_eui64_from_node_id (sl_802154_short_addr_t sl_zigbee_node_id, sl_802154_long_addr_t eui64)

Compute the EUI64 from the node ID in the device table.

This function looks up the device-table entry using the node ID and return the EUI64.

Returns

• bool True if an EUI can be found, false if not.

sl_zigbee_af_device_table_get_node_id_from_index#

uint16_t sl_zigbee_af_device_table_get_node_id_from_index (uint16_t index)

Compute the node ID from the device table index.

Looks up the device table entry based on the index and returns the node ID.

Returns

• The node ID of the device.

sl_zigbee_af_device_table_get_endpoint_from_node_id_and_endpoint#

uint16_t sl_zigbee_af_device_table_get_endpoint_from_node_id_and_endpoint (sl_802154_short_addr_t sl_zigbee_node_id, uint8_t endpoint)

Find the endpoint index from node ID and endpoint number.

Computes the index into the endpoint table based on the node ID and the endpoint number.

Returns

• The index of the device.

sl_zigbee_af_device_table_get_index_from_node_id#

uint16_t sl_zigbee_af_device_table_get_index_from_node_id (sl_802154_short_addr_t sl_zigbee_node_id)

Find the index based on the node ID.

Computes the device-table index based on the node ID.

Returns

• The index in the device-table.

sl_zigbee_af_device_table_get_first_index_from_eui64#

uint16_t sl_zigbee_af_device_table_get_first_index_from_eui64 (sl_802154_long_addr_t eui64)

Find the index based on the EUI64.

Computes the first device table index from the EUI64.

Returns

• The first index that matches the EUI64.

sl_zigbee_af_device_table_get_index_from_eui64_and_endpoint#

uint16_t sl_zigbee_af_device_table_get_index_from_eui64_and_endpoint (sl_802154_long_addr_t eui64, uint8_t endpoint)

Find the index based on the EUI64 and endpoint.

Computes the node ID based on the device table entry that matches the EUI64.

Returns

• Index that matches the EUI64

sl_zigbee_af_device_table_get_node_id_from_eui64#

uint16_t sl_zigbee_af_device_table_get_node_id_from_eui64 (sl_802154_long_addr_t eui64)

Find the node ID based on the EUI64.

Computes the node ID based on the device table entry that matches the EUI64.

Returns

• The node ID that matches the EUI64.

sl_zigbee_af_device_table_message_sent_status#

void sl_zigbee_af_device_table_message_sent_status (sl_802154_short_addr_t nodeId, sl_status_t status, uint16_t profileId, uint16_t clusterId)

Change the device status based on the last sent message.

If the last sent message was a success, change the device state to "joined". However, if the last message sent was not a success, change the device state to unresponsive.

sl_zigbee_af_device_table_send_leave#

void sl_zigbee_af_device_table_send_leave (uint16_t index)

Send a leave message to a device based on the index.

Sends a leave message to the device indicated by the index.

sl_zigbee_af_device_table_message_received#

void sl_zigbee_af_device_table_message_received (sl_802154_short_addr_t nodeId)

Inform the device table that a message was received.

The device table keeps track of whether a device has become unresponsive. Hearing from a known device causes the device table to transition the device state from "unresponsive" to "joined". Hearing from an unknown device causes the device table to discover the device, potentially fixing routing issues (i.e., if the node ID has changed).

sl_zigbee_af_device_table_initiate_route_repair#

void sl_zigbee_af_device_table_initiate_route_repair (sl_802154_short_addr_t nodeId)

Kick off device table route repair.

A message was sent to the device and failed. Therefore, the route repair will be attempted and the node marked as unresponsive. Currently, route repair simply sends a broadcast message looking for the node ID based on the EUI64. It may be replaced with something more sophisticated in the future.

sl_zigbee_af_device_table_pointer#

sl_zigbee_af_plugin_device_table_entry_t * sl_zigbee_af_device_table_pointer (void )

Return a pointer to the device table structure.

Returns a pointer to the device table structure.

Returns

• A pointer to the device table structure.

sl_zigbee_af_device_table_find_device_table_entry#

sl_zigbee_af_plugin_device_table_entry_t * sl_zigbee_af_device_table_find_device_table_entry (uint16_t index)

Return a pointer to the device table entry.

Returns a pointer to the device table entry based on the device table index.

Returns

• A pointer to the device table entry.

sl_zigbee_af_device_table_new_device_join_handler#

void sl_zigbee_af_device_table_new_device_join_handler (sl_802154_short_addr_t newNodeId, sl_802154_long_addr_t newNodeEui64)

Inform the device table that a new device joined.

Call this function in the device table when a device joins, rejoins, or sends an end-device announce. If the device is new, it will generate a new device table entry and kick off the discovery process. If the device is not new, the device-table will make sure the node ID matches the EUI64 and make an update if necessary. It will also check to verify the discovery process has completed and attempt to complete it.

sl_zigbee_af_device_table_time_since_last_message#

uint32_t sl_zigbee_af_device_table_time_since_last_message (uint16_t index)

Calculate time since the device heard the last message.

Computes the amount of time, in seconds, since receiving a message from the device.

Returns

• The time since the last message (in seconds).

sl_zigbee_af_device_table_match_eui64#

bool sl_zigbee_af_device_table_match_eui64 (sl_802154_long_addr_t a, sl_802154_long_addr_t b)

Return true if the two EUI64 parameters match.

Determines whether two EUI64 values are the same. The function will print a feedback message to indicate if both EUI64 values are NULL. The function will also print out a feedback message to indicate if the EUI64 values match but in reverse order.

sl_zigbee_af_device_table_clear#

void sl_zigbee_af_device_table_clear (void )

Clear the device table.

Clears the device table and the backup file of the device table is also cleared if it is a host.

sl_zigbee_af_device_table_index_removed_cb#

void sl_zigbee_af_device_table_index_removed_cb (uint16_t currentIndex)

Called when a device has been removed from the device table.

Called when the device has been removed from the table.

sl_zigbee_af_device_table_initialized#

void sl_zigbee_af_device_table_initialized (void )

Called when the device table has been initialized.

Called when the device table has been initialized

sl_zigbee_af_plugin_device_table_device_state_t#

sl_zigbee_af_plugin_device_table_device_state_t

sl_zigbee_af_plugin_device_table_device_state_t#

typedef uint8_t sl_zigbee_af_plugin_device_table_device_state_t