Raw Link

Questo modulo include funzioni che controllano la configurazione del livello di collegamento grezzo.

Sommario

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

Funzioni
`otLinkRawEnergyScan ( otInstance *aInstance, uint8_t aScanChannel, uint16_t aScanDuration, otLinkRawEnergyScanDone aCallback)`	`otError` Questo metodo avvia la sequenza di scansione dell'energia sulla radio.
`otLinkRawGetCaps ( otInstance *aInstance)`	`otRadioCaps` Ottieni le funzionalità radio.
`otLinkRawGetPromiscuous ( otInstance *aInstance)`	`bool` Questa funzione ottiene lo stato di modalità promiscua.
`otLinkRawGetRadioTime ( otInstance *aInstance)`	`uint64_t` Ottieni il tempo di piattaforma corrente (larghezza 64 bit) del chip radio.
`otLinkRawGetRssi ( otInstance *aInstance)`	`int8_t` Ottieni la misurazione RSSI più recente.
`otLinkRawGetTransmitBuffer ( otInstance *aInstance)`	`otRadioFrame *` La radio passa da Trasmissione a Ricezione.
`otLinkRawIsEnabled ( otInstance *aInstance)`	`bool` Questa funzione indica se il livello di collegamento grezzo è abilitato o meno.
`otLinkRawReceive ( otInstance *aInstance)`	`otError` Transizione della radio dallo stato di sospensione alla ricezione.
`otLinkRawSetMacFrameCounter ( otInstance *aInstance, uint32_t aMacFrameCounter)`	`otError` Imposta il valore corrente del contatore di frame MAC.
`otLinkRawSetMacKey ( otInstance aInstance, uint8_t aKeyIdMode, uint8_t aKeyId, const otMacKey aPrevKey, const otMacKey aCurrKey, const otMacKey aNextKey)`	`otError` Aggiorna le chiavi MAC e l'indice delle chiavi.
`otLinkRawSetPromiscuous ( otInstance *aInstance, bool aEnable)`	`otError` Questa funzione abilita o disabilita la modalità promiscua.
`otLinkRawSetReceiveDone ( otInstance *aInstance, otLinkRawReceiveDone aCallback)`	`otError` Questa funzione abilita / disabilita il livello di collegamento grezzo.
`otLinkRawSetShortAddress ( otInstance *aInstance, uint16_t aShortAddress)`	`otError` Imposta l'indirizzo breve per il filtraggio degli indirizzi.
`otLinkRawSleep ( otInstance *aInstance)`	`otError` Transizione della radio da Ricevi a Sospensione.
`otLinkRawSrcMatchAddExtEntry ( otInstance aInstance, const otExtAddress aExtAddress)`	`otError` Aggiunta di un indirizzo esteso alla tabella delle corrispondenze di origine.
`otLinkRawSrcMatchAddShortEntry ( otInstance *aInstance, uint16_t aShortAddress)`	`otError` Aggiunta di un indirizzo breve alla tabella delle corrispondenze di origine.
`otLinkRawSrcMatchClearExtEntries ( otInstance *aInstance)`	`otError` Rimozione di tutti gli indirizzi estesi dalla tabella delle corrispondenze di origine.
`otLinkRawSrcMatchClearExtEntry ( otInstance aInstance, const otExtAddress aExtAddress)`	`otError` Rimozione dell'indirizzo esteso dalla tabella delle corrispondenze di origine della radio.
`otLinkRawSrcMatchClearShortEntries ( otInstance *aInstance)`	`otError` Rimozione di tutti gli indirizzi brevi dalla tabella delle corrispondenze di origine.
`otLinkRawSrcMatchClearShortEntry ( otInstance *aInstance, uint16_t aShortAddress)`	`otError` Rimozione dell'indirizzo breve dalla tabella delle corrispondenze di origine.
`otLinkRawSrcMatchEnable ( otInstance *aInstance, bool aEnable)`	`otError` Abilita / disabilita la corrispondenza della sorgente per il frame in sospeso.
`otLinkRawTransmit ( otInstance *aInstance, otLinkRawTransmitDone aCallback)`	`otError` Questo metodo avvia la sequenza di trasmissione sulla radio.

