Dela via


funktionen SPIMaster_Open

Sidhuvud: #include <applibs/spi.h>

Öppnar och konfigurerar ett SPI-huvudgränssnitt för exklusiv användning och returnerar en filbeskrivning som ska användas för efterföljande samtal.

Gränssnittet initieras med standardinställningarna: SPI_Mode_0, SPI_BitOrder_MsbFirst. Du kan ändra de här inställningarna med SPI-funktioner när gränssnittet har öppnats.

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

Parametrar

  • interfaceId ID för SPI-huvudgränssnittet som ska öppnas.

  • chipSelectId Chipet väljer ID som ska användas med SPI-mastergränssnittet.

  • config Konfigurationen för SPI-huvudgränssnittet. Innan du anropar den här funktionen måste du ringa SPIMaster_InitConfig för att initiera SPIMaster_Config struct. Du kan ändra inställningarna efter att structen har initierats. Argumentet config innehåller alla inställningar som måste konfigureras som en del av att öppna gränssnittet och som inte kan ändras efteråt.

Fel

Returnerar -1 om ett fel uppstår och anger errno felvärdet.

  • EACCES: åtkomst till detta SPI-gränssnitt tillåts inte eftersom parametern interfaceId inte visas i fältet SpiMaster i programmanifestet.

errno Andra kan också anges, sådana fel är inte deterministiska och samma beteende kanske inte behålls via systemuppdateringar.

Returvärde

Returnerar filbeskrivning för SPI-gränssnittet om det öppnades korrekt, eller -1 för fel, i vilket fall errno felvärdet är inställt. Du kan använda den här beskrivningen med standard read(2) och write(2) funktioner för att handla med den anslutna enheten. Du kan också använda SPIMaster_TransferSequential för att köra en sekvens av överföringar.

Krav för programmanifest

För åtkomst till enskilda SPI-gränssnitt måste programmet identifiera dem i fältet SpiMaster i programmanifestet.