Service description

AN4018

14/23

DocID022544 Rev 3

4.4

Data link security services

These services provide the functions to send and receive messages with security features.

The security data management is performed by using the ST7580 on-chip 128-bit AES

encryption HW block.

For further information about the use of security service, see Appendix D.

4.4.1

Security data request

s8 DL_SS_DataRequest(u8* DAddress, u8 Dlen, u8* Data)

Description:

This service is used by application layer to send a data collection in security mode to

another node.

Input parameters:

•

DAddress: pointer to destination node MAC address

•

Data: pointer to data collection to send to the node

•

Dlen: length of data, number of bytes.

Output parameters:

None.

Return value:

Data link error code value.

4.4.2

Security data indication

u8* DL_SS_DataIndication(u8* SAddress, u8* DLen, u8* DiParam)

Description:

This service reports to application layer if a security data indication occurs.

Input parameters:

None.

Output parameters:

•

SAddress: pointer to source node MAC address

•

Dlen: length of data payload, number of bytes

•

DiParam: data indication parameters, 4 bytes (see the UM0932 user manual).

Return value:

Pointer to data collection (payload).