Typedef

otLinkRawEnergyScanDone

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

Questo puntatore alla funzione alla ricezione di un frame IEEE 802.15.4.

Dettagli

Parametri

`[in] aInstance`	Puntatore a un'istanza di OpenThread.
`[in] aEnergyScanMaxRssi`	L'RSSI massimo riscontrato sul canale scansionato.

otLinkRawReceiveDone

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

Questo puntatore alla funzione alla ricezione di un frame IEEE 802.15.4.

Dettagli

Parametri

`[in] aInstance`	Puntatore a un'istanza di OpenThread.
`[in] aFrame`	Un puntatore al frame ricevuto o NULL se l'operazione di ricezione è stata interrotta.
`[in] aError`	OT_ERROR_NONE quando ha ricevuto con successo 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)

Questo puntatore alla funzione alla ricezione di un frame IEEE 802.15.4.

Dettagli

Parametri

`[in] aInstance`	Puntatore a un'istanza di OpenThread.
`[in] aFrame`	Un puntatore al frame che è stato 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 alcun ACK OT_ERROR_CHANNEL_ACCESS_FAILURE quando la trasmissione non è stata possibile a causa dell'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
)

Questo metodo avvia la sequenza di scansione dell'energia sulla radio.

Dettagli

Parametri

`[in] aInstance`	Puntatore a un'istanza di 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 scansionato.

Valori restituiti

`OT_ERROR_NONE`	Avviata con successo la scansione del canale.
`OT_ERROR_NOT_IMPLEMENTED`	La radio non supporta la scansione energetica.
`OT_ERROR_INVALID_STATE`	Se il livello di collegamento grezzo non è abilitato.

otLinkRawGetCaps

otRadioCaps otLinkRawGetCaps(
  otInstance *aInstance
)

Ottieni le funzionalità radio.

Dettagli

Parametri

[in] aInstance

Puntatore a un'istanza di OpenThread.

ritorna

Il vettore di bit di capacità radio. Lo stack abilita o disabilita alcune funzioni in base a questo valore.

otLinkRawGetPromiscuous

bool otLinkRawGetPromiscuous(
  otInstance *aInstance
)

Questa funzione ottiene lo stato di modalità promiscua.

Dettagli

Parametri

[in] aInstance

Puntatore a un'istanza di OpenThread.

Valori restituiti

`true`	La modalità promiscua è abilitata.
`false`	La modalità promiscua è disabilitata.

otLinkRawGetRadioTime

uint64_t otLinkRawGetRadioTime(
  otInstance *aInstance
)

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

Dettagli

Parametri

[in] aInstance

Puntatore a un'istanza di OpenThread.

ritorna

L'ora della radio corrente in microsecondi.

otLinkRawGetRssi

int8_t otLinkRawGetRssi(
  otInstance *aInstance
)

Ottieni la misurazione RSSI più recente.

Dettagli

Parametri

[in] aInstance

Puntatore a un'istanza di OpenThread.

ritorna

L'RSSI in dBm quando è valido. 127 quando RSSI non è valido.

otLinkRawGetTransmitBuffer

otRadioFrame * otLinkRawGetTransmitBuffer(
  otInstance *aInstance
)

La radio passa da Trasmissione a Ricezione.

Questo metodo 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

Puntatore a un'istanza di OpenThread.

ritorna

Un puntatore al buffer di trasmissione o NULL se il livello di collegamento non elaborato non è abilitato.

otLinkRawIsEnabled

bool otLinkRawIsEnabled(
  otInstance *aInstance
)

Questa funzione indica se il livello di collegamento grezzo è abilitato o meno.

Dettagli

Parametri

[in] aInstance

Puntatore a un'istanza di OpenThread.

Valori restituiti

`true`	Il livello di collegamento grezzo è abilitato.
`false`	Il livello di collegamento grezzo è disabilitato.

otLinkRawReceive

otError otLinkRawReceive(
  otInstance *aInstance
)

Transizione della radio dallo stato di sospensione alla ricezione.

