當(dāng)前位置:首頁 > 公眾號精選 > 嵌入式微處理器
[導(dǎo)讀]前陣子工作上做了一些關(guān)于 ADC 的支持,由于現(xiàn)在 ADC 相關(guān)的支持都被移動到了 IIO (Industrial I/O) 子系統(tǒng)下,我查閱了一些關(guān)于 IIO 資料,包括書籍、文章、內(nèi)核文檔和代碼。個人感覺最好的入門文章應(yīng)該是 ST WiKi 網(wǎng)站上 的 IIO Overview(2019) 和 Analog



前陣子工作上做了一些關(guān)于 ADC 的支持,由于現(xiàn)在 ADC 相關(guān)的支持都被移動到了 IIO (Industrial I/O) 子系統(tǒng)下,我查閱了一些關(guān)于 IIO 資料,包括書籍、文章、內(nèi)核文檔和代碼。個人感覺最好的入門文章應(yīng)該是 ST WiKi 網(wǎng)站上 的 IIO Overview(2019) 和 Analog Device Wiki 網(wǎng)站上的 Linux Industrial I/O Subsystem(2017),為了方便愛偷懶或者英文不好的小伙伴,我提煉了多篇文章的精華內(nèi)容并在其基礎(chǔ)上進(jìn)行完善,盡量控制篇幅,希望能給大家提供一點(diǎn)小小的幫助。

Linux 驅(qū)動開發(fā) / IIO子系統(tǒng)入門1

正文目錄:
    
1. 什么是 IIO 子系統(tǒng)?
  1.1 IIO 概述
  1.2 IIO 相關(guān)的組件
2. IIO 功能特性
3. IIO 相關(guān)配置  
  3.1 配置內(nèi)核
  3.2 配置設(shè)備樹
    3.2.1 IIO providers
    3.2.2 IIO consumers
4. IIO API
  4.1 用戶空間 API
    4.1.1 4種接口
    4.1.2 操作實(shí)例
5. 更多值得學(xué)習(xí)的知識點(diǎn)
6. 相關(guān)參考
寫作目的:
  • 整理一些 IIO 子系統(tǒng)的入門知識。

1. 什么是 IIO 子系統(tǒng)?

1.1 IIO 概述

Industrial I/O 子系統(tǒng)旨在為某種意義上是模數(shù)或數(shù)模轉(zhuǎn)換器 (ADC,DAC) 的設(shè)備提供支持,于2009年由 Huawei 的 Jonathan Cameront 添加。
簡單框圖:
支持的設(shè)備包括:
    
ADC / DAC
加速度計(jì)
磁力計(jì)
陀螺儀
壓力傳感器
濕度傳感器
溫度傳感器
...
很久以前,對于上述硬件的支持散落在 Linux 源碼中的各種地方。
IIO 的出現(xiàn),提供了一個統(tǒng)一的框架用于訪問和控制上述各種類型的傳感器,并且為用戶態(tài)應(yīng)用訪問傳感器提供了標(biāo)準(zhǔn)的接口:sysfs/devfs,并且填補(bǔ)了 Hwmon 和 Input 子系統(tǒng)之間的空白
另外,IIO 不僅可以支持低速的 SoC ADC,還可支持高速、高數(shù)據(jù)速率的工業(yè)設(shè)備,例如 100M samples/sec 工業(yè) ADC。

1.2 IIO 相關(guān)的組件

IIO-overview
上圖基于 STM32 MPU,來源見文末。
1) 客戶端應(yīng)用程序(用戶空間):

該組件會使用 libiio 庫來配置 IIO 設(shè)備,然后從 IIO 設(shè)備讀數(shù)據(jù)或者寫數(shù)據(jù)到 IIO 設(shè)備中??蛻舳顺绦蚩梢约?xì)分為 local client 和 remote client。
2) libiio 庫(用戶空間):

