Se usó la API de Cloud Translation para traducir esta página.

IPv6

Este módulo incluye funciones que controlan la comunicación de IPv6.

Resumen

Enumeraciones
`anonymous enum{ OT_ADDRESS_ORIGIN_THREAD = 0, OT_ADDRESS_ORIGIN_SLAAC = 1, OT_ADDRESS_ORIGIN_DHCPV6 = 2, OT_ADDRESS_ORIGIN_MANUAL = 3 }`	Enum Orígenes de la dirección IPv6.
`anonymous enum{ OT_ECN_NOT_CAPABLE = 0x0, OT_ECN_CAPABLE_0 = 0x2, OT_ECN_CAPABLE_1 = 0x1, OT_ECN_MARKED = 0x3 }`	Enum Estados ECN, representados como en el encabezado IP.
`anonymous enum{ 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 }`	Enum Números de protocolo de Internet.

Typedefs
`otIp6Address`	typedef `struct otIp6Address` Esta estructura representa una dirección IPv6.
`otIp6AddressCallback)(const otIp6AddressInfo aAddressInfo, bool aIsAdded, void aContext)`	typedef `void(*` Se llama a este puntero de función cuando se agrega o quita una dirección IPv6 interna.
`otIp6AddressComponents`	typedef `struct otIp6AddressComponents` Esta estructura representa los componentes de una dirección IPv6.
`otIp6AddressInfo`	typedef `struct otIp6AddressInfo`
`otIp6InterfaceIdentifier`	typedef `struct otIp6InterfaceIdentifier` Esta estructura representa el identificador de interfaz de una dirección IPv6.
`otIp6NetworkPrefix`	typedef `struct otIp6NetworkPrefix` Esta estructura representa el prefijo de red de una dirección IPv6 (los 64 bits más significativos de la dirección).
`otIp6Prefix`	typedef `struct otIp6Prefix` Esta estructura representa un prefijo IPv6.
`otIp6ReceiveCallback)(otMessage aMessage, void aContext)`	typedef `void(*` Se llama a este puntero de función cuando se recibe un datagrama IPv6.
`otIp6RegisterMulticastListenersCallback)(void aContext, otError aError, uint8_t aMlrStatus, const otIp6Address aFailedAddresses, uint8_t aFailedAddressNum)`	typedef `void(*` Se llama a este puntero de función con los resultados de `otIp6RegisterMulticastListeners`.
`otIp6SlaacPrefixFilter)(otInstance aInstance, const otIp6Prefix aPrefix)`	typedef `bool(*` Este puntero de función permite al usuario filtrar prefijos y no permite que se agregue una dirección ANSAC basada en un prefijo.
`otMessageInfo`	typedef `struct otMessageInfo` Esta estructura representa las direcciones de socket IPv6 locales y de pares.
`otNetifAddress`	typedef `struct otNetifAddress` Esta estructura representa una dirección de unidifusión de la interfaz de red IPv6.
`otNetifMulticastAddress`	typedef `struct otNetifMulticastAddress` Esta estructura representa una dirección de multidifusión de la interfaz de red IPv6.
`otSockAddr`	typedef `struct otSockAddr` Esta estructura representa una dirección de socket IPv6.

Variables
`OT_TOOL_PACKED_END`	`OT_TOOL_PACKED_BEGIN struct otIp6InterfaceIdentifier`

