Partilhar via

Função SPIMaster_Open

  • Artigo

Cabeçalho: #include <applibs/spi.h>

Abre e configura uma interface mestra SPI para utilização exclusiva e devolve um descritor de ficheiros a utilizar para chamadas subsequentes.

A interface é inicializada com as predefinições: SPI_Mode_0, SPI_BitOrder_MsbFirst. Pode alterar estas definições com funções SPI após a interface ser aberta.

static inline int SPIMaster_Open(SPI_InterfaceId interfaceId, SPI_ChipSelectId chipSelectId, const SPIMaster_Config *config);

Parâmetros

  • interfaceId O ID da interface mestra SPI a abrir.

  • chipSelectId O chip seleciona o ID a utilizar com a interface mestra SPI.

  • config A configuração da interface mestra SPI. Antes de chamar esta função, tem de chamar SPIMaster_InitConfig para inicializar a estrutura SPIMaster_Config . Pode alterar as definições após a inicialização da estrutura. O config argumento contém todas as definições que têm de ser configuradas como parte da abertura da interface e que poderão não ser alteradas posteriormente.

Erros

Devolve -1 se for encontrado um erro e define errno para o valor de erro.

  • EACCES: o acesso a esta interface SPI não é permitido porque o interfaceId parâmetro não está listado no campo SpiMaster do manifesto da aplicação.

Também pode ser especificado qualquer outro errno ; esses erros não são deterministas e o mesmo comportamento pode não ser retido através de atualizações do sistema.

Valor devolvido

Devolve o descritor de ficheiros da interface SPI se tiver sido aberto com êxito ou -1 para a falha, caso errno em que está definido como o valor de erro. Pode utilizar este descritor com padrão read(2) e write(2) funções para transacionar com o dispositivo ligado. Também pode utilizar SPIMaster_TransferSequential para executar uma sequência de transferências.

Requisitos do manifesto de aplicação

Para aceder a interfaces SPI individuais, a sua aplicação tem de identificá-las no campo SpiMaster do manifesto da aplicação.