Lien brut

Ce module comprend des fonctions qui contrôlent la configuration brute de la couche liaison.

Résumé

Typedefs
`otLinkRawEnergyScanDone )(otInstance *aInstance, int8_t aEnergyScanMaxRssi)`	typedef `void(*` Cette fonction pointeur à la réception d'une trame IEEE 802.15.4.
`otLinkRawReceiveDone )(otInstance aInstance, otRadioFrame aFrame, otError aError)`	typedef `void(*` Cette fonction pointeur à la réception d'une trame IEEE 802.15.4.
`otLinkRawTransmitDone )(otInstance aInstance, otRadioFrame aFrame, otRadioFrame *aAckFrame, otError aError)`	typedef `void(*` Cette fonction pointeur à la réception d'une trame IEEE 802.15.4.

Les fonctions
`otLinkRawEnergyScan ( otInstance *aInstance, uint8_t aScanChannel, uint16_t aScanDuration, otLinkRawEnergyScanDone aCallback)`	`otError` Cette méthode démarre la séquence de balayage d'énergie sur la radio.
`otLinkRawGetCaps ( otInstance *aInstance)`	`otRadioCaps` Obtenez les capacités radio.
`otLinkRawGetPromiscuous ( otInstance *aInstance)`	`bool` Cette fonction obtient le statut du mode promiscuité.
`otLinkRawGetRadioTime ( otInstance *aInstance)`	`uint64_t` Obtenez l'heure actuelle de la plateforme (largeur 64 bits) de la puce radio.
`otLinkRawGetRssi ( otInstance *aInstance)`	`int8_t` Obtenez la mesure RSSI la plus récente.
`otLinkRawGetTransmitBuffer ( otInstance *aInstance)`	`otRadioFrame *` La radio passe de la transmission à la réception.
`otLinkRawIsEnabled ( otInstance *aInstance)`	`bool` Cette fonction indique si la couche de liaison brute est activée ou non.
`otLinkRawReceive ( otInstance *aInstance)`	`otError` Transition de la radio du mode veille à la réception.
`otLinkRawSetMacFrameCounter ( otInstance *aInstance, uint32_t aMacFrameCounter)`	`otError` Définit la valeur actuelle du compteur de trames MAC.
`otLinkRawSetMacKey ( otInstance aInstance, uint8_t aKeyIdMode, uint8_t aKeyId, const otMacKey aPrevKey, const otMacKey aCurrKey, const otMacKey aNextKey)`	`otError` Mettez à jour les clés MAC et l'index des clés.
`otLinkRawSetPromiscuous ( otInstance *aInstance, bool aEnable)`	`otError` Cette fonction active ou désactive le mode promiscuité.
`otLinkRawSetReceiveDone ( otInstance *aInstance, otLinkRawReceiveDone aCallback)`	`otError` Cette fonction active / désactive la couche de liaison brute.
`otLinkRawSetShortAddress ( otInstance *aInstance, uint16_t aShortAddress)`	`otError` Définissez l'adresse courte pour le filtrage d'adresses.
`otLinkRawSleep ( otInstance *aInstance)`	`otError` Faites passer la radio de réception à sommeil.
`otLinkRawSrcMatchAddExtEntry ( otInstance aInstance, const otExtAddress aExtAddress)`	`otError` Ajout d'une adresse étendue à la table de correspondance source.
`otLinkRawSrcMatchAddShortEntry ( otInstance *aInstance, uint16_t aShortAddress)`	`otError` Ajout d'une adresse courte à la table de correspondance source.
`otLinkRawSrcMatchClearExtEntries ( otInstance *aInstance)`	`otError` Suppression de toutes les adresses étendues de la table de correspondance source.
`otLinkRawSrcMatchClearExtEntry ( otInstance aInstance, const otExtAddress aExtAddress)`	`otError` Suppression de l'adresse étendue de la table de correspondance source de la radio.
`otLinkRawSrcMatchClearShortEntries ( otInstance *aInstance)`	`otError` Suppression de toutes les adresses courtes de la table de correspondance source.
`otLinkRawSrcMatchClearShortEntry ( otInstance *aInstance, uint16_t aShortAddress)`	`otError` Suppression de l'adresse courte de la table de correspondance source.
`otLinkRawSrcMatchEnable ( otInstance *aInstance, bool aEnable)`	`otError` Activer / Désactiver la correspondance de source pour l'image en attente.
`otLinkRawTransmit ( otInstance *aInstance, otLinkRawTransmitDone aCallback)`	`otError` Cette méthode démarre la séquence de transmission sur la radio.

