spi_async怎么使用，需要用 wait_for_completion？

SPI (Serial Peripheral Interface) 是一种用于连接主机系统和外设设备的同步通信接口。当涉及到异步操作，例如SPI_async，它通常是在基于中断的环境中使用的，目的是提高数据传输效率并允许CPU继续处理其他任务，而不会阻塞。

在使用SPI_async时，你需要按照以下步骤操作：

1. **初始化**: 首先，你需要创建一个SPI_async_instance，并配置相关的SPI硬件设置，如频率、数据线宽度等。

spi_device_t device;
spi_bus_config_t bus_cfg;
spi_host_device_t host;

2. **开启bus**: 初始化并打开SPI总线。

spi_host_get_default(&host);
spi_bus_initialize(host, &bus_cfg);
spi_bus_lock(host);

3. **创建async transaction**: 创建一个SPI_async_transaction对象，这将管理异步传输。

spi_transaction_t transaction;

4. **设置transfer**: 设置要传输的数据缓冲区以及完成回调函数（如果需要），`wait_for_completion`就是这个回调的一部分。

transaction.buffer = data_buffer; // 数据缓冲区
transaction.length = data_length;
transaction.flags |= SPI_TRANSFER_MODE_0 | SPI.transfer_dma; // 使用DMA

// 如果你想等待交易完成后回调
bool wait = true;
transaction.wait_for_completion_func = wait_for_completion_function;
transaction.wait_for_completion_arg = user_arg;

5. **发送数据**: 发起异步传输。

spi_device_transmit(device, &transaction);

6. **处理中断**: 系统会通过中断通知你传输已经完成或出错，这时你可以调用`wait_for_completion`的回调函数`wait_for_completion_function(transaction, user_arg)`来获取结果。

7. **关闭资源**: 当不再使用时，记得释放资源并关闭总线。

spi_transaction_cancel(&transaction); // 取消未完成的交易
spi_device_close(device);
spi_bus_free(host);
spi_host_release(host);

关于`wait_for_completion`函数，它通常用来在后台线程等待交易完成，而不是阻塞主线程。如果不需要在主程序中等待，那么可以不设置该回调。是否使用取决于你的应用需求。