Sdílet prostřednictvím

funkce SPIMaster_Open

  • Článek

Hlavička: #include <applibs/spi.h>

Otevře a nakonfiguruje hlavní rozhraní SPI pro výhradní použití a vrátí popisovač souboru, který se má použít pro následná volání.

Rozhraní se inicializuje s výchozím nastavením: SPI_Mode_0, SPI_BitOrder_MsbFirst. Tato nastavení můžete změnit pomocí funkcí SPI po otevření rozhraní.

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

Parametry

  • interfaceId ID hlavního rozhraní SPI, které se má otevřít.

  • chipSelectId Čip vybere ID pro použití s hlavním rozhraním SPI.

  • config Konfigurace pro hlavní rozhraní SPI. Před voláním této funkce je nutné volat SPIMaster_InitConfig inicializovat strukturu SPIMaster_Config . Nastavení můžete změnit po inicializaci struktury. Argument config obsahuje všechna nastavení, která musí být nakonfigurována jako součást otevření rozhraní a která se nesmí později změnit.

Chyby

Vrátí hodnotu -1, pokud dojde k chybě, a nastaví errno se na chybovou hodnotu.

  • EACCES: Přístup k tomuto rozhraní SPI není povolen, protože interfaceId parametr není uveden v poli SpiMaster manifestu aplikace.

Je také možné zadat všechny ostatní errno chyby. Tyto chyby nejsou deterministické a stejné chování nemusí být zachováno prostřednictvím aktualizací systému.

Vrácená hodnota

Vrátí popisovač souboru rozhraní SPI, pokud byl úspěšně otevřen, nebo -1 pro selhání, v tomto případě errno je nastavena na chybovou hodnotu. Tento popisovač můžete použít se standardem read(2) a write(2) funkcemi k transakcím s připojeným zařízením. Můžete také použít SPIMaster_TransferSequential ke spuštění posloupnosti přenosů.

Požadavky manifestu aplikace

Pro přístup k jednotlivým rozhraním SPI je vaše aplikace musí identifikovat v poli SpiMaster manifestu aplikace.