Typedefs

otLinkRawEnergyScanDone

void(* otLinkRawEnergyScanDone)(otInstance *aInstance, int8_t aEnergyScanMaxRssi)

Cette fonction pointeur à la réception d'une trame IEEE 802.15.4.

Détails

Paramètres

`[in] aInstance`	Un pointeur vers une instance d'OpenThread.
`[in] aEnergyScanMaxRssi`	RSSI maximum rencontré sur le canal balayé.

otLinkRawReceiveDone

void(* otLinkRawReceiveDone)(otInstance *aInstance, otRadioFrame *aFrame, otError aError)

Cette fonction pointeur à la réception d'une trame IEEE 802.15.4.

Détails

Paramètres

`[in] aInstance`	Un pointeur vers une instance d'OpenThread.
`[in] aFrame`	Un pointeur vers la trame reçue ou NULL si l'opération de réception a été abandonnée.
`[in] aError`	OT_ERROR_NONE lors de la réception réussie d'une trame. OT_ERROR_ABORT lorsque la réception a été interrompue et qu'une trame n'a pas été reçue.

otLinkRawTransmitDone

void(* otLinkRawTransmitDone)(otInstance *aInstance, otRadioFrame *aFrame, otRadioFrame *aAckFrame, otError aError)

Cette fonction pointeur à la réception d'une trame IEEE 802.15.4.

Détails

Paramètres

`[in] aInstance`	Un pointeur vers une instance d'OpenThread.
`[in] aFrame`	Un pointeur vers la trame qui a été transmise.
`[in] aAckFrame`	Un pointeur vers le cadre ACK.
`[in] aError`	OT_ERROR_NONE lorsque la trame a été transmise. OT_ERROR_NO_ACK lorsque la trame a été transmise mais aucun ACK n'a été reçu OT_ERROR_CHANNEL_ACCESS_FAILURE lorsque la transmission n'a pas pu avoir lieu en raison d'une activité sur le canal. OT_ERROR_ABORT lorsque la transmission a été interrompue pour d'autres raisons.

Les fonctions

otLinkRawEnergyScan

 otError otLinkRawEnergyScan(
  otInstance *aInstance,
  uint8_t aScanChannel,
  uint16_t aScanDuration,
  otLinkRawEnergyScanDone aCallback
)

Cette méthode démarre la séquence de balayage d'énergie sur la radio.

Détails

Paramètres

`[in] aInstance`	Un pointeur vers une instance d'OpenThread.
`[in] aScanChannel`	Le canal sur lequel effectuer le balayage d'énergie.
`[in] aScanDuration`	Durée, en millisecondes, du canal à analyser.
`[in] aCallback`	Un pointeur vers une fonction appelée à la fin d'un canal balayé.

Valeurs de retour

`OT_ERROR_NONE`	Lancement réussi de la numérisation de la chaîne.
`OT_ERROR_NOT_IMPLEMENTED`	La radio ne prend pas en charge le balayage d'énergie.
`OT_ERROR_INVALID_STATE`	Si la couche de liaison brute n'est pas activée.

otLinkRawGetCaps

 otRadioCaps otLinkRawGetCaps(
  otInstance *aInstance
)

Obtenez les capacités radio.

Détails

Paramètres

[in] aInstance

Un pointeur vers une instance d'OpenThread.

Retour

Le vecteur de bits de capacité radio. La pile active ou désactive certaines fonctions basées sur cette valeur.

