缓冲区¶

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，指定有符号（补码）或无符号。
- bits，是有效数据位的数量。
- storagebits，是在缓冲区中占用的位数（填充后）。
- repeat，指定位/storagebits 重复的次数。当 repeat 元素为 0 或 1 时，则省略 repeat 值。
- shift，如果指定，是在屏蔽未使用的位之前需要应用的移位。

例如，一个三轴加速度计的驱动程序，其具有 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 内核

目录

本页

缓冲区¶

IIO 缓冲区 sysfs 接口¶

IIO 缓冲区设置¶

更多详细信息¶