Questa pagina è stata tradotta dall'API Cloud Translation.

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)`	`otError` Imposta il periodo di attività per il rilevamento di Jam (in secondi).
`otJamDetectionSetRssiThreshold(otInstance *aInstance, int8_t aRssiThreshold)`	`otError` Imposta la soglia RSSI per il rilevamento di Jam (in dBm).
`otJamDetectionSetWindow(otInstance *aInstance, uint8_t aWindow)`	`otError` Imposta la finestra di rilevamento del rilevamento di Jam (in secondi).
`otJamDetectionStart(otInstance aInstance, otJamDetectionCallback aCallback, void aContext)`	`otError` Avvia il rilevamento dell'interruzione.
`otJamDetectionStop(otInstance *aInstance)`	`otError` 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.