通过

SPIMaster_Open 函数

  • 项目

标头： #include <applibs/spi.h>

打开并配置 SPI 主接口以供独占使用，并返回用于后续调用的文件描述符。

接口使用默认设置进行初始化： SPI_Mode_0、 SPI_BitOrder_MsbFirst。 打开接口后，可以使用 SPI 函数更改这些设置。

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

参数

  • interfaceId 要打开的 SPI 主接口的 ID。

  • chipSelectId 芯片选择用于 SPI 主接口的 ID。

  • config SPI 主接口的配置。 在调用此函数之前，必须调用 SPIMaster_InitConfig 以初始化 SPIMaster_Config 结构。 可以在初始化结构后更改设置。 参数 config 包含所有必须配置为打开接口的一部分的设置，之后可能不会更改这些设置。

错误

如果遇到错误并设置为 errno 错误值，则返回 -1。

  • EACCES：不允许访问此 SPI 接口， interfaceId 因为参数未在应用程序清单的 SpiMaster 字段中列出。

还可以指定任何其他 errno 错误;此类错误不是确定性的，并且可能不会通过系统更新保留相同的行为。

返回值

如果成功打开 SPI 接口，则返回文件描述符;如果失败，则返回 -1，在这种情况下 errno ，将 设置为错误值。 可以将此描述符与标准和read(2)write(2)函数一起使用，以便与连接的设备进行交易。 还可以使用 SPIMaster_TransferSequential 来运行一系列传输。

应用程序清单要求

若要访问单个 SPI 接口，应用程序必须在 应用程序清单的 SpiMaster 字段中标识它们。