otLinkRawGetPromiscuous

bool otLinkRawGetPromiscuous(
  otInstance *aInstance
)

Cette fonction obtient le statut du mode promiscuité.

Détails

Paramètres

[in] aInstance

Un pointeur vers une instance d'OpenThread.

Valeurs de retour

`true`	Le mode promiscuité est activé.
`false`	Le mode promiscuité est désactivé.

otLinkRawGetRadioTime

uint64_t otLinkRawGetRadioTime(
  otInstance *aInstance
)

Obtenez l'heure actuelle de la plateforme (largeur 64 bits) de la puce radio.

Détails

Paramètres

[in] aInstance

Un pointeur vers une instance d'OpenThread.

Retour

L'heure actuelle de la radio en microsecondes.

otLinkRawGetRssi

int8_t otLinkRawGetRssi(
  otInstance *aInstance
)

Obtenez la mesure RSSI la plus récente.

Détails

Paramètres

[in] aInstance

Un pointeur vers une instance d'OpenThread.

Retour

Le RSSI en dBm lorsqu'il est valide. 127 lorsque RSSI est invalide.

otLinkRawGetTransmitBuffer

 otRadioFrame * otLinkRawGetTransmitBuffer(
  otInstance *aInstance
)

La radio passe de la transmission à la réception.

Cette méthode renvoie un pointeur vers le tampon de transmission.

L'appelant forme la trame IEEE 802.15.4 dans ce tampon puis appelle otLinkRawTransmit () pour demander la transmission.

Détails

Paramètres

[in] aInstance

Un pointeur vers une instance d'OpenThread.

Retour

Un pointeur vers le tampon de transmission ou NULL si la couche de liaison brute n'est pas activée.

otLinkRawIsEnabled

bool otLinkRawIsEnabled(
  otInstance *aInstance
)

Cette fonction indique si la couche de liaison brute est activée ou non.

Détails

Paramètres

[in] aInstance

Un pointeur vers une instance d'OpenThread.

Valeurs de retour

`true`	La couche de liaison brute est activée.
`false`	La couche de liaison brute est désactivée.

otLinkRawReceive

 otError otLinkRawReceive(
  otInstance *aInstance
)

Transition de la radio du mode veille à la réception.

Allume la radio.

Détails

Paramètres

[in] aInstance

Un pointeur vers une instance d'OpenThread.

Valeurs de retour

`OT_ERROR_NONE`	Transition réussie vers la réception.
`OT_ERROR_INVALID_STATE`	La radio était désactivée ou émettait.

otLinkRawSetMacFrameCounter

 otError otLinkRawSetMacFrameCounter(
  otInstance *aInstance,
  uint32_t aMacFrameCounter
)

Définit la valeur actuelle du compteur de trames MAC.

Détails

Paramètres

`[in] aInstance`	Un pointeur vers une instance d'OpenThread.
`[in] aMacFrameCounter`	La valeur du compteur de trames MAC.

Valeurs de retour

`OT_ERROR_NONE`	En cas de succès.
`OT_ERROR_INVALID_STATE`	Si la couche de liaison brute n'est pas activée.

otLinkRawSetMacKey

 otError otLinkRawSetMacKey(
  otInstance *aInstance,
  uint8_t aKeyIdMode,
  uint8_t aKeyId,
  const otMacKey *aPrevKey,
  const otMacKey *aCurrKey,
  const otMacKey *aNextKey
)

Mettez à jour les clés MAC et l'index des clés.

Détails

Paramètres

`[in] aInstance`	Un pointeur vers une instance d'OpenThread.
`[in] aKeyIdMode`	Le mode d'identification de clé.
`[in] aKeyId`	L'index clé.
`[in] aPrevKey`	La clé MAC précédente.
`[in] aCurrKey`	La clé MAC actuelle.
`[in] aNextKey`	La prochaine clé MAC.

Valeurs de retour

`OT_ERROR_NONE`	En cas de succès.
`OT_ERROR_INVALID_STATE`	Si la couche de liaison brute n'est pas activée.

