Modules#

otIp6InterfaceIdentifier

otIp6NetworkPrefix

otIp6AddressComponents

otIp6Address

otIp6Prefix

otNetifAddress

otNetifMulticastAddress

otSockAddr

otMessageInfo

otIp6AddressInfo

otPacketsAndBytes

otBorderRoutingCounters

IPv6#

This module includes functions that control IPv6 communication.

Enumerations#

enum
@3 {
OT_ADDRESS_ORIGIN_THREAD = 0
OT_ADDRESS_ORIGIN_SLAAC = 1
OT_ADDRESS_ORIGIN_DHCPV6 = 2
OT_ADDRESS_ORIGIN_MANUAL = 3
}

IPv6 Address origins.

enum
@4 {
OT_ECN_NOT_CAPABLE = 0x0
OT_ECN_CAPABLE_0 = 0x2
OT_ECN_CAPABLE_1 = 0x1
OT_ECN_MARKED = 0x3
}

ECN statuses, represented as in the IP header.

enum
@5 {
OT_IP6_PROTO_HOP_OPTS = 0
OT_IP6_PROTO_TCP = 6
OT_IP6_PROTO_UDP = 17
OT_IP6_PROTO_IP6 = 41
OT_IP6_PROTO_ROUTING = 43
OT_IP6_PROTO_FRAGMENT = 44
OT_IP6_PROTO_ICMP6 = 58
OT_IP6_PROTO_NONE = 59
OT_IP6_PROTO_DST_OPTS = 60
}

Internet Protocol Numbers.

Typedefs#

This structure represents the Interface Identifier of an IPv6 address.

typedef struct otIp6NetworkPrefix

This structure represents the Network Prefix of an IPv6 address (most significant 64 bits of the address).

typedef struct otIp6AddressComponents

This structure represents the components of an IPv6 address.

typedef struct otIp6Address

This structure represents an IPv6 address.

typedef struct otIp6Prefix

This structure represents an IPv6 prefix.

typedef struct otNetifAddress

This structure represents an IPv6 network interface unicast address.

This structure represents an IPv6 network interface multicast address.

typedef struct otSockAddr

This structure represents an IPv6 socket address.

typedef struct otMessageInfo

This structure represents the local and peer IPv6 socket addresses.

typedef void(*
otIp6ReceiveCallback)(otMessage *aMessage, void *aContext)

This function pointer is called when an IPv6 datagram is received.

typedef void(*
otIp6AddressCallback)(const otIp6AddressInfo *aAddressInfo, bool aIsAdded, void *aContext)

This function pointer is called when an internal IPv6 address is added or removed.

typedef bool(*
otIp6SlaacPrefixFilter)(otInstance *aInstance, const otIp6Prefix *aPrefix)

This function pointer allows user to filter prefixes and not allow an SLAAC address based on a prefix to be added.

typedef void(*
otIp6RegisterMulticastListenersCallback)(void *aContext, otError aError, uint8_t aMlrStatus, const otIp6Address *aFailedAddresses, uint8_t aFailedAddressNum)

This function pointer is called with results of otIp6RegisterMulticastListeners.

typedef struct otPacketsAndBytes

This structure represents the counters for packets and bytes.

This structure represents the counters of packets forwarded via Border Routing.

Functions#

otIp6SetEnabled(otInstance *aInstance, bool aEnabled)

Brings the IPv6 interface up or down.

bool
otIp6IsEnabled(otInstance *aInstance)

Indicates whether or not the IPv6 interface is up.

otIp6AddUnicastAddress(otInstance *aInstance, const otNetifAddress *aAddress)

Adds a Network Interface Address to the Thread interface.

otIp6RemoveUnicastAddress(otInstance *aInstance, const otIp6Address *aAddress)

Removes a Network Interface Address from the Thread interface.

otIp6GetUnicastAddresses(otInstance *aInstance)

Gets the list of IPv6 addresses assigned to the Thread interface.

otIp6SubscribeMulticastAddress(otInstance *aInstance, const otIp6Address *aAddress)

Subscribes the Thread interface to a Network Interface Multicast Address.

otIp6UnsubscribeMulticastAddress(otInstance *aInstance, const otIp6Address *aAddress)

Unsubscribes the Thread interface to a Network Interface Multicast Address.

otIp6GetMulticastAddresses(otInstance *aInstance)

Gets the list of IPv6 multicast addresses subscribed to the Thread interface.

bool
otIp6IsMulticastPromiscuousEnabled(otInstance *aInstance)

Checks if multicast promiscuous mode is enabled on the Thread interface.

void
otIp6SetMulticastPromiscuousEnabled(otInstance *aInstance, bool aEnabled)

Enables or disables multicast promiscuous mode on the Thread interface.

otIp6NewMessage(otInstance *aInstance, const otMessageSettings *aSettings)

Allocate a new message buffer for sending an IPv6 message.

otIp6NewMessageFromBuffer(otInstance *aInstance, const uint8_t *aData, uint16_t aDataLength, const otMessageSettings *aSettings)

