Definições
Este módulo inclui a abstração da plataforma para armazenamento não volátil de configurações.
Resumo
Funções | |
---|---|
otPlatSettingsAdd ( otInstance *aInstance, uint16_t aKey, const uint8_t *aValue, uint16_t aValueLength) | Adiciona um valor a uma configuração. |
otPlatSettingsDeinit ( otInstance *aInstance) | void Executa qualquer inicialização do subsistema de configurações, se necessário. |
otPlatSettingsDelete ( otInstance *aInstance, uint16_t aKey, int aIndex) | Remove uma configuração do armazenamento de configurações. |
otPlatSettingsGet ( otInstance *aInstance, uint16_t aKey, int aIndex, uint8_t *aValue, uint16_t *aValueLength) | Busca o valor de uma configuração. |
otPlatSettingsInit ( otInstance *aInstance) | void Executa qualquer inicialização para o subsistema de configurações, se necessário. |
otPlatSettingsSet ( otInstance *aInstance, uint16_t aKey, const uint8_t *aValue, uint16_t aValueLength) | Define ou substitui o valor de uma configuração. |
otPlatSettingsWipe ( otInstance *aInstance) | void Remove todas as configurações do armazenamento de configurações. |
Funções
otPlatSettingsAdd
otError otPlatSettingsAdd( otInstance *aInstance, uint16_t aKey, const uint8_t *aValue, uint16_t aValueLength )
Adiciona um valor a uma configuração.
Esta função adiciona o valor a uma configuração identificada por aKey, sem substituir nenhum valor existente.
Observe que a implementação subjacente não é necessária para manter a ordem dos itens associados a uma chave específica. O valor agregado pode ser agregado ao final, ao começo ou mesmo em algum lugar no meio. A ordem de quaisquer valores pré-existentes também pode mudar.
Chamar essa função com êxito pode fazer com que configurações não relacionadas com vários valores sejam reordenadas.
Detalhes | |||||||||
---|---|---|---|---|---|---|---|---|---|
Parâmetros |
| ||||||||
Valores Retornados |
|
otPlatSettingsDeinit
void otPlatSettingsDeinit( otInstance *aInstance )
Executa qualquer inicialização do subsistema de configurações, se necessário.
Detalhes | |||
---|---|---|---|
Parâmetros |
|
otPlatSettingsDelete
otError otPlatSettingsDelete( otInstance *aInstance, uint16_t aKey, int aIndex )
Remove uma configuração do armazenamento de configurações.
Esta função exclui um valor específico da configuração identificada por aKey do armazenamento de configurações.
Observe que a implementação subjacente não é necessária para manter a ordem dos itens associados a uma chave específica.
Detalhes | |||||||
---|---|---|---|---|---|---|---|
Parâmetros |
| ||||||
Valores Retornados |
|
otPlatSettingsGet
otError otPlatSettingsGet( otInstance *aInstance, uint16_t aKey, int aIndex, uint8_t *aValue, uint16_t *aValueLength )
Busca o valor de uma configuração.
Esta função busca o valor da configuração identificada por aKey e o grava na memória apontada por aValue. Em seguida, ele grava o comprimento no número inteiro apontado por aValueLength. O valor inicial de aValueLength é o número máximo de bytes a serem gravados em aValue.
Esta função pode ser usada para verificar a existência de uma chave sem buscar o valor, definindo aValue e aValueLength como NULL. Você também pode verificar o comprimento da configuração sem buscá-la, definindo apenas aValue como NULL.
Observe que a implementação de armazenamento subjacente não é necessária para manter a ordem das configurações com vários valores. A ordem de tais valores PODE mudar após QUALQUER operação de gravação na loja.
Detalhes | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|
Parâmetros |
| ||||||||||
Valores Retornados |
|
otPlatSettingsInit
void otPlatSettingsInit( otInstance *aInstance )
Executa qualquer inicialização para o subsistema de configurações, se necessário.
Detalhes | |||
---|---|---|---|
Parâmetros |
|
otPlatSettingsSet
otError otPlatSettingsSet( otInstance *aInstance, uint16_t aKey, const uint8_t *aValue, uint16_t aValueLength )
Define ou substitui o valor de uma configuração.
Esta função define ou substitui o valor de uma configuração identificada por aKey. Se houver mais de um valor associado anteriormente a aKey, todos eles serão excluídos e substituídos por essa única entrada.
Chamar essa função com êxito pode fazer com que configurações não relacionadas com vários valores sejam reordenadas.
Detalhes | |||||||||
---|---|---|---|---|---|---|---|---|---|
Parâmetros |
| ||||||||
Valores Retornados |
|
otPlatSettingsWipe
void otPlatSettingsWipe( otInstance *aInstance )
Remove todas as configurações do armazenamento de configurações.
Esta função exclui todas as configurações do armazenamento de configurações, restaurando-o ao seu estado inicial de fábrica.
Detalhes | |||
---|---|---|---|
Parâmetros |
|