Diagnostica di fabbrica - Piattaforma

Questo modulo include l'astrazione della piattaforma per le funzionalità di diagnostica.

Riepilogo

Enumerazioni

otGpioMode{
  OT_GPIO_MODE_INPUT = 0,
  OT_GPIO_MODE_OUTPUT = 1
}
enum
Definisce le modalità gpio.

Funzioni

otPlatDiagAlarmCallback(otInstance *aInstance)
void
Elabora l'evento di allarme.
otPlatDiagChannelSet(uint8_t aChannel)
void
Imposta il canale da utilizzare per la diagnostica di fabbrica.
otPlatDiagGpioGet(uint32_t aGpio, bool *aValue)
Restituisce il valore gpio.
otPlatDiagGpioGetMode(uint32_t aGpio, otGpioMode *aMode)
Ottieni la modalità gpio.
otPlatDiagGpioSet(uint32_t aGpio, bool aValue)
Imposta il valore gpio.
otPlatDiagGpioSetMode(uint32_t aGpio, otGpioMode aMode)
Imposta la modalità gpio.
otPlatDiagModeGet(void)
bool
Indica se è attiva o meno la modalità diagnostica di fabbrica.
otPlatDiagModeSet(bool aMode)
void
Attiva/disattiva la modalità diagnostica di fabbrica.
otPlatDiagProcess(otInstance *aInstance, uint8_t aArgsLength, char *aArgs[], char *aOutput, size_t aOutputMaxLen)
Consente di elaborare una riga di comando per la diagnostica di fabbrica.
otPlatDiagRadioGetPowerSettings(otInstance *aInstance, uint8_t aChannel, int16_t *aTargetPower, int16_t *aActualPower, uint8_t *aRawPowerSetting, uint16_t *aRawPowerSettingLength)
Verifica le impostazioni di accensione del canale.
otPlatDiagRadioGetRawPowerSetting(otInstance *aInstance, uint8_t *aRawPowerSetting, uint16_t *aRawPowerSettingLength)
Scarica l'impostazione di alimentazione non elaborata della radio per il modulo di diagnostica.
otPlatDiagRadioRawPowerSettingEnable(otInstance *aInstance, bool aEnable)
Abilita/disabilita il livello della piattaforma per utilizzare l'impostazione di potenza non elaborata impostata da otPlatDiagRadioSetRawPowerSetting().
otPlatDiagRadioReceived(otInstance *aInstance, otRadioFrame *aFrame, otError aError)
void
Elabora il frame radio ricevuto.
otPlatDiagRadioSetRawPowerSetting(otInstance *aInstance, const uint8_t *aRawPowerSetting, uint16_t aRawPowerSettingLength)
Imposta l'impostazione di alimentazione non elaborata della radio per il modulo di diagnostica.
otPlatDiagRadioTransmitCarrier(otInstance *aInstance, bool aEnable)
Avvia/interrompi il livello della piattaforma per trasmettere un'onda portante continua.
otPlatDiagRadioTransmitStream(otInstance *aInstance, bool aEnable)
Avvia/interrompi il livello della piattaforma per trasmettere il flusso di caratteri.
otPlatDiagTxPowerSet(int8_t aTxPower)
void
Imposta la potenza di trasmissione da utilizzare per la diagnostica di fabbrica.

Enumerazioni

otGpioMode

 otGpioMode

Definisce le modalità gpio.

Proprietà
OT_GPIO_MODE_INPUT

Modalità di ingresso senza resistenza di pull.

OT_GPIO_MODE_OUTPUT

Modalità di output.

Funzioni

otPlatDiagAlarmCallback

void otPlatDiagAlarmCallback(
  otInstance *aInstance
)

Elabora l'evento di allarme.

Dettagli
Parametri
[in] aInstance
L'istanza OpenThread per la richiesta attuale.

otPlatDiagChannelSet

void otPlatDiagChannelSet(
  uint8_t aChannel
)

Imposta il canale da utilizzare per la diagnostica di fabbrica.

Dettagli
Parametri
[in] aChannel
Il valore del canale.

otPlatDiagGpioGet

otError otPlatDiagGpioGet(
  uint32_t aGpio,
  bool *aValue
)

Restituisce il valore gpio.

Dettagli
Parametri
[in] aGpio
Il numero gpio.
[out] aValue
Un puntatore in cui inserire il valore gpio.
Valori restituiti
OT_ERROR_NONE
Valore gpio ottenuto.
OT_ERROR_FAILED
Si è verificato un errore della piattaforma durante il recupero del valore gpio.
OT_ERROR_INVALID_ARGS
aGpio non è supportato oppure aValue è NULL.
OT_ERROR_INVALID_STATE
La modalità diagnostica non è stata attivata o aGpio non è configurato come input.
OT_ERROR_NOT_IMPLEMENTED
Questa funzione non è implementata o configurata sulla piattaforma.

otPlatDiagGpioGetMode

otError otPlatDiagGpioGetMode(
  uint32_t aGpio,
  otGpioMode *aMode
)

Ottieni la modalità gpio.

