INA226 Unit

这是 INA226 Unit 的驱动库，用于从 INA226 传感器获取电流和功率数据。

支持以下产品：

UiFlow2 应用示例

获取值

在 UiFlow2 中打开 ina226_core2_example.m5f2 项目。

该示例从 INA226 Unit 获取电流、电压和功率值，并将其显示在屏幕上。

UiFlow2 代码块：

示例输出：

None

MicroPython 应用示例

获取值

该示例从 INA226 Unit 获取电流、电压和功率值，并将其显示在屏幕上。

MicroPython 代码块：

# SPDX-FileCopyrightText: 2025 M5Stack Technology CO LTD
#
# SPDX-License-Identifier: MIT

import os, sys, io
import M5
from M5 import *
import m5ui
import lvgl as lv
from hardware import I2C
from hardware import Pin
import time
from unit import INA226Unit


page0 = None
label0 = None
label1 = None
label2 = None
label3 = None
i2c0 = None
ina226_0 = None


def setup():
    global page0, label0, label1, label2, label3, i2c0, ina226_0

    M5.begin()
    Widgets.setRotation(1)
    m5ui.init()
    page0 = m5ui.M5Page(bg_c=0xFFFFFF)
    label0 = m5ui.M5Label(
        "Bus Voltage:",
        x=0,
        y=56,
        text_c=0x000000,
        bg_c=0xFFFFFF,
        bg_opa=0,
        font=lv.font_montserrat_16,
        parent=page0,
    )
    label1 = m5ui.M5Label(
        "Current:",
        x=0,
        y=88,
        text_c=0x000000,
        bg_c=0xFFFFFF,
        bg_opa=0,
        font=lv.font_montserrat_16,
        parent=page0,
    )
    label2 = m5ui.M5Label(
        "Power:",
        x=0,
        y=124,
        text_c=0x000000,
        bg_c=0xFFFFFF,
        bg_opa=0,
        font=lv.font_montserrat_16,
        parent=page0,
    )
    label3 = m5ui.M5Label(
        "Shunt Voltage:",
        x=0,
        y=161,
        text_c=0x000000,
        bg_c=0xFFFFFF,
        bg_opa=0,
        font=lv.font_montserrat_16,
        parent=page0,
    )

    i2c0 = I2C(0, scl=Pin(33), sda=Pin(32), freq=100000)
    ina226_0 = INA226Unit(i2c0, 0x41, type="1A")
    page0.screen_load()


def loop():
    global page0, label0, label1, label2, label3, i2c0, ina226_0
    M5.update()
    time.sleep_ms(500)
    label0.set_text(
        str((str("Bus Voltage:") + str((str((ina226_0.read_bus_voltage())) + str("V")))))
    )
    label1.set_text(str((str("Current:") + str((str((ina226_0.read_current())) + str("A"))))))
    label2.set_text(str((str("Power:") + str((str((ina226_0.read_power())) + str("W"))))))
    label3.set_text(
        str((str("Shunt Voltage:") + str((str((ina226_0.read_shunt_voltage())) + str("V")))))
    )


if __name__ == "__main__":
    try:
        setup()
        while True:
            loop()
    except (Exception, KeyboardInterrupt) as e:
        try:
            m5ui.deinit()
            from utility import print_error_msg

            print_error_msg(e)
        except ImportError:
            print("please update to latest firmware")

示例输出：

None

API参考

INA226Unit

class unit.ina226.INA226Unit(i2c, address=65, type='10A')

基类：INA226

创建一个 INA226Unit 对象。

参数:

i2c (I2C) – Accel Unit 连接的 I2C 总线。
address (int) – 设备的 I2C 地址。默认为 0x41。
type (str) – INA226 的类型。默认值为 “10A”。可选值为 “1A” 和 “10A”。

UiFlow2 代码块：

MicroPython 代码块：

from hardware import I2C
from unit import INA226Unit

i2c0 = I2C(0, scl=Pin(1), sda=Pin(2), freq=100000)
ina226_0 = INA226Unit(i2c0, address=0x41, type="10A")

INA226

class driver.ina226.INA226(i2c, addr=64, shunt_resistor=0.02)

基类：object

创建一个 INA226 对象。

参数:

i2c (I2C) – INA226 连接到的 I2C 总线。
address (int) – 设备的 I2C 地址。
shunt_resistor (float) – 分流电阻的阻值（单位：Ω）。默认值为 0.2。

UiFlow2 代码块：

MicroPython 代码块：

from hardware import I2C
from driver import INA226

i2c0 = I2C(0, scl=Pin(1), sda=Pin(2), freq=100000)
ina226 = INA226(i2c0, 0x40, shunt_resistor=0.02)

calibrate(max_expected_current=0, cal_value=None)

校准 INA226。

参数:

max_expected_current (float) – 最大预期电流，单位为安培。
cal_value (int) – 要使用的校准值。如果为 None，则会根据预期最大电流和分流电阻值进行计算。

MicroPython 代码块：

ina226_0.calibrate(10)

ina226_0.calibrate(cal_value=0xC80)

read_shunt_voltage()

读取分流电压（单位：V）。

返回:: 分流电阻电压（单位：V）。
返回类型:: float

UiFlow2 代码块：

MicroPython 代码块：

ina226_0.read_shunt_voltage()

read_bus_voltage()

读取总线电压，单位为 V。

返回:: 总线电压，单位为 V。
返回类型:: float

UiFlow2 代码块：

MicroPython 代码块：

ina226_0.read_bus_voltage()

read_current()

以安培为单位读取电流。

返回:: 电流，单位为安培。
返回类型:: float

UiFlow2 代码块：

MicroPython 代码块：

ina226_0.read_current()

read_power()

读取以瓦特 (W) 为单位的功率。

返回:: 功率，单位为 Watt。
返回类型:: float

UiFlow2 代码块：

MicroPython 代码块：

ina226_0.read_power()