Allocate a new message buffer and write the IPv6 datagram to the message buffer for sending an IPv6 message.

void
otIp6SetReceiveCallback(otInstance *aInstance, otIp6ReceiveCallback aCallback, void *aCallbackContext)

This function registers a callback to provide received IPv6 datagrams.

void
otIp6SetAddressCallback(otInstance *aInstance, otIp6AddressCallback aCallback, void *aCallbackContext)

This function registers a callback to notify internal IPv6 address changes.

bool
otIp6IsReceiveFilterEnabled(otInstance *aInstance)

This function indicates whether or not Thread control traffic is filtered out when delivering IPv6 datagrams via the callback specified in otIp6SetReceiveCallback().

void
otIp6SetReceiveFilterEnabled(otInstance *aInstance, bool aEnabled)

This function sets whether or not Thread control traffic is filtered out when delivering IPv6 datagrams via the callback specified in otIp6SetReceiveCallback().

otIp6Send(otInstance *aInstance, otMessage *aMessage)

This function sends an IPv6 datagram via the Thread interface.

otIp6AddUnsecurePort(otInstance *aInstance, uint16_t aPort)

This function adds a port to the allowed unsecured port list.

otIp6RemoveUnsecurePort(otInstance *aInstance, uint16_t aPort)

This function removes a port from the allowed unsecure port list.

void
otIp6RemoveAllUnsecurePorts(otInstance *aInstance)

This function removes all ports from the allowed unsecure port list.

const uint16_t *
otIp6GetUnsecurePorts(otInstance *aInstance, uint8_t *aNumEntries)

This function returns a pointer to the unsecure port list.

bool
otIp6IsAddressEqual(const otIp6Address *aFirst, const otIp6Address *aSecond)

Test if two IPv6 addresses are the same.

bool
otIp6ArePrefixesEqual(const otIp6Prefix *aFirst, const otIp6Prefix *aSecond)

Test if two IPv6 prefixes are the same.

otIp6AddressFromString(const char *aString, otIp6Address *aAddress)

This function converts a human-readable IPv6 address string into a binary representation.

otIp6PrefixFromString(const char *aString, otIp6Prefix *aPrefix)

This function converts a human-readable IPv6 prefix string into a binary representation.

void
otIp6AddressToString(const otIp6Address *aAddress, char *aBuffer, uint16_t aSize)

This function converts a given IPv6 address to a human-readable string.

void
otIp6SockAddrToString(const otSockAddr *aSockAddr, char *aBuffer, uint16_t aSize)

This function converts a given IPv6 socket address to a human-readable string.

void
otIp6PrefixToString(const otIp6Prefix *aPrefix, char *aBuffer, uint16_t aSize)

This function converts a given IPv6 prefix to a human-readable string.

uint8_t
otIp6PrefixMatch(const otIp6Address *aFirst, const otIp6Address *aSecond)

This function returns the prefix match length (bits) for two IPv6 addresses.

void
otIp6GetPrefix(const otIp6Address *aAddress, uint8_t aLength, otIp6Prefix *aPrefix)

This method gets a prefix with aLength from aAddress.

bool
otIp6IsAddressUnspecified(const otIp6Address *aAddress)

This function indicates whether or not a given IPv6 address is the Unspecified Address.

otIp6SelectSourceAddress(otInstance *aInstance, otMessageInfo *aMessageInfo)

This function perform OpenThread source address selection.

bool
otIp6IsSlaacEnabled(otInstance *aInstance)

This function indicates whether the SLAAC module is enabled or not.

void
otIp6SetSlaacEnabled(otInstance *aInstance, bool aEnabled)

This function enables/disables the SLAAC module.

void
otIp6SetSlaacPrefixFilter(otInstance *aInstance, otIp6SlaacPrefixFilter aFilter)

This function sets the SLAAC module filter handler.

otIp6RegisterMulticastListeners(otInstance *aInstance, const otIp6Address *aAddresses, uint8_t aAddressNum, const uint32_t *aTimeout, otIp6RegisterMulticastListenersCallback aCallback, void *aContext)

This function registers Multicast Listeners to Primary Backbone Router.

otIp6SetMeshLocalIid(otInstance *aInstance, const otIp6InterfaceIdentifier *aIid)

This function sets the Mesh Local IID (for test purpose).

const char *
otIp6ProtoToString(uint8_t aIpProto)

This function converts a given IP protocol number to a human-readable string.

otIp6GetBorderRoutingCounters(otInstance *aInstance)

Gets the Border Routing counters.

void
otIp6ResetBorderRoutingCounters(otInstance *aInstance)

Resets the Border Routing counters.

Macros#

#define

Size of an IPv6 prefix (bytes)

#define
OT_IP6_PREFIX_BITSIZE (OT_IP6_PREFIX_SIZE * 8)

Size of an IPv6 prefix (bits)

#define

Size of an IPv6 Interface Identifier (bytes)

#define