Dettagli
Parametri
[in] aGpio
Il numero gpio.
[out] aMode
Un puntatore a cui attivare la modalità gpio.
Valori restituiti
OT_ERROR_NONE
Modalità gpio ottenuta.
OT_ERROR_FAILED
La modalità restituita dalla piattaforma non è implementata in OpenThread oppure si è verificato un errore della piattaforma durante l'accesso alla modalità gpio.
OT_ERROR_INVALID_ARGS
aGpio non è supportato oppure aMode è NULL.
OT_ERROR_INVALID_STATE
Modalità diagnostica non attivata.
OT_ERROR_NOT_IMPLEMENTED
Questa funzione non è implementata o configurata sulla piattaforma.

otPlatDiagGpioSet

otError otPlatDiagGpioSet(
  uint32_t aGpio,
  bool aValue
)

Imposta il valore gpio.

Dettagli
Parametri
[in] aGpio
Il numero gpio.
[in] aValue
true per impostare gpio ad alto livello o false in caso contrario.
Valori restituiti
OT_ERROR_NONE
gpio impostato.
OT_ERROR_FAILED
Si è verificato un errore della piattaforma durante l'impostazione di gpio.
OT_ERROR_INVALID_ARGS
L'aGpio non è supportato.
OT_ERROR_INVALID_STATE
La modalità diagnostica non è stata attivata o aGpio non è configurato come output.
OT_ERROR_NOT_IMPLEMENTED
Questa funzione non è implementata o configurata sulla piattaforma.

otPlatDiagGpioSetMode

otError otPlatDiagGpioSetMode(
  uint32_t aGpio,
  otGpioMode aMode
)

Imposta la modalità gpio.

Dettagli
Parametri
[in] aGpio
Il numero gpio.
[out] aMode
La modalità gpio.
Valori restituiti
OT_ERROR_NONE
Modalità gpio impostata.
OT_ERROR_FAILED
Si è verificato un errore della piattaforma durante l'impostazione della modalità gpio.
OT_ERROR_INVALID_ARGS
aGpio o aMode non sono supportati.
OT_ERROR_INVALID_STATE
Modalità diagnostica non attivata.
OT_ERROR_NOT_IMPLEMENTED
Questa funzione non è implementata o configurata sulla piattaforma.

otPlatDiagModeGet

bool otPlatDiagModeGet(
  void
)

Indica se è attiva o meno la modalità diagnostica di fabbrica.

Dettagli
Restituisce
TRUE se è abilitata la modalità diagnostica di fabbrica, FALSE in caso contrario.

otPlatDiagModeSet

void otPlatDiagModeSet(
  bool aMode
)

Attiva/disattiva la modalità diagnostica di fabbrica.

Dettagli
Parametri
[in] aMode
TRUE per abilitare la modalità diagnostica, FALSE in caso contrario.

otPlatDiagProcess

otError otPlatDiagProcess(
  otInstance *aInstance,
  uint8_t aArgsLength,
  char *aArgs[],
  char *aOutput,
  size_t aOutputMaxLen
)

Consente di elaborare una riga di comando per la diagnostica di fabbrica.

L'output di questa funzione (il contenuto scritto in aOutput) DEVE terminare con \0 e \0 è all'interno del buffer di output.

Dettagli
Parametri
[in] aInstance
L'istanza OpenThread per la richiesta attuale.
[in] aArgsLength
Il numero di argomenti in aArgs.
[in] aArgs
Gli argomenti della riga di comando di diagnostica.
[out] aOutput
Risultato dell'esecuzione della diagnostica.
[in] aOutputMaxLen
La dimensione del buffer di output.
Valori restituiti
OT_ERROR_INVALID_ARGS
Il comando è supportato, ma sono stati forniti argomenti non validi.
OT_ERROR_NONE
L'elaborazione del comando è riuscita.
OT_ERROR_INVALID_COMMAND
Il comando non è valido o non è supportato.

otPlatDiagRadioGetPowerSettings

otError otPlatDiagRadioGetPowerSettings(
  otInstance *aInstance,
  uint8_t aChannel,
  int16_t *aTargetPower,
  int16_t *aActualPower,
  uint8_t *aRawPowerSetting,
  uint16_t *aRawPowerSettingLength
)

Verifica le impostazioni di accensione del canale.

Dettagli
Parametri
[in] aInstance
La struttura dell'istanza OpenThread.
[in] aChannel
Il canale radio.
[out] aTargetPower
Potenza target in 0,01 dBm.
[out] aActualPower
La potenza effettiva in 0,01 dBm.
[out] aRawPowerSetting
Un puntatore all'array di byte di impostazione potenza non elaborata.
[in,out] aRawPowerSettingLength
Nell'input, un puntatore delle dimensioni di aRawPowerSetting. All'uscita, un puntatore alla lunghezza dei dati non elaborati relativi all'impostazione della potenza.
Valori restituiti
OT_ERROR_NONE
Potenza target raggiunta.
OT_ERROR_INVALID_ARGS
aChannel non è valido, aActualPower, aRawPowerSetting o aRawPowerSettingLength è NULL o è troppo breve.
OT_ERROR_NOT_FOUND
Impossibile trovare le impostazioni di accensione di aChannel.
OT_ERROR_NOT_IMPLEMENTED
Questo metodo non è implementato.