libiio 是 Analog Device 公司發(fā)起的一個用于訪問 IIO 設(shè)備的開源庫。
它封裝了對 /sys/bus/iio/devices(配置 iio) 和 /dev/iio/deviceX(讀寫iio) 的訪問,并且提供了便于測試的 iio 命令行工具 (iio_info / iio_readdev) 和 iiod server
iiod server 內(nèi)含 local backend 和 remote backend 以支持 local client 和 remote client 的訪問。
libiio 的源碼位于:github libiio
3) 訪問接口(用戶空間):
iio 支持多種標(biāo)準(zhǔn)的 Linux 設(shè)備訪問接口:
char device, sysfs, configfs, debugfs。
4) 內(nèi)核空間的 iio 消費(fèi)者(即 IIO consumers):

除了用戶空間的應(yīng)用程序能訪問 iio 設(shè)備之外,在內(nèi)核里也有其他設(shè)備驅(qū)動需要使用 iio 子系統(tǒng)的 API 來編寫符合自身框架的設(shè)備驅(qū)動。
例如在 iio 子系統(tǒng)里支持了某款 Soc ADC 后,可能會有不同的硬件設(shè)備接到該 ADC 通道上,典型的例子是觸摸芯片,開發(fā)人員需要在 input 子系統(tǒng)的框架下編寫 touch driver,在 touch driver的 irq handler 中 調(diào)用 iio in-kern API 來讀取觸摸屏的 X、Y 值。
iio in-kernl API的定義位于頭文件:
include/linux/iio/consumer.h
5) IIO framework(內(nèi)核空間):
IIO 子系統(tǒng)的核心實(shí)現(xiàn)。
6) IIO device driver(或稱 IIO providers):
7) Linux 內(nèi)核自帶的 IIO 調(diào)試工具:

2. IIO 的功能特性

相關(guān)參考:
  • Linux-4.14/drivers/staging/iio/Documentation/overview.txt
1) 基礎(chǔ)的設(shè)備注冊和訪問
  • 類似于 hwmon 子系統(tǒng),它們都可以通過 sysfs 以輪循的方式訪問設(shè)備;
2) 可讀取事件的字符設(shè)備(Event chrdevs)
  • 類似于 input 子系統(tǒng),iio 子系統(tǒng)也可以向應(yīng)用層上報(bào)事件(hardware triggered events),例如閾值檢測事件,自由落體檢測事件、更復(fù)雜的動作檢測事件;

  • 目前 event 的格式為:event code + 時間戳;

3) 支持硬件 buffer
4) 支持 Trigger 和軟件 buffer

3. IIO 相關(guān)配置

3.1 配置內(nèi)核

Linux-4.14:
    
$ make menuconfig
Device Drivers  --->
  <*> Industrial I/O support  --->
    [*]   Enable buffer support within IIO
     < >     IIO callback buffer used  for push in-kernel interfaces
     <*>     Industrial I/O HW buffering
     <*>     Industrial I/O buffering based on kfifo
     < >   Enable IIO configuration via configfs                        
     [*]    Enable triggered sampling support
     (2)     Maximum number of consumers per trigger                    
     < >   Enable software triggers support                             
           Accelerometers  --->                                         
           Analog to digital converters  --->                          
           Amplifiers  --->                                             
           Chemical Sensors  --->                                       
           Hid Sensor IIO Common  ----                                  
           SSP Sensor Common  --->                                      
           Digital to analog converters  --->                           
           IIO dummy driver  --->                                       
           Frequency Synthesizers DDS/PLL  --->                         
           Digital gyroscope sensors  --->                              
           Health Sensors  --->                                         
           Humidity sensors  --->                                       
           Inertial measurement units  --->                             
           Light sensors  --->                                          
           Magnetometer sensors  --->                                   
           Inclinometer sensors  ----                                   
           Triggers - standalone  --->                                  
           Digital potentiometers  --->                                 
           Pressure sensors  --->                                       
           Lightning sensors  --->                                      
           Proximity sensors  --->                                      
           Temperature sensors  --->
從配置項(xiàng)的數(shù)目來看,IIO 的用途真的很廣泛。

3.2 配置設(shè)備樹

相關(guān)參考:
  • Linux-4.14/Documentation/devicetree/bindings/iio/iio-bindings.txt

3.2.1 IIO providers

1) 相關(guān)要點(diǎn):
  • IIO channels 源在設(shè)備樹中用 IIO providers 來指定;
