Função SPIMaster_Open
Cabeçalho: #include <applibs/spi.h>
Abre e configura uma interface master SPI para uso exclusivo e retorna um descritor de arquivo a ser usado para chamadas subsequentes.
A interface é inicializada com as configurações padrão: SPI_Mode_0
, SPI_BitOrder_MsbFirst
. Você pode alterar essas configurações com funções SPI depois que a interface for aberta.
static inline int SPIMaster_Open(SPI_InterfaceId interfaceId, SPI_ChipSelectId chipSelectId, const SPIMaster_Config *config);
Parâmetros
interfaceId
A ID da interface spi master a ser aberta.chipSelectId
O chip selecione ID para usar com a interface master SPI.config
A configuração da interface master SPI. Antes de chamar essa função, você deve chamar SPIMaster_InitConfig para inicializar o struct SPIMaster_Config . Você pode alterar as configurações depois que o struct for inicializado. Oconfig
argumento contém todas as configurações que devem ser configuradas como parte da abertura da interface e que podem não ser alteradas posteriormente.
Erros
Retorna -1 se um erro for encontrado e definir errno
como o valor do erro.
- EACCES: o acesso a essa interface SPI não é permitido porque o
interfaceId
parâmetro não está listado no campo SpiMaster do manifesto do aplicativo.
Qualquer outro errno
também pode ser especificado; esses erros não são determinísticos e o mesmo comportamento pode não ser mantido por meio de atualizações do sistema.
Valor retornado
Retorna o descritor de arquivo da interface SPI se ele foi aberto com êxito ou -1 para falha, nesse caso errno
é definido como o valor do erro. Você pode usar esse descritor com funções padrão read(2)
e write(2)
para transacionar com o dispositivo conectado. Você também pode usar SPIMaster_TransferSequential para executar uma sequência de transferências.
Requisitos de manifesto do aplicativo
Para acessar interfaces spi individuais, seu aplicativo deve identificá-las no campo SpiMaster do manifesto do aplicativo.