Cette page a été traduite par l'API Cloud Translation.

Instance

Ce module comprend des fonctions qui contrôlent l'instance OpenThread.

Résumé

Énumérations
anonymous enum{ OT_CHANGED_IP6_ADDRESS_ADDED = 1 << 0, OT_CHANGED_IP6_ADDRESS_REMOVED = 1 << 1, OT_CHANGED_THREAD_ROLE = 1 << 2, OT_CHANGED_THREAD_LL_ADDR = 1 << 3, OT_CHANGED_THREAD_ML_ADDR = 1 << 4, OT_CHANGED_THREAD_RLOC_ADDED = 1 << 5, OT_CHANGED_THREAD_RLOC_REMOVED = 1 << 6, OT_CHANGED_THREAD_PARTITION_ID = 1 << 7, OT_CHANGED_THREAD_KEY_SEQUENCE_COUNTER = 1 << 8, OT_CHANGED_THREAD_NETDATA = 1 << 9, OT_CHANGED_THREAD_CHILD_ADDED = 1 << 10, OT_CHANGED_THREAD_CHILD_REMOVED = 1 << 11, OT_CHANGED_IP6_MULTICAST_SUBSCRIBED = 1 << 12, OT_CHANGED_IP6_MULTICAST_UNSUBSCRIBED = 1 << 13, OT_CHANGED_THREAD_CHANNEL = 1 << 14, OT_CHANGED_THREAD_PANID = 1 << 15, OT_CHANGED_THREAD_NETWORK_NAME = 1 << 16, OT_CHANGED_THREAD_EXT_PANID = 1 << 17, OT_CHANGED_NETWORK_KEY = 1 << 18, OT_CHANGED_PSKC = 1 << 19, OT_CHANGED_SECURITY_POLICY = 1 << 20, OT_CHANGED_CHANNEL_MANAGER_NEW_CHANNEL = 1 << 21, OT_CHANGED_SUPPORTED_CHANNEL_MASK = 1 << 22, OT_CHANGED_COMMISSIONER_STATE = 1 << 23, OT_CHANGED_THREAD_NETIF_STATE = 1 << 24, OT_CHANGED_THREAD_BACKBONE_ROUTER_STATE = 1 << 25, OT_CHANGED_THREAD_BACKBONE_ROUTER_LOCAL = 1 << 26, OT_CHANGED_JOINER_STATE = 1 << 27, OT_CHANGED_ACTIVE_DATASET = 1 << 28, OT_CHANGED_PENDING_DATASET = 1 << 29 }	énumération, enum Cette énumération définit les options transmises dans `otStateChangedCallback`.

Énumérations

anonymous enum{
  OT_CHANGED_IP6_ADDRESS_ADDED = 1 << 0,
  OT_CHANGED_IP6_ADDRESS_REMOVED = 1 << 1,
  OT_CHANGED_THREAD_ROLE = 1 << 2,
  OT_CHANGED_THREAD_LL_ADDR = 1 << 3,
  OT_CHANGED_THREAD_ML_ADDR = 1 << 4,
  OT_CHANGED_THREAD_RLOC_ADDED = 1 << 5,
  OT_CHANGED_THREAD_RLOC_REMOVED = 1 << 6,
  OT_CHANGED_THREAD_PARTITION_ID = 1 << 7,
  OT_CHANGED_THREAD_KEY_SEQUENCE_COUNTER = 1 << 8,
  OT_CHANGED_THREAD_NETDATA = 1 << 9,
  OT_CHANGED_THREAD_CHILD_ADDED = 1 << 10,
  OT_CHANGED_THREAD_CHILD_REMOVED = 1 << 11,
  OT_CHANGED_IP6_MULTICAST_SUBSCRIBED = 1 << 12,
  OT_CHANGED_IP6_MULTICAST_UNSUBSCRIBED = 1 << 13,
  OT_CHANGED_THREAD_CHANNEL = 1 << 14,
  OT_CHANGED_THREAD_PANID = 1 << 15,
  OT_CHANGED_THREAD_NETWORK_NAME = 1 << 16,
  OT_CHANGED_THREAD_EXT_PANID = 1 << 17,
  OT_CHANGED_NETWORK_KEY = 1 << 18,
  OT_CHANGED_PSKC = 1 << 19,
  OT_CHANGED_SECURITY_POLICY = 1 << 20,
  OT_CHANGED_CHANNEL_MANAGER_NEW_CHANNEL = 1 << 21,
  OT_CHANGED_SUPPORTED_CHANNEL_MASK = 1 << 22,
  OT_CHANGED_COMMISSIONER_STATE = 1 << 23,
  OT_CHANGED_THREAD_NETIF_STATE = 1 << 24,
  OT_CHANGED_THREAD_BACKBONE_ROUTER_STATE = 1 << 25,
  OT_CHANGED_THREAD_BACKBONE_ROUTER_LOCAL = 1 << 26,
  OT_CHANGED_JOINER_STATE = 1 << 27,
  OT_CHANGED_ACTIVE_DATASET = 1 << 28,
  OT_CHANGED_PENDING_DATASET = 1 << 29
}