otLinkRawSetPromiscuous

 otError otLinkRawSetPromiscuous(
  otInstance *aInstance,
  bool aEnable
)

Cette fonction active ou désactive le mode promiscuité.

Détails

Paramètres

`[in] aInstance`	Un pointeur vers une instance d'OpenThread.
`[in] aEnable`	Une valeur pour activer ou désactiver le mode promiscuité.

Valeurs de retour

`OT_ERROR_NONE`	En cas de succès.
`OT_ERROR_INVALID_STATE`	Si la couche de liaison brute n'est pas activée.

otLinkRawSetReceiveDone

 otError otLinkRawSetReceiveDone(
  otInstance *aInstance,
  otLinkRawReceiveDone aCallback
)

Cette fonction active / désactive la couche de liaison brute.

Détails

Paramètres

`[in] aInstance`	Un pointeur vers une instance d'OpenThread.
`[in] aCallback`	Un pointeur vers une fonction appelée à la réception d'une trame IEEE 802.15.4. NULL pour désactiver la couche de liaison brute.

Valeurs de retour

`OT_ERROR_FAILED`	La radio n'a pas pu être activée / désactivée.
`OT_ERROR_INVALID_STATE`	Si l'interface OpenThread Ip6 est déjà activée.
`OT_ERROR_NONE`	Si l'état d'activation a été défini avec succès.

otLinkRawSetShortAddress

 otError otLinkRawSetShortAddress(
  otInstance *aInstance,
  uint16_t aShortAddress
)

Définissez l'adresse courte pour le filtrage d'adresses.

Détails

Paramètres

`[in] aInstance`	Un pointeur vers une instance d'OpenThread.
`[in] aShortAddress`	L'adresse courte IEEE 802.15.4.

Valeurs de retour

`OT_ERROR_NONE`	En cas de succès.
`OT_ERROR_INVALID_STATE`	Si la couche de liaison brute n'est pas activée.

otLinkRawSleep

 otError otLinkRawSleep(
  otInstance *aInstance
)

Faites passer la radio de réception à sommeil.

Éteindre la radio.

Détails

Paramètres

[in] aInstance

Un pointeur vers une instance d'OpenThread.

Valeurs de retour

`OT_ERROR_NONE`	Transition réussie vers Sleep.
`OT_ERROR_BUSY`	La radio transmettait
`OT_ERROR_INVALID_STATE`	La radio a été désactivée

otLinkRawSrcMatchAddExtEntry

 otError otLinkRawSrcMatchAddExtEntry(
  otInstance *aInstance,
  const otExtAddress *aExtAddress
)

Ajout d'une adresse étendue à la table de correspondance source.

Détails

Paramètres

`[in] aInstance`	Un pointeur vers une instance d'OpenThread.
`[in] aExtAddress`	L'adresse étendue à ajouter.

Valeurs de retour

`OT_ERROR_NONE`	L'adresse étendue a bien été ajoutée à la table de correspondance source.
`OT_ERROR_NO_BUFS`	Aucune entrée disponible dans la table de correspondance source.
`OT_ERROR_INVALID_STATE`	Si la couche de liaison brute n'est pas activée.

otLinkRawSrcMatchAddShortEntry

 otError otLinkRawSrcMatchAddShortEntry(
  otInstance *aInstance,
  uint16_t aShortAddress
)

Ajout d'une adresse courte à la table de correspondance source.

Détails

Paramètres

`[in] aInstance`	Un pointeur vers une instance d'OpenThread.
`[in] aShortAddress`	L'adresse courte à ajouter.

Valeurs de retour

`OT_ERROR_NONE`	L'adresse courte a bien été ajoutée à la table de correspondance source.
`OT_ERROR_NO_BUFS`	Aucune entrée disponible dans la table de correspondance source.
`OT_ERROR_INVALID_STATE`	Si la couche de liaison brute n'est pas activée.