Funciones
`otIp6AddUnicastAddress(otInstance aInstance, const otNetifAddress aAddress)`	`otError` Agrega una dirección de interfaz de red a la interfaz de Thread.
`otIp6AddUnsecurePort(otInstance *aInstance, uint16_t aPort)`	`otError` Esta función agrega un puerto a la lista de puertos no seguros permitidos.
`otIp6AddressFromString(const char aString, otIp6Address aAddress)`	`otError` Esta función convierte una string de dirección IPv6 legible en una representación binaria.
`otIp6AddressToString(const otIp6Address aAddress, char aBuffer, uint16_t aSize)`	`void` Esta función convierte una dirección IPv6 determinada en una string legible.
`otIp6ArePrefixesEqual(const otIp6Prefix aFirst, const otIp6Prefix aSecond)`	`bool` Prueba si dos prefijos IPv6 son iguales.
`otIp6GetMulticastAddresses(otInstance *aInstance)`	`const otNetifMulticastAddress *` Obtén la lista de direcciones de multidifusión IPv6 suscritas a la interfaz de Thread.
`otIp6GetPrefix(const otIp6Address aAddress, uint8_t aLength, otIp6Prefix aPrefix)`	`void` Este método obtiene un prefijo con `aLength` de `aAddress`.
`otIp6GetUnicastAddresses(otInstance *aInstance)`	`const otNetifAddress *` Obtén la lista de direcciones IPv6 asignadas a la interfaz de Thread.
`otIp6GetUnsecurePorts(otInstance aInstance, uint8_t aNumEntries)`	`const uint16_t *` Esta función muestra un puntero a la lista de puertos no seguros.
`otIp6IsAddressEqual(const otIp6Address aFirst, const otIp6Address aSecond)`	`bool` Prueba si dos direcciones IPv6 son iguales.
`otIp6IsAddressUnspecified(const otIp6Address *aAddress)`	`bool` Esta función indica si una dirección IPv6 determinada es o no la dirección no especificada.
`otIp6IsEnabled(otInstance *aInstance)`	`bool` Esta función indica si la interfaz IPv6 está activa o no.
`otIp6IsMulticastPromiscuousEnabled(otInstance *aInstance)`	`bool` Verifica si el modo promiscuo de multidifusión está habilitado en la interfaz de Thread.
`otIp6IsReceiveFilterEnabled(otInstance *aInstance)`	`bool` Esta función indica si se filtra el tráfico de control de Thread cuando se envían datagramas de IPv6 a través de la devolución de llamada especificada en otIp6SetReceiveCallback().
`otIp6IsSlaacEnabled(otInstance *aInstance)`	`bool` Esta función indica si el módulo ANSAC está habilitado o no.
`otIp6NewMessage(otInstance aInstance, const otMessageSettings aSettings)`	`otMessage *` Asigna un nuevo búfer de mensajes para enviar un mensaje IPv6.
`otIp6NewMessageFromBuffer(otInstance aInstance, const uint8_t aData, uint16_t aDataLength, const otMessageSettings *aSettings)`	`otMessage *` Asigna un nuevo búfer de mensajes y escribe el datagrama IPv6 en el búfer de mensajes para enviar un mensaje IPv6.
`otIp6PrefixMatch(const otIp6Address aFirst, const otIp6Address aSecond)`	`uint8_t` Esta función muestra la longitud de coincidencia del prefijo (bits) para dos direcciones IPv6.
`otIp6PrefixToString(const otIp6Prefix aPrefix, char aBuffer, uint16_t aSize)`	`void` Esta función convierte un prefijo IPv6 determinado en una string legible.
`otIp6ProtoToString(uint8_t aIpProto)`	`const char *` Esta función convierte un número de protocolo IP determinado en una string legible.
`otIp6RegisterMulticastListeners(otInstance aInstance, const otIp6Address aAddresses, uint8_t aAddressNum, const uint32_t aTimeout, otIp6RegisterMulticastListenersCallback aCallback, void aContext)`	`otError` Esta función registra objetos de escucha de multidifusión en el router troncal principal.
`otIp6RemoveAllUnsecurePorts(otInstance *aInstance)`	`void` Esta función quita todos los puertos de la lista de puertos no seguros permitidos.
`otIp6RemoveUnicastAddress(otInstance aInstance, const otIp6Address aAddress)`	`otError` Quita una dirección de interfaz de red de la interfaz de Thread.
`otIp6RemoveUnsecurePort(otInstance *aInstance, uint16_t aPort)`	`otError` Esta función quita un puerto de la lista de puertos no seguros permitidos.
`otIp6SelectSourceAddress(otInstance aInstance, otMessageInfo aMessageInfo)`	`otError` Esta función realiza la selección de direcciones de origen de OpenThread.
`otIp6Send(otInstance aInstance, otMessage aMessage)`	`otError` Esta función envía un datagrama IPv6 a través de la interfaz de Thread.
`otIp6SetAddressCallback(otInstance aInstance, otIp6AddressCallback aCallback, void aCallbackContext)`	`void` Esta función registra una devolución de llamada para notificar los cambios de direcciones IPv6 internas.
`otIp6SetEnabled(otInstance *aInstance, bool aEnabled)`	`otError` Esta función activa o desactiva la interfaz de IPv6.
`otIp6SetMeshLocalIid(otInstance aInstance, const otIp6InterfaceIdentifier aIid)`	`otError` Esta función establece el IID local de malla (para fines de prueba).
`otIp6SetMulticastPromiscuousEnabled(otInstance *aInstance, bool aEnabled)`	`void` Habilita el modo promiscuo de multidifusión en la interfaz de Thread.
`otIp6SetReceiveCallback(otInstance aInstance, otIp6ReceiveCallback aCallback, void aCallbackContext)`	`void` Esta función registra una devolución de llamada para proporcionar los datagramas IPv6 recibidos.
`otIp6SetReceiveFilterEnabled(otInstance *aInstance, bool aEnabled)`	`void` Esta función define si se filtra el tráfico de control de Thread cuando se envían datagramas de IPv6 a través de la devolución de llamada especificada en otIp6SetReceiveCallback().
`otIp6SetSlaacEnabled(otInstance *aInstance, bool aEnabled)`	`void` Esta función habilita o inhabilita el módulo ANSAC.
`otIp6SetSlaacPrefixFilter(otInstance *aInstance, otIp6SlaacPrefixFilter aFilter)`	`void` Esta función establece el controlador de filtros del módulo ANSAC.
`otIp6SockAddrToString(const otSockAddr aSockAddr, char aBuffer, uint16_t aSize)`	`void` Esta función convierte una dirección de socket IPv6 determinada en una string legible.
`otIp6SubscribeMulticastAddress(otInstance aInstance, const otIp6Address aAddress)`	`otError` Suscribe la interfaz de Thread a una dirección de multidifusión de la interfaz de red.
`otIp6UnsubscribeMulticastAddress(otInstance aInstance, const otIp6Address aAddress)`	`otError` Anula la suscripción de la interfaz de Thread a una dirección de multidifusión de la interfaz de red.

Structs
otIp6Dirección	Esta estructura representa una dirección IPv6.
otIp6AddressComponents	Esta estructura representa los componentes de una dirección IPv6.
otIp6AddressInfo	Esta estructura representa la información de dirección IPv6.
otIp6InterfaceIdentifier	Esta estructura representa el identificador de interfaz de una dirección IPv6.
otIp6NetworkPrefix	Esta estructura representa el prefijo de red de una dirección IPv6 (los 64 bits más significativos de la dirección).
otIp6Prefix	Esta estructura representa un prefijo IPv6.
otMessageInfo	Esta estructura representa las direcciones de socket IPv6 locales y de pares.
otNetifAddress.	Esta estructura representa una dirección de unidifusión de la interfaz de red IPv6.
otNetifMulticastAddress	Esta estructura representa una dirección de multidifusión de la interfaz de red IPv6.
otSockAddr	Esta estructura representa una dirección de socket IPv6.

Uniones
otIp6InterfaceIdentifier::OT_TOOL_PACKED_FIELD

Enumeraciones

enumeración anónima

 anonymous enum

Orígenes de la dirección IPv6.