énumération, enum

Cette énumération définit les options transmises dans otStateChangedCallback.

Définitions
`otChangedFlags`	Définition `uint32_t` Ce type représente un champ de bits indiquant un état/une configuration spécifique qui a changé.
`otInstance`	Définition `struct otInstance` Cette structure représente la structure d'instance OpenThread.
`otStateChangedCallback)(otChangedFlags aFlags, void *aContext)`	Définition `void(*` Ce pointeur de fonction est appelé pour avertir certaines modifications de configuration ou d'état dans OpenThread.

Fonctions
`otGetRadioVersionString(otInstance *aInstance)`	`const char *` Cette fonction obtient la chaîne de version radio OpenThread.
`otGetVersionString(void)`	`const char *` Cette fonction obtient la chaîne de version OpenThread.
`otInstanceErasePersistentInfo(otInstance *aInstance)`	`otError` Cette fonction efface toutes les informations persistantes (paramètres réseau) OpenThread de la mémoire non volatile.
`otInstanceFactoryReset(otInstance *aInstance)`	`void` Supprime tous les paramètres stockés sur la mémoire non volatile, puis déclenche une réinitialisation de la plate-forme.
`otInstanceFinalize(otInstance *aInstance)`	`void` Cette fonction désactive la bibliothèque OpenThread.
`otInstanceGetUptime(otInstance *aInstance)`	`uint64_t` Cette fonction renvoie le temps d'activité actuel de l'instance (en millisecondes).
`otInstanceGetUptimeAsString(otInstance aInstance, char aBuffer, uint16_t aSize)`	`void` Cette fonction renvoie le temps d'activité actuel de l'instance sous la forme d'une chaîne lisible.
`otInstanceInit(void aInstanceBuffer, size_t aInstanceBufferSize)`	`otInstance *` Cette fonction initialise la bibliothèque OpenThread.
`otInstanceInitSingle(void)`	`otInstance *` Cette fonction initialise l'instance statique statique de la bibliothèque OpenThread.
`otInstanceIsInitialized(otInstance *aInstance)`	`bool` Cette fonction indique si l'instance est valide ou initialisée.
`otInstanceReset(otInstance *aInstance)`	`void` Cette méthode déclenche une réinitialisation de la plate-forme.
`otInstanceResetRadioStack(otInstance *aInstance)`	`void` Cette méthode réinitialise les états internes de la pile radio OpenThread.
`otRemoveStateChangeCallback(otInstance aInstance, otStateChangedCallback aCallback, void aContext)`	`void` Cette fonction supprime un rappel pour indiquer que certaines configurations ou certains états changent dans OpenThread.
`otSetStateChangedCallback(otInstance aInstance, otStateChangedCallback aCallback, void aContext)`	`otError` Cette fonction enregistre un rappel pour indiquer que certaines configurations ou certains états changent dans OpenThread.

Énumérations

énumération anonyme

 anonymous enum

Cette énumération définit les options transmises dans otStateChangedCallback.