Size of an IPv6 address (bytes)

#define

Recommended size for string representation of an IPv6 address.

#define

Recommended size for string representation of an IPv6 socket address.

#define

Recommended size for string representation of an IPv6 prefix.

#define

Max number of IPv6 addresses supported by Multicast Listener Registration.

Enumeration Documentation#

@3#

@3

IPv6 Address origins.

Enumerator
OT_ADDRESS_ORIGIN_THREAD

Thread assigned address (ALOC, RLOC, MLEID, etc)

OT_ADDRESS_ORIGIN_SLAAC

SLAAC assigned address.

OT_ADDRESS_ORIGIN_DHCPV6

DHCPv6 assigned address.

OT_ADDRESS_ORIGIN_MANUAL

Manually assigned address.


Definition at line 165 of file include/openthread/ip6.h

@4#

@4

ECN statuses, represented as in the IP header.

Enumerator
OT_ECN_NOT_CAPABLE

Non-ECT.

OT_ECN_CAPABLE_0

ECT(0)

OT_ECN_CAPABLE_1

ECT(1)

OT_ECN_MARKED

Congestion encountered (CE)


Definition at line 214 of file include/openthread/ip6.h

@5#

@5

Internet Protocol Numbers.

Enumerator
OT_IP6_PROTO_HOP_OPTS

IPv6 Hop-by-Hop Option.

OT_IP6_PROTO_TCP

Transmission Control Protocol.

OT_IP6_PROTO_UDP

User Datagram.

OT_IP6_PROTO_IP6

IPv6 encapsulation.

OT_IP6_PROTO_ROUTING

Routing Header for IPv6.

OT_IP6_PROTO_FRAGMENT

Fragment Header for IPv6.

OT_IP6_PROTO_ICMP6

ICMP for IPv6.

OT_IP6_PROTO_NONE

No Next Header for IPv6.

OT_IP6_PROTO_DST_OPTS

Destination Options for IPv6.


Definition at line 246 of file include/openthread/ip6.h

Typedef Documentation#

otIp6InterfaceIdentifier#

typedef struct otIp6InterfaceIdentifier otIp6InterfaceIdentifier

This structure represents the Interface Identifier of an IPv6 address.


Definition at line 81 of file include/openthread/ip6.h

otIp6NetworkPrefix#

typedef struct otIp6NetworkPrefix otIp6NetworkPrefix

This structure represents the Network Prefix of an IPv6 address (most significant 64 bits of the address).


Definition at line 99 of file include/openthread/ip6.h

otIp6AddressComponents#

typedef struct otIp6AddressComponents otIp6AddressComponents

This structure represents the components of an IPv6 address.


Definition at line 118 of file include/openthread/ip6.h

otIp6Address#

typedef struct otIp6Address otIp6Address

This structure represents an IPv6 address.


Definition at line 142 of file include/openthread/ip6.h

otIp6Prefix#

typedef struct otIp6Prefix otIp6Prefix

This structure represents an IPv6 prefix.


Definition at line 159 of file include/openthread/ip6.h

otNetifAddress#

typedef struct otNetifAddress otNetifAddress

This structure represents an IPv6 network interface unicast address.


Definition at line 188 of file include/openthread/ip6.h

otNetifMulticastAddress#

typedef struct otNetifMulticastAddress otNetifMulticastAddress

This structure represents an IPv6 network interface multicast address.


Definition at line 198 of file include/openthread/ip6.h

otSockAddr#

typedef struct otSockAddr otSockAddr

This structure represents an IPv6 socket address.


Definition at line 208 of file include/openthread/ip6.h

otMessageInfo#

typedef struct otMessageInfo otMessageInfo

This structure represents the local and peer IPv6 socket addresses.


Definition at line 240 of file include/openthread/ip6.h

otIp6ReceiveCallback#

typedef void(* otIp6ReceiveCallback) (otMessage *aMessage, void *aContext) )(otMessage *aMessage, void *aContext)

This function pointer is called when an IPv6 datagram is received.

Parameters
[in]aMessage

A pointer to the message buffer containing the received IPv6 datagram. This function transfers the ownership of the aMessage to the receiver of the callback. The message should be freed by the receiver of the callback after it is processed (see otMessageFree()).

[in]aContext

A pointer to application-specific context.


Definition at line 431 of file include/openthread/ip6.h

otIp6AddressInfo#

typedef struct otIp6AddressInfo otIp6AddressInfo

Definition at line 462 of file include/openthread/ip6.h

otIp6AddressCallback#

typedef void(* otIp6AddressCallback) (const otIp6AddressInfo *aAddressInfo, bool aIsAdded, void *aContext) )(const otIp6AddressInfo *aAddressInfo, bool aIsAdded, void *aContext)

This function pointer is called when an internal IPv6 address is added or removed.

Parameters
[in]aAddressInfo

A pointer to the IPv6 address information.

[in]aIsAdded

TRUE if the aAddress was added, FALSE if aAddress was removed.

[in]aContext