Propiedades
`OT_ADDRESS_ORIGIN_DHCPV6`	Dirección asignada de DHCPv6.
`OT_ADDRESS_ORIGIN_MANUAL`	Dirección asignada manualmente.
`OT_ADDRESS_ORIGIN_SLAAC`	Dirección asignada de ANSAC.
`OT_ADDRESS_ORIGIN_THREAD`	Dirección asignada de conversación (ALOC, RLOC, MLEID, etc.)

enumeración anónima

 anonymous enum

Estados ECN, representados como en el encabezado IP.

Propiedades
`OT_ECN_CAPABLE_0`	ECT(0)
`OT_ECN_CAPABLE_1`	ECT(1)
`OT_ECN_MARKED`	Congestión encontrada (CE)
`OT_ECN_NOT_CAPABLE`	No ECT.

enumeración anónima

 anonymous enum

Números de protocolo de Internet.

Propiedades
`OT_IP6_PROTO_DST_OPTS`	Opciones de destino para IPv6
`OT_IP6_PROTO_FRAGMENT`	Encabezado de fragmento para IPv6
`OT_IP6_PROTO_HOP_OPTS`	Opción IPv6 paso a paso.
`OT_IP6_PROTO_ICMP6`	ICMP para IPv6
`OT_IP6_PROTO_IP6`	Encapsulamiento de IPv6
`OT_IP6_PROTO_NONE`	No hay ningún encabezado siguiente para IPv6.
`OT_IP6_PROTO_ROUTING`	Encabezado de enrutamiento para IPv6.
`OT_IP6_PROTO_TCP`	Protocolo de control de transmisión.
`OT_IP6_PROTO_UDP`	Datagram del usuario.

Typedefs

Dirección ot6IP

struct otIp6Address otIp6Address

Esta estructura representa una dirección IPv6.

otIp6AddressCallback

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

Se llama a este puntero de función cuando se agrega o quita una dirección IPv6 interna.

Detalles

Parámetros

`[in] aAddressInfo`	Un puntero para la información de la dirección IPv6.
`[in] aIsAdded`	TRUE si se agregó `aAddress` y FALSE si se quitó `aAddress`
`[in] aContext`	Un puntero al contexto específico de la aplicación.

otIp6AddressComponents

struct otIp6AddressComponents otIp6AddressComponents

Esta estructura representa los componentes de una dirección IPv6.

ot6IDDDirección

struct otIp6AddressInfo otIp6AddressInfo

otIp6InterfaceIdentifier

struct otIp6InterfaceIdentifier otIp6InterfaceIdentifier

Esta estructura representa el identificador de interfaz de una dirección IPv6.

Prefijo de red ot6p6

struct otIp6NetworkPrefix otIp6NetworkPrefix

Esta estructura representa el prefijo de red de una dirección IPv6 (los 64 bits más significativos de la dirección).

Prefijo de i6

struct otIp6Prefix otIp6Prefix

Esta estructura representa un prefijo IPv6.

otIp6ReceiveCallback

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

Se llama a este puntero de función cuando se recibe un datagrama IPv6.

Detalles

Parámetros

`[in] aMessage`	Un puntero al búfer de mensajes que contiene el datagrama IPv6 recibido. Esta función transfiere la propiedad de `aMessage` al receptor de la devolución de llamada. El receptor de la devolución de llamada debe liberar el mensaje después de que se procese (consulta otMessageFree()).
`[in] aContext`	Un puntero al contexto específico de la aplicación.

otIp6RegisterMulticastListenersCallback

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

Se llama a este puntero de función con los resultados de otIp6RegisterMulticastListeners.

Detalles

Parámetros

`[in] aContext`	Un puntero al contexto del usuario.
`[in] aError`	OT_ERROR_NONE cuando se envió correctamente MLR.req y se recibió MLR.rsp; OT_ERROR_RESPONSE_TIMEOUT cuando no se pudo recibir MLR.rsp; OT_ERROR_PARSE cuando no se pudo analizar MLR.rsp
`[in] aMlrStatus`	El estado del registro del objeto de escucha multidifusión cuando `aError` es OT_ERROR_NONE.
`[in] aFailedAddresses`	Un puntero para las direcciones IPv6 con errores cuando `aError` es OT_ERROR_NONE.
`[in] aFailedAddressNum`	La cantidad de direcciones IPv6 con errores cuando `aError` es OT_ERROR_NONE

Consulta también:
otIp6RegisterMulticastListeners

otIp6SlaacPrefixFilter

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

Este puntero de función permite al usuario filtrar prefijos y no permite que se agregue una dirección ANSAC basada en un prefijo.

Se puede usar otIp6SetSlaacPrefixFilter() para configurar el controlador de filtros. El módulo de ANSAC invoca el controlador de filtros cuando está a punto de agregar una dirección de ANSAC basada en un prefijo. Su valor booleano que se muestra determina si la dirección se filtra (no se agrega) o no.

Detalles

Parámetros

`[in] aInstance`	Un puntero para una instancia de OpenThread.
`[in] aPrefix`	Un puntero para el prefijo que se va a agregar a la dirección del SLAAC.

Valores de retorno

`TRUE`	Indica que la dirección del ANSAC basada en el prefijo se debe filtrar y NO agregar.
`FALSE`	Indica que se debe agregar la dirección del ANSAC basada en el prefijo.

otMessageInfo

struct otMessageInfo otMessageInfo

Esta estructura representa las direcciones de socket IPv6 locales y de pares.

Dirección onetNetif

struct otNetifAddress otNetifAddress

Esta estructura representa una dirección de unidifusión de la interfaz de red IPv6.

otNetifMulticastAddress

struct otNetifMulticastAddress otNetifMulticastAddress

Esta estructura representa una dirección de multidifusión de la interfaz de red IPv6.

otSockAddr

struct otSockAddr otSockAddr