Propriétés
`OT_CHANGED_ACTIVE_DATASET`	L'ensemble de données opérationnel actif a été modifié.
`OT_CHANGED_CHANNEL_MANAGER_NEW_CHANNEL`	Le nouveau canal de discussion en attente du gestionnaire de canaux a été modifié.
`OT_CHANGED_COMMISSIONER_STATE`	État du commissaire modifié.
`OT_CHANGED_IP6_ADDRESS_ADDED`	L'adresse IPv6 a été ajoutée.
`OT_CHANGED_IP6_ADDRESS_REMOVED`	L'adresse IPv6 a été supprimée.
`OT_CHANGED_IP6_MULTICAST_SUBSCRIBED`	Abonné à une adresse de multidiffusion IPv6.
`OT_CHANGED_IP6_MULTICAST_UNSUBSCRIBED`	Vous vous êtes désabonné d'une adresse de multidiffusion IPv6.
`OT_CHANGED_JOINER_STATE`	État de la jointure modifié.
`OT_CHANGED_NETWORK_KEY`	Clé réseau modifiée.
`OT_CHANGED_PENDING_DATASET`	La valeur "Ensemble de données opérationnelle en attente" a été modifiée.
`OT_CHANGED_PSKC`	PSKc modifiée.
`OT_CHANGED_SECURITY_POLICY`	Règle de sécurité modifiée.
`OT_CHANGED_SUPPORTED_CHANNEL_MASK`	Masque de canal compatible modifié.
`OT_CHANGED_THREAD_BACKBONE_ROUTER_LOCAL`	Configuration du routeur backbone local modifiée.
`OT_CHANGED_THREAD_BACKBONE_ROUTER_STATE`	État du routeur backbone modifié.
`OT_CHANGED_THREAD_CHANNEL`	Canal du réseau Thread modifié.
`OT_CHANGED_THREAD_CHILD_ADDED`	L'élément enfant a été ajouté.
`OT_CHANGED_THREAD_CHILD_REMOVED`	L'enfant a été supprimé.
`OT_CHANGED_THREAD_EXT_PANID`	L'ID du PAN étendu du réseau des fils de discussion a été modifié.
`OT_CHANGED_THREAD_KEY_SEQUENCE_COUNTER`	La séquence de clés de fil de discussion a été modifiée.
`OT_CHANGED_THREAD_LL_ADDR`	L'adresse de liaison locale a été modifiée.
`OT_CHANGED_THREAD_ML_ADDR`	L'adresse du réseau maillé a été modifiée.
`OT_CHANGED_THREAD_NETDATA`	Les données du réseau Thread ont été modifiées.
`OT_CHANGED_THREAD_NETIF_STATE`	L'état de l'interface réseau des fils de discussion a été modifié.
`OT_CHANGED_THREAD_NETWORK_NAME`	Nom du réseau Thread modifié.
`OT_CHANGED_THREAD_PANID`	L'ID du PAN du réseau Thread a été modifié.
`OT_CHANGED_THREAD_PARTITION_ID`	ID de partition modifié.
`OT_CHANGED_THREAD_RLOC_ADDED`	RLOC a été ajouté.
`OT_CHANGED_THREAD_RLOC_REMOVED`	Le RLOC a été supprimé.
`OT_CHANGED_THREAD_ROLE`	Le rôle (désactivé, dissocié, enfant, routeur, responsable) a été modifié.

Définitions

otChangedFlags

uint32_t otChangedFlags

Ce type représente un champ de bits indiquant un état/une configuration spécifique qui a changé.

Consultez les définitions de OT_CHANGED_*.

Instance

struct otInstance otInstance

Cette structure représente la structure d'instance OpenThread.

otStateChangedCallback

void(* otStateChangedCallback)(otChangedFlags aFlags, void *aContext)

Ce pointeur de fonction est appelé pour avertir certaines modifications de configuration ou d'état dans OpenThread.

Détails

Paramètres

`[in] aFlags`	Champ de bits indiquant un état spécifique qui a changé. Consultez les définitions de `OT_CHANGED_*`.
`[in] aContext`	Un pointeur vers un contexte spécifique à l'application.

Fonctions

otGetRadioVersionString