A pointer to application-specific context.


Definition at line 472 of file include/openthread/ip6.h

otIp6SlaacPrefixFilter#

typedef bool(* otIp6SlaacPrefixFilter) (otInstance *aInstance, const otIp6Prefix *aPrefix) )(otInstance *aInstance, const otIp6Prefix *aPrefix)

This function pointer allows user to filter prefixes and not allow an SLAAC address based on a prefix to be added.

Parameters
[in]aInstance

A pointer to an OpenThread instance.

[in]aPrefix

A pointer to prefix for which SLAAC address is about to be added.

otIp6SetSlaacPrefixFilter() can be used to set the filter handler. The filter handler is invoked by SLAAC module when it is about to add a SLAAC address based on a prefix. Its boolean return value determines whether the address is filtered (not added) or not.


Definition at line 770 of file include/openthread/ip6.h

otIp6RegisterMulticastListenersCallback#

typedef void(* otIp6RegisterMulticastListenersCallback) (void *aContext, otError aError, uint8_t aMlrStatus, const otIp6Address *aFailedAddresses, uint8_t aFailedAddressNum) )(void *aContext, otError aError, uint8_t aMlrStatus, const otIp6Address *aFailedAddresses, uint8_t aFailedAddressNum)

This function pointer is called with results of otIp6RegisterMulticastListeners.

Parameters
[in]aContext

A pointer to the user context.

[in]aError

OT_ERROR_NONE when successfully sent MLR.req and received MLR.rsp, OT_ERROR_RESPONSE_TIMEOUT when failed to receive MLR.rsp, OT_ERROR_PARSE when failed to parse MLR.rsp.

[in]aMlrStatus

The Multicast Listener Registration status when aError is OT_ERROR_NONE.

[in]aFailedAddresses

A pointer to the failed IPv6 addresses when aError is OT_ERROR_NONE.

[in]aFailedAddressNum

The number of failed IPv6 addresses when aError is OT_ERROR_NONE.

See Also


Definition at line 804 of file include/openthread/ip6.h

otPacketsAndBytes#

typedef struct otPacketsAndBytes otPacketsAndBytes

This structure represents the counters for packets and bytes.


Definition at line 877 of file include/openthread/ip6.h

otBorderRoutingCounters#

typedef struct otBorderRoutingCounters otBorderRoutingCounters

This structure represents the counters of packets forwarded via Border Routing.


Definition at line 895 of file include/openthread/ip6.h

Variable Documentation#

OT_TOOL_PACKED_END#

OT_TOOL_PACKED_BEGIN struct otIp6Prefix OT_TOOL_PACKED_END

Definition at line 75 of file include/openthread/ip6.h

Function Documentation#

otIp6SetEnabled#

otError otIp6SetEnabled (otInstance * aInstance, bool aEnabled)

Brings the IPv6 interface up or down.

Parameters
[in]aInstance

A pointer to an OpenThread instance.

[in]aEnabled

TRUE to enable IPv6, FALSE otherwise.

Call this to enable or disable IPv6 communication.


Definition at line 272 of file include/openthread/ip6.h

otIp6IsEnabled#

bool otIp6IsEnabled (otInstance * aInstance)

Indicates whether or not the IPv6 interface is up.

Parameters
[in]aInstance

A pointer to an OpenThread instance.


Definition at line 283 of file include/openthread/ip6.h

otIp6AddUnicastAddress#

otError otIp6AddUnicastAddress (otInstance * aInstance, const otNetifAddress * aAddress)

Adds a Network Interface Address to the Thread interface.

Parameters
[in]aInstance

A pointer to an OpenThread instance.

[in]aAddress

A pointer to a Network Interface Address.

The passed-in instance aAddress is copied by the Thread interface. The Thread interface only supports a fixed number of externally added unicast addresses. See OPENTHREAD_CONFIG_IP6_MAX_EXT_UCAST_ADDRS.


Definition at line 298 of file include/openthread/ip6.h

otIp6RemoveUnicastAddress#

otError otIp6RemoveUnicastAddress (otInstance * aInstance, const otIp6Address * aAddress)

Removes a Network Interface Address from the Thread interface.

Parameters
[in]aInstance

A pointer to an OpenThread instance.

[in]aAddress

A pointer to an IP Address.


Definition at line 310 of file include/openthread/ip6.h

otIp6GetUnicastAddresses#

const otNetifAddress * otIp6GetUnicastAddresses (otInstance * aInstance)

Gets the list of IPv6 addresses assigned to the Thread interface.

Parameters
[in]aInstance

A pointer to an OpenThread instance.

Returns

  • A pointer to the first Network Interface Address.


Definition at line 319 of file include/openthread/ip6.h

otIp6SubscribeMulticastAddress#

otError otIp6SubscribeMulticastAddress (otInstance * aInstance, const otIp6Address * aAddress)

Subscribes the Thread interface to a Network Interface Multicast Address.

Parameters
[in]aInstance

A pointer to an OpenThread instance.