Esta estructura representa una dirección de socket IPv6.

Variables

TS_TOOL_PACKED_END

OT_TOOL_PACKED_BEGIN struct otIp6InterfaceIdentifier OT_TOOL_PACKED_END

Funciones

otIp6AddUnicastAddress

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

Agrega una dirección de interfaz de red a la interfaz de Thread.

La interfaz de Thread copia la instancia pasada aAddress. La interfaz de Thread solo admite un número fijo de direcciones de unidifusión agregadas de forma externa. Consulta OPENTHREAD_CONFIG_IP6_MAX_EXT_UCAST_ADDRS.

Detalles

Parámetros

`[in] aInstance`	Un puntero para una instancia de OpenThread.
`[in] aAddress`	Un puntero para una dirección de interfaz de red.

Valores de retorno

`OT_ERROR_NONE`	La dirección de interfaz de red se ha agregado (o actualizado) correctamente.
`OT_ERROR_INVALID_ARGS`	La dirección IP indicada por `aAddress` es una dirección interna.
`OT_ERROR_NO_BUFS`	La interfaz de red ya está almacenando la cantidad máxima permitida de direcciones externas.

oT6AgregarUnUnPuertoSeguro

otError otIp6AddUnsecurePort(
  otInstance *aInstance,
  uint16_t aPort
)

Esta función agrega un puerto a la lista de puertos no seguros permitidos.

Detalles

Parámetros

`[in] aInstance`	Un puntero para una instancia de OpenThread.
`[in] aPort`	El valor del puerto.

Valores de retorno

`OT_ERROR_NONE`	El puerto se agregó correctamente a la lista de puertos no seguros permitidos.
`OT_ERROR_INVALID_ARGS`	El puerto no es válido (el valor 0 está reservado para uso interno).
`OT_ERROR_NO_BUFS`	La lista de puertos no seguros está llena.

otIp6AddressFromString

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

Esta función convierte una string de dirección IPv6 legible en una representación binaria.

Detalles

Parámetros

`[in] aString`	Un puntero para una string terminada en NULL.
`[out] aAddress`	Un puntero para una dirección IPv6.

Valores de retorno

`OT_ERROR_NONE`	Se analizó correctamente la string.
`OT_ERROR_INVALID_ARGS`	No se pudo analizar la string.

otIp6AddressToString

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

Esta función convierte una dirección IPv6 determinada en una string legible.