const char * otGetRadioVersionString(
  otInstance *aInstance
)

Cette fonction obtient la chaîne de version radio OpenThread.

Détails

Paramètres

[in] aInstance

Pointeur vers une instance OpenThread.

Renvoie

Un pointeur vers la version radio OpenThread.

otGetVersionString

const char * otGetVersionString(
  void
)

Cette fonction obtient la chaîne de version OpenThread.

Détails
Renvoie	Un pointeur vers la version d'OpenThread.

otInstanceEffacerPersistentInfo

otError otInstanceErasePersistentInfo(
  otInstance *aInstance
)

Cette fonction efface toutes les informations persistantes (paramètres réseau) OpenThread de la mémoire non volatile.

L'effacement ne fonctionne que si l'appareil est à l'état disabled.

Détails

Paramètres

[in] aInstance

Pointeur vers une instance OpenThread.

Valeurs de retour

`OT_ERROR_NONE`	Toutes les informations/états persistants ont bien été effacés.
`OT_ERROR_INVALID_STATE`	L'appareil n'est pas associé à l'état ou rôle `disabled`.

otInstanceFactoryReset

void otInstanceFactoryReset(
  otInstance *aInstance
)

Supprime tous les paramètres stockés sur la mémoire non volatile, puis déclenche une réinitialisation de la plate-forme.

Détails

Paramètres

[in] aInstance

Pointeur vers une instance OpenThread.

Finalisation de l'instance

void otInstanceFinalize(
  otInstance *aInstance
)

Cette fonction désactive la bibliothèque OpenThread.

Appelez cette fonction lorsque OpenThread n'est plus utilisé.

Détails

Paramètres

[in] aInstance

Pointeur vers une instance OpenThread.

OTInstanceGetUptime

uint64_t otInstanceGetUptime(
  otInstance *aInstance
)

Cette fonction renvoie le temps d'activité actuel de l'instance (en millisecondes).

Cette fonction nécessite l'activation de OPENTHREAD_CONFIG_UPTIME_ENABLE.

Le temps d'activité est exprimé en nombre de millisecondes depuis l'initialisation de l'instance OpenThread.

Détails

Paramètres

[in] aInstance

Pointeur vers une instance OpenThread.

Renvoie

Temps d'activité (en millisecondes).

otInstanceGetUptimeAsString

void otInstanceGetUptimeAsString(
  otInstance *aInstance,
  char *aBuffer,
  uint16_t aSize
)

Cette fonction renvoie le temps d'activité actuel de l'instance sous la forme d'une chaîne lisible.

Cette fonction nécessite l'activation de OPENTHREAD_CONFIG_UPTIME_ENABLE.

