linux内核 iio子系统介绍以及具体例子

一 .介绍

Linux IIO (Industrial I/O) 子系统是一个用于处理模拟到数字或数字到模拟转换器和各种传感器的框架。它主要用于嵌入式系统和工业应用中。以下是 IIO 子系统的主要特点和组成部分：

1. 目的：
   - 为各种传感器和转换器提供统一的接口
   - 简化驱动程序开发
   - 提供用户空间访问接口

2. 主要组件：
   a) IIO 设备：代表物理传感器或转换器
   b) IIO 通道：表示设备的单个测量通道
   c) IIO 触发器：用于同步数据采集
   d) IIO 缓冲区：用于高速数据传输

3. 设备类型：
   - ADC（模数转换器）
   - DAC（数模转换器）
   - 加速度计
   - 陀螺仪
   - 磁力计
   - 光传感器
   - 温度传感器
   - 压力传感器
   等

4. 用户空间接口：
   - sysfs：提供设备配置和单次读取
   - configfs：用于动态配置某些 IIO 设备
   - 字符设备：用于连续数据流

5. 驱动程序结构：
   - 实现 iio_info 结构
   - 定义通道
   - 实现读写操作
   - 可选：实现缓冲区支持

6. 数据采集模式：
   - 直接模式：单次读取
   - 缓冲模式：连续数据流

7. 主要特性：
   - 设备发现和枚举
   - 通道配置
   - 数据格式处理
   - 触发器支持
   - 缓冲区管理

8. 工具和实用程序：
   - iio_info：列出系统中的 IIO 设备
   - iio_generic_buffer：从 IIO 设备读取数据

9. 内核配置：
   启用 IIO 支持需要在内核配置中选择：
   ```
   CONFIG_IIO=y
   ```

10. 示例用法：
    读取 ADC 值：
    ```bash
    cat /sys/bus/iio/devices/iio:device0/in_voltage0_raw
    ```

11. 优势：
    - 标准化接口
    - 简化驱动开发
    - 灵活的数据采集机制
    - 支持广泛的设备类型

12. 挑战：
    - 对于某些特定设备，可能需要额外的自定义
    - 学习曲线可能较陡

总之，IIO 子系统为 Linux 嵌入式系统中的模拟传感器和转换器提供了一个强大而灵活的框架，简化了驱动程序开发并提供了统一的用户空间接口。
 

二.例子

如下提供一个 IIO 驱动开发的示例。一个简单的温度传感器驱动程序。

1. 首先,定义设备结构体:

```c
struct my_temp_sensor {
    struct iio_dev *indio_dev;
    struct device *dev;
    // 添加其他需要的设备特定字段
};
```

2. 定义 IIO 通道:

```c
static const struct iio_chan_spec my_temp_sensor_channels[] = {
    {
        .type = IIO_TEMP,
        .info_mask_separate = BIT(IIO_CHAN_INFO_RAW) |
                              BIT(IIO_CHAN_INFO_SCALE),
    },
};
```

3. 实现读取函数:

```c
static int my_temp_sensor_read_raw(struct iio_dev *indio_dev,
                                   struct iio_chan_spec const *chan,
                                   int *val, int *val2, long mask)
{
    struct my_temp_sensor *sensor = iio_priv(indio_dev);

    switch (mask) {
    case IIO_CHAN_INFO_RAW:
        // 从硬件读取原始温度值
        *val = /* 读取温度值的代码 */;
        return IIO_VAL_INT;
    case IIO_CHAN_INFO_SCALE:
        // 提供比例因子以转换为摄氏度
        *val = 1000; // 1000 表示 0.001 摄氏度/原始单位
        return IIO_VAL_INT;
    default:
        return -EINVAL;
    }
}
```

4. 定义 IIO 操作:

```c
static const struct iio_info my_temp_sensor_info = {
    .read_raw = my_temp_sensor_read_raw,
};
```

5. 实现探测函数:

```c
static int my_temp_sensor_probe(struct i2c_client *client,
                                const struct i2c_device_id *id)
{
    struct my_temp_sensor *sensor;
    struct iio_dev *indio_dev;

    indio_dev = devm_iio_device_alloc(&client->dev, sizeof(*sensor));
    if (!indio_dev)
        return -ENOMEM;

    sensor = iio_priv(indio_dev);
    sensor->dev = &client->dev;
    i2c_set_clientdata(client, indio_dev);

    indio_dev->name = "my-temp-sensor";
    indio_dev->modes = INDIO_DIRECT_MODE;
    indio_dev->info = &my_temp_sensor_info;
    indio_dev->channels = my_temp_sensor_channels;
    indio_dev->num_channels = ARRAY_SIZE(my_temp_sensor_channels);

    return devm_iio_device_register(&client->dev, indio_dev);
}
```

6. 定义移除函数:

```c
static int my_temp_sensor_remove(struct i2c_client *client)
{
    // 通常不需要执行任何操作，因为我们使用 devm_ 函数
    return 0;
}
```

7. 设置 I2C 驱动:

```c
static const struct i2c_device_id my_temp_sensor_id[] = {
    { "my-temp-sensor", 0 },
    { }
};
MODULE_DEVICE_TABLE(i2c, my_temp_sensor_id);

static struct i2c_driver my_temp_sensor_driver = {
    .driver = {
        .name = "my-temp-sensor",
    },
    .probe = my_temp_sensor_probe,
    .remove = my_temp_sensor_remove,
    .id_table = my_temp_sensor_id,
};

module_i2c_driver(my_temp_sensor_driver);

MODULE_AUTHOR("Your Name");
MODULE_DESCRIPTION("My Temperature Sensor Driver");
MODULE_LICENSE("GPL v2");
```

8. 在设备树中添加节点:

```dts
i2c {
    my_temp_sensor: my-temp-sensor@48 {
        compatible = "my-temp-sensor";
        reg = <0x48>;
    };
};
```

这个示例展示了如何创建一个基本的 IIO 温度传感器驱动。它包括:
- 定义设备结构和 IIO 通道
- 实现读取函数
- 设置 IIO 操作
- 实现探测和移除函数
- 设置 I2C 驱动

实际开发中,您需要根据具体的硬件添加更多细节,如初始化代码、具体的寄存器读写等。此外,可能还需要添加调试信息、错误处理,以及可能的电源管理功能。