Messaging Server#

API and Callbacks for the friendly-name Component.

Silicon Labs implementation of the Messaging server cluster. This component serves up messages in its table to clients that request them. This component requires extending to populate the message table with messages.

Modules#

EmberAfPluginMessagingServerMessage

API#

bool
emberAfPluginMessagingServerGetMessage(uint8_t endpoint, EmberAfPluginMessagingServerMessage *message)

Get the message used by the messaging server plugin.

void
emberAfPluginMessagingServerSetMessage(uint8_t endpoint, const EmberAfPluginMessagingServerMessage *message)

Set the message used by the Messaging server plugin.

void
emberAfPluginMessagingServerDisplayMessage(EmberNodeId nodeId, uint8_t srcEndpoint, uint8_t dstEndpoint)

Get the message used by the messaging server plugin.

void
emberAfPluginMessagingServerCancelMessage(EmberNodeId nodeId, uint8_t srcEndpoint, uint8_t dstEndpoint)

Get the message used by the messaging server plugin.

Macros#

#define
ZCL_MESSAGING_CLUSTER_IMPORTANCE_MASK (BIT(3) | BIT(2))
#define
ZCL_MESSAGING_CLUSTER_RESERVED_MASK (BIT(6) | BIT(5) | BIT(4))

API Documentation#

emberAfPluginMessagingServerGetMessage#

bool emberAfPluginMessagingServerGetMessage (uint8_t endpoint, EmberAfPluginMessagingServerMessage * message)

Get the message used by the messaging server plugin.

Parameters
N/Aendpoint

The relevant endpoint.

N/Amessage

The EmberAfPluginMessagingServerMessage structure describing the message.

This function gets the message and metadata that the plugin sends to clients. For "start now" messages that are current or scheduled, the duration is adjusted to reflect how many minutes remain for the message. Otherwise, the start time and duration of "start now" messages reflect the actual start and the original duration.

Returns

  • True if the message is valid or false is the message does not exist or is expired.


Definition at line 95 of file app/framework/plugin/messaging-server/messaging-server.h

emberAfPluginMessagingServerSetMessage#

void emberAfPluginMessagingServerSetMessage (uint8_t endpoint, const EmberAfPluginMessagingServerMessage * message)

Set the message used by the Messaging server plugin.

Parameters
N/Aendpoint

The relevant endpoint.

N/Amessage

The EmberAfPluginMessagingServerMessage structure describing the message. If NULL, the message is removed from the server.

This function sets the message and metadata that the plugin will send to clients. Setting the start time to zero instructs clients to start the message now. For "start now" messages, the plugin will automatically adjust the duration reported to clients based on the original start time of the message.


Definition at line 111 of file app/framework/plugin/messaging-server/messaging-server.h

emberAfPluginMessagingServerDisplayMessage#

void emberAfPluginMessagingServerDisplayMessage (EmberNodeId nodeId, uint8_t srcEndpoint, uint8_t dstEndpoint)

Get the message used by the messaging server plugin.

Parameters
N/AnodeId

The relevant endpoint.

N/AsrcEndpoint

The EmberAfPluginMessagingServerMessage structure describing the message.

N/AdstEndpoint

This function gets the message and metadata that the plugin sends to clients. For "start now" messages that are current or scheduled, the duration is adjusted to reflect how many minutes remain for the message. Otherwise, the start time and duration of "start now" messages reflect the actual start and the original duration.

Returns

  • True if the message is valid or false is the message does not exist or is expired.


Definition at line 114 of file app/framework/plugin/messaging-server/messaging-server.h

emberAfPluginMessagingServerCancelMessage#

void emberAfPluginMessagingServerCancelMessage (EmberNodeId nodeId, uint8_t srcEndpoint, uint8_t dstEndpoint)

Get the message used by the messaging server plugin.

Parameters
N/AnodeId

The relevant endpoint.

N/AsrcEndpoint

The EmberAfPluginMessagingServerMessage structure describing the message.

N/AdstEndpoint

This function gets the message and metadata that the plugin sends to clients. For "start now" messages that are current or scheduled, the duration is adjusted to reflect how many minutes remain for the message. Otherwise, the start time and duration of "start now" messages reflect the actual start and the original duration.

Returns

  • True if the message is valid or false is the message does not exist or is expired.


Definition at line 118 of file app/framework/plugin/messaging-server/messaging-server.h

Macro Definition Documentation#

ZCL_MESSAGING_CLUSTER_TRANSMISSION_MASK#

#define ZCL_MESSAGING_CLUSTER_TRANSMISSION_MASK
Value:
(BIT(1) | BIT(0))

Definition at line 40 of file app/framework/plugin/messaging-server/messaging-server.h

ZCL_MESSAGING_CLUSTER_IMPORTANCE_MASK#

#define ZCL_MESSAGING_CLUSTER_IMPORTANCE_MASK
Value:
(BIT(3) | BIT(2))

Definition at line 41 of file app/framework/plugin/messaging-server/messaging-server.h

ZCL_MESSAGING_CLUSTER_RESERVED_MASK#

#define ZCL_MESSAGING_CLUSTER_RESERVED_MASK
Value:
(BIT(6) | BIT(5) | BIT(4))

Definition at line 42 of file app/framework/plugin/messaging-server/messaging-server.h

ZCL_MESSAGING_CLUSTER_CONFIRMATION_MASK#

#define ZCL_MESSAGING_CLUSTER_CONFIRMATION_MASK
Value:
BIT(7)

Definition at line 43 of file app/framework/plugin/messaging-server/messaging-server.h

ZCL_MESSAGING_CLUSTER_START_TIME_NOW#

#define ZCL_MESSAGING_CLUSTER_START_TIME_NOW
Value:
0x00000000UL

Definition at line 45 of file app/framework/plugin/messaging-server/messaging-server.h

ZCL_MESSAGING_CLUSTER_END_TIME_NEVER#

#define ZCL_MESSAGING_CLUSTER_END_TIME_NEVER
Value:
0xFFFFFFFFUL

Definition at line 46 of file app/framework/plugin/messaging-server/messaging-server.h

ZCL_MESSAGING_CLUSTER_DURATION_UNTIL_CHANGED#

#define ZCL_MESSAGING_CLUSTER_DURATION_UNTIL_CHANGED
Value:
0xFFFF

Definition at line 47 of file app/framework/plugin/messaging-server/messaging-server.h