La chaîne respecte le format "::." pour les heures, les minutes, les secondes et les millisecondes (si le temps d'activité est inférieur à un jour) ou ".

d.::." (s'il dure plus d'un jour).

Si la chaîne obtenue ne tient pas dans aBuffer (au sein de ses aSize caractères), elle sera tronquée, mais la chaîne générée sera toujours fermée à zéro.

Détails

Paramètres

`[in] aInstance`	Pointeur vers une instance OpenThread.
`[out] aBuffer`	Un pointeur vers un tableau de caractères pour générer la chaîne.
`[in] aSize`	Taille de `aBuffer` (en octets). Utilisation recommandée de `OT_UPTIME_STRING_SIZE`.

InstanceInstanceInit

otInstance * otInstanceInit(
  void *aInstanceBuffer,
  size_t *aInstanceBufferSize
)

Cette fonction initialise la bibliothèque OpenThread.

Cette fonction initialise OpenThread et la prépare pour les appels d'API OpenThread ultérieurs. Cette fonction doit être appelée avant tout autre appel à OpenThread.

Cette fonction est disponible et ne peut être utilisée que lorsque la compatibilité avec plusieurs instances OpenThread est activée.

Détails

Paramètres

`[in] aInstanceBuffer`	Tampon pour OpenThread à utiliser pour attribuer la structure otInstance.
`[in,out] aInstanceBufferSize`	En entrée, la taille de aInstanceBuffer. Dans la sortie, si l'espace est insuffisant pour otInstance, il s'agit du nombre d'octets requis pour otInstance.

Renvoie

Un pointeur vers la nouvelle instance OpenThread.

Voir également:
otInstanceFinalize

InstanceInstanceInitSingle

otInstance * otInstanceInitSingle(
  void
)

Cette fonction initialise l'instance statique statique de la bibliothèque OpenThread.

Cette fonction initialise OpenThread et la prépare pour les appels d'API OpenThread ultérieurs. Cette fonction doit être appelée avant tout autre appel à OpenThread.

Cette fonction est disponible et ne peut être utilisée que lorsque la compatibilité avec plusieurs instances OpenThread est désactivée.

Détails
Renvoie	Un pointeur vers l'instance OpenThread unique.

otInstanceIsInitialized

bool otInstanceIsInitialized(
  otInstance *aInstance
)

Cette fonction indique si l'instance est valide ou initialisée.

L'instance est considérée comme valide si elle est acquise et initialisée avec otInstanceInitSingle() (en cas d'instance unique) ou otInstanceInit() (en cas d'instance multiinstance). Si vous appelez otInstanceFinalize() ultérieurement, l'instance sera considérée comme non initialisée.

Détails

Paramètres

[in] aInstance

Pointeur vers une instance OpenThread.

Renvoie

TRUE si l'instance donnée est valide/initialisée, FALSE dans le cas contraire.

InstanceInstanceReset

void otInstanceReset(
  otInstance *aInstance
)

Cette méthode déclenche une réinitialisation de la plate-forme.

Le processus de réinitialisation garantit que toutes les informations et l'état OpenThread (stockés en mémoire volatile) sont effacés. Notez que otPlatformReset n'efface pas les informations/états persistants enregistrés dans la mémoire non volatile.

Détails

Paramètres

[in] aInstance

Pointeur vers une instance OpenThread.

otInstanceResetRadioStack

void otInstanceResetRadioStack(
  otInstance *aInstance
)

Cette méthode réinitialise les états internes de la pile radio OpenThread.

Les rappels et les configurations sont conservés.

Cette API n'est disponible que dans les versions radio (OPENTHREAD_RADIO = 1).

Détails

Paramètres

[in] aInstance

Pointeur vers une instance OpenThread.

otRemoveStateChangeCallback

void otRemoveStateChangeCallback(
  otInstance *aInstance,
  otStateChangedCallback aCallback,
  void *aContext
)

Cette fonction supprime un rappel pour indiquer que certaines configurations ou certains états changent dans OpenThread.

Détails

Paramètres

`[in] aInstance`	Pointeur vers une instance OpenThread.
`[in] aCallback`	Pointeur vers une fonction appelée avec certaines modifications de configuration ou d'état.
`[in] aContext`	Un pointeur vers un contexte spécifique à l'application.

otSetStateChangedCallback

otError otSetStateChangedCallback(
  otInstance *aInstance,
  otStateChangedCallback aCallback,
  void *aContext
)

Cette fonction enregistre un rappel pour indiquer que certaines configurations ou certains états changent dans OpenThread.

Détails

Paramètres

`[in] aInstance`	Pointeur vers une instance OpenThread.
`[in] aCallback`	Pointeur vers une fonction appelée avec certaines modifications de configuration ou d'état.
`[in] aContext`	Un pointeur vers un contexte spécifique à l'application.

Valeurs de retour

`OT_ERROR_NONE`	Ajout du rappel à la liste des rappels.
`OT_ERROR_ALREADY`	Le rappel a déjà été enregistré.
`OT_ERROR_NO_BUFS`	Impossible d'ajouter le rappel en raison de contraintes liées aux ressources.

Macros

Prolongations : UP_UPTIME_STRING_SIZE

 OT_UPTIME_STRING_SIZE 24

Taille recommandée pour la représentation sous forme de chaîne du temps d'activité.

Resources

Les sujets de référence de l'API OpenThread proviennent du code source, disponible sur GitHub. Pour plus d'informations ou pour contribuer à notre documentation, reportez-vous à la page Ressources.