核心驅動 ina2xx

支援的晶片

  • 德州儀器 INA219

    字首:‘ina219’ 地址:I2C 0x40 - 0x4f

    資料手冊:可在德州儀器網站上公開獲取

  • 德州儀器 INA220

    字首:‘ina220’

    地址:I2C 0x40 - 0x4f

    資料手冊:可在德州儀器網站上公開獲取

  • 德州儀器 INA226

    字首:‘ina226’

    地址:I2C 0x40 - 0x4f

    資料手冊:可在德州儀器網站上公開獲取

  • 德州儀器 INA230

    字首:‘ina230’

    地址:I2C 0x40 - 0x4f

    資料手冊:可在德州儀器網站上公開獲取

  • 德州儀器 INA231

    字首:‘ina231’

    地址:I2C 0x40 - 0x4f

    資料手冊:可在德州儀器網站上公開獲取

  • 德州儀器 INA260

    字首:‘ina260’

    地址:I2C 0x40 - 0x4f

    資料手冊:可在德州儀器網站上公開獲取

  • 矽力傑 SY24655

    字首:‘sy24655’

    地址:I2C 0x40 - 0x4f

    資料手冊:可在矽力傑網站上公開獲取

作者:Lothar Felten <lothar.felten@gmail.com>

描述

INA219 是一款帶有 I2C 介面的高側電流分流器和功率監控器。INA219 可監控分流壓降和電源電壓,並具有可程式設計的轉換時間和濾波功能。

INA220 是一款帶有 I2C 介面的高側或低側電流分流器和功率監控器。INA220 可監控分流壓降和電源電壓。

INA226 是一款帶有 I2C 介面的電流分流器和功率監控器。INA226 可監控分流壓降和匯流排電源電壓。

INA230 和 INA231 是一款帶有 I2C 介面的高側或低側電流分流器和功率監控器。這些晶片可監控分流壓降和匯流排電源電壓。

INA260 是一款帶有整合式分流電阻器的高側或低側電流和功率監控器。

SY24655 是一款帶有 I2C 介面的高側和低側電流分流器和功率監控器。SY24655 支援分流壓降和電源電壓,並具有可程式設計的校準值和轉換時間。SY24655 還可以計算平均功率,用於能量轉換。

分流值(以微歐姆為單位)可以在編譯時透過平臺數據或裝置樹設定,也可以在執行時透過 sysfs 中的 shunt_resistor 屬性設定。如果使用裝置樹,請參考 Documentation/devicetree/bindings/hwmon/ti,ina2xx.yaml 以獲取繫結資訊。

此外,ina226 支援 update_interval 屬性,如 sysfs 檔案的命名和資料格式標準 中所述。在內部,該間隔是匯流排和分流電壓轉換時間之和乘以平均速率。我們不修改轉換時間,只修改平均數。update_interval 的下限為 2 毫秒,上限為 2253 毫秒。實際程式設計的間隔可能與期望值不同。

通用 sysfs 條目

in0_input

分流電壓(毫伏)通道

in1_input

匯流排電壓(毫伏)通道

curr1_input

電流(毫安)測量通道

power1_input

功率(微瓦)測量通道

shunt_resistor

分流電阻(微歐姆)通道(不適用於 ina260)

適用於 ina226、ina230、ina231、ina260 和 sy24655 的額外 sysfs 條目

curr1_lcrit

臨界低電流

curr1_crit

臨界高電流

curr1_lcrit_alarm

電流臨界低報警

curr1_crit_alarm

電流臨界高報警

in0_lcrit

臨界低分流電壓

in0_crit

臨界高分流電壓

in0_lcrit_alarm

分流電壓臨界低報警

in0_crit_alarm

分流電壓臨界高報警

in1_lcrit

臨界低匯流排電壓

in1_crit

臨界高匯流排電壓

in1_lcrit_alarm

匯流排電壓臨界低報警

in1_crit_alarm

匯流排電壓臨界高報警

power1_crit

臨界高功率

power1_crit_alarm

功率臨界高報警

update_interval

資料轉換時間;影響用於平均分流和匯流排電壓結果的樣本數量。

僅適用於 sy24655 的 sysfs 條目

power1_average

從上次讀數到當前的平均功率。

注意

  • 在配置 power1_crit 之前,請先配置 shunt_resistor,因為功率值是根據設定的 shunt_resistor 計算的。

  • 由於底層的暫存器實現,只有一個 *crit 設定及其 alarm 可以處於活動狀態。寫入一個 *crit 設定會清除其他 *crit 設定和報警。將 0 寫入任何 *crit 設定會清除所有 *crit 設定和報警。