RK356X ADC 使用

说明

以下用 SAR-ADC 为例子，介绍 ADC 的基本配置方法。

ADC常用接口说明

1、iio_channel_get

struct iio_channel *iio_channel_get(struct device *dev, const char *consumer_channel);
功能：获取 iio 通道描述
参数：
dev: 使用该通道的设备描述指针
consumer_channel: 该设备所使用的 IIO 通道描述指针

2、iio_channel_release

void iio_channel_release(struct iio_channel *chan);
功能：释放 iio_channel_get 函数获取到的通道
参数：
chan：要被释放的通道描述指针

3、iio_read_channel_raw

int iio_read_channel_raw(struct iio_channel *chan, int *val);
功能：读取 chan 通道 AD 采集的原始数据。
参数：
chan：要读取的采集通道指针
val：存放读取结果的指针

DTS配置

配置DTS节点

SAR-ADC 的 DTS 节点在 kernel/arch/arm64/boot/dts/rockchip/rk3568.dtsi 文件中定义，如下所示：

saradc: saradc@fe720000 {
	compatible = "rockchip,rk3568-saradc", "rockchip,rk3399-saradc";
	reg = <0x0 0xfe720000 0x0 0x100>;
	interrupts = <GIC_SPI 93 IRQ_TYPE_LEVEL_HIGH>;
	#io-channel-cells = <1>;
	clocks = <&cru CLK_SARADC>, <&cru PCLK_SARADC>;
	clock-names = "saradc", "apb_pclk";
	resets = <&cru SRST_P_SARADC>;
	reset-names = "saradc-apb";
	status = "disabled";
};

我们首先需在 DTSI 文件中添加 ADC 的资源描述：

kernel/arch/arm64/boot/dts/rockchip/rk356x-demo.dtsi :
   adc_demo: adc_demo{
       status = "okay";
       compatible = "demo,rk356x-adc";
       io-channels = <&saradc 5>; 
   };
   // io-channels 为adc 通道

在驱动文件中匹配 DTS设备节点

驱动可参考 adc demo :kernel/drivers/iio/adc/adc-firefly-demo.c，这是一个侦测 ROC-RK3568-PC 风扇状态的驱动。
首先在驱动文件中定义 of_device_id 结构体数组：

static const struct of_device_id _adc_match[] = {
     { .compatible = "demo,rk356x-adc" },
     {},
};

of_device_id 用于device和driver的match，其在/include/linux/mod_devicetable.h中定义

然后将该结构体数组填充到要使用 ADC 的 platform_driver 中：

static struct platform_driver demo_adc_driver = {
    .probe      = demo_adc_probe,
    .remove     = demo_adc_remove,
    .driver     = {
        .name   = "demo_adc",
        .owner  = THIS_MODULE,
        .of_match_table = demo_adc_match,
        },
};

接着在 demo_adc_probe 中对 DTSI 所添加的资源进行解析：

static int demo_adc_probe(struct platform_device *pdev)
{
     printk("demo_adc_probe!\n");
     chan = iio_channel_get(&(pdev->dev), NULL);
     if (IS_ERR(chan)){
	    chan = NULL;
        printk("%s() have not set adc chan\n", __FUNCTION__);
        return -1;
     }
     fan_insert = false;
     if (chan) {
		INIT_DELAYED_WORK(&adc_poll_work, demo_adc_poll);
		schedule_delayed_work(&adc_poll_work,1000);
     }
     return 0;
}

驱动说明

获取 AD 通道

struct iio_channel *chan;     #定义 IIO 通道结构体
chan = iio_channel_get(&pdev->dev, NULL);    #获取 IIO 通道结构体

注意： iio_channel_get 通过 probe 函数传进来的参数 pdev 获取 IIO 通道结构体，probe 函数如下：

static int demo_probe(struct platform_device *pdev);

读取 AD 采集到的原始数据

int val,ret;
ret = iio_read_channel_raw(chan, &val);

调用 iio_read_channel_raw 函数读取 AD 采集的原始数据并存入 val 中。

计算采集到的电压

使用标准电压将 AD 转换的值转换为所需要的电压值。其计算公式如下：

Vref / (2^n-1) = Vresult / raw

注意：

Vref 为标准电压

n 为 AD 转换的位数

Vresult 为用户所需要的采集电压

raw 为 AD 采集的原始数据
即

Vresult  = Vref / (2^n-1) * raw

假如，标准电压为 1.8V，AD 采集位数为 10 位，AD 采集到的原始数据为 512，则：

Vresult = (1800mv * 512) / 1023;

FAQs：
1、有个便捷的方法可以查询到每个 SARADC 的值

cat /sys/bus/iio/devices/iio\:device0/in_voltage*_raw

2、为何按上面的步骤申请 SARADC，会出现申请报错的情况？
驱动需要获取ADC通道来使用时，需要对驱动的加载时间进行控制，必须要在saradc初始化之后。saradc是使用module_platform_driver()进行平台设备驱动注册，最终调用的是module_init()。所以用户的驱动加载函数只需使用比module_init()优先级低的，例如：late_initcall()，就能保证驱动的加载的时间比saradc初始化时间晚，可避免出错。