Link non elaborato

Questo modulo include funzioni che controllano la configurazione non elaborata a livello di link.

Riepilogo

Typedef
otLinkRawEnergyScanDone)(otInstance *aInstance, int8_t aEnergyScanMaxRssi) typedef
void(*
Puntatore alla ricezione di un frame IEEE 802.15.4.
otLinkRawReceiveDone)(otInstance *aInstance, otRadioFrame *aFrame, otError aError) typedef
void(*
Puntatore alla ricezione di un frame IEEE 802.15.4.
otLinkRawTransmitDone)(otInstance *aInstance, otRadioFrame *aFrame, otRadioFrame *aAckFrame, otError aError) typedef
void(*
Puntatore alla ricezione di un frame IEEE 802.15.4.

Funzioni
otLinkRawEnergyScan(otInstance *aInstance, uint8_t aScanChannel, uint16_t aScanDuration, otLinkRawEnergyScanDone aCallback)
Avvia la sequenza di scansione energetica alla radio.
otLinkRawGetCaps(otInstance *aInstance)
Ottieni le funzionalità radio.
otLinkRawGetPromiscuous(otInstance *aInstance)
bool
Visualizza lo stato della modalità promiscuo.
otLinkRawGetRadioTime(otInstance *aInstance)
uint64_t
Ottieni il tempo di piattaforma attuale (larghezza di 64 bit) del chip di radio.
otLinkRawGetRssi(otInstance *aInstance)
int8_t
Ottieni la misurazione RSSI più recente.
otLinkRawGetTransmitBuffer(otInstance *aInstance)
La radio passa dalla trasmissione alla ricezione.
otLinkRawIsEnabled(otInstance *aInstance)
bool
Indica se il livello link non elaborato è abilitato o meno.
otLinkRawReceive(otInstance *aInstance)
Transizione della radio da Sonno a Ricezione.
otLinkRawSetMacFrameCounter(otInstance *aInstance, uint32_t aMacFrameCounter)
Imposta il valore del contatore di frame MAC corrente.
otLinkRawSetMacFrameCounterIfLarger(otInstance *aInstance, uint32_t aMacFrameCounter)
Imposta il valore del contatore di frame MAC corrente solo se il nuovo valore è maggiore di quello attuale.
otLinkRawSetMacKey(otInstance *aInstance, uint8_t aKeyIdMode, uint8_t aKeyId, const otMacKey *aPrevKey, const otMacKey *aCurrKey, const otMacKey *aNextKey)
Aggiorna le chiavi MAC e l'indice delle chiavi.
otLinkRawSetPromiscuous(otInstance *aInstance, bool aEnable)
Attiva o disattiva la modalità promiscuo.
otLinkRawSetReceiveDone(otInstance *aInstance, otLinkRawReceiveDone aCallback)
Attiva/disattiva il livello link non elaborato.
otLinkRawSetShortAddress(otInstance *aInstance, uint16_t aShortAddress)
Imposta l'indirizzo breve per il filtro degli indirizzi.
otLinkRawSleep(otInstance *aInstance)
Passa dalla ricezione alla modalità Sonno.
otLinkRawSrcMatchAddExtEntry(otInstance *aInstance, const otExtAddress *aExtAddress)
Aggiunta dell'indirizzo esteso alla tabella delle corrispondenze di origine.
otLinkRawSrcMatchAddShortEntry(otInstance *aInstance, uint16_t aShortAddress)
Aggiunta dell'indirizzo breve alla tabella delle corrispondenze di origine.
otLinkRawSrcMatchClearExtEntries(otInstance *aInstance)
Rimozione di tutti gli indirizzi estesi dalla tabella delle corrispondenze di origine.
otLinkRawSrcMatchClearExtEntry(otInstance *aInstance, const otExtAddress *aExtAddress)
Rimozione dell'indirizzo esteso alla tabella delle corrispondenze di origine della radio.
otLinkRawSrcMatchClearShortEntries(otInstance *aInstance)
Rimozione di tutti gli indirizzi brevi dalla tabella delle corrispondenze di origine.
otLinkRawSrcMatchClearShortEntry(otInstance *aInstance, uint16_t aShortAddress)
Rimozione dell'indirizzo breve nella tabella delle corrispondenze di origine.
otLinkRawSrcMatchEnable(otInstance *aInstance, bool aEnable)
Attiva/disattiva la corrispondenza dell'origine per il frame in attesa.
otLinkRawTransmit(otInstance *aInstance, otLinkRawTransmitDone aCallback)
Avvia la sequenza di trasmissione alla radio.

Typedef

otLinkRawEnergyScanDone

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

Puntatore alla ricezione di un frame IEEE 802.15.4.

Dettagli
Parametri
[in] aInstance
Un puntatore a un'istanza OpenThread.
[in] aEnergyScanMaxRssi
Il numero massimo di RSSI rilevato sul canale sottoposto a scansione.

otLinkRawReceiveDone

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

Puntatore alla ricezione di un frame IEEE 802.15.4.

Dettagli
Parametri
[in] aInstance
Un puntatore a un'istanza OpenThread.
[in] aFrame
Un puntatore al frame ricevuto o NULL se l'operazione di ricezione è stata interrotta.
[in] aError
OT_ERROR_NONE alla ricezione di un frame. OT_ERROR_ABORT quando la ricezione è stata interrotta e non è stato ricevuto un frame.

otLinkRawTransmitDone

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

Puntatore alla ricezione di un frame IEEE 802.15.4.

Dettagli
Parametri
[in] aInstance
Un puntatore a un'istanza OpenThread.
[in] aFrame
Un puntatore al frame trasmesso.
[in] aAckFrame
Un puntatore al frame ACK.
[in] aError
OT_ERROR_NONE quando il frame è stato trasmesso. OT_ERROR_NO_ACK quando il frame è stato trasmesso, ma non è stato ricevuto nessun ACK OT_ERROR_CHANNEL_ACCESS_FAILURE quando non è stato possibile effettuare la trasmissione a causa di attività sul canale. OT_ERROR_ABORT quando la trasmissione è stata interrotta per altri motivi.

Funzioni

otLinkRawEnergyScan

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

Avvia la sequenza di scansione energetica alla radio.

Dettagli
Parametri
[in] aInstance
Un puntatore a un'istanza OpenThread.
[in] aScanChannel
Il canale su cui eseguire la scansione energetica.
[in] aScanDuration
La durata in millisecondi della scansione del canale.
[in] aCallback
Un puntatore a una funzione chiamata al completamento di un canale analizzato.
Valori restituiti
OT_ERROR_NONE
Ricerca del canale avviata.
OT_ERROR_BUSY
La radio sta eseguendo una scansione energetica.
OT_ERROR_NOT_IMPLEMENTED
La radio non supporta la scansione energetica.
OT_ERROR_INVALID_STATE
Se il livello link non elaborato non è abilitato.

otLinkRawGetCaps

otRadioCaps otLinkRawGetCaps(
  otInstance *aInstance
)

Ottieni le funzionalità radio.

Dettagli
Parametri
[in] aInstance
Un puntatore a un'istanza OpenThread.
Restituisce
Il vettore di bit della funzionalità radio. Lo stack attiva o disattiva alcune funzioni in base a questo valore.

otLinkRawGetPromiscuous

bool otLinkRawGetPromiscuous(
  otInstance *aInstance
)

Visualizza lo stato della modalità promiscuo.

Dettagli
Parametri
[in] aInstance
Un puntatore a un'istanza OpenThread.
Valori restituiti
true
La modalità promiscuo è attivata.
false
La modalità promiscuo è disattivata.

otLinkRawGetRadioTime

uint64_t otLinkRawGetRadioTime(
  otInstance *aInstance
)

Ottieni il tempo di piattaforma attuale (larghezza di 64 bit) del chip di radio.

Dettagli
Parametri
[in] aInstance
Un puntatore a un'istanza OpenThread.
Restituisce
L'ora della radio attuale in microsecondi.

otLinkRawGetRssi

int8_t otLinkRawGetRssi(
  otInstance *aInstance
)

Ottieni la misurazione RSSI più recente.

Dettagli
Parametri
[in] aInstance
Un puntatore a un'istanza OpenThread.
Restituisce
L'RSSI in dBm, se valido. 127 quando RSSI non è valido.

otLinkRawGetTransmitBuffer

otRadioFrame * otLinkRawGetTransmitBuffer(
  otInstance *aInstance
)

La radio passa dalla trasmissione alla ricezione.

Restituisce un puntatore al buffer di trasmissione.

Il chiamante forma il frame IEEE 802.15.4 in questo buffer, quindi chiama otLinkRawTransmit() per richiedere la trasmissione.

Dettagli
Parametri
[in] aInstance
Un puntatore a un'istanza OpenThread.
Restituisce
Puntatore al buffer di trasmissione o al NULL se il livello link non elaborato non è abilitato.

otLinkRawIsEnabled

bool otLinkRawIsEnabled(
  otInstance *aInstance
)

Indica se il livello link non elaborato è abilitato o meno.

Dettagli
Parametri
[in] aInstance
Un puntatore a un'istanza OpenThread.
Valori restituiti
true
Il livello link non elaborato è abilitato.
false
Il livello link non elaborato è disabilitato.

otLinkRawReceive

otError otLinkRawReceive(
  otInstance *aInstance
)

Transizione della radio da Sonno a Ricezione.

Accendi la radio.

Dettagli
Parametri
[in] aInstance
Un puntatore a un'istanza OpenThread.
Valori restituiti
OT_ERROR_NONE
Transizione eseguita correttamente a Ricevi.
OT_ERROR_INVALID_STATE
La radio è stata disattivata o sta trasmettendo.

otLinkRawSetMacFrameCounter

otError otLinkRawSetMacFrameCounter(
  otInstance *aInstance,
  uint32_t aMacFrameCounter
)

Imposta il valore del contatore di frame MAC corrente.

Imposta sempre il contatore MAC sul nuovo valore specificato, aMacFrameCounter, indipendentemente dal valore corrente.

Dettagli
Parametri
[in] aInstance
Un puntatore a un'istanza OpenThread.
[in] aMacFrameCounter
Il valore del contatore di frame MAC.
Valori restituiti
OT_ERROR_NONE
In caso di esito positivo.
OT_ERROR_INVALID_STATE
Se il livello link non elaborato non è abilitato.

otLinkRawSetMacFrameCounterIfLarger

otError otLinkRawSetMacFrameCounterIfLarger(
  otInstance *aInstance,
  uint32_t aMacFrameCounter
)

Imposta il valore del contatore di frame MAC corrente solo se il nuovo valore è maggiore di quello attuale.

Dettagli
Parametri
[in] aInstance
Un puntatore a un'istanza OpenThread.
[in] aMacFrameCounter
Il valore del contatore di frame MAC.
Valori restituiti
OT_ERROR_NONE
In caso di esito positivo.
OT_ERROR_INVALID_STATE
Se il livello link non elaborato non è abilitato.

otLinkRawSetMacKey

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

Aggiorna le chiavi MAC e l'indice delle chiavi.

Dettagli
Parametri
[in] aInstance
Un puntatore a un'istanza OpenThread.
[in] aKeyIdMode
La modalità ID chiave.
[in] aKeyId
L'indice della chiave.
[in] aPrevKey
La chiave MAC precedente.
[in] aCurrKey
La chiave MAC corrente.
[in] aNextKey
La chiave MAC successiva.
Valori restituiti
OT_ERROR_NONE
In caso di esito positivo.
OT_ERROR_INVALID_STATE
Se il livello link non elaborato non è abilitato.

otLinkRawSetPromiscuous

otError otLinkRawSetPromiscuous(
  otInstance *aInstance,
  bool aEnable
)

Attiva o disattiva la modalità promiscuo.

Dettagli
Parametri
[in] aInstance
Un puntatore a un'istanza OpenThread.
[in] aEnable
Un valore per attivare o disattivare la modalità promiscuo.
Valori restituiti
OT_ERROR_NONE
In caso di esito positivo.
OT_ERROR_INVALID_STATE
Se il livello link non elaborato non è abilitato.

otLinkRawSetReceiveDone

otError otLinkRawSetReceiveDone(
  otInstance *aInstance,
  otLinkRawReceiveDone aCallback
)

Attiva/disattiva il livello link non elaborato.

Dettagli
Parametri
[in] aInstance
Un puntatore a un'istanza OpenThread.
[in] aCallback
Un puntatore a una funzione chiamata alla ricezione di un frame IEEE 802.15.4. NULL per disabilitare il livello di link non elaborato.
Valori restituiti
OT_ERROR_FAILED
Impossibile attivare/disattivare la radio.
OT_ERROR_INVALID_STATE
Se l'interfaccia IPv6 OpenThread è già abilitata.
OT_ERROR_NONE
Se lo stato di abilitazione è stato impostato correttamente.

otLinkRawSetShortAddress

otError otLinkRawSetShortAddress(
  otInstance *aInstance,
  uint16_t aShortAddress
)

Imposta l'indirizzo breve per il filtro degli indirizzi.

Dettagli
Parametri
[in] aInstance
Un puntatore a un'istanza OpenThread.
[in] aShortAddress
L'indirizzo breve IEEE 802.15.4.
Valori restituiti
OT_ERROR_NONE
In caso di esito positivo.
OT_ERROR_INVALID_STATE
Se il livello link non elaborato non è abilitato.

otLinkRawSleep

otError otLinkRawSleep(
  otInstance *aInstance
)

Passa dalla ricezione alla modalità Sonno.

Spegni la radio.

Dettagli
Parametri
[in] aInstance
Un puntatore a un'istanza OpenThread.
Valori restituiti
OT_ERROR_NONE
Transizione alla modalità Sonno eseguita correttamente.
OT_ERROR_BUSY
La radio stava trasmettendo
OT_ERROR_INVALID_STATE
La radio è stata disattivata

otLinkRawSrcMatchAddExtEntry

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

Aggiunta dell'indirizzo esteso alla tabella delle corrispondenze di origine.

Dettagli
Parametri
[in] aInstance
Un puntatore a un'istanza OpenThread.
[in] aExtAddress
L'indirizzo esteso da aggiungere.
Valori restituiti
OT_ERROR_NONE
L'indirizzo esteso è stato aggiunto alla tabella delle corrispondenze di origine.
OT_ERROR_NO_BUFS
Nessuna voce disponibile nella tabella delle corrispondenze di origine.
OT_ERROR_INVALID_STATE
Se il livello link non elaborato non è abilitato.

otLinkRawSrcMatchAddShortEntry

otError otLinkRawSrcMatchAddShortEntry(
  otInstance *aInstance,
  uint16_t aShortAddress
)

Aggiunta dell'indirizzo breve alla tabella delle corrispondenze di origine.

Dettagli
Parametri
[in] aInstance
Un puntatore a un'istanza OpenThread.
[in] aShortAddress
L'indirizzo breve da aggiungere.
Valori restituiti
OT_ERROR_NONE
Indirizzo breve aggiunto alla tabella delle corrispondenze di origine.
OT_ERROR_NO_BUFS
Nessuna voce disponibile nella tabella delle corrispondenze di origine.
OT_ERROR_INVALID_STATE
Se il livello link non elaborato non è abilitato.

otLinkRawSrcMatchClearExtEntries

otError otLinkRawSrcMatchClearExtEntries(
  otInstance *aInstance
)

Rimozione di tutti gli indirizzi estesi dalla tabella delle corrispondenze di origine.

Dettagli
Parametri
[in] aInstance
Un puntatore a un'istanza OpenThread.
Valori restituiti
OT_ERROR_NONE
In caso di esito positivo.
OT_ERROR_INVALID_STATE
Se il livello link non elaborato non è abilitato.

otLinkRawSrcMatchClearExtEntry

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

Rimozione dell'indirizzo esteso alla tabella delle corrispondenze di origine della radio.

Dettagli
Parametri
[in] aInstance
Un puntatore a un'istanza OpenThread.
[in] aExtAddress
L'indirizzo esteso da rimuovere.
Valori restituiti
OT_ERROR_NONE
L'indirizzo esteso dalla tabella delle corrispondenze di origine è stato rimosso correttamente.
OT_ERROR_NO_ADDRESS
L'indirizzo esteso non si trova nella tabella delle corrispondenze di origine.
OT_ERROR_INVALID_STATE
Se il livello link non elaborato non è abilitato.

otLinkRawSrcMatchClearShortEntries

otError otLinkRawSrcMatchClearShortEntries(
  otInstance *aInstance
)

Rimozione di tutti gli indirizzi brevi dalla tabella delle corrispondenze di origine.

Dettagli
Parametri
[in] aInstance
Un puntatore a un'istanza OpenThread.
Valori restituiti
OT_ERROR_NONE
In caso di esito positivo.
OT_ERROR_INVALID_STATE
Se il livello link non elaborato non è abilitato.

otLinkRawSrcMatchClearShortEntry

otError otLinkRawSrcMatchClearShortEntry(
  otInstance *aInstance,
  uint16_t aShortAddress
)

Rimozione dell'indirizzo breve nella tabella delle corrispondenze di origine.

Dettagli
Parametri
[in] aInstance
Un puntatore a un'istanza OpenThread.
[in] aShortAddress
L'indirizzo breve da rimuovere.
Valori restituiti
OT_ERROR_NONE
L'indirizzo breve è stato rimosso dalla tabella delle corrispondenze di origine.
OT_ERROR_NO_ADDRESS
L'indirizzo breve non si trova nella tabella delle corrispondenze di origine.
OT_ERROR_INVALID_STATE
Se il livello link non elaborato non è abilitato.

otLinkRawSrcMatchEnable

otError otLinkRawSrcMatchEnable(
  otInstance *aInstance,
  bool aEnable
)

Attiva/disattiva la corrispondenza dell'origine per il frame in attesa.

Dettagli
Parametri
[in] aInstance
Un puntatore a un'istanza OpenThread.
[in] aEnable
Attiva/disattiva la corrispondenza di origine per il frame in attesa.
Valori restituiti
OT_ERROR_NONE
In caso di esito positivo.
OT_ERROR_INVALID_STATE
Se il livello link non elaborato non è abilitato.

otLinkRawTransmit

otError otLinkRawTransmit(
  otInstance *aInstance,
  otLinkRawTransmitDone aCallback
)

Avvia la sequenza di trasmissione alla radio.

Prima di richiedere la trasmissione, il chiamante deve formare il frame IEEE 802.15.4 nel buffer fornito da otLinkRawGetTransmitBuffer(). Anche il canale e la potenza di trasmissione sono inclusi nella struttura otRadioFrame.

La sequenza di trasmissione è composta da:

  1. Transizione della radio in Trasmissione da Ricevi.
  2. Trasmette la PSDU sul canale e alla potenza di trasmissione specificata.

Dettagli
Parametri
[in] aInstance
Un puntatore a un'istanza OpenThread.
[in] aCallback
Un puntatore a una funzione chiamata al completamento della trasmissione.
Valori restituiti
OT_ERROR_NONE
Transizione eseguita correttamente.
OT_ERROR_INVALID_STATE
La radio non era in stato di ricezione.

Risorse

Gli argomenti di riferimento dell'API OpenThread provengono dal codice sorgente, disponibile su GitHub. Per saperne di più o per contribuire alla nostra documentazione, consulta la sezione Risorse.