[in]aAddress

A pointer to an IP Address.

The passed in instance aAddress will be copied by the Thread interface. The Thread interface only supports a fixed number of externally added multicast addresses. See OPENTHREAD_CONFIG_IP6_MAX_EXT_MCAST_ADDRS.


Definition at line 338 of file include/openthread/ip6.h

otIp6UnsubscribeMulticastAddress#

otError otIp6UnsubscribeMulticastAddress (otInstance * aInstance, const otIp6Address * aAddress)

Unsubscribes the Thread interface to a Network Interface Multicast Address.

Parameters
[in]aInstance

A pointer to an OpenThread instance.

[in]aAddress

A pointer to an IP Address.


Definition at line 351 of file include/openthread/ip6.h

otIp6GetMulticastAddresses#

const otNetifMulticastAddress * otIp6GetMulticastAddresses (otInstance * aInstance)

Gets the list of IPv6 multicast addresses subscribed to the Thread interface.

Parameters
[in]aInstance

A pointer to an OpenThread instance.

Returns

  • A pointer to the first Network Interface Multicast Address.


Definition at line 361 of file include/openthread/ip6.h

otIp6IsMulticastPromiscuousEnabled#

bool otIp6IsMulticastPromiscuousEnabled (otInstance * aInstance)

Checks if multicast promiscuous mode is enabled on the Thread interface.

Parameters
[in]aInstance

A pointer to an OpenThread instance.

See Also


Definition at line 371 of file include/openthread/ip6.h

otIp6SetMulticastPromiscuousEnabled#

void otIp6SetMulticastPromiscuousEnabled (otInstance * aInstance, bool aEnabled)

Enables or disables multicast promiscuous mode on the Thread interface.

Parameters
[in]aInstance

A pointer to an OpenThread instance.

[in]aEnabled

TRUE to enable Multicast Promiscuous mode, FALSE otherwise.

See Also


Definition at line 382 of file include/openthread/ip6.h

otIp6NewMessage#

otMessage * otIp6NewMessage (otInstance * aInstance, const otMessageSettings * aSettings)

Allocate a new message buffer for sending an IPv6 message.

Parameters
[in]aInstance

A pointer to an OpenThread instance.

[in]aSettings

A pointer to the message settings or NULL to set default settings.

Note

  • If aSettings is 'NULL', the link layer security is enabled and the message priority is set to OT_MESSAGE_PRIORITY_NORMAL by default.

Returns

  • A pointer to the message buffer or NULL if no message buffers are available or parameters are invalid.

See Also


Definition at line 398 of file include/openthread/ip6.h

otIp6NewMessageFromBuffer#

otMessage * otIp6NewMessageFromBuffer (otInstance * aInstance, const uint8_t * aData, uint16_t aDataLength, const otMessageSettings * aSettings)

Allocate a new message buffer and write the IPv6 datagram to the message buffer for sending an IPv6 message.

Parameters
[in]aInstance

A pointer to an OpenThread instance.

[in]aData

A pointer to the IPv6 datagram buffer.

[in]aDataLength

The size of the IPv6 datagram buffer pointed by aData.

[in]aSettings

A pointer to the message settings or NULL to set default settings.

Note

  • If aSettings is NULL, the link layer security is enabled and the message priority is obtained from IPv6 message itself. If aSettings is not NULL, the aSetting->mPriority is ignored and obtained from IPv6 message itself.

Returns

  • A pointer to the message or NULL if malformed IPv6 header or insufficient message buffers are available.

See Also


Definition at line 417 of file include/openthread/ip6.h

otIp6SetReceiveCallback#

void otIp6SetReceiveCallback (otInstance * aInstance, otIp6ReceiveCallback aCallback, void * aCallbackContext)

This function registers a callback to provide received IPv6 datagrams.

Parameters
[in]aInstance

A pointer to an OpenThread instance.

[in]aCallback

A pointer to a function that is called when an IPv6 datagram is received or NULL to disable the callback.

[in]aCallbackContext

A pointer to application-specific context.

By default, this callback does not pass Thread control traffic. See otIp6SetReceiveFilterEnabled() to change the Thread control traffic filter setting.

See Also


Definition at line 448 of file include/openthread/ip6.h

otIp6SetAddressCallback#

void otIp6SetAddressCallback (otInstance * aInstance, otIp6AddressCallback aCallback, void * aCallbackContext)

This function registers a callback to notify internal IPv6 address changes.

Parameters
[in]aInstance

A pointer to an OpenThread instance.

[in]aCallback

A pointer to a function that is called when an internal IPv6 address is added or removed. NULL to disable the callback.

[in]aCallbackContext

A pointer to application-specific context.


Definition at line 483 of file include/openthread/ip6.h

otIp6IsReceiveFilterEnabled#

bool otIp6IsReceiveFilterEnabled (otInstance * aInstance)

This function indicates whether or not Thread control traffic is filtered out when delivering IPv6 datagrams via the callback specified in otIp6SetReceiveCallback().