otPlatDiagRadioGetRawPowerSetting

otError otPlatDiagRadioGetRawPowerSetting(
  otInstance *aInstance,
  uint8_t *aRawPowerSetting,
  uint16_t *aRawPowerSettingLength
)

Scarica l'impostazione di alimentazione non elaborata della radio per il modulo di diagnostica.

Dettagli
Parametri
[in] aInstance
La struttura dell'istanza OpenThread.
[out] aRawPowerSetting
Un puntatore all'array di byte di impostazione potenza non elaborata.
[in,out] aRawPowerSettingLength
Nell'input, un puntatore delle dimensioni di aRawPowerSetting. All'uscita, un puntatore alla lunghezza dei dati non elaborati relativi all'impostazione della potenza.
Valori restituiti
OT_ERROR_NONE
Impostazione di alimentazione non elaborata riuscita.
OT_ERROR_INVALID_ARGS
aRawPowerSetting o aRawPowerSettingLength è NULL o è troppo breve.
OT_ERROR_NOT_FOUND
L'impostazione della potenza grezza non è configurata.
OT_ERROR_NOT_IMPLEMENTED
Questo metodo non è implementato.

otPlatDiagRadioRawPowerSettingEnable

otError otPlatDiagRadioRawPowerSettingEnable(
  otInstance *aInstance,
  bool aEnable
)

Abilita/disabilita il livello della piattaforma per utilizzare l'impostazione di potenza non elaborata impostata da otPlatDiagRadioSetRawPowerSetting().

Dettagli
Parametri
[in] aInstance
La struttura dell'istanza OpenThread.
[in] aEnable
TRUE per abilitare o FALSE per disabilitare l'impostazione di alimentazione non elaborata.
Valori restituiti
OT_ERROR_NONE
Impostazione alimentazione non elaborata attivata/disattivata.
OT_ERROR_NOT_IMPLEMENTED
Questo metodo non è implementato.

otPlatDiagRadioReceived

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

Elabora il frame radio ricevuto.

Dettagli
Parametri
[in] aInstance
L'istanza OpenThread per la richiesta attuale.
[in] aFrame
Il frame radio ricevuto.
[in] aError
Lo stato del frame radio ricevuto.

otPlatDiagRadioSetRawPowerSetting

otError otPlatDiagRadioSetRawPowerSetting(
  otInstance *aInstance,
  const uint8_t *aRawPowerSetting,
  uint16_t aRawPowerSettingLength
)

Imposta l'impostazione di alimentazione non elaborata della radio per il modulo di diagnostica.

Dettagli
Parametri
[in] aInstance
La struttura dell'istanza OpenThread.
[in] aRawPowerSetting
Un puntatore all'array di byte di impostazione potenza non elaborata.
[in] aRawPowerSettingLength
La lunghezza del aRawPowerSetting.
Valori restituiti
OT_ERROR_NONE
Impostazione di alimentazione non elaborata riuscita.
OT_ERROR_INVALID_ARGS
Il valore aRawPowerSetting è NULL oppure aRawPowerSettingLength è troppo lungo.
OT_ERROR_NOT_IMPLEMENTED
Questo metodo non è implementato.

otPlatDiagRadioTransmitCarrier

otError otPlatDiagRadioTransmitCarrier(
  otInstance *aInstance,
  bool aEnable
)

Avvia/interrompi il livello della piattaforma per trasmettere un'onda portante continua.

Dettagli
Parametri
[in] aInstance
La struttura dell'istanza OpenThread.
[in] aEnable
TRUE per abilitare o FALSE per disattivare il livello della piattaforma per la trasmissione dell'onda portante continua.
Valori restituiti
OT_ERROR_NONE
Attivato/disattivato correttamente .
OT_ERROR_INVALID_STATE
La radio non era in stato di ricezione.
OT_ERROR_NOT_IMPLEMENTED
Questo metodo non è implementato.

otPlatDiagRadioTransmitStream

otError otPlatDiagRadioTransmitStream(
  otInstance *aInstance,
  bool aEnable
)

Avvia/interrompi il livello della piattaforma per trasmettere il flusso di caratteri.

Dettagli
Parametri
[in] aInstance
La struttura dell'istanza OpenThread.
[in] aEnable
TRUE per abilitare o FALSE per disabilitare il livello della piattaforma per la trasmissione del flusso.
Valori restituiti
OT_ERROR_NONE
Attivato/disattivato.
OT_ERROR_INVALID_STATE
La radio non era in stato di ricezione.
OT_ERROR_NOT_IMPLEMENTED
Questa funzione non è implementata.

otPlatDiagTxPowerSet

void otPlatDiagTxPowerSet(
  int8_t aTxPower
)

Imposta la potenza di trasmissione da utilizzare per la diagnostica di fabbrica.

Dettagli
Parametri
[in] aTxPower
Il valore della potenza di trasmissione.

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.