上一篇笔记中学习了ADC驱动,STM32MP157 也有DAC外设,DAC也使用的IIO驱动框架。本章就来学习一下如下在Linux下使用STM32MP157上的DAC。
DAC简介
ADC是模数转换器,负责将外界的模拟信号转换为数字信号。DAC刚好相反,是数模转换器,负责将SOC的数字信号转换为模拟信号。
STM32MP157的DAC模块(数字/模拟转换模块)是12位数字输入,电压输出型的DAC。DAC可以配置为8位或12位模式,也可以与DMA控制器配合使用。DAC工作在12位模式
时,数据可以设置成左对齐或右对齐。DAC模块有2个输出通道,每个通道都有独立的转换器。在双DAC模式下,2个通道可以独立地进行转换,也可以同时进行转换并同步地更新2个通道的输出。DAC可以通过引脚输入参考电压Vref+(同ADC共用)以获得更精确的转换结果。STM32MP157的DAC模块主要特点有:
- 1个DAC 接口,最大两个DAC输出通道。
- 12位模式下数据左对齐或者右对齐。
- 同步更新功能。
- 噪声波、三角波形生成。
- 外部触发。
- 双DAC通道同时或者分别转换。
- 每个通道都有DMA功能。
- 输入参考电压VREF+。
- ……
STM32MP157 DAC框图如下图所示:
图中VDDA和VSSA为DAC模块模拟部分的供电,而VREF+则是DAC模块的参考电压。DAC_OUT1/2就是DAC的两个输出通道了,DAC_OUT1对应PA4引脚,DAC_OUT2对应PA5引脚。正点原子STM32MP157开发板使用DAC_OUT1,引脚为PA4。
DAC驱动源码分析
设备树下的DAC节点
stm32mp151.dtsi文件中的dac节点信息如下:
第2行,compatible属性值为“st,stm32h7-dac-core”,所以在整个Linux源码里面搜索这个字符串即可找到STM32MP157的DAC驱动核心文件,这个文件就是drivers/iio/dac/stm32-dac-core.c。
第11、18行,compatible属性值“st,stm32-dac”,搜索这个字符串,可以找到ADC驱动文件,这个文件就是drivers/iio/dac/stm32-dac.c。
关于STM32MP157的DAC节点更为详细的信息请参考对应的绑定文档:Documentation/devicetree/bindings/iio/dac/st,stm32-dac.txt。接下来简单分析一下绑定文档,后面需要根据绑定文档修改设备树,使能DAC对应的通道。
DAC首先需要一个根节点,DAC根节点属性如下:
1、必要属性
- compatible:兼容性属性,必须的,可以设置为“st,stm32h7-dac-core”。
- reg:DAC控制器寄存器信息。
- clocks:时钟。
- clock-names:时钟名字,必须为“pclk”。
- vref-supply:此属性对应vref参考电压句柄。
- address-cells:设置为1。
- size-cells:设置为0。
2、可选属性
- :pinctrl 引脚配置信息。
- resets:复位句柄。
STM32MP157有两个DAC通道,每个DAC通道对应一个子节点,DAC子节点相关属性
如下:
- compatible:兼容性属性,必须的,可以设置为“st,stm32-dac”。
- reg:不同ADC控制器寄存器地址偏移信息。
- io-channel-cells:设置为1。
DAC驱动源码分析
STM32MP157 DAC驱动文件也有两个:stm32-dac-core.c和stm32-dac.c。stm32-dac-core.c是DAC核心层,主要用于DAC时钟、电源等初始化。需要重点关注的是stm32-dac.c这个文件。stm32-adc.c主体框架是platform,配合IIO驱动框架实现DAC驱动。
stm32_dac结构体
首先来看一下stm32_dac结构体,内如如下:
stm32_dac结构体很简单,比上一章的stm32_adc结构体要简单很多,只有一个stm32_dac_common成员变量,内容如下:
可以看出,DAC驱动也采用了regmap API。
stm32_dac_probe函数
接下来看一下stm32_dac_probe函数,内容如下(有省略):
第12行,调用devm_iio_device_alloc函数申请iio_dev,这里也连stm32_dac内存一起申请
了。
第17行,调用iio_priv函数从iio_dev里面得到stm32_dac首地址。
第19-23行,初始化iio_dev,重点是第22行的stm32_dac_iio_info,因为用户空间读取或设置DAC数据最终就是由stm32_dac_iio_info来完成的。
第25行,调用stm32_dac_chan_of_init函数设置DAC通道。
第36行,调用iio_device_register函数向内核注册iio_dev。
同样的stm32_dac_probe函数核心就是初始化DAC,然后建立DAC的IIO驱动框架。
stm32_dac_iio_info结构体
stm32_dac_iio_info结构体内容如下所示:
第2行,stm32_dac_read_raw函数用于读取DAC信息,读取DAC原始数据值、分辨率等。
第3行,stm32_dac_write_raw函数用于设置DAC值。
stm32_dac_read_raw和stm32_dac_write_raw函数内容如下:
第1-17行,stm32_dac_read_raw函数,读取DAC的原始值以及分辨率,非常简单。
第19-31行,stm32_dac_write_raw函数,向DAC写入原始值,也就是设置DAC。
硬件原理图分析
DAC原理图如下:
上一章讲ADC的时候,说了JP2是一个3P的排针,用来设置ADC连接可调电位器还DAC。本章学习使用DAC,因此可以使用跳线帽将JP2的1,2引脚连接起来。也就是将DAC和ADC连接在一起,如下图所示:
可以编写应用程序设置DAC,然后再使用ADC采集回去。正点原子STM32MP157开发板使用了DAC通道 1,引脚为PA4。
DAC驱动编写
修改设备树
DAC驱动ST已经编写好了,只需要修改设备树即可。首先在stm32mp15-pinctrl.dtsi文件中添加DAC使用的PA4引脚配置信息:
示例代码 58.4.1.1 PA4 引脚配置信息
1 dac_ch1_pins_a: dac-ch1 {
2 pins {
3 pinmux = <STM32_PINMUX('A', 4, ANALOG)>;
4 };
5 };
接下来在stm32mp157d-atk.dts文件中向根节点添加vdd子节点信息,内容如下:
示例代码 58.4.1.2 vdd 子节点
1 v3v3: regulator-3p3v {
2 compatible = "regulator-fixed";
3 regulator-name = "v3v3";
4 regulator-min-microvolt = <3300000>;
5 regulator-max-microvolt = <3300000>;
6 regulator-always-on;
7 regulator-boot-on;
8 };
最后在stm32mp157d-atk.dts 文件中向 adc 节点追加一些内容,内容如下:
示例代码 58.4.1.3 adc 节点
1 &dac {
2 pinctrl-names = "default";
3 pinctrl-0 = <&dac_ch1_pins_a>;
4 vref-supply = <&v3v3>;
5 status = "okay";
6 dac1: dac@1 {
7 status = "okay";
8 };
9 };
第3行,配置dac引脚。
第4行,设置电压属性。
第6-8行,dac1子节点,设置很简单,直接将status属性设置为“okay”即可。
使能DAC驱动
同样的,使能Linux内核中的ST32MP157 DAC驱动,打开Linux内核配置界面,配置路
径如下:
-> Device Drivers -> Industrial I/O support (IIO [=y]) -> Digital to analog converters -> <*>STMicroelectronics STM32 DAC //使能 STM32 DAC |
如下图所示:
编写测试APP
编译修改后的设备树,然后使用新的设备树启动系统。进入/sys/bus/iio/devices目录下,此目录下就有DAC对应的iio设备:iio:deviceX,本章例程如下图所示:
上图中有两个IIO设备:iio:device0和iio:device1,可以依次进入这两个目录查
看分别对应什么外设。教程中当前所使用的开发板中iio:device0为ADC(上一章实验使能的 ADC驱动),iio:device1为本章使能的DAC设备。
进入“iio:device1”目录,内容如下图所示:
标准的IIO设备文件目录,只关心三个文件:
- out_voltage1_powerdown:DAC输出使能文件,写0打开DAC,写1关闭DAC,默认为1,也就是关闭DAC。
- out_voltage1_raw:DAC1通道 1原始值文件。
- out_voltage1_scale:DAC1比例文件(分辨率),单位为mV。实际输出电压值(mV)=out_voltage1_raw * out_voltage1_scale。out_voltage1_scale默认值如下图所示:
从上图可以看出,out_voltage1_scale默认为0.805664062。
DAC1默认12位,因此可设置范围为0-4095。向out_voltage1_raw写入2000,命令如下:
echo 0 > /sys/bus/iio/devices/iio:device1/out_voltage1_powerdown //开启 DAC echo 2000 > /sys/bus/iio/devices/iio:device1/out_voltage1_raw //设置 DAC |
此时DAC输出的理论电压值为2000*0.805664062≈1611.328mV。
那么DAC输出是否正确呢?直接使用上一章编写的adcAPP.c读取DAC引脚电压值就行了。这里注意,一定要先按照之前的连接示意图所示,将JP2的右边两根排针连接起来,也就是将DAC和ADC引脚连接在一起。
运行上一章的adcApp.c,结果如下图所示:
从上图可以看出,ADC采集到的电压为1.61V,和设置的DAC理论值基本一致。这里要注意,DAC1是12位的,而ADC是16位的,因此可以看到他们的原始值会不一样。
接下来编译一个简单的DAC测试APP,APP等待用户输入DAC原始值,一旦用户输入以后就调用ADC来采集DAC输出的电压值,最后将DAC理论值与ADC采集到的实际值打印出来,看一下是否正确。
这里的过程基本相似,先设置char字符数组指针file_path放置iio框架对应的文件路径,并enum对应的文件索引,然后设置dac的设备结构体,存一下raw、scale和act就可以了。
之后编写file_data_read,是一样的操作,fopen打开然后fscanf扫描,遇到EOF就fseek调到头然后fclose。
之后写dac_add_dac_read函数来获取ADC、DAC数据,这里就是file_data_read然后atoi、atof得到原始值和比例,之后经过换算把实际值存到dac_dev结构体指针dev的adc_act成员变量中;之后同样方法获取DAC的理论真实值存到dev->dac_act中。
之后编写dac_enable,里面就是system来调用控制台进而使能DAC。dac_disable也是同理。
之后编写dac_set函数,设置DAC,这里就是sprintf将传入的value转为字符串,然后fopen打开文件,fseek把文件指针调整到文件头,fwrite写入转为字符串的value,之后fclose关闭文件。
最后写main函数,argc就1个,首先要dac_enable使能DAC,之后再while中scanf获取输入的目标dac设置值,然后通过fgets来获取输入值,之后dac_set把这个值传给DAC,调用dac_add_dac_read来获取数据,成功后就打印当前dac和adc值。
运行测试
编译驱动程序和测试APP
输入如下编译dacApp.c这个测试程序:
arm-none-linux-gnueabihf-gcc -march=armv7-a -mfpu=neon -mfloat-abi=hard dacApp.c -o dacApp |
编译成功以后就会生成dacApp这个应用程序。
运行测试
注意,在测试之前一定要先按照接线示意图所示,将JP2跳线帽接到右边,也就是将ADC1_CH19通道连接到开发板上DAC1引脚上!
输入如下命令,使用dacApp测试程序:
./dacApp |
APP运行以后会等待输入要设置的DAC值,每输入一次就会自动打印出ADC采集到的实际ADC值以及DAC的理论值,如下图所示:
上图中设置了0、500、1000、2000、3000和4095共6个DAC原始值,可以看出DAC设置的理论值和ADC采集到的实际值基本一致。
总结
DAC和ADC总体就很接近,都是ST官方已经写好了驱动,总体就是platform驱动加上regmap配合IIO驱动来完成。