Parameters
[in]aInstance

A pointer to an OpenThread instance.

Returns

  • TRUE if Thread control traffic is filtered out, FALSE otherwise.

See Also


Definition at line 497 of file include/openthread/ip6.h

otIp6SetReceiveFilterEnabled#

void otIp6SetReceiveFilterEnabled (otInstance * aInstance, bool aEnabled)

This function sets whether or not Thread control traffic is filtered out when delivering IPv6 datagrams via the callback specified in otIp6SetReceiveCallback().

Parameters
[in]aInstance

A pointer to an OpenThread instance.

[in]aEnabled

TRUE if Thread control traffic is filtered out, FALSE otherwise.

See Also


Definition at line 510 of file include/openthread/ip6.h

otIp6Send#

otError otIp6Send (otInstance * aInstance, otMessage * aMessage)

This function sends an IPv6 datagram via the Thread interface.

Parameters
[in]aInstance

A pointer to an OpenThread instance.

[in]aMessage

A pointer to the message buffer containing the IPv6 datagram.

The caller transfers ownership of aMessage when making this call. OpenThread will free aMessage when processing is complete, including when a value other than OT_ERROR_NONE is returned.


Definition at line 530 of file include/openthread/ip6.h

otIp6AddUnsecurePort#

otError otIp6AddUnsecurePort (otInstance * aInstance, uint16_t aPort)

This function adds a port to the allowed unsecured port list.

Parameters
[in]aInstance

A pointer to an OpenThread instance.

[in]aPort

The port value.


Definition at line 543 of file include/openthread/ip6.h

otIp6RemoveUnsecurePort#

otError otIp6RemoveUnsecurePort (otInstance * aInstance, uint16_t aPort)

This function removes a port from the allowed unsecure port list.

Parameters
[in]aInstance

A pointer to an OpenThread instance.

[in]aPort

The port value.

Note


Definition at line 560 of file include/openthread/ip6.h

otIp6RemoveAllUnsecurePorts#

void otIp6RemoveAllUnsecurePorts (otInstance * aInstance)

This function removes all ports from the allowed unsecure port list.

Parameters
[in]aInstance

A pointer to an OpenThread instance.


Definition at line 568 of file include/openthread/ip6.h

otIp6GetUnsecurePorts#

const uint16_t * otIp6GetUnsecurePorts (otInstance * aInstance, uint8_t * aNumEntries)

This function returns a pointer to the unsecure port list.

Parameters
[in]aInstance

A pointer to an OpenThread instance.

[out]aNumEntries

The number of entries in the list.

Note

  • Port value 0 is used to indicate an invalid entry.

Returns

  • A pointer to the unsecure port list.


Definition at line 581 of file include/openthread/ip6.h

otIp6IsAddressEqual#

bool otIp6IsAddressEqual (const otIp6Address * aFirst, const otIp6Address * aSecond)

Test if two IPv6 addresses are the same.

Parameters
[in]aFirst

A pointer to the first IPv6 address to compare.

[in]aSecond

A pointer to the second IPv6 address to compare.


Definition at line 593 of file include/openthread/ip6.h

otIp6ArePrefixesEqual#

bool otIp6ArePrefixesEqual (const otIp6Prefix * aFirst, const otIp6Prefix * aSecond)

Test if two IPv6 prefixes are the same.

Parameters
[in]aFirst

A pointer to the first IPv6 prefix to compare.

[in]aSecond

A pointer to the second IPv6 prefix to compare.


Definition at line 605 of file include/openthread/ip6.h

otIp6AddressFromString#

otError otIp6AddressFromString (const char * aString, otIp6Address * aAddress)

This function converts a human-readable IPv6 address string into a binary representation.

Parameters
[in]aString

A pointer to a NULL-terminated string.

[out]aAddress

A pointer to an IPv6 address.


Definition at line 617 of file include/openthread/ip6.h

otIp6PrefixFromString#

otError otIp6PrefixFromString (const char * aString, otIp6Prefix * aPrefix)

This function converts a human-readable IPv6 prefix string into a binary representation.

Parameters
[in]aString

A pointer to a NULL-terminated string.

[out]aPrefix

A pointer to an IPv6 prefix.

The aString parameter should be a string in the format "<address>/<plen>", where <address> is an IPv6 address and <plen> is a prefix length.


Definition at line 632 of file include/openthread/ip6.h

otIp6AddressToString#

void otIp6AddressToString (const otIp6Address * aAddress, char * aBuffer, uint16_t aSize)

This function converts a given IPv6 address to a human-readable string.

Parameters
[in]aAddress

A pointer to an IPv6 address (MUST NOT be NULL).

[out]aBuffer

A pointer to a char array to output the string (MUST NOT be NULL).

[in]aSize

The size of aBuffer (in bytes). Recommended to use OT_IP6_ADDRESS_STRING_SIZE.

The IPv6 address string is formatted as 16 hex values separated by ':' (i.e., "%x:%x:%x:...:%x").