otLinkRawSrcMatchClearExtEntries

 otError otLinkRawSrcMatchClearExtEntries(
  otInstance *aInstance
)

Suppression de toutes les adresses étendues de la table de correspondance source.

Détails

Paramètres

[in] aInstance

Un pointeur vers une instance d'OpenThread.

Valeurs de retour

`OT_ERROR_NONE`	En cas de succès.
`OT_ERROR_INVALID_STATE`	Si la couche de liaison brute n'est pas activée.

otLinkRawSrcMatchClearExtEntry

 otError otLinkRawSrcMatchClearExtEntry(
  otInstance *aInstance,
  const otExtAddress *aExtAddress
)

Suppression de l'adresse étendue de la table de correspondance source de la radio.

Détails

Paramètres

`[in] aInstance`	Un pointeur vers une instance d'OpenThread.
`[in] aExtAddress`	L'adresse étendue à supprimer.

Valeurs de retour

`OT_ERROR_NONE`	Suppression de l'adresse étendue de la table de correspondance source.
`OT_ERROR_NO_ADDRESS`	L'adresse étendue ne figure pas dans la table de correspondance source.
`OT_ERROR_INVALID_STATE`	Si la couche de liaison brute n'est pas activée.

otLinkRawSrcMatchClearShortEntries

 otError otLinkRawSrcMatchClearShortEntries(
  otInstance *aInstance
)

Suppression de toutes les adresses courtes de la table de correspondance source.

Détails

Paramètres

[in] aInstance

Un pointeur vers une instance d'OpenThread.

Valeurs de retour

`OT_ERROR_NONE`	En cas de succès.
`OT_ERROR_INVALID_STATE`	Si la couche de liaison brute n'est pas activée.

otLinkRawSrcMatchClearShortEntry

 otError otLinkRawSrcMatchClearShortEntry(
  otInstance *aInstance,
  uint16_t aShortAddress
)

Suppression de l'adresse courte de la table de correspondance source.

Détails

Paramètres

`[in] aInstance`	Un pointeur vers une instance d'OpenThread.
`[in] aShortAddress`	L'adresse courte à supprimer.

Valeurs de retour

`OT_ERROR_NONE`	L'adresse courte a bien été supprimée de la table de correspondance source.
`OT_ERROR_NO_ADDRESS`	L'adresse courte ne figure pas dans la table de correspondance source.
`OT_ERROR_INVALID_STATE`	Si la couche de liaison brute n'est pas activée.

otLinkRawSrcMatchEnable

 otError otLinkRawSrcMatchEnable(
  otInstance *aInstance,
  bool aEnable
)

Activer / Désactiver la correspondance de source pour l'image en attente.

Détails

Paramètres

`[in] aInstance`	Un pointeur vers une instance d'OpenThread.
`[in] aEnable`	Activer / désactiver la correspondance de source pour l'image en attente.

Valeurs de retour

`OT_ERROR_NONE`	En cas de succès.
`OT_ERROR_INVALID_STATE`	Si la couche de liaison brute n'est pas activée.

otLinkRawTransmit

 otError otLinkRawTransmit(
  otInstance *aInstance,
  otLinkRawTransmitDone aCallback
)

Cette méthode démarre la séquence de transmission sur la radio.

L'appelant doit former la trame IEEE 802.15.4 dans le tampon fourni par otLinkRawGetTransmitBuffer () avant de demander la transmission. Le canal et la puissance d'émission sont également inclus dans la structure otRadioFrame .

La séquence de transmission se compose de:

Transition de la radio pour transmettre à partir de la réception.
Transmet le PSDU sur le canal donné et à la puissance d'émission donnée.

Détails

Paramètres

`[in] aInstance`	Un pointeur vers une instance d'OpenThread.
`[in] aCallback`	Un pointeur vers une fonction appelée à la fin de la transmission.

Valeurs de retour

`OT_ERROR_NONE`	Transition réussie vers Transmit.
`OT_ERROR_INVALID_STATE`	La radio n'était pas dans l'état de réception.