Zynq-Linux移植學習筆記之16-Zynq下linux XADC驅動
XADC模塊的使用方法,一是直接用FPGA JTAG專用接口訪問,這時XADC模塊工作在缺省模式;二是在設計中例化XADC模塊,這是可以通過FPGA邏輯或ZYNQ器件的PS到ADC模塊的專用接口訪問。例化XADC模塊有兩種基本形式:一是ISE和PlanAhead環境下LogiCOREIP核的形式調用,二是EDK環境下對LogiCOREIP核的調用。這兩種調用方法相信對使用過XILINX產品的朋友來說操作界面與步驟都很熟悉,這里就不贅述了,主要是想說明下XADC模塊原語,以期對這模塊有個基本的了解。
1、 簡介
XADC是zynq芯片內部進行溫度和電壓檢測的模塊,通過(http://www.wiki.xilinx.com/xadc)這篇wiki可以知道,XADC控制器有兩種表現形式,一種是位於PS內部,即文檔中提到的the PS-XADC interface for the PS software to control the XADC,另一種是位於PL內部,通過IP核的方式實現。目前常用的是第一種。
通過ug480_7Series_XADC這篇文檔得知,The ADCs can access up to 17 external analog input channels,也就是除了內部原有的監測項外,XADC最多支持17路擴展通道,可以參看下圖。
對硬件有了基本的了解后,就可以進行devicetree的設置了。
2、 devicetree配置
由於是在PS部分,XADC控制器設置就像其他控制器一樣即可,system.hdf中給出了地址:
Devicetree設置如下:
- xadc@f8007100 {
- compatible= "xlnx,zynq-xadc-1.00.a";
- reg =<0xf8007100 0x20>;
- interrupts= <0 7 4>;
- interrupt-parent = <&gic>;
- clocks =<&pcap_clk>;
- xlnx,channels {
- #address-cells = <1>;
- #size-cells = <0>;
- channel@0 {
- reg= <0>;
- };
- channel@1 {
- reg= <1>;
- };
- channel@8 {
- reg= <8>;
- };
- };
- };
這里只啟用了三個channel,如果啟用更多channel可以在devicetree中進行添加。
3、 kernel配置
內核中已經包含了xadc的驅動程序,位置是drivers\iio\adc,最后三個xilinx打頭的文件。將驅動加入內核配置過程如下:
如果為了省事,也可以直接在defconfig文件中加入配置信息,這樣默認是選中的。
4、 測試
加載devicetree,uimage,uramdisk后能在sys目錄下找到檢測信息:
打開in_temp0_raw能看到數字,注意,該數字是原始數字,需要轉換才能得到正確的攝氏度。
該數字不斷變化,表明溫度在變化。其他電壓信息類似。
為了更直觀的展現監測信息,可以做一個用戶app來打印,代碼如下:
- #define MAX_PATH_SIZE 200
- #define MAX_NAME_SIZE 50
- #define MAX_VALUE_SIZE 100
- #define MAX_CMD_NAME_SIZE 100
- #define MAX_UNIT_NAME_SIZE 50
- #define SYS_PATH_IIO "/sys/bus/iio/devices/iio:device0"
- #define VCC_INT_CMD "xadc_get_value_vccint"
- #define VCC_AUX_CMD "xadc_get_value_vccaux"
- #define VCC_BRAM_CMD "xadc_get_value_vccbram"
- #define VCC_TEMP_CMD "xadc_get_value_temp"
- #define VCC_EXT_CH_CMD "xadc_get_value_ext_ch"
- static const int mV_mul = 1000;
- static const int multiplier = 1 << 12;
- static char gNodeName[MAX_NAME_SIZE];
- enum EConvType
- {
- EConvType_None,
- EConvType_Raw_to_Scale,
- EConvType_Scale_to_Raw,
- EConvType_Max
- };
- enum XADC_Param
- {
- EParamVccInt,
- EParamVccAux,
- EParamVccBRam,
- EParamTemp,
- EParamVAux0,
- EParamMax
- };
- struct command
- {
- const enum XADC_Param parameter_id;
- const char cmd_name[MAX_CMD_NAME_SIZE];
- const char unit[MAX_UNIT_NAME_SIZE];
- };
- struct command command_list[EParamMax] = {
- {EParamVccInt, VCC_INT_CMD, "mV"},
- {EParamVccAux, VCC_AUX_CMD, "mV"},
- {EParamVccBRam, VCC_BRAM_CMD, "mV"},
- {EParamTemp, VCC_TEMP_CMD, "Degree Celsius"},
- {EParamVAux0, VCC_EXT_CH_CMD, "mV"}
- };
- struct XadcParameter
- {
- const char name[MAX_NAME_SIZE];
- float value;
- float (* const conv_fn)(float,enum EConvType);
- };
- /*
- struct XadcParameter gXadcData[EParamMax] = {
- [EParamVccInt] = { "in_voltage0_vccint_raw", 0, conv_voltage},
- [EParamVccAux] = { "in_voltage4_vccpaux_raw", 0, conv_voltage},
- [EParamVccBRam]= { "in_voltage2_vccbram_raw", 0, conv_voltage},
- [EParamTemp] = { "in_temp0_raw", 0, conv_temperature},
- [EParamVAux0] = { "in_voltage8_raw", 0, conv_voltage_ext_ch}
- };
- */
- #include <stdio.h>
- #include <string.h>
- #include <errno.h>
- #include <unistd.h>
- #include <dirent.h>
- #include <stdlib.h>
- #include <sys/ioctl.h>
- #include <fcntl.h>
- #include <ctype.h>
- #include <pthread.h>
- #include <assert.h>
- #include "xadc_core.h"
- //utility functions
- float conv_voltage(float input, enum EConvType conv_direction)
- {
- float result=0;
- switch(conv_direction)
- {
- case EConvType_Raw_to_Scale:
- result = ((input * 3.0 * mV_mul)/multiplier);
- break;
- case EConvType_Scale_to_Raw:
- result = (input/(3.0 * mV_mul))*multiplier;
- break;
- default:
- printf("Convertion type incorrect... Doing no conversion\n");
- // intentional no break;
- case EConvType_None:
- result = input;
- break;
- }
- return result;
- }
- float conv_voltage_ext_ch(float input, enum EConvType conv_direction)
- {
- float result=0;
- switch(conv_direction)
- {
- case EConvType_Raw_to_Scale:
- result = ((input * mV_mul)/multiplier);
- break;
- case EConvType_Scale_to_Raw:
- result = (input/mV_mul)*multiplier;
- break;
- default:
- printf("Convertion type incorrect... Doing no conversion\n");
- // intentional no break;
- case EConvType_None:
- result = input;
- break;
- }
- return result;
- }
- float conv_temperature(float input, enum EConvType conv_direction)
- {
- float result=0;
- switch(conv_direction)
- {
- case EConvType_Raw_to_Scale:
- result = ((input * 503.975)/multiplier) - 273.15;
- break;
- case EConvType_Scale_to_Raw:
- result = (input + 273.15)*multiplier/503.975;
- break;
- default:
- printf("Conversion type incorrect... Doing no conversion\n");
- // intentional no break;
- case EConvType_None:
- result = input;
- break;
- }
- return result;
- }
- void get_iio_node()
- {
- struct dirent **namelist;
- int i,n;
- char value=0;
- int fd = -1;
- char upset[20];
- float raw_data=0;
- float true_data=0;
- int offset=0;
- int currpos;
- n = scandir(SYS_PATH_IIO, &namelist, 0, alphasort);
- for (i=0; i < n; i++)
- {
- sprintf(gNodeName,"%s/%s", SYS_PATH_IIO, namelist[i]->d_name);
- fd = open(gNodeName, O_RDWR );
- if(strstr(gNodeName,"temp"))
- {
- if(strstr(gNodeName,"raw"))
- {
- offset=0;
- while(offset<5)
- {
- lseek(fd,offset,SEEK_SET);
- read(fd,&value,sizeof(char));
- upset[offset]=value;
- offset++;
- }
- upset[offset]='\0';
- raw_data=atoi(upset);
- true_data=conv_temperature(raw_data, EConvType_Raw_to_Scale);
- printf("%s is %f cent\n",namelist[i]->d_name,true_data);
- }
- }
- else if(strstr(gNodeName,"voltage"))
- {
- if(strstr(gNodeName,"raw"))
- {
- offset=0;
- while(offset<5)
- {
- lseek(fd,offset,SEEK_SET);
- read(fd,&value,sizeof(char));
- upset[offset]=value;
- offset++;
- }
- upset[offset]='\0';
- raw_data=atoi(upset);
- true_data=conv_voltage(raw_data, EConvType_Raw_to_Scale);
- printf("%s is %f mv\n",namelist[i]->d_name,true_data);
- }
- }
- close(fd);
- }
- }
- int main(int argc, char *argv[])
- {
- get_iio_node();
- return 0;
- }
在編寫這段代碼時遇到好幾個問題,首先用read函數取值取到的其實是 文件中ASCII碼字符,沒有什么好辦法只好改成一位一位讀取存入字符串然后調用atoi函數轉換為int數字。其次,用lseek函數獲取文件大小時得 到的值都為4096,但是這些文件並不是目錄,不知道為何大小都顯示的是linux最基本的文件塊大小,最后只好投機取巧根據每個文件中的數字位數進行取 值,例如temp和vcc這些文件只有4位,那么就從文件中讀4位。最后輸出結果如下:
上圖中溫度為39度,和實際情況差不多。至此XADC驅動告一段落。