La cadena de dirección IPv6 tiene el formato de 16 valores hexadecimales, separados por ':' (es decir, &%;%x:%x:%x:...:%x").

Si la string resultante no cabe en aBuffer (dentro de sus aSize caracteres), la string se truncará, pero la string resultante siempre será nula.

Detalles

Parámetros

`[in] aAddress`	Un puntero para una dirección IPv6 (NO DEBE ser NULO).
`[out] aBuffer`	Un puntero para un arreglo de caracteres que genera la string (NO DEBE ser NULO).
`[in] aSize`	El tamaño de `aBuffer` (en bytes). Se recomienda usar `OT_IP6_ADDRESS_STRING_SIZE`.

otIp6ArePrefixesEqual

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

Prueba si dos prefijos IPv6 son iguales.

Detalles

Parámetros

`[in] aFirst`	Un puntero al primer prefijo de IPv6 para comparar.
`[in] aSecond`	Un puntero al segundo prefijo de IPv6 para comparar.

Valores de retorno

`TRUE`	Los dos prefijos de IPv6 son iguales.
`FALSE`	Los dos prefijos de IPv6 no son iguales.

ot6ODMultiMultiAddresses

const otNetifMulticastAddress * otIp6GetMulticastAddresses(
  otInstance *aInstance
)

Obtén la lista de direcciones de multidifusión IPv6 suscritas a la interfaz de Thread.

Detalles

Parámetros

[in] aInstance

Un puntero para una instancia de OpenThread.

Qué muestra

Un puntero para la primera dirección de multidifusión de la interfaz de red.

OtIp6GetPrefix

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

Este método obtiene un prefijo con aLength de aAddress.

Detalles

Parámetros

`[in] aAddress`	Un puntero para una dirección IPv6.
`[in] aLength`	La longitud del prefijo en bits.
`[out] aPrefix`	Un puntero para mostrar el prefijo de IPv6.

ot6IGetUnicastAddresses

const otNetifAddress * otIp6GetUnicastAddresses(
  otInstance *aInstance
)

Obtén la lista de direcciones IPv6 asignadas a la interfaz de Thread.

Detalles

Parámetros

[in] aInstance

Un puntero para una instancia de OpenThread.

Qué muestra

Un puntero para la primera dirección de interfaz de red.

otIp6GetUnsecurePorts

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

Esta función muestra un puntero a la lista de puertos no seguros.

Detalles

Parámetros

`[in] aInstance`	Un puntero para una instancia de OpenThread.
`[out] aNumEntries`	La cantidad de entradas de la lista.

Qué muestra

Un puntero para la lista de puertos no seguros.

otIp6IsAddressEqual

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

Prueba si dos direcciones IPv6 son iguales.

Detalles

Parámetros

`[in] aFirst`	Un puntero a la primera dirección IPv6 para comparar.
`[in] aSecond`	Un puntero a la segunda dirección IPv6 para comparar.

Valores de retorno

`TRUE`	Las dos direcciones IPv6 son iguales.
`FALSE`	Las dos direcciones IPv6 no son iguales.

otIp6IsAddressUnspecified

bool otIp6IsAddressUnspecified(
  const otIp6Address *aAddress
)

Esta función indica si una dirección IPv6 determinada es o no la dirección no especificada.

Detalles

Parámetros

[in] aAddress

Un puntero para una dirección IPv6.

Valores de retorno

`TRUE`	Si la dirección IPv6 es la no especificada.
`FALSE`	Si la dirección IPv6 no es la especificada.

otIp6IsEnabled

bool otIp6IsEnabled(
  otInstance *aInstance
)

Esta función indica si la interfaz IPv6 está activa o no.

Detalles

Parámetros

[in] aInstance

Un puntero para una instancia de OpenThread.

Valores de retorno

`TRUE`	La interfaz de IPv6 está habilitada.
`FALSE`	La interfaz de IPv6 está inhabilitada.

ot6iMulticastPromiscuousEnabled

bool otIp6IsMulticastPromiscuousEnabled(
  otInstance *aInstance
)

Verifica si el modo promiscuo de multidifusión está habilitado en la interfaz de Thread.

Detalles

Parámetros

[in] aInstance

Un puntero para una instancia de OpenThread.

Consulta también:
otIp6SetMulticastPromiscuousEnabled

ot6IIsFilterFilterEnabled

bool otIp6IsReceiveFilterEnabled(
  otInstance *aInstance
)

Esta función indica si se filtra el tráfico de control de Thread cuando se envían datagramas de IPv6 a través de la devolución de llamada especificada en otIp6SetReceiveCallback().

Detalles

Parámetros

[in] aInstance

Un puntero para una instancia de OpenThread.

Qué muestra

TRUE si se filtra el tráfico de control de Thread; de lo contrario, es FALSE.

Consulta también:
otIp6SetReceiveCallback
otIp6SetReceiveFilterEnabled

oT6IsSlaacEnabled

bool otIp6IsSlaacEnabled(
  otInstance *aInstance
)

Esta función indica si el módulo ANSAC está habilitado o no.

Esta función requiere que se habilite la función de tiempo de compilación OPENTHREAD_CONFIG_IP6_SLAAC_ENABLE.

Detalles

Valores de retorno

`TRUE`	El módulo ANSAC está habilitado.
`FALSE`	El módulo ANSAC está inhabilitado.

ot6NuevoMensaje

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

Asigna un nuevo búfer de mensajes para enviar un mensaje IPv6.

Nota: Si aSettings es &NULL3, la seguridad de la capa del vínculo está habilitada y la prioridad del mensaje se establece en OT_MESSAGE_PRIORITY_NORMAL de forma predeterminada.

Detalles

Parámetros

`[in] aInstance`	Un puntero para una instancia de OpenThread.
`[in] aSettings`	Un puntero para la configuración del mensaje o NULL para establecer la configuración predeterminada

Qué muestra

Un puntero al búfer de mensajes o NULL si no hay búferes de mensajes disponibles o si los parámetros no son válidos.

Consulta también:
otMessageFree

ot6NuevoMensajeDeBuffer

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

Asigna un nuevo búfer de mensajes y escribe el datagrama IPv6 en el búfer de mensajes para enviar un mensaje IPv6.

Nota: Si aSettings es NULO, se habilita la seguridad de la capa de vínculos y se obtiene la prioridad del mensaje a partir del mensaje IPv6. Si aSettings no es NULO, se ignora aSetting->mPriority y se obtiene del mensaje de IPv6.

Detalles

Parámetros

`[in] aInstance`	Un puntero para una instancia de OpenThread.
`[in] aData`	Un puntero para el búfer de datagramas IPv6.
`[in] aDataLength`	El tamaño del búfer de datagramas IPv6 señalado por `aData`.
`[in] aSettings`	Un puntero para la configuración del mensaje o NULL para establecer la configuración predeterminada

Qué muestra

Un puntero al mensaje o NULL si el encabezado IPv6 con formato incorrecto o los búferes de mensajes no están disponibles.

Consulta también:
otMessageFree

OtIp6PrefixMatch

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

Esta función muestra la longitud de coincidencia del prefijo (bits) para dos direcciones IPv6.

Detalles

Parámetros

`[in] aFirst`	Un puntero para la primera dirección IPv6.
`[in] aSecond`	Un puntero para la segunda dirección IPv6.

Qué muestra

Longitud de coincidencia del prefijo en bits.

otIp6PrefixToString

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

Esta función convierte un prefijo IPv6 determinado en una string legible.

La cadena de dirección IPv6 tiene el formato "%x:%x:%x:...[::]/plen".

Si la string resultante no cabe en aBuffer (dentro de sus aSize caracteres), la string se truncará, pero la string resultante siempre será nula.

Detalles

Parámetros

`[in] aPrefix`	Un puntero para un prefijo de IPv6 (NO DEBE ser NULO).
`[out] aBuffer`	Un puntero para un arreglo de caracteres que genera la string (NO DEBE ser NULO).
`[in] aSize`	El tamaño de `aBuffer` (en bytes). Se recomienda usar `OT_IP6_PREFIX_STRING_SIZE`.

otIp6ProtoToString

const char * otIp6ProtoToString(
  uint8_t aIpProto
)

Esta función convierte un número de protocolo IP determinado en una string legible.

Detalles

Parámetros

[in] aIpProto

Un número de protocolo IP (enumeración OT_IP6_PROTO_*).

Qué muestra

Una string que representa aIpProto.

otIp6RegisterMulticastListeners

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

Esta función registra objetos de escucha de multidifusión en el router troncal principal.

Nota: Disponible solo cuando OPENTHREAD_CONFIG_TMF_PROXY_MLR_ENABLE y OPENTHREAD_CONFIG_COMMISSIONER_ENABLE están habilitados)

Detalles

Parámetros

`[in] aInstance`	Un puntero para una instancia de OpenThread.
`[in] aAddresses`	Un arreglo de direcciones de multidifusión para registrar.
`[in] aAddressNum`	La cantidad de direcciones de multidifusión que se registrarán (0 si `aAddresses` es NULO).
`[in] aTimeout`	Un puntero para el valor del tiempo de espera (en segundos) que se incluirá en MLR.req. Un valor de tiempo de espera de 0 quita el receptor de multidifusión correspondiente. Si es NULL, MLR.req no tendría un Tlv de tiempo de espera de forma predeterminada.
`[in] aCallback`	Un puntero para la función de devolución de llamada.
`[in] aContext`	Un puntero al contexto del usuario.

