Rilevamento dell'inceppamento

Questo modulo include funzioni per il rilevamento del blocco del segnale.

Riepilogo

Le funzioni in questo modulo sono disponibili quando è abilitata la funzionalità di rilevamento degli Jam (OPENTHREAD_CONFIG_JAM_DETECTION_ENABLE).

Defdef

otJamDetectionCallback)(bool aJamState, void *aContext) tipodef
void(*
Il puntatore di questa funzione viene chiamato se il rilevamento dell'ingorgo è attivato e viene rilevato un jam.

Functions

otJamDetectionGetBusyPeriod(otInstance *aInstance)
uint8_t
Periodo di attività del rilevamento di Jam (in secondi)
otJamDetectionGetHistoryBitmap(otInstance *aInstance)
uint64_t
Scarica la bitmap della cronologia corrente.
otJamDetectionGetRssiThreshold(otInstance *aInstance)
int8_t
Ottieni la soglia RSSI per il rilevamento di Jam (in dBm).
otJamDetectionGetState(otInstance *aInstance)
bool
Seleziona lo stato di rilevamento del Jam.
otJamDetectionGetWindow(otInstance *aInstance)
uint8_t
Visualizza la finestra di rilevamento del rilevamento di Jam (in secondi).
otJamDetectionIsEnabled(otInstance *aInstance)
bool
Conoscere lo stato di rilevamento del Jam (attivato/disattivato)
otJamDetectionSetBusyPeriod(otInstance *aInstance, uint8_t aBusyPeriod)
Imposta il periodo di attività per il rilevamento di Jam (in secondi).
otJamDetectionSetRssiThreshold(otInstance *aInstance, int8_t aRssiThreshold)
Imposta la soglia RSSI per il rilevamento di Jam (in dBm).
otJamDetectionSetWindow(otInstance *aInstance, uint8_t aWindow)
Imposta la finestra di rilevamento del rilevamento di Jam (in secondi).
otJamDetectionStart(otInstance *aInstance, otJamDetectionCallback aCallback, void *aContext)
Avvia il rilevamento dell'interruzione.
otJamDetectionStop(otInstance *aInstance)
Interrompi il rilevamento dell'interruzione.

Defdef

OtJamDetectionCallback

void(* otJamDetectionCallback)(bool aJamState, void *aContext)

Il puntatore di questa funzione viene chiamato se il rilevamento dell'ingorgo è attivato e viene rilevato un jam.

Dettagli
Parametri
[in] aJamState
Stato attuale del Jam (true se il Jam viene rilevato, false in caso contrario).
[in] aContext
Un puntatore sul contesto specifico dell'applicazione.

Functions

otJamDetectionGetBusyPeriod

uint8_t otJamDetectionGetBusyPeriod(
  otInstance *aInstance
)

Periodo di attività del rilevamento di Jam (in secondi)

Dettagli
Parametri
[in] aInstance
Un puntatore su un'istanza di OpenThread.
Restituisce
Il periodo di rilevamento del Jam.

otJamDetectionGetHistoryBitmap

uint64_t otJamDetectionGetHistoryBitmap(
  otInstance *aInstance
)

Scarica la bitmap della cronologia corrente.

Questo valore fornisce informazioni sullo stato attuale del modulo di rilevamento dell'inceppamento ai fini del monitoraggio e del debug. Restituisce un valore di 64 bit in cui ogni bit corrisponde a un intervallo di un secondo che inizia con il bit 0 per l'intervallo più recente e con il bit 63 per gli intervalli meno recenti (63 sec prima). Il bit è impostato su 1 se il modulo di rilevamento dell'inceppamento è stato rilevato/rilevato con un livello di segnale elevato durante l'intervallo corrispondente di un secondo.

Dettagli
Parametri
[in] aInstance
Un puntatore su un'istanza di OpenThread.
Restituisce
La bitmap della cronologia corrente.

otJamDetectionGetRssiThreshold

int8_t otJamDetectionGetRssiThreshold(
  otInstance *aInstance
)

Ottieni la soglia RSSI per il rilevamento di Jam (in dBm).

Dettagli
Parametri
[in] aInstance
Un puntatore su un'istanza di OpenThread.
Restituisce
La soglia RSSI per il rilevamento degli Jam.

otJamDetectionGetState

bool otJamDetectionGetState(
  otInstance *aInstance
)

Seleziona lo stato di rilevamento del Jam.

Dettagli
Parametri
[in] aInstance
Un puntatore su un'istanza di OpenThread.
Restituisce
Lo stato di rilevamento del Jam (è stato rilevato true jam, `false' altrimenti).

OtJamDetectionGetWindow

uint8_t otJamDetectionGetWindow(
  otInstance *aInstance
)

Visualizza la finestra di rilevamento del rilevamento di Jam (in secondi).

Dettagli
Parametri
[in] aInstance
Un puntatore su un'istanza di OpenThread.
Restituisce
Finestra di rilevamento dei Jam.

otJamDetectionIsEnabled

bool otJamDetectionIsEnabled(
  otInstance *aInstance
)

Conoscere lo stato di rilevamento del Jam (attivato/disattivato)

Dettagli
Parametri
[in] aInstance
Un puntatore su un'istanza di OpenThread.
Restituisce
Lo stato di rilevamento del Jam (true se abilitato, false negli altri casi).

otJamDetectionSetBusyPeriod

otError otJamDetectionSetBusyPeriod(
  otInstance *aInstance,
  uint8_t aBusyPeriod
)

Imposta il periodo di attività per il rilevamento di Jam (in secondi).

Il numero di secondi aggregati all'interno della finestra di rilevamento in cui il codice RSSI deve essere superiore alla soglia per attivare il rilevamento.

Dettagli
Parametri
[in] aInstance
Un puntatore su un'istanza di OpenThread.
[in] aBusyPeriod
Il periodo di rilevamento del Jam (deve essere diverso da zero e inferiore o uguale alla finestra di rilevamento del Jam)
Valori di ritorno
OT_ERROR_NONE
Impostazione della finestra riuscita.
OT_ERROR_INVALID_ARGS
Il valore specificato non rientra nell'intervallo valido.

otJamDetectionSetRssiThreshold

otError otJamDetectionSetRssiThreshold(
  otInstance *aInstance,
  int8_t aRssiThreshold
)

Imposta la soglia RSSI per il rilevamento di Jam (in dBm).

Dettagli
Parametri
[in] aInstance
Un puntatore su un'istanza di OpenThread.
[in] aRssiThreshold
La soglia RSSI.
Valori di ritorno
OT_ERROR_NONE
Impostazione della soglia riuscita.

OtJamDetectionSetWindow

otError otJamDetectionSetWindow(
  otInstance *aInstance,
  uint8_t aWindow
)

Imposta la finestra di rilevamento del rilevamento di Jam (in secondi).

Dettagli
Parametri
[in] aInstance
Un puntatore su un'istanza di OpenThread.
[in] aWindow
Finestra di rilevamento dei Jam (intervallo valido compreso tra 1 e 63)
Valori di ritorno
OT_ERROR_NONE
Impostazione della finestra riuscita.
OT_ERROR_INVALID_ARGS
Il parametro di input specificato non rientra nell'intervallo valido (1-63)

otJamDetectionStart

otError otJamDetectionStart(
  otInstance *aInstance,
  otJamDetectionCallback aCallback,
  void *aContext
)

Avvia il rilevamento dell'interruzione.

Dettagli
Parametri
[in] aInstance
Un puntatore su un'istanza di OpenThread.
[in] aCallback
Un puntatore su una funzione chiamata per notificare una modifica dello stato di interruzione.
[in] aContext
Un puntatore sul contesto specifico dell'applicazione.
Valori di ritorno
OT_ERROR_NONE
Rilevamento del blocco iniziato.
OT_ERROR_ALREADY
Il rilevamento dei Jam è già stato avviato.

otJamDetectionStop

otError otJamDetectionStop(
  otInstance *aInstance
)

Interrompi il rilevamento dell'interruzione.

Dettagli
Parametri
[in] aInstance
Un puntatore su un'istanza di OpenThread.
Valori di ritorno
OT_ERROR_NONE
Rilevamento del blocco interrotto.
OT_ERROR_ALREADY
Rilevamento del Jam già interrotto.

Risorse

Gli argomenti di riferimento per l'API OpenThread provengono dal codice sorgente, disponibile su GitHub. Per ulteriori informazioni o per contribuire alla nostra documentazione, consulta la sezione Risorse.