Google is committed to advancing racial equity for Black communities. See how.
Se usó la API de Cloud Translation para traducir esta página.
Switch to English

Carpintero

Este módulo incluye funciones para el rol Thread Joiner.

Resumen

Enumeraciones

otJoinerState enumeración
Esta enumeración define el estado de unión.

Typedefs

otJoinerCallback )(otError aError, void *aContext) typedef
void(*
Se llama a este puntero de función para notificar la finalización de una operación de unión.
otJoinerDiscerner typedef
Esta estructura representa un discernidor de unión.
otJoinerState typedef
Esta enumeración define el estado de unión.

Las funciones

otJoinerGetDiscerner ( otInstance *aInstance)
Este método obtiene el Joiner Discerner.
otJoinerGetId ( otInstance *aInstance)
const otExtAddress *
Este método obtiene la ID de Joiner.
otJoinerGetState ( otInstance *aInstance)
Esta función devuelve el estado de unión.
otJoinerSetDiscerner ( otInstance *aInstance, otJoinerDiscerner *aDiscerner)
Este método establece el discernidor de unión.
otJoinerStart ( otInstance *aInstance, const char *aPskd, const char *aProvisioningUrl, const char *aVendorName, const char *aVendorModel, const char *aVendorSwVersion, const char *aVendorData, otJoinerCallback aCallback, void *aContext)
Esta función habilita la función Thread Joiner.
otJoinerStop ( otInstance *aInstance)
void
Esta función desactiva la función Thread Joiner.

Estructuras

otJoinerDiscerner

Esta estructura representa un discernidor de unión.

Enumeraciones

otJoinerState

 otJoinerState

Esta enumeración define el estado de unión.

Typedefs

otJoinerCallback

void(* otJoinerCallback)(otError aError, void *aContext)

Se llama a este puntero de función para notificar la finalización de una operación de unión.

Detalles
Parámetros
[in] aError
OT_ERROR_NONE si el proceso de unión se realizó correctamente. OT_ERROR_SECURITY si el proceso de unión falla debido a credenciales de seguridad. OT_ERROR_NOT_FOUND si no se descubrió ninguna red unible. OT_ERROR_RESPONSE_TIMEOUT si se agotó el tiempo de espera de una respuesta.
[in] aContext
Un puntero al contexto específico de la aplicación.

otJoinerDiscerner

struct otJoinerDiscerner otJoinerDiscerner

Esta estructura representa un discernidor de unión.

otJoinerState

enum otJoinerState otJoinerState

Esta enumeración define el estado de unión.

Las funciones

otJoinerGetDiscerner

const otJoinerDiscerner * otJoinerGetDiscerner(
  otInstance *aInstance
)

Este método obtiene el Joiner Discerner.

Detalles
Parámetros
[in] aInstance
Un puntero a la instancia de OpenThread.
Devoluciones
Un puntero a Joiner Discerner o NULL si no está configurado ninguno.

otJoinerGetId

const otExtAddress * otJoinerGetId(
  otInstance *aInstance
)

Este método obtiene la ID de Joiner.

Si no se establece un Joiner Discerner, Joiner ID son los primeros 64 bits del resultado de calcular SHA-256 sobre IEEE EUI-64 asignado de fábrica. De lo contrario, la ID de Joiner se calcula a partir del valor de Discerner de Joiner.

El Joiner ID también se usa como la dirección extendida IEEE 802.15.4 del dispositivo durante el proceso de puesta en marcha.

Detalles
Parámetros
[in] aInstance
Un puntero a la instancia de OpenThread.
Devoluciones
Un puntero a la ID de Joiner.

otJoinerGetState

 otJoinerState otJoinerGetState(
  otInstance *aInstance
)

Esta función devuelve el estado de unión.

Detalles
Parámetros
[in] aInstance
Un puntero a una instancia de OpenThread.
Valores de retorno
OT_JOINER_STATE_IDLE
OT_JOINER_STATE_DISCOVER
OT_JOINER_STATE_CONNECT
OT_JOINER_STATE_CONNECTED
OT_JOINER_STATE_ENTRUST
OT_JOINER_STATE_JOINED

otJoinerSetDiscerner

 otError otJoinerSetDiscerner(
  otInstance *aInstance,
  otJoinerDiscerner *aDiscerner
)

Este método establece el discernidor de unión.

El Joiner Discerner se utiliza para calcular la ID de Joiner utilizada durante el proceso de puesta en marcha / unión.

Por defecto (cuando no se proporciona un discernidor o no se establece en NULL), la ID de unión se deriva como los primeros 64 bits del resultado de calcular SHA-256 sobre IEEE EUI-64 asignado de fábrica. Tenga en cuenta que este es el comportamiento principal esperado por la especificación de subprocesos.

Detalles
Parámetros
[in] aInstance
Un puntero a la instancia de OpenThread.
[in] aDiscerner
Un puntero a un Joiner Discerner. Si NULL borra cualquier discernidor previamente establecido.
Valores de retorno
OT_ERROR_NONE
El Joiner Discerner se actualizó con éxito.
OT_ERROR_INVALID_ARGS
aDiscerner no es válido (la longitud especificada no está dentro del rango válido).
OT_ERROR_INVALID_STATE
Hay un proceso de unión en curso, por lo que no se pudo cambiar Joiner Discerner.

otJoinerStart

 otError otJoinerStart(
  otInstance *aInstance,
  const char *aPskd,
  const char *aProvisioningUrl,
  const char *aVendorName,
  const char *aVendorModel,
  const char *aVendorSwVersion,
  const char *aVendorData,
  otJoinerCallback aCallback,
  void *aContext
)

Esta función habilita la función Thread Joiner.

Detalles
Parámetros
[in] aInstance
Un puntero a una instancia de OpenThread.
[in] aPskd
Un puntero a la PSKd.
[in] aProvisioningUrl
Un puntero a la URL de aprovisionamiento (puede ser NULL).
[in] aVendorName
Un puntero al nombre del proveedor (puede ser NULL).
[in] aVendorModel
Un puntero al modelo de proveedor (puede ser NULL).
[in] aVendorSwVersion
Un puntero a la versión SW del proveedor (puede ser NULL).
[in] aVendorData
Un puntero a los datos del proveedor (puede ser NULL).
[in] aCallback
Un puntero a una función que se llama cuando se completa la operación de unión.
[in] aContext
Un puntero al contexto específico de la aplicación.
Valores de retorno
OT_ERROR_NONE
Comenzó con éxito el papel de Joiner.
OT_ERROR_BUSY
El intento anterior aún está en curso.
OT_ERROR_INVALID_ARGS
aPskd o aProvisioningUrl no es válido.
OT_ERROR_INVALID_STATE
La pila de IPv6 no está habilitada o la pila de subprocesos está totalmente habilitada.

otJoinerStop

void otJoinerStop(
  otInstance *aInstance
)

Esta función deshabilita la función Thread Joiner.

Detalles
Parámetros
[in] aInstance
Un puntero a una instancia de OpenThread.

Macros

OT_JOINER_MAX_DISCERNER_LENGTH

 OT_JOINER_MAX_DISCERNER_LENGTH 64

Longitud máxima de un Joiner Discerner en bits.