Valores de retorno

`OT_ERROR_NONE`	Se envió correctamente MLR.req. Se llamará a `aCallback` si este método muestra OT_ERROR_NONE.
`OT_ERROR_BUSY`	Si el registro anterior estaba en curso.
`OT_ERROR_INVALID_ARGS`	Si uno o más argumentos no son válidos.
`OT_ERROR_INVALID_STATE`	Si el dispositivo no tenía un estado válido para enviar MLR.req (p.ej., no se inició el comisionado, no se encontró el router troncal principal).
`OT_ERROR_NO_BUFS`	Si no hay suficientes búferes de mensajes disponibles.

Consulta también:
otIp6RegisterMulticastListenersCallback

ot6pQuitarTodosLosPuertosNoSeguros

void otIp6RemoveAllUnsecurePorts(
  otInstance *aInstance
)

Esta función quita todos los puertos de la lista de puertos no seguros permitidos.

Detalles

Parámetros

[in] aInstance

Un puntero para una instancia de OpenThread.

OtIp6RemoveUnicastAddress

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

Quita una dirección de interfaz de red de la interfaz de Thread.

Detalles

Parámetros

`[in] aInstance`	Un puntero para una instancia de OpenThread.
`[in] aAddress`	Un puntero para una dirección IP.

Valores de retorno

`OT_ERROR_NONE`	Se quitó correctamente la dirección de la interfaz de red.
`OT_ERROR_INVALID_ARGS`	La dirección IP indicada por `aAddress` es una dirección interna.
`OT_ERROR_NOT_FOUND`	No se encontró la dirección IP indicada por `aAddress`.

ot6ipUnUnPuertoDeSeguridad

otError otIp6RemoveUnsecurePort(
  otInstance *aInstance,
  uint16_t aPort
)

Esta función quita un puerto de la lista de puertos no seguros permitidos.

Nota: Esta función quita aPort mediante el reemplazo de aPort con el elemento después de aPort en la lista de puertos internos. Ten cuidado cuando llames a otIp6GetUnsecurePorts() y, luego, otIp6RemoveUnsecurePort() para quitar puertos no seguros.

Detalles

Parámetros

`[in] aInstance`	Un puntero para una instancia de OpenThread.
`[in] aPort`	El valor del puerto.

Valores de retorno

`OT_ERROR_NONE`	El puerto se quitó correctamente de la lista de puertos no seguros permitidos.
`OT_ERROR_INVALID_ARGS`	El puerto no es válido (el valor 0 está reservado para uso interno).
`OT_ERROR_NOT_FOUND`	No se encontró el puerto en la lista de puertos no seguros.

ot6IDdeDireccióndeSeleccionarFuente

otError otIp6SelectSourceAddress(
  otInstance *aInstance,
  otMessageInfo *aMessageInfo
)

Esta función realiza la selección de direcciones de origen de OpenThread.

Detalles

Parámetros

`[in] aInstance`	Un puntero para una instancia de OpenThread.
`[in,out] aMessageInfo`	Un puntero para la información del mensaje.

Valores de retorno

`OT_ERROR_NONE`	Se encontró una dirección de origen y se completó en mSockAddr de `aMessageInfo`.
`OT_ERROR_NOT_FOUND`	No se encontró ninguna dirección de origen y `aMessageInfo` no se modificó.

ot6iEnviar

otError otIp6Send(
  otInstance *aInstance,
  otMessage *aMessage
)

Esta función envía un datagrama IPv6 a través de la interfaz de Thread.

El emisor transfiere la propiedad de aMessage cuando realiza esta llamada. OpenThread liberará aMessage cuando se complete el procesamiento, incluso cuando se muestre un valor distinto de OT_ERROR_NONE.

Detalles

Parámetros

`[in] aInstance`	Un puntero para una instancia de OpenThread.
`[in] aMessage`	Un puntero al búfer de mensajes que contiene el datagrama IPv6.

Valores de retorno

`OT_ERROR_NONE`	El mensaje se procesó correctamente.
`OT_ERROR_DROP`	El mensaje tenía el formato correcto, pero no se procesó por completo debido a las reglas de procesamiento de paquetes.
`OT_ERROR_NO_BUFS`	No se pudieron asignar los búferes de mensajes necesarios al procesar el datagrama.
`OT_ERROR_NO_ROUTE`	No hay ruta para el host.
`OT_ERROR_INVALID_SOURCE_ADDRESS`	La dirección de origen no es válida, p.ej., una dirección Anycast o una multidifusión.
`OT_ERROR_PARSE`	Se encontró un encabezado con formato incorrecto al procesar el mensaje.

otIp6SetAddressCallback

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

Esta función registra una devolución de llamada para notificar los cambios de direcciones IPv6 internas.

Detalles

Parámetros

`[in] aInstance`	Un puntero para una instancia de OpenThread.
`[in] aCallback`	Un puntero para una función que se llama cuando se agrega o quita una dirección IPv6 interna. NULL para inhabilitar la devolución de llamada.
`[in] aCallbackContext`	Un puntero al contexto específico de la aplicación.

otIp6SetEnabled

otError otIp6SetEnabled(
  otInstance *aInstance,
  bool aEnabled
)

Esta función activa o desactiva la interfaz de IPv6.

Llama a esta función para habilitar o inhabilitar la comunicación IPv6.

Detalles

Parámetros

`[in] aInstance`	Un puntero para una instancia de OpenThread.
`[in] aEnabled`	TRUE para habilitar IPv6; de lo contrario, FALSE.

