Questa pagina è stata tradotta dall'API Cloud Translation.

Rilevamento inceppamenti

Questo modulo include funzioni per la funzionalità di rilevamento dell'interferenza tra i segnali.

Riepilogo

Le funzioni in questo modulo sono disponibili quando la funzionalità di rilevamento di inceppamenti è attiva (OPENTHREAD_CONFIG_JAM_DETECTION_ENABLE).

Typedef
`otJamDetectionCallback)(bool aJamState, void *aContext)`	typedef `void(*` Il puntatore viene chiamato se il rilevamento dell'inceppamento del segnale è attivo e viene rilevato un inceppamento.

Funzioni
`otJamDetectionGetBusyPeriod(otInstance *aInstance)`	`uint8_t` Attiva il periodo di rilevamento dei Jam (in secondi)
`otJamDetectionGetHistoryBitmap(otInstance *aInstance)`	`uint64_t` Visualizza la bitmap della cronologia attuale.
`otJamDetectionGetRssiThreshold(otInstance *aInstance)`	`int8_t` Ottieni la soglia RSSI per il rilevamento dei blocchi (in dBm).
`otJamDetectionGetState(otInstance *aInstance)`	`bool` Ottieni lo stato di rilevamento dei Jam.
`otJamDetectionGetWindow(otInstance *aInstance)`	`uint8_t` Accedi alla finestra di rilevamento dei blocchi (in secondi).
`otJamDetectionIsEnabled(otInstance *aInstance)`	`bool` Conoscere lo stato del rilevamento dei Jam (attivato/disattivato)
`otJamDetectionSetBusyPeriod(otInstance *aInstance, uint8_t aBusyPeriod)`	`otError` Imposta il periodo di tempo per il rilevamento dei Jam (in secondi).
`otJamDetectionSetRssiThreshold(otInstance *aInstance, int8_t aRssiThreshold)`	`otError` Imposta la soglia RSSI per il rilevamento dei blocchi (in dBm).
`otJamDetectionSetWindow(otInstance *aInstance, uint8_t aWindow)`	`otError` Imposta la finestra di rilevamento del rilevamento dei blocchi (in secondi).
`otJamDetectionStart(otInstance aInstance, otJamDetectionCallback aCallback, void aContext)`	`otError` Avvia il rilevamento jamming.
`otJamDetectionStop(otInstance *aInstance)`	`otError` Interrompi il rilevamento di jamming.

Typedef

otJamDetectionCallback

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

Il puntatore viene chiamato se il rilevamento dell'inceppamento del segnale è attivo e viene rilevato un inceppamento.

Dettagli

Parametri

`[in] aJamState`	Stato attuale del Jam (`true` se viene rilevato un Jam, `false` in caso contrario).
`[in] aContext`	Un puntatore al contesto specifico dell'applicazione.

Funzioni

otJamDetectionGetBusyPeriod

uint8_t otJamDetectionGetBusyPeriod(
  otInstance *aInstance
)

Attiva il periodo di rilevamento dei Jam (in secondi)

Dettagli

Parametri

[in] aInstance

Un puntatore a un'istanza OpenThread.

Restituisce

Il periodo di attività durante il rilevamento dei Jam.

otJamDetectionGetHistoryBitmap

uint64_t otJamDetectionGetHistoryBitmap(
  otInstance *aInstance
)

Visualizza la bitmap della cronologia attuale.

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

Dettagli

Parametri

[in] aInstance

Un puntatore a un'istanza OpenThread.

Restituisce

La bitmap della cronologia attuale.

otJamDetectionGetRssiThreshold

int8_t otJamDetectionGetRssiThreshold(
  otInstance *aInstance
)

Ottieni la soglia RSSI per il rilevamento dei blocchi (in dBm).

Dettagli

Parametri

[in] aInstance

Un puntatore a un'istanza OpenThread.

Restituisce

