ESP32-C3， esp-idf 5.0.2，如何配置并使用spi

首先，需要在 `sdkconfig` 文件中启用 SPI 驱动程序。找到以下行并取消注释：

CONFIG_ESP32C3_SPI

然后，需要通过 `spi_bus_initialize()` 函数初始化 SPI 总线。可以使用以下代码：

spi_bus_config_t bus_cfg = {
    .miso_io_num = PIN_NUM_MISO,
    .mosi_io_num = PIN_NUM_MOSI,
    .sclk_io_num = PIN_NUM_CLK,
    .quadwp_io_num = -1,
    .quadhd_io_num = -1,
    .max_transfer_sz = 0,
};

spi_bus_initialize(VSPI_HOST, &bus_cfg, DMA_CHAN);

其中，`PIN_NUM_MISO`，`PIN_NUM_MOSI`，和 `PIN_NUM_CLK` 是 MISO，MOSI 和 SCLK 的引脚号，`DMA_CHAN` 是 DMA 通道的编号，可以设置为 1。

接下来，需要通过 `spi_device_interface_config_t` 结构体配置 SPI 设备。可以使用以下代码：

spi_device_interface_config_t dev_cfg = {
    .command_bits = 0,
    .address_bits = 0,
    .dummy_bits = 0,
    .mode = 0,
    .duty_cycle_pos = 0,
    .cs_ena_pretrans = 0,
    .cs_ena_posttrans = 0,
    .clock_speed_hz = 1000000,
    .input_delay_ns = 0,
    .spics_io_num = PIN_NUM_CS,
    .flags = 0,
    .queue_size = 1,
    .pre_cb = NULL,
    .post_cb = NULL,
};

spi_device_handle_t spi_handle;
spi_bus_add_device(VSPI_HOST, &dev_cfg, &spi_handle);

其中，`PIN_NUM_CS` 是片选引脚的引脚号，可以设置为任何 GPIO 引脚。

现在，可以使用 `spi_device_transmit()` 函数来传输数据。例如，要写入一个字节，可以使用以下代码：

uint8_t data = 0xAB;
spi_transaction_t tx = {
    .length = 8,
    .tx_buffer = &data,
};

spi_device_transmit(spi_handle, &tx);

要读取一个字节，可以使用以下代码：

uint8_t data = 0;
spi_transaction_t tx = {
    .length = 8,
    .rx_buffer = &data,
};

spi_device_transmit(spi_handle, &tx);

注意，在 `spi_transaction_t` 结构体中，如果 `tx_buffer` 不为 `NULL`，则将执行写操作；如果 `rx_buffer` 不为 `NULL`，则将执行读操作；如果两者都不为 `NULL`，则将执行读写操作。

需要注意的是，在使用 SPI 设备之前，必须对 SPI 总线进行初始化，并且在完成传输之后，必须调用 `spi_bus_remove_device()` 函数来删除设备。代码示例如下：

spi_bus_initialize(VSPI_HOST, &bus_cfg, DMA_CHAN);

spi_device_interface_config_t dev_cfg = {...};
spi_device_handle_t spi_handle;
spi_bus_add_device(VSPI_HOST, &dev_cfg, &spi_handle);

uint8_t data = 0xAB;
spi_transaction_t tx = {...};
spi_device_transmit(spi_handle, &tx);

spi_bus_remove_device(spi_handle);
spi_bus_free(VSPI_HOST);