Valores de retorno

`OT_ERROR_NONE`	La interfaz IPv6 se subió y se bajó correctamente.
`OT_ERROR_INVALID_STATE`	La interfaz IPv6 no está disponible porque el dispositivo funciona en modo de vínculo sin procesar (aplicable solo cuando la función `OPENTHREAD_CONFIG_LINK_RAW_ENABLE` está habilitada).

op6SetMeshLocalIid

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

Esta función establece el IID local de malla (para fines de prueba).

Solo está disponible cuando OPENTHREAD_CONFIG_REFERENCE_DEVICE_ENABLE está habilitado.

Detalles

Parámetros

`[in] aInstance`	Un puntero para una instancia de OpenThread.
`[in] aIid`	Un puntero para el IID local de la malla que se configurará.

Valores de retorno

`OT_ERROR_NONE`	Se configuró correctamente el IID local de la malla.
`OT_ERROR_INVALID_STATE`	Los protocolos de subprocesos están habilitados.

otIp6SetMulticastPromiscuousEnabled

void otIp6SetMulticastPromiscuousEnabled(
  otInstance *aInstance,
  bool aEnabled
)

Habilita el modo promiscuo de multidifusión en la interfaz de Thread.

Detalles

Parámetros

`[in] aInstance`	Un puntero para una instancia de OpenThread.
`[in] aEnabled`	TRUE para habilitar el modo Multicast Promiscuous. De lo contrario, FALSE.

Consulta también:
otIp6IsMulticastPromiscuousEnabled

otIp6SetReceiveCallback

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

Esta función registra una devolución de llamada para proporcionar los datagramas IPv6 recibidos.

De forma predeterminada, esta devolución de llamada no pasa el tráfico de control de Thread. Consulta otIp6SetReceiveFilterEnabled() para cambiar la configuración del filtro de control de Thread.

Detalles

Parámetros

`[in] aInstance`	Un puntero para una instancia de OpenThread.
`[in] aCallback`	Un puntero para una función que se llama cuando se recibe un datagrama IPv6 o NULL para inhabilitar la devolución de llamada.
`[in] aCallbackContext`	Un puntero al contexto específico de la aplicación.

Consulta también:
otIp6IsReceiveFilterEnabled
otIp6SetReceiveFilterEnabled

otIp6SetReceiveFilterEnabled

void otIp6SetReceiveFilterEnabled(
  otInstance *aInstance,
  bool aEnabled
)

Esta función define si se filtra el tráfico de control de Thread cuando se envían datagramas de IPv6 a través de la devolución de llamada especificada en otIp6SetReceiveCallback().

Detalles

Parámetros

`[in] aInstance`	Un puntero para una instancia de OpenThread.
`[in] aEnabled`	TRUE si se filtra el tráfico de control de Thread; de lo contrario, es FALSE.

Consulta también:
otIp6SetReceiveCallback
otIsReceiveIp6FilterEnabled

ot6p6SetSlaacEnabled

void otIp6SetSlaacEnabled(
  otInstance *aInstance,
  bool aEnabled
)

Esta función habilita o inhabilita el módulo ANSAC.

Esta función requiere que se habilite la función de tiempo de compilación OPENTHREAD_CONFIG_IP6_SLAAC_ENABLE.

Cuando el módulo ANSAC está habilitado, las direcciones de ANSAC (según los prefijos en la malla en los datos de red) se agregan a la interfaz. Cuando se inhabilita el módulo ANSAC, se quita cualquier dirección que se haya agregado anteriormente.

Detalles

Parámetros

`[in] aInstance`	Un puntero para una instancia de OpenThread.
`[in] aEnabled`	TRUE para habilitar; FALSE para inhabilitar.

otIp6SetSlaacPrefixFilter

void otIp6SetSlaacPrefixFilter(
  otInstance *aInstance,
  otIp6SlaacPrefixFilter aFilter
)

Esta función establece el controlador de filtros del módulo ANSAC.

Esta función requiere que se habilite la función de tiempo de compilación OPENTHREAD_CONFIG_IP6_SLAAC_ENABLE.

El módulo de ANSA llama al controlador de filtros cuando está a punto de agregar una dirección de este tipo según un prefijo para decidir si se debe agregar o no.

Un controlador de filtro NULL inhabilita el filtrado y permite que se agreguen todas las direcciones del ANSAC.

Si no se llama a esta función, el filtro predeterminado que usará el módulo de ANSAC será NULL (el filtro está inhabilitado).

Detalles

Parámetros

`[in] aInstance`	Un puntero para una instancia de OpenThread.
`[in] aFilter`	Un puntero para el controlador de filtros del prefijo ANSAC o NULL para inhabilitar el filtrado.

otIp6SockAddrToString

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

Esta función convierte una dirección de socket IPv6 determinada en una string legible.

La cadena de dirección del socket IPv6 tiene el formato "[

]:" donde `

