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缓冲区设置¶

更多细节¶