If the resulting string does not fit in aBuffer (within its aSize characters), the string will be truncated but the outputted string is always null-terminated.


Definition at line 649 of file include/openthread/ip6.h

otIp6SockAddrToString#

void otIp6SockAddrToString (const otSockAddr * aSockAddr, char * aBuffer, uint16_t aSize)

This function converts a given IPv6 socket address to a human-readable string.

Parameters
[in]aSockAddr

A pointer to an IPv6 socket address (MUST NOT be NULL).

[out]aBuffer

A pointer to a char array to output the string (MUST NOT be NULL).

[in]aSize

The size of aBuffer (in bytes). Recommended to use OT_IP6_SOCK_ADDR_STRING_SIZE.

The IPv6 socket address string is formatted as [address]:port where address is shown as 16 hex values separated by : and port is the port number in decimal format, for example "[%x:%x:...:%x]:%u".

If the resulting string does not fit in aBuffer (within its aSize characters), the string will be truncated but the outputted string is always null-terminated.


Definition at line 668 of file include/openthread/ip6.h

otIp6PrefixToString#

void otIp6PrefixToString (const otIp6Prefix * aPrefix, char * aBuffer, uint16_t aSize)

This function converts a given IPv6 prefix to a human-readable string.

Parameters
[in]aPrefix

A pointer to an IPv6 prefix (MUST NOT be NULL).

[out]aBuffer

A pointer to a char array to output the string (MUST NOT be NULL).

[in]aSize

The size of aBuffer (in bytes). Recommended to use OT_IP6_PREFIX_STRING_SIZE.

The IPv6 address string is formatted as "%x:%x:%x:...[::]/plen".

If the resulting string does not fit in aBuffer (within its aSize characters), the string will be truncated but the outputted string is always null-terminated.


Definition at line 685 of file include/openthread/ip6.h

otIp6PrefixMatch#

uint8_t otIp6PrefixMatch (const otIp6Address * aFirst, const otIp6Address * aSecond)

This function returns the prefix match length (bits) for two IPv6 addresses.

Parameters
[in]aFirst

A pointer to the first IPv6 address.

[in]aSecond

A pointer to the second IPv6 address.

Returns

  • The prefix match length in bits.


Definition at line 696 of file include/openthread/ip6.h

otIp6GetPrefix#

void otIp6GetPrefix (const otIp6Address * aAddress, uint8_t aLength, otIp6Prefix * aPrefix)

This method gets a prefix with aLength from aAddress.

Parameters
[in]aAddress

A pointer to an IPv6 address.

[in]aLength

The length of prefix in bits.

[out]aPrefix

A pointer to output the IPv6 prefix.


Definition at line 706 of file include/openthread/ip6.h

otIp6IsAddressUnspecified#

bool otIp6IsAddressUnspecified (const otIp6Address * aAddress)

This function indicates whether or not a given IPv6 address is the Unspecified Address.

Parameters
[in]aAddress

A pointer to an IPv6 address.


Definition at line 717 of file include/openthread/ip6.h

otIp6SelectSourceAddress#

otError otIp6SelectSourceAddress (otInstance * aInstance, otMessageInfo * aMessageInfo)

This function perform OpenThread source address selection.

Parameters
[in]aInstance

A pointer to an OpenThread instance.

[inout]aMessageInfo

A pointer to the message information.


Definition at line 729 of file include/openthread/ip6.h

otIp6IsSlaacEnabled#

bool otIp6IsSlaacEnabled (otInstance * aInstance)

This function indicates whether the SLAAC module is enabled or not.

Parameters
N/AaInstance

This function requires the build-time feature OPENTHREAD_CONFIG_IP6_SLAAC_ENABLE to be enabled.


Definition at line 740 of file include/openthread/ip6.h

otIp6SetSlaacEnabled#

void otIp6SetSlaacEnabled (otInstance * aInstance, bool aEnabled)

This function enables/disables the SLAAC module.

Parameters
[in]aInstance

A pointer to an OpenThread instance.

[in]aEnabled

TRUE to enable, FALSE to disable.

This function requires the build-time feature OPENTHREAD_CONFIG_IP6_SLAAC_ENABLE to be enabled.

When SLAAC module is enabled, SLAAC addresses (based on on-mesh prefixes in Network Data) are added to the interface. When SLAAC module is disabled any previously added SLAAC address is removed.


Definition at line 754 of file include/openthread/ip6.h

otIp6SetSlaacPrefixFilter#

void otIp6SetSlaacPrefixFilter (otInstance * aInstance, otIp6SlaacPrefixFilter aFilter)

This function sets the SLAAC module filter handler.

Parameters
[in]aInstance

A pointer to an OpenThread instance.

[in]aFilter

A pointer to SLAAC prefix filter handler, or NULL to disable filtering.

This function requires the build-time feature OPENTHREAD_CONFIG_IP6_SLAAC_ENABLE to be enabled.