Accendi la radio.

Dettagli

Parametri

[in] aInstance

Puntatore a un'istanza di OpenThread.

Valori restituiti

`OT_ERROR_NONE`	Transito con successo a Ricevi.
`OT_ERROR_INVALID_STATE`	La radio era disattivata o stava trasmettendo.

otLinkRawSetMacFrameCounter

otError otLinkRawSetMacFrameCounter(
  otInstance *aInstance,
  uint32_t aMacFrameCounter
)

Imposta il valore corrente del contatore di frame MAC.

Dettagli

Parametri

`[in] aInstance`	Puntatore a un'istanza di OpenThread.
`[in] aMacFrameCounter`	Il valore del contatore di frame MAC.

Valori restituiti

`OT_ERROR_NONE`	In caso di successo.
`OT_ERROR_INVALID_STATE`	Se il livello di collegamento grezzo 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`	Puntatore a un'istanza di OpenThread.
`[in] aKeyIdMode`	La modalità ID chiave.
`[in] aKeyId`	L'indice chiave.
`[in] aPrevKey`	La chiave MAC precedente.
`[in] aCurrKey`	La chiave MAC corrente.
`[in] aNextKey`	La prossima chiave MAC.

Valori restituiti

`OT_ERROR_NONE`	In caso di successo.
`OT_ERROR_INVALID_STATE`	Se il livello di collegamento grezzo non è abilitato.

otLinkRawSetPromiscuous

otError otLinkRawSetPromiscuous(
  otInstance *aInstance,
  bool aEnable
)

Questa funzione abilita o disabilita la modalità promiscua.

Dettagli

Parametri

`[in] aInstance`	Puntatore a un'istanza di OpenThread.
`[in] aEnable`	Un valore per abilitare o disabilitare la modalità promiscua.

Valori restituiti

`OT_ERROR_NONE`	In caso di successo.
`OT_ERROR_INVALID_STATE`	Se il livello di collegamento grezzo non è abilitato.

otLinkRawSetReceiveDone

otError otLinkRawSetReceiveDone(
  otInstance *aInstance,
  otLinkRawReceiveDone aCallback
)

Questa funzione abilita / disabilita il livello di collegamento grezzo.

Dettagli

Parametri

`[in] aInstance`	Puntatore a un'istanza di OpenThread.
`[in] aCallback`	Puntatore a una funzione chiamata alla ricezione di un frame IEEE 802.15.4. NULL per disabilitare il livello di collegamento non elaborato.

Valori restituiti

`OT_ERROR_FAILED`	La radio non può essere abilitata / disabilitata.
`OT_ERROR_INVALID_STATE`	Se l'interfaccia OpenThread Ip6 è 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 filtraggio degli indirizzi.

Dettagli

Parametri

`[in] aInstance`	Puntatore a un'istanza di OpenThread.
`[in] aShortAddress`	L'indirizzo breve IEEE 802.15.4.

Valori restituiti

`OT_ERROR_NONE`	In caso di successo.
`OT_ERROR_INVALID_STATE`	Se il livello di collegamento grezzo non è abilitato.

otLinkRawSleep

otError otLinkRawSleep(
  otInstance *aInstance
)

Transizione della radio da Ricevi a Sospensione.

Spegni la radio.

Dettagli

Parametri

[in] aInstance

Puntatore a un'istanza di OpenThread.

Valori restituiti

`OT_ERROR_NONE`	Transizione riuscita a Sleep.
`OT_ERROR_BUSY`	La radio stava trasmettendo
`OT_ERROR_INVALID_STATE`	La radio è stata disattivata

otLinkRawSrcMatchAddExtEntry

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

Aggiunta di un indirizzo esteso alla tabella delle corrispondenze di origine.

Dettagli

Parametri

`[in] aInstance`	Puntatore a un'istanza di OpenThread.
`[in] aExtAddress`	L'indirizzo esteso da aggiungere.

Valori restituiti

`OT_ERROR_NONE`	Indirizzo esteso aggiunto con successo 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 di collegamento grezzo non è abilitato.

otLinkRawSrcMatchAddShortEntry

otError otLinkRawSrcMatchAddShortEntry(
  otInstance *aInstance,
  uint16_t aShortAddress
)

Aggiunta di un indirizzo breve alla tabella delle corrispondenze di origine.

Dettagli

Parametri

`[in] aInstance`	Puntatore a un'istanza di OpenThread.
`[in] aShortAddress`	L'indirizzo breve da aggiungere.

Valori restituiti

`OT_ERROR_NONE`	Indirizzo breve aggiunto con successo 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 di collegamento grezzo non è abilitato.

otLinkRawSrcMatchClearExtEntries

otError otLinkRawSrcMatchClearExtEntries(
  otInstance *aInstance
)

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

Dettagli

Parametri

[in] aInstance

Puntatore a un'istanza di OpenThread.

Valori restituiti

`OT_ERROR_NONE`	In caso di successo.
`OT_ERROR_INVALID_STATE`	Se il livello di collegamento grezzo non è abilitato.

otLinkRawSrcMatchClearExtEntry

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

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

Dettagli

Parametri

`[in] aInstance`	Puntatore a un'istanza di OpenThread.
`[in] aExtAddress`	L'indirizzo esteso da rimuovere.

Valori restituiti

`OT_ERROR_NONE`	Rimosso con successo l'indirizzo esteso dalla tabella delle corrispondenze di origine.
`OT_ERROR_NO_ADDRESS`	L'indirizzo esteso non è nella tabella delle corrispondenze di origine.
`OT_ERROR_INVALID_STATE`	Se il livello di collegamento grezzo non è abilitato.

otLinkRawSrcMatchClearShortEntries

otError otLinkRawSrcMatchClearShortEntries(
  otInstance *aInstance
)

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

Dettagli

Parametri

[in] aInstance

Puntatore a un'istanza di OpenThread.

Valori restituiti

`OT_ERROR_NONE`	In caso di successo.
`OT_ERROR_INVALID_STATE`	Se il livello di collegamento grezzo non è abilitato.

otLinkRawSrcMatchClearShortEntry

otError otLinkRawSrcMatchClearShortEntry(
  otInstance *aInstance,
  uint16_t aShortAddress
)

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

Dettagli

Parametri

`[in] aInstance`	Puntatore a un'istanza di OpenThread.
`[in] aShortAddress`	L'indirizzo breve da rimuovere.

Valori restituiti

`OT_ERROR_NONE`	Indirizzo breve rimosso con successo dalla tabella delle corrispondenze di origine.
`OT_ERROR_NO_ADDRESS`	L'indirizzo breve non è nella tabella delle corrispondenze di origine.
`OT_ERROR_INVALID_STATE`	Se il livello di collegamento grezzo non è abilitato.

otLinkRawSrcMatchEnable

otError otLinkRawSrcMatchEnable(
  otInstance *aInstance,
  bool aEnable
)

Abilita / disabilita la corrispondenza della sorgente per il frame in sospeso.

Dettagli

Parametri

`[in] aInstance`	Puntatore a un'istanza di OpenThread.
`[in] aEnable`	Abilita / disabilita la corrispondenza della sorgente per il frame in sospeso.

Valori restituiti

`OT_ERROR_NONE`	In caso di successo.
`OT_ERROR_INVALID_STATE`	Se il livello di collegamento grezzo non è abilitato.

otLinkRawTransmit

otError otLinkRawTransmit(
  otInstance *aInstance,
  otLinkRawTransmitDone aCallback
)

Questo metodo avvia la sequenza di trasmissione sulla radio.

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

La sequenza di trasmissione consiste in:

Transizione della radio alla trasmissione dalla ricezione.
Trasmette la PSDU sul canale dato e alla potenza di trasmissione data.

Dettagli

Parametri

`[in] aInstance`	Puntatore a un'istanza di OpenThread.
`[in] aCallback`	Un puntatore a una funzione chiamata al termine della trasmissione.

Valori restituiti

`OT_ERROR_NONE`	Transmit riuscito a Transmit.
`OT_ERROR_INVALID_STATE`	La radio non era nello stato di ricezione.