Compartilhar via


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

  • interfaceIdA ID da interface spi master a ser aberta.

  • chipSelectIdO chip selecione ID para usar com a interface master SPI.

  • configA 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. O config 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.