SPIMaster_Open függvény
Fejléc: #include <applibs/spi.h>
Megnyit és konfigurál egy SPI-főfelületet kizárólagos használatra, és visszaad egy fájlleírót a későbbi hívásokhoz.
A felület inicializálása az alapértelmezett beállításokkal történik: SPI_Mode_0
, SPI_BitOrder_MsbFirst
. Ezeket a beállításokat az SPI-függvényekkel módosíthatja a felület megnyitása után.
static inline int SPIMaster_Open(SPI_InterfaceId interfaceId, SPI_ChipSelectId chipSelectId, const SPIMaster_Config *config);
Paraméterek
interfaceId
A megnyitni kívánt SPI-főfelület azonosítója.chipSelectId
A lapka az SPI fő felületéhez használni kívánt azonosítót választja ki.config
Az SPI-főillesztő konfigurációja. A függvény meghívása előtt meg kell hívnia SPIMaster_InitConfig a SPIMaster_Config struktúrájának inicializálásához. A szerkezet inicializálása után módosíthatja a beállításokat. Azconfig
argumentum tartalmazza az összes olyan beállítást, amelyet konfigurálni kell a felület megnyitásakor, és amelyek később nem módosíthatók.
Hibák
-1 értéket ad vissza, ha hiba történik, és a hibaértékre van halmazva errno
.
- EACCES: Az SPI-felülethez való hozzáférés nem engedélyezett, mert a
interfaceId
paraméter nem szerepel az alkalmazásjegyzék SpiMaster mezőjében.
errno
Más is megadható; az ilyen hibák nem determinisztikusak, és előfordulhat, hogy a rendszerfrissítések nem őrzik meg ugyanazt a viselkedést.
Visszatérési érték
Az SPI-felület fájlleíróját adja vissza, ha az sikeresen meg lett nyitva, vagy -1 hiba esetén, amely esetben errno
a hibaérték van beállítva. Ezt a leírót standard read(2)
és write(2)
függvényekkel is használhatja a csatlakoztatott eszközzel való tranzakcióhoz. A SPIMaster_TransferSequential is használhatja az átvitelek sorozatának futtatásához.
Alkalmazásjegyzékre vonatkozó követelmények
Az egyes SPI-felületek eléréséhez az alkalmazásnak azonosítania kell őket az alkalmazásjegyzék SpiMaster mezőjében.