Address Table#

API and Callbacks for the Address Table Component.

This component supports managing the address table. On the SoC, all actions are directly performed on the stack address table. The host maintains a copy of the address table and ensures that it is always in sync with the NCP's address table. When building the Host, make sure that the NCP can support the address table size in the component configuration. The optimal size varies based on the platform architecture and size of other dynamically-allocated data for this application. If errors occur upon reseting the NCP, the NCP may not have enough room to store a large address table size. If this is not the case, the NCP may not be able to dynamically increase the address table size based on the host's request. To work around this issue, statically allocate the desired address table size on the Zigbee Pro Stack\Pro Leaf Stack components on the NCP.

API#

EmberStatus

Remove an entry from the address table.

uint8_t

Add a new entry to the address table.

EmberStatus
emberAfPluginAddressTableLookupByIndex(uint8_t index, EmberEUI64 entry)

Copy the entry stored at the passed index to the passed variable and return EMBER_SUCCESS if the passed index is valid.

EmberNodeId

Copy the entry stored at the passed index to the passed variable and return EMBER_SUCCESS if the passed index is valid.

EmberStatus
emberAfSendUnicastToEui64(EmberEUI64 destination, EmberApsFrame *apsFrame, uint16_t messageLength, uint8_t *message)

Allow sending a unicast message specifying the EUI64 of the destination node.

EmberStatus
emberAfSendCommandUnicastToEui64(EmberEUI64 destination)

Send the command prepared with emberAfFill.... macro.

EmberStatus
emberAfGetCurrentSenderEui64(EmberEUI64 address)

Copy the sender EUI64, if available, to the address parameter and return EMBER_SUCCESS. Otherwise, return EMBER_INVALID_CALL.

#define

Add a new entry to the address table.

#define

Remove an entry from the address table by index.

#define

Search for an EUI64 in the address table.

API Documentation#

emberAfPluginAddressTableRemoveEntry#

EmberStatus emberAfPluginAddressTableRemoveEntry (EmberEUI64 entry)

Remove an entry from the address table.

Parameters
N/Aentry

If the entry exists, the entry is cleared and the EMBER_SUCCESS status is returned. Otherwise, the status EMBER_INVALID_CALL is returned.


Definition at line 70 of file app/framework/plugin/address-table/address-table.h

emberAfLookupAddressTableEntryByEui64#

uint8_t emberAfLookupAddressTableEntryByEui64 (EmberEUI64 longId)

Add a new entry to the address table.

Parameters
N/AlongId

If the entry already exists, no new entry is created and the index of the entry already in the table is returned. If a free entry is found, the entry is added to the table and the corresponding index is returned. If no free entry is available in the address table, the value EMBER_NULL_ADDRESS_TABLE_INDEX is returned.


Definition at line 91 of file app/framework/plugin/address-table/address-table.h

emberAfPluginAddressTableLookupByIndex#

EmberStatus emberAfPluginAddressTableLookupByIndex (uint8_t index, EmberEUI64 entry)

Copy the entry stored at the passed index to the passed variable and return EMBER_SUCCESS if the passed index is valid.

Parameters
N/Aindex
N/Aentry

Otherwise, the status EMBER_INVALID_CALL is returned.


Definition at line 101 of file app/framework/plugin/address-table/address-table.h

emberAfPluginAddressTableLookupNodeIdByIndex#

EmberNodeId emberAfPluginAddressTableLookupNodeIdByIndex (uint8_t index)

Copy the entry stored at the passed index to the passed variable and return EMBER_SUCCESS if the passed index is valid.

Parameters
N/Aindex

Otherwise, the status EMBER_INVALID_CALL is returned.


Definition at line 112 of file app/framework/plugin/address-table/address-table.h

emberAfSendUnicastToEui64#

EmberStatus emberAfSendUnicastToEui64 (EmberEUI64 destination, EmberApsFrame * apsFrame, uint16_t messageLength, uint8_t * message)

Allow sending a unicast message specifying the EUI64 of the destination node.

Parameters
N/Adestination
N/AapsFrame
N/AmessageLength
N/Amessage

Note: the specified EUI64 must be present in the address table. Otherwise, the status EMBER_INVALID_CALL is returned.


Definition at line 121 of file app/framework/plugin/address-table/address-table.h

emberAfSendCommandUnicastToEui64#

EmberStatus emberAfSendCommandUnicastToEui64 (EmberEUI64 destination)

Send the command prepared with emberAfFill.... macro.

Parameters
N/Adestination

This function sends a command that was previously prepared using the emberAfFill... macros from the client command API. It will be sent as unicast to the node that corresponds in the address table to the passed EUI64.


Definition at line 134 of file app/framework/plugin/address-table/address-table.h

emberAfGetCurrentSenderEui64#

EmberStatus emberAfGetCurrentSenderEui64 (EmberEUI64 address)

Copy the sender EUI64, if available, to the address parameter and return EMBER_SUCCESS. Otherwise, return EMBER_INVALID_CALL.

Parameters
N/Aaddress

Definition at line 140 of file app/framework/plugin/address-table/address-table.h

emberAfPluginAddressTableAddEntry#

#define emberAfPluginAddressTableAddEntry
Value:
(longId)

Add a new entry to the address table.

If the entry already exists, no new entry is created and the index of the entry already in the table is returned. If a free entry is found, the entry is added to the table and the corresponding index is returned. If no free entry is available in the address table, the value EMBER_NULL_ADDRESS_TABLE_INDEX is returned.


Definition at line 60 of file app/framework/plugin/address-table/address-table.h

emberAfPluginAddressTableRemoveEntryByIndex#

#define emberAfPluginAddressTableRemoveEntryByIndex
Value:
(index)

Remove an entry from the address table by index.

If the index is valid, the entry is cleared and the EMBER_SUCCESS status is returned. Otherwise, the status EMBER_INVALID_CALL is returned.


Definition at line 79 of file app/framework/plugin/address-table/address-table.h

emberAfPluginAddressTableLookupByEui64#

#define emberAfPluginAddressTableLookupByEui64
Value:
(longId)

Search for an EUI64 in the address table.

If an entry with a matching EUI64 is found, the function returns the corresponding index. Otherwise, the value EMBER_NULL_ADDRESS_TABLE_INDEX is returned.


Definition at line 89 of file app/framework/plugin/address-table/address-table.h