La soglia RSSI per il rilevamento dei Jam.

otJamDetectionGetState

bool otJamDetectionGetState(
  otInstance *aInstance
)

Ottieni lo stato di rilevamento dei Jam.

Dettagli

Parametri

[in] aInstance

Un puntatore a un'istanza OpenThread.

Restituisce

Lo stato di rilevamento del Jam (true jam rilevato, altrimenti "false").

otJamDetectionGetWindow

uint8_t otJamDetectionGetWindow(
  otInstance *aInstance
)

Accedi alla finestra di rilevamento dei blocchi (in secondi).

Dettagli

Parametri

[in] aInstance

Un puntatore a un'istanza OpenThread.

Restituisce

La finestra di rilevamento dei blocchi.

otJamDetectionIsEnabled

bool otJamDetectionIsEnabled(
  otInstance *aInstance
)

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

Dettagli

Parametri

[in] aInstance

Un puntatore a un'istanza OpenThread.

Restituisce

Lo stato di rilevamento dei Jam (true se attivato, falso in caso contrario).

otJamDetectionSetBusyPeriod

otError otJamDetectionSetBusyPeriod(
  otInstance *aInstance,
  uint8_t aBusyPeriod
)

Imposta il periodo di tempo per il rilevamento dei Jam (in secondi).

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

Dettagli

Parametri

`[in] aInstance`	Un puntatore a un'istanza OpenThread.
`[in] aBusyPeriod`	Il periodo di occupato per il rilevamento dei Jam (deve essere diverso da zero e inferiore o uguale alla finestra di rilevamento dei Jam)

Valori restituiti

`OT_ERROR_NONE`	Finestra impostata correttamente.
`OT_ERROR_INVALID_ARGS`	Il valore immesso non è compreso nell'intervallo valido.

otJamDetectionSetRssiThreshold

otError otJamDetectionSetRssiThreshold(
  otInstance *aInstance,
  int8_t aRssiThreshold
)

Imposta la soglia RSSI per il rilevamento dei blocchi (in dBm).

Dettagli

Parametri

`[in] aInstance`	Un puntatore a un'istanza OpenThread.
`[in] aRssiThreshold`	La soglia RSSI.

Valori restituiti

OT_ERROR_NONE

Soglia impostata correttamente.

otJamDetectionSetWindow

otError otJamDetectionSetWindow(
  otInstance *aInstance,
  uint8_t aWindow
)

Imposta la finestra di rilevamento del rilevamento dei blocchi (in secondi).

Dettagli

Parametri

`[in] aInstance`	Un puntatore a un'istanza OpenThread.
`[in] aWindow`	Finestra di rilevamento dei blocchi (l'intervallo valido è compreso tra 1 e 63)

Valori restituiti

`OT_ERROR_NONE`	Finestra impostata correttamente.
`OT_ERROR_INVALID_ARGS`	Il parametro di input specificato non è compreso nell'intervallo valido (1-63)

otJamDetectionStart

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

Avvia il rilevamento jamming.

Dettagli

Parametri

`[in] aInstance`	Un puntatore a un'istanza OpenThread.
`[in] aCallback`	Un puntatore a una funzione chiamata per notificare la modifica dello stato di jamming.
`[in] aContext`	Un puntatore al contesto specifico dell'applicazione.

Valori restituiti

`OT_ERROR_NONE`	Rilevamento jamming avviato.
`OT_ERROR_ALREADY`	Il rilevamento dei Jam è già stato avviato.

otJamDetectionStop

otError otJamDetectionStop(
  otInstance *aInstance
)

Interrompi il rilevamento di jamming.

Dettagli

Parametri

[in] aInstance

Un puntatore a un'istanza OpenThread.

Valori restituiti

`OT_ERROR_NONE`	Rilevamento di jamming interrotto correttamente.
`OT_ERROR_ALREADY`	Il rilevamento dei Jam è già stato interrotto.

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.