2) 必要屬性:
  • io-channel-cells,0 表示只有 1 路 IIO output,1 表示有多路 IIO output;

  • io-channel-ranges: 一個 empty 屬性(即不用賦值),會在 driver/iio/inkern.c/iio_channel_get() 中被引用,它表明繼承了當(dāng)前節(jié)點(diǎn)的子節(jié)點(diǎn)可以引用當(dāng)前節(jié)點(diǎn)的 IIO channel;

3) 例子1 (no trigger)
    
adc: voltage-sensor@ 35 {
  compatible =  "maxim,max1139";
  reg = < 0x35>;
   #io-channel-cells = <1>;
};
4) 例子2 (with trigger)
    
adc@ 35 {
  compatible =  "some-vendor,some-adc";
  reg = < 0x35>;

  adc1: iio-device@ 0 {
     #io-channel-cells = <1>;
     /* other properties */
  };
  adc2: iio-device@ 1 {
     #io-channel-cells = <1>;
     /* other properties */
  };
};

3.2.2 IIO consumers

1) 相關(guān)要點(diǎn):
  • IIO consumer 節(jié)點(diǎn)的形式是 <phandle iio_specifier>;

  • 它的作用是連接 IIO provider 的 input 端到 IIO consumer 的 output 端;

  • 其中,phandle 是 IIO provider 的句柄,specifier 用于選擇第幾路 channel;

  • 類似 gpio specifier, IIO specifier 是有 1 個或者多個 cells 的數(shù)組,用于確定 IIO device的 output 端,即 1 個 cell 對應(yīng)一個 IIO channel output;

  • IIO specifier 數(shù)組的長度由 IIO provider 節(jié)點(diǎn)的 #io-channel-cells 屬性決定;

2) 必要屬性:
  • io-channels: <phandle iio_specifier> 列表, 一個 <phandle iio_specifier> 代表該設(shè)備連接著的一路 IIO input。如果 IIO provider 的 io-channel-cells=0 (即只有1路 IIO output), 則省略 iio_specifier。
3) 可選屬性:
  • io-channel-names: IIO input 的名稱列表,順序要和 io-channels 屬性保持一致,Consumers drivers 會將該名稱和 iio_specifier 指定的 IIO input match 到一起。
4) 例子1
    
some_consumer {
  io-channels = <&adc  1>, <&ref  0>;
  io-channel-names =  "vcc""vdd";
 };
上述例子的引用了provider &adc 的第1路 channel,和proiver &ref 的第0路 channel。

4. IIO API

4.1 用戶空間 API

相關(guān)參考:
  • IIO user space interface
  • How to use the IIO user space interface

4.1.1 4種接口

1). sysfs interface
  • /sys/bus/iio/devices/iio:deviceX;

  • 可用于配置 /dev/iio:deviceX 接口的 events / data

  • 可用于輪循的方式低速地直接讀/寫 IIO 設(shè)備;

  • Documentation/ABI/testing/sysfs-bus-iio;

2). character device
  • /dev/iio:deviceX,該接口在 IIO 子系統(tǒng)里是可選非必要的;

  • 標(biāo)準(zhǔn)的文件 IO API: open(), read(), write(), close().

  • 用于讀取 events 和 data;

3). configfs
  • 用于配置額外的 IIO 特性,例如:軟件 triggers 或者 hrtimer triggers;

  • 詳細(xì)說明:

    • Documentation/ABI/testing/configfs-iio;
    • Documentation/iio/iio_configfs.txt;
4). debugfs
  • 一些調(diào)試功能,例如 direct_reg_access 節(jié)點(diǎn)可用于讀寫寄存器;

4.1.2 操作實(shí)例

IIO direct mode: 通過 sysfs 以輪循的方式讀 ADC 或者寫 DAC:
1) 直接讀 ADC
確定 sysfs 節(jié)點(diǎn)(方式1,不依賴工具)
    