The filter handler is called by SLAAC module when it is about to add a SLAAC address based on a prefix to decide whether the address should be added or not.

A NULL filter handler disables filtering and allows all SLAAC addresses to be added.

If this function is not called, the default filter used by SLAAC module will be NULL (filtering is disabled).


Definition at line 788 of file include/openthread/ip6.h

otIp6RegisterMulticastListeners#

otError otIp6RegisterMulticastListeners (otInstance * aInstance, const otIp6Address * aAddresses, uint8_t aAddressNum, const uint32_t * aTimeout, otIp6RegisterMulticastListenersCallback aCallback, void * aContext)

This function registers Multicast Listeners to Primary Backbone Router.

Parameters
[in]aInstance

A pointer to an OpenThread instance.

[in]aAddresses

A Multicast Address Array to register.

[in]aAddressNum

The number of Multicast Address to register (0 if aAddresses is NULL).

[in]aTimeout

A pointer to the timeout value (in seconds) to be included in MLR.req. A timeout value of 0 removes the corresponding Multicast Listener. If NULL, MLR.req would have no Timeout Tlv by default.

[in]aCallback

A pointer to the callback function.

[in]aContext

A pointer to the user context.

Note: only available when both OPENTHREAD_CONFIG_TMF_PROXY_MLR_ENABLE and OPENTHREAD_CONFIG_COMMISSIONER_ENABLE are enabled)

See Also


Definition at line 838 of file include/openthread/ip6.h

otIp6SetMeshLocalIid#

otError otIp6SetMeshLocalIid (otInstance * aInstance, const otIp6InterfaceIdentifier * aIid)

This function sets the Mesh Local IID (for test purpose).

Parameters
[in]aInstance

A pointer to an OpenThread instance.

[in]aIid

A pointer to the Mesh Local IID to set.

Only available when OPENTHREAD_CONFIG_REFERENCE_DEVICE_ENABLE is enabled.


Definition at line 857 of file include/openthread/ip6.h

otIp6ProtoToString#

const char * otIp6ProtoToString (uint8_t aIpProto)

This function converts a given IP protocol number to a human-readable string.

Parameters
[in]aIpProto

An IP protocol number (OT_IP6_PROTO_* enumeration).

Returns

  • A string representing aIpProto.


Definition at line 867 of file include/openthread/ip6.h

otIp6GetBorderRoutingCounters#

const otBorderRoutingCounters * otIp6GetBorderRoutingCounters (otInstance * aInstance)

Gets the Border Routing counters.

Parameters
[in]aInstance

A pointer to an OpenThread instance.

This function requires the build-time feature OPENTHREAD_CONFIG_IP6_BR_COUNTERS_ENABLE to be enabled.

Returns

  • A pointer to the Border Routing counters.


Definition at line 907 of file include/openthread/ip6.h

otIp6ResetBorderRoutingCounters#

void otIp6ResetBorderRoutingCounters (otInstance * aInstance)

Resets the Border Routing counters.

Parameters
[in]aInstance

A pointer to an OpenThread instance.


Definition at line 915 of file include/openthread/ip6.h

Macro Definition Documentation#

OT_IP6_PREFIX_SIZE#

#define OT_IP6_PREFIX_SIZE
Value:
8

Size of an IPv6 prefix (bytes)


Definition at line 55 of file include/openthread/ip6.h

OT_IP6_PREFIX_BITSIZE#

#define OT_IP6_PREFIX_BITSIZE
Value:
(OT_IP6_PREFIX_SIZE * 8)

Size of an IPv6 prefix (bits)


Definition at line 56 of file include/openthread/ip6.h

OT_IP6_IID_SIZE#

#define OT_IP6_IID_SIZE
Value:
8

Size of an IPv6 Interface Identifier (bytes)


Definition at line 57 of file include/openthread/ip6.h

OT_IP6_ADDRESS_SIZE#

#define OT_IP6_ADDRESS_SIZE
Value:
16

Size of an IPv6 address (bytes)


Definition at line 58 of file include/openthread/ip6.h

OT_IP6_ADDRESS_STRING_SIZE#

#define OT_IP6_ADDRESS_STRING_SIZE
Value:
40

Recommended size for string representation of an IPv6 address.


Definition at line 634 of file include/openthread/ip6.h

OT_IP6_SOCK_ADDR_STRING_SIZE#

#define OT_IP6_SOCK_ADDR_STRING_SIZE
Value:
48

Recommended size for string representation of an IPv6 socket address.


Definition at line 651 of file include/openthread/ip6.h

OT_IP6_PREFIX_STRING_SIZE#

#define OT_IP6_PREFIX_STRING_SIZE
Value:
45

Recommended size for string representation of an IPv6 prefix.


Definition at line 670 of file include/openthread/ip6.h

OT_IP6_MAX_MLR_ADDRESSES#

#define OT_IP6_MAX_MLR_ADDRESSES
Value:
15

Max number of IPv6 addresses supported by Multicast Listener Registration.


Definition at line 810 of file include/openthread/ip6.h