se muestra como 16 valores hexadecimales separados por ':' y es el número de puerto en formato decimal (es decir, &%;[%x:%x:...:%x]:%u")

Si la string resultante no cabe en aBuffer (dentro de sus aSize caracteres), la string se truncará, pero la string resultante siempre será nula.

Detalles

Parámetros

`[in] aSockAddr`	Un puntero para una dirección de socket IPv6 (NO DEBE ser NULO).
`[out] aBuffer`	Un puntero para un arreglo de caracteres que genera la string (NO DEBE ser NULO).
`[in] aSize`	El tamaño de `aBuffer` (en bytes). Se recomienda usar `OT_IP6_SOCK_ADDR_STRING_SIZE`.

Dirección de suscripción de multidifusión otIp6

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

Suscribe la interfaz de Thread a una dirección de multidifusión de la interfaz de red.

La interfaz de Thread copiará el elemento que se pasó en la instancia aAddress. La interfaz de Thread solo admite un número fijo de direcciones de multidifusión agregadas de forma externa. Consulta OPENTHREAD_CONFIG_IP6_MAX_EXT_MCAST_ADDRS.

Detalles

Parámetros

`[in] aInstance`	Un puntero para una instancia de OpenThread.
`[in] aAddress`	Un puntero para una dirección IP.

Valores de retorno

`OT_ERROR_NONE`	La suscripción a la dirección multidifusión de la interfaz de red se ha suscrito correctamente.
`OT_ERROR_ALREADY`	La dirección multidifusión ya está suscrita.
`OT_ERROR_INVALID_ARGS`	La dirección IP indicada por `aAddress` no es una dirección de multidifusión no válida.
`OT_ERROR_REJECTED`	La dirección IP indicada por `aAddress` es una dirección de multidifusión interna.
`OT_ERROR_NO_BUFS`	La interfaz de red ya almacena la cantidad máxima de direcciones de multidifusión externas permitidas.

otIp6Anular la función de multidifusión

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

Anula la suscripción de la interfaz de Thread a una dirección de multidifusión de la interfaz de red.

Detalles

Parámetros

`[in] aInstance`	Un puntero para una instancia de OpenThread.
`[in] aAddress`	Un puntero para una dirección IP.

Valores de retorno

`OT_ERROR_NONE`	Se anuló correctamente la suscripción a la dirección multidifusión de la interfaz de red.
`OT_ERROR_REJECTED`	La dirección IP indicada por `aAddress` es una dirección interna.
`OT_ERROR_NOT_FOUND`	No se encontró la dirección IP indicada por `aAddress`.

Macros

TS_IP6_ADDRESS_SIZE

 OT_IP6_ADDRESS_SIZE 16

Tamaño de una dirección IPv6 (bytes)

TS_IP6_ADDRESS_STRING_SIZE

 OT_IP6_ADDRESS_STRING_SIZE 40

Tamaño recomendado para la representación de string de una dirección IPv6.

OT_IP6_IID_SIZE

 OT_IP6_IID_SIZE 8

Tamaño de un identificador de interfaz IPv6 (bytes)

TS_IP6_MAX_MLR_ADDRESSES

 OT_IP6_MAX_MLR_ADDRESSES 15

Cantidad máxima de direcciones IPv6 compatibles con el registro de objetos de escucha de multidifusión

TS_IP6_PREFIX_BITSIZE

 OT_IP6_PREFIX_BITSIZE (OT_IP6_PREFIX_SIZE * 8)

Tamaño de un prefijo de IPv6 (bits)

TS_IP6_PREFIX_SIZE

 OT_IP6_PREFIX_SIZE 8

Tamaño de un prefijo IPv6 (bytes)

TS_IP6_PREFIX_STRING_SIZE

 OT_IP6_PREFIX_STRING_SIZE 45

Tamaño recomendado para la representación de string de un prefijo IPv6.

TS_IP6_SOCK_ADDR_STRING_SIZE

 OT_IP6_SOCK_ADDR_STRING_SIZE 48

Tamaño recomendado para la representación de string de una dirección de socket IPv6.

Recursos

Los temas de referencia de la API de OpenThread se originan a partir del código fuente, disponible en GitHub. Para obtener más información o contribuir con nuestra documentación, consulta Recursos.

IPv6

Resumen

Enumeraciones

Typedefs

Variables

Funciones

Structs

Uniones

Enumeraciones

enumeración anónima

enumeración anónima

enumeración anónima

Typedefs

Dirección ot6IP

otIp6AddressCallback

otIp6AddressComponents

ot6IDDDirección

otIp6InterfaceIdentifier

Prefijo de red ot6p6

Prefijo de i6

otIp6ReceiveCallback

otIp6RegisterMulticastListenersCallback

otIp6SlaacPrefixFilter

otMessageInfo

Dirección onetNetif

otNetifMulticastAddress

otSockAddr

Variables

TS_TOOL_PACKED_END

Funciones

otIp6AddUnicastAddress

oT6AgregarUnUnPuertoSeguro

otIp6AddressFromString

otIp6AddressToString

otIp6ArePrefixesEqual

ot6ODMultiMultiAddresses

OtIp6GetPrefix

ot6IGetUnicastAddresses

otIp6GetUnsecurePorts

otIp6IsAddressEqual

otIp6IsAddressUnspecified

otIp6IsEnabled

ot6iMulticastPromiscuousEnabled

ot6IIsFilterFilterEnabled

oT6IsSlaacEnabled

ot6NuevoMensaje

ot6NuevoMensajeDeBuffer

OtIp6PrefixMatch

otIp6PrefixToString

otIp6ProtoToString

otIp6RegisterMulticastListeners

ot6pQuitarTodosLosPuertosNoSeguros

OtIp6RemoveUnicastAddress

ot6ipUnUnPuertoDeSeguridad

ot6IDdeDireccióndeSeleccionarFuente

ot6iEnviar

otIp6SetAddressCallback

otIp6SetEnabled

op6SetMeshLocalIid

otIp6SetMulticastPromiscuousEnabled

otIp6SetReceiveCallback

otIp6SetReceiveFilterEnabled

ot6p6SetSlaacEnabled

otIp6SetSlaacPrefixFilter

otIp6SockAddrToString

Dirección de suscripción de multidifusión otIp6

otIp6Anular la función de multidifusión

Macros

TS_IP6_ADDRESS_SIZE

TS_IP6_ADDRESS_STRING_SIZE

OT_IP6_IID_SIZE

TS_IP6_MAX_MLR_ADDRESSES

TS_IP6_PREFIX_BITSIZE

TS_IP6_PREFIX_SIZE

TS_IP6_PREFIX_STRING_SIZE

TS_IP6_SOCK_ADDR_STRING_SIZE

Recursos