$ grep -H  "" /sys/bus/iio/devices /*/name | grep adc
/sys/bus/iio/devices/iio:device0/name:48003000.adc:adc@0
/sys/bus/iio/devices/iio:device1/name:48003000.adc:adc@1
sysfs 中的 iio:device0 sysfs 對應(yīng) ADC1;
    
$ cd /sys/bus/iio/devices/iio:device0/
$ cat in_voltage6_raw      # Convert ADC1 channel  0 (analog-to-digital): get raw value
40603
$ cat in_voltage_scale     # Read scale
0.044250488
$ cat in_voltage_offset    # Read offset
0
$ awk  "BEGIN{printf (\"%d\n\", (40603 + 0) * 0.044250488)}"
1796  
計(jì)算公式: Scaled value = (raw + offset) * scale = 1796 mV;
2) 直接寫 DAC
確定 sysfs 節(jié)點(diǎn)(方式2)
    
$ lsiio | grep dac
Device  00340017000.dac:dac@ 1
Device  00440017000.dac:dac@ 2
sysfs 中的 iio:device3 sysfs 對應(yīng) DAC1,lsiio 來源于Linux 內(nèi)核源碼(tools/iio/)。
    
$ cd /sys/bus/iio/devices/iio:device3/
$ cat out_voltage1_scale              # Read scale
0.708007812
$ awk  "BEGIN{printf (\"%d\n\", 2000 / 0.708007812)}"  # 假設(shè)要輸出  2000 mV
2824
$ echo  2824 > out_voltage1_raw        # Write raw value to DAC1
$ echo  0 > out_voltage1_powerdown     #  Enable DAC1 (out of power-down mode)

5. 更多值得學(xué)習(xí)的知識點(diǎn)

  • 以 timer triggers 和 buffers 的方式讀 ADC 或者寫 DAC;
  • IIO 內(nèi)核空間 API;
  • 編寫 IIO device driver
  • 編寫 IIO consumer driver
  • ...
鑒于大多數(shù)人的注意力無法在一篇文章里上集中太久,更多的內(nèi)容請大家先自行去閱讀吧,不是自己理解到的東西是消化不了的。有機(jī)會的話我會把更多的讀書心得放在后面的文章。

6. 相關(guān)參考

  • IIO Overview
  • Linux Industrial I/O Subsystem
  • 《Linux Device Drivers Development》
本文只是一篇入門的文章,仍然有許多細(xì)節(jié)的知識點(diǎn)沒有被描述到。如果本文能讓你對 IIO 子系統(tǒng)有個大概的認(rèn)識,那么本文的目的也就算達(dá)成了,以后還會繼續(xù)寫更多 IIO 子系統(tǒng)的文章。知識的學(xué)習(xí)應(yīng)該是螺旋上升的,找到一條平緩的學(xué)習(xí)路線很重要,先有一個整體的概念,然后再不斷地去豐富細(xì)節(jié)會比較好一點(diǎn)。就好像爬山一樣,相對于幾千米的高山,人類看起來總是顯得多么的渺小,但是只要每天平穩(wěn)地走幾百個階梯,再高的山也能在不知不覺中走完。

本文授權(quán)轉(zhuǎn)載自公眾號“嵌入式Hacker”,作者吳偉東Jack


-END-




推薦閱讀



【01】數(shù)學(xué)對于編程來說重要嗎?編程大佬現(xiàn)身說“線性代數(shù)”
【02】學(xué)不好后悔一輩子:刨根問底之鏈表數(shù)據(jù)結(jié)構(gòu)
【03】精彩!由FPGA觸發(fā)的芯片戰(zhàn)爭!
【04】12條CPU硬核干貨!最全解釋!
【05】史上最經(jīng)典的“史密斯圓圖”講解

免責(zé)聲明:整理文章為傳播相關(guān)技術(shù),版權(quán)歸原作者所有,如有侵權(quán),請聯(lián)系刪除

免責(zé)聲明:本文內(nèi)容由21ic獲得授權(quán)后發(fā)布,版權(quán)歸原作者所有,本平臺僅提供信息存儲服務(wù)。文章僅代表作者個人觀點(diǎn),不代表本平臺立場,如有問題,請聯(lián)系我們,謝謝!

嵌入式ARM

掃描二維碼,關(guān)注更多精彩內(nèi)容

本站聲明: 本文章由作者或相關(guān)機(jī)構(gòu)授權(quán)發(fā)布,目的在于傳遞更多信息,并不代表本站贊同其觀點(diǎn),本站亦不保證或承諾內(nèi)容真實(shí)性等。需要轉(zhuǎn)載請聯(lián)系該專欄作者,如若文章內(nèi)容侵犯您的權(quán)益,請及時聯(lián)系本站刪除。
換一批
延伸閱讀

9月2日消息,不造車的華為或?qū)⒋呱龈蟮莫?dú)角獸公司,隨著阿維塔和賽力斯的入局,華為引望愈發(fā)顯得引人矚目。

關(guān)鍵字: 阿維塔 塞力斯 華為

加利福尼亞州圣克拉拉縣2024年8月30日 /美通社/ -- 數(shù)字化轉(zhuǎn)型技術(shù)解決方案公司Trianz今天宣布,該公司與Amazon Web Services (AWS)簽訂了...

關(guān)鍵字: AWS AN BSP 數(shù)字化

倫敦2024年8月29日 /美通社/ -- 英國汽車技術(shù)公司SODA.Auto推出其旗艦產(chǎn)品SODA V,這是全球首款涵蓋汽車工程師從創(chuàng)意到認(rèn)證的所有需求的工具,可用于創(chuàng)建軟件定義汽車。 SODA V工具的開發(fā)耗時1.5...

關(guān)鍵字: 汽車 人工智能 智能驅(qū)動 BSP

北京2024年8月28日 /美通社/ -- 越來越多用戶希望企業(yè)業(yè)務(wù)能7×24不間斷運(yùn)行,同時企業(yè)卻面臨越來越多業(yè)務(wù)中斷的風(fēng)險(xiǎn),如企業(yè)系統(tǒng)復(fù)雜性的增加,頻繁的功能更新和發(fā)布等。如何確保業(yè)務(wù)連續(xù)性,提升韌性,成...

關(guān)鍵字: 亞馬遜 解密 控制平面 BSP

8月30日消息,據(jù)媒體報(bào)道,騰訊和網(wǎng)易近期正在縮減他們對日本游戲市場的投資。

關(guān)鍵字: 騰訊 編碼器 CPU

8月28日消息,今天上午,2024中國國際大數(shù)據(jù)產(chǎn)業(yè)博覽會開幕式在貴陽舉行,華為董事、質(zhì)量流程IT總裁陶景文發(fā)表了演講。

關(guān)鍵字: 華為 12nm EDA 半導(dǎo)體

8月28日消息,在2024中國國際大數(shù)據(jù)產(chǎn)業(yè)博覽會上,華為常務(wù)董事、華為云CEO張平安發(fā)表演講稱,數(shù)字世界的話語權(quán)最終是由生態(tài)的繁榮決定的。

關(guān)鍵字: 華為 12nm 手機(jī) 衛(wèi)星通信

要點(diǎn): 有效應(yīng)對環(huán)境變化,經(jīng)營業(yè)績穩(wěn)中有升 落實(shí)提質(zhì)增效舉措,毛利潤率延續(xù)升勢 戰(zhàn)略布局成效顯著,戰(zhàn)新業(yè)務(wù)引領(lǐng)增長 以科技創(chuàng)新為引領(lǐng),提升企業(yè)核心競爭力 堅(jiān)持高質(zhì)量發(fā)展策略,塑強(qiáng)核心競爭優(yōu)勢...

關(guān)鍵字: 通信 BSP 電信運(yùn)營商 數(shù)字經(jīng)濟(jì)

北京2024年8月27日 /美通社/ -- 8月21日,由中央廣播電視總臺與中國電影電視技術(shù)學(xué)會聯(lián)合牽頭組建的NVI技術(shù)創(chuàng)新聯(lián)盟在BIRTV2024超高清全產(chǎn)業(yè)鏈發(fā)展研討會上宣布正式成立。 活動現(xiàn)場 NVI技術(shù)創(chuàng)新聯(lián)...

關(guān)鍵字: VI 傳輸協(xié)議 音頻 BSP

北京2024年8月27日 /美通社/ -- 在8月23日舉辦的2024年長三角生態(tài)綠色一體化發(fā)展示范區(qū)聯(lián)合招商會上,軟通動力信息技術(shù)(集團(tuán))股份有限公司(以下簡稱"軟通動力")與長三角投資(上海)有限...

關(guān)鍵字: BSP 信息技術(shù)
關(guān)閉
關(guān)閉