Buffers¶

struct iio_buffer — 通用緩衝區結構
iio_validate_scan_mask_onehot() — 驗證是否只選擇了一個通道
iio_buffer_get() — 獲取緩衝區的引用
iio_buffer_put() — 釋放緩衝區的引用

工業I/O核心提供了一種基於觸發源的連續資料捕獲方式。可以從/dev/iio:deviceX字元裝置節點一次讀取多個數據通道，從而降低CPU負載。

IIO緩衝區sysfs介面¶

IIO緩衝區在/sys/bus/iio/devices/iio:deviceX/buffer/*下有一個關聯的屬性目錄。以下是一些現有屬性

length，可以由緩衝區儲存的資料樣本總數（容量）。
enable，啟用緩衝區捕獲。

IIO緩衝區設定¶

與放置在緩衝區中的通道讀取相關的元資訊稱為掃描元素。配置掃描元素的重要位透過/sys/bus/iio/devices/iio:deviceX/scan_elements/目錄暴露給使用者空間應用程式。此目錄包含以下形式的屬性

enable，用於啟用通道。當且僅當其屬性非零時，觸發捕獲將包含此通道的資料樣本。
index，通道的scan_index。
type，描述緩衝區中掃描元素的資料儲存，因此也描述了從使用者空間讀取它的形式。格式為[be|le]:[s|u]bits/storagebits[Xrepeat][>>shift] 。
- be或le，指定大端或小端。
- s或u，指定有符號（2的補碼）或無符號。
- bits，是有效資料位的數量。
- storagebits，是在緩衝區中佔用的位數（填充後）。
- repeat，指定bits/storagebits重複的次數。當repeat元素為0或1時，則省略repeat值。
- shift，如果指定，是在遮蔽掉未使用的位之前需要應用的位移。

例如，一個3軸加速度計的驅動程式，其12位解析度的資料儲存在兩個8位暫存器中，如下所示

  7   6   5   4   3   2   1   0
+---+---+---+---+---+---+---+---+
|D3 |D2 |D1 |D0 | X | X | X | X | (LOW byte, address 0x06)
+---+---+---+---+---+---+---+---+

  7   6   5   4   3   2   1   0
+---+---+---+---+---+---+---+---+
|D11|D10|D9 |D8 |D7 |D6 |D5 |D4 | (HIGH byte, address 0x07)
+---+---+---+---+---+---+---+---+

對於每個軸，將具有以下掃描元素型別

$ cat /sys/bus/iio/devices/iio:device0/scan_elements/in_accel_y_type
le:s12/16>>4

使用者空間應用程式會將從緩衝區讀取的資料樣本解釋為兩位元組小端有符號資料，在遮蔽掉12個有效資料位之前需要右移4位。

為了實現緩衝區支援，驅動程式應在iio_chan_spec定義中初始化以下欄位

struct iio_chan_spec {
/* other members */
        int scan_index
        struct {
                char sign;
                u8 realbits;
                u8 storagebits;
                u8 shift;
                u8 repeat;
                enum iio_endian endianness;
               } scan_type;
       };

實現上述加速度計的驅動程式將具有以下通道定義

struct iio_chan_spec accel_channels[] = {
        {
                .type = IIO_ACCEL,
                .modified = 1,
                .channel2 = IIO_MOD_X,
                /* other stuff here */
                .scan_index = 0,
                .scan_type = {
                        .sign = 's',
                        .realbits = 12,
                        .storagebits = 16,
                        .shift = 4,
                        .endianness = IIO_LE,
                },
        }
        /* similar for Y (with channel2 = IIO_MOD_Y, scan_index = 1)
         * and Z (with channel2 = IIO_MOD_Z, scan_index = 2) axis
         */
 }

在此， scan_index 定義了啟用通道在緩衝區中放置的順序。具有較低 scan_index 的通道將放置在具有較高索引的通道之前。每個通道都需要具有唯一的 scan_index。

將 scan_index 設定為-1可用於指示特定通道不支援緩衝捕獲。在這種情況下，不會在scan_elements目錄中為通道建立任何條目。

Linux核心

目錄

本頁

Buffers¶

IIO緩衝區sysfs介面¶

IIO緩衝區設定¶

更多細節¶