Detailed Description

Data Structures
struct	EMBENET_IPV6
	IPv6 address. More...

struct	EMBENET_K1
	128 bit pre-shared key used to authenticate Beacons More...

struct	EMBENET_PSK
	Constrained join 128-bit pre-shared key. This key should be unique and shared with JRC. More...

struct	EMBENET_NODE_QuickJoinCredentials
	Structure describing the data necessary to perform a quick network rejoin. More...

Macro Definition Documentation

◆ EMBENET_EUI64_INVALID

#define EMBENET_EUI64_INVALID UINT64_C(0)

Invalid value of EMBENET_GroupId used as an error indication.

◆ EMBENET_GROUPID_INVALID

#define EMBENET_GROUPID_INVALID (EMBENET_GroupId)(0U)

Invalid value of EMBENET_GroupId used as an error indication.

Typedef Documentation

◆ EMBENET_NetworkPrefix

typedef uint64_t EMBENET_NetworkPrefix

Network prefix - common first 8 bytes of nodes IPv6 Address.

◆ EMBENET_EUI64

typedef uint64_t EMBENET_EUI64

Unique identifier of the node.

◆ EMBENET_GroupId

typedef uint16_t EMBENET_GroupId

Multicast group ID.

◆ EMBENET_PANID

typedef uint16_t EMBENET_PANID

IEEE802.15.4e PAN ID.

◆ EMBENET_RandomSeed

typedef uint64_t EMBENET_RandomSeed

Initial value of internal random number generators. USING NOT A RANDOM NUMBER WILL CAUSE A SERIOUS SECURITY VUNERABILITY.

Enumeration Type Documentation

◆ EMBENET_Result

enum EMBENET_Result

Possible result codes.

Enumerator
EMBENET_RESULT_OK
EMBENET_RESULT_UNSPECIFIED_ERROR	Unspecified error.
EMBENET_RESULT_INVALID_ARGUMENT	Function arguments are invalid.
EMBENET_RESULT_CALLED_OUTSIDE_A_TASK	The called function was called outside of a running task.
EMBENET_RESULT_NOT_SYNCHRONIZED	The node is not synchronized to the network.
EMBENET_RESULT_UNABLE_TO_SCHEDULE_IN_THE_PAST	The task was not scheduled because the requested time is in the past.
EMBENET_RESULT_INVALID_CREDENTIALS	The provided credentials were invalid.
EMBENET_RESULT_ROOT_CAPABILITIES_DISABLED	The requested operation requires root capabilities, which were not built in.
EMBENET_RESULT_UDP_MAX_DATA_SIZE_EXCEEDED	Data size beyond limit.
EMBENET_RESULT_UDP_PACKET_QUEUE_FULL	Device's packet queue is full.
EMBENET_RESULT_UDP_FORWARDING_ERROR	Forwarding error.
EMBENET_RESULT_UDP_SOCKET_UNREGISTERED	UDP socket was not registered.
EMBENET_RESULT_JOIN_RULE_ALREADY_EXISTS	Adding rule failed - the rule already exists.
EMBENET_RESULT_JOIN_RULE_NOT_FOUND	Rule not found in the register.
EMBENET_RESULT_JOIN_RULE_REGISTER_FULL

◆ EMBENET_AddressingMode

enum EMBENET_AddressingMode

Possible addressing modes.

Enumerator
EMBENET_ADDRESSING_MODE_SINGLE	Unicast addressing mode - the recipient is a single node.
EMBENET_ADDRESSING_MODE_GROUP	Multicast addressing mode - the recipients are all nodes within a group.

Function Documentation

◆ EMBENET_AssembleUnicastIpv6()

EMBENET_IPV6 EMBENET_AssembleUnicastIpv6	(	EMBENET_NetworkPrefix	nwkPrefix,
		EMBENET_EUI64	uid
	)

Assembles Network prefix and Node's UID into IPv6 Address.

Parameters

nwkPrefix	Network prefix
uid	Unique Identifier (UID) of the node

Returns: IPv6 address

◆ EMBENET_AssembleMulticastIpv6()

EMBENET_IPV6 EMBENET_AssembleMulticastIpv6	(	EMBENET_NetworkPrefix	nwkPrefix,
		EMBENET_GroupId	gid
	)

Assembles Network prefix and Multicast group ID into IPv6 Address.