Modules#

EmberAfPluginEsiManagementEsiEntry

ESI Management#

API and Callbacks for the ESI Management Component.

This component maintains a table of ESIs that can be queried by other components. This is used by all Smart Energy client devices.

Typedefs#

typedef void(*

API Documentation#

emberAfPluginEsiManagementEsiLookUpByShortIdAndEndpoint#

EmberAfPluginEsiManagementEsiEntry * emberAfPluginEsiManagementEsiLookUpByShortIdAndEndpoint (EmberNodeId shortId, uint8_t endpoint)
Parameters
N/AshortId
N/Aendpoint

Search in the ESI table by the pair node (short ID, endopoint).

Returns a pointer to the entry if a matching entry was found. Otherwise, it returns NULL.


Definition at line 68 of file app/framework/plugin/esi-management/esi-management.h

emberAfPluginEsiManagementEsiLookUpByLongIdAndEndpoint#

EmberAfPluginEsiManagementEsiEntry * emberAfPluginEsiManagementEsiLookUpByLongIdAndEndpoint (EmberEUI64 longId, uint8_t endpoint)
Parameters
N/AlongId
N/Aendpoint

Search in the ESI table by the pair node (long ID, endopoint).

Returns a pointer to the entry if a matching entry was found. Otherwise, it returns NULL.


Definition at line 77 of file app/framework/plugin/esi-management/esi-management.h

emberAfPluginEsiManagementIndexLookUpByShortIdAndEndpoint#

uint8_t emberAfPluginEsiManagementIndexLookUpByShortIdAndEndpoint (EmberNodeId shortId, uint8_t endpoint)
Parameters
N/AshortId
N/Aendpoint

Allow retrieving the index of an entry that matches the passed short ID and endpoint.

Returns the index of the matching entry if a matching entry was found. Otherwise, it returns 0xFF.


Definition at line 87 of file app/framework/plugin/esi-management/esi-management.h

emberAfPluginEsiManagementIndexLookUpByLongIdAndEndpoint#

uint8_t emberAfPluginEsiManagementIndexLookUpByLongIdAndEndpoint (EmberEUI64 longId, uint8_t endpoint)
Parameters
N/AlongId
N/Aendpoint

Allow retrieving the index of an entry that matches the passed long ID and endpoint.

Returns the index of the matching entry if a matching entry was found. Otherwise, it returns 0xFF.


Definition at line 97 of file app/framework/plugin/esi-management/esi-management.h

emberAfPluginEsiManagementEsiLookUpByIndex#

EmberAfPluginEsiManagementEsiEntry * emberAfPluginEsiManagementEsiLookUpByIndex (uint8_t index)
Parameters
N/Aindex

Search in the ESI table by the table index.

Returns a pointer to the ESI entry stored at the index passed as parameter.


Definition at line 106 of file app/framework/plugin/esi-management/esi-management.h

emberAfPluginEsiManagementGetNextEntry#

EmberAfPluginEsiManagementEsiEntry * emberAfPluginEsiManagementGetNextEntry (EmberAfPluginEsiManagementEsiEntry * entry, uint8_t age)
Parameters
N/Aentry
N/Aage

Iterate through the entries in the table that are within a certain age threshold.

If the passed pointer is NULL, it returns the first active entry with age lesser or equal than the passed age parameter (if any). Otherwise, it returns the next active entry that satisfy the age requirement. If the are no entries after the passed entry that satisfy the age requirement, it returns NULL.


Definition at line 117 of file app/framework/plugin/esi-management/esi-management.h

emberAfPluginEsiManagementGetFreeEntry#

EmberAfPluginEsiManagementEsiEntry * emberAfPluginEsiManagementGetFreeEntry (void )
Parameters
N/A

Allow obtaining a free entry in the ESI table. It is the requester responsibility to properly set all the fields in the obtained free entry such as nodeId, age, and so on to avoid inconsistencies in the table.

Returns a free entry (if any), otherwise it clears the oldest entry whose age is at least EMBER_AF_PLUGIN_ESI_MANAGEMENT_MIN_ERASING_AGE (if any) and returns it, otherwise it returns NULL.


Definition at line 130 of file app/framework/plugin/esi-management/esi-management.h

emberAfPluginEsiManagementDeleteEntry#

void emberAfPluginEsiManagementDeleteEntry (uint8_t index)
Parameters
N/Aindex

Delete the entry indicated by the parameter 'index' from the ESI table.


Definition at line 136 of file app/framework/plugin/esi-management/esi-management.h

emberAfPluginEsiManagementAgeAllEntries#

void emberAfPluginEsiManagementAgeAllEntries (void )
Parameters
N/A

Increase the age of all the active entries in the table. A non-active entry is an entry whose short ID is set to EMBER_NULL_NODE_ID.


Definition at line 142 of file app/framework/plugin/esi-management/esi-management.h

emberAfPluginEsiManagementClearTable#

void emberAfPluginEsiManagementClearTable (void )
Parameters
N/A

Clear the ESI table, i.e., set the short ID of each entry to EMBER_NULL_NODE_ID.


Definition at line 148 of file app/framework/plugin/esi-management/esi-management.h

emberAfPluginEsiManagementSubscribeToDeletionAnnouncements#

bool emberAfPluginEsiManagementSubscribeToDeletionAnnouncements (EmberAfEsiManagementDeletionCallback callback)
Parameters
N/Acallback

Allow a plugin to subscribe to ESI entries deletion announcements by passing its own deletion callback function. Upon an entry deletion, all the deletion callback function are called passing the index of the deleted entry.

It returns true if the subscription was successful, false otherwise.


Definition at line 158 of file app/framework/plugin/esi-management/esi-management.h

emberAfPluginEsiManagementUpdateEsiAndGetIndex#

uint8_t emberAfPluginEsiManagementUpdateEsiAndGetIndex (const EmberAfClusterCommand * cmd)
Parameters
N/Acmd

Perform the following steps:

  • Search for the source node of the passed command in the ESI table.

  • Add a new entry in the ESI table if the source node is not present in the ESI table yet, or update the current entry if needed.

Returns

  • The index of the source node of the passed command in the ESI table, or it returns 0xFF if the ESI was not present in the table and a new entry could not be added since the table was full.


Definition at line 170 of file app/framework/plugin/esi-management/esi-management.h

Typedef Documentation#

EmberAfEsiManagementDeletionCallback#

typedef void(* EmberAfEsiManagementDeletionCallback) (uint8_t) )(uint8_t)

Definition at line 55 of file app/framework/plugin/esi-management/esi-management.h

Macro Definition Documentation#

EMBER_AF_PLUGIN_ESI_MANAGEMENT_MIN_ERASING_AGE#

#define EMBER_AF_PLUGIN_ESI_MANAGEMENT_MIN_ERASING_AGE
Value:
3

Definition at line 40 of file app/framework/plugin/esi-management/esi-management.h

EMBER_AF_PLUGIN_ESI_MANAGEMENT_PLUGIN_CALLBACK_TABLE_SIZE#

#define EMBER_AF_PLUGIN_ESI_MANAGEMENT_PLUGIN_CALLBACK_TABLE_SIZE
Value:
5

Definition at line 44 of file app/framework/plugin/esi-management/esi-management.h