Miniscale Unit

Miniscale 类用于与迷你称重传感器进行接口连接，该传感器包含一个 HX711 22-bit ADC。该传感器能够测量重量，并且还包含 LED 控制以及多种滤波等附加功能。

支持以下产品：

UiFlow2 应用示例

基本示例

在 UiFlow2 中打开 m5cores3_miniscales_base_example.m5f2 项目。

该示例演示如何从 MiniScale unit 读取并显示重量值。它将平均滤波等级设置为 10，以获得更平滑的读数，并每 1 秒更新一次重量显示。

UiFlow2 代码块：

示例输出：

None

校准示例

在 UiFlow2 中打开 m5cores3_miniscales_calibrate_example.m5f2 项目。

该示例演示 MiniScale 单元的完整校准流程。它引导用户完成三步校准：首先移除所有物品并记录零点 ADC 值，然后放置 100 g 砝码并记录该 ADC 值，最后执行 tare 操作以设置零点。校准完成后，将以平均滤波等级 5 显示重量。

UiFlow2 代码块：

示例输出：

None

MicroPython 应用示例

基本示例

该示例演示如何从 MiniScale unit 读取并显示重量值。它将平均滤波等级设置为 10，以获得更平滑的读数，并每 1 秒更新一次重量显示。

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
from unit import MiniScaleUnit
import time


page0 = None
label_title = None
label_weight = None
i2c0 = None
miniscales_0 = None
last_time = None
weight = None


def setup():
    global page0, label_title, label_weight, i2c0, miniscales_0, last_time, weight

    M5.begin()
    Widgets.setRotation(1)
    m5ui.init()
    page0 = m5ui.M5Page(bg_c=0xFFFFFF)
    label_title = m5ui.M5Label(
        "MiniScales",
        x=94,
        y=5,
        text_c=0x0000FF,
        bg_c=0xFFFFFF,
        bg_opa=0,
        font=lv.font_montserrat_24,
        parent=page0,
    )
    label_weight = m5ui.M5Label(
        "Weights: -- g",
        x=81,
        y=90,
        text_c=0x0000FF,
        bg_c=0xFFFFFF,
        bg_opa=0,
        font=lv.font_montserrat_24,
        parent=page0,
    )

    i2c0 = I2C(0, scl=Pin(1), sda=Pin(2), freq=100000)
    miniscales_0 = MiniScaleUnit(i2c0)
    miniscales_0.set_average_filter_level(10)
    page0.screen_load()


def loop():
    global page0, label_title, label_weight, i2c0, miniscales_0, last_time, weight
    M5.update()
    if (time.ticks_diff((time.ticks_ms()), last_time)) >= 1000:
        last_time = time.ticks_ms()
        weight = int(miniscales_0.weight)
        label_weight.set_text(str((str("Weight: ") + str((str(weight) + str(" g"))))))


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

校准示例

该示例演示 MiniScale 单元的完整校准流程。它引导用户完成三步校准：首先移除所有物品并记录零点 ADC 值，然后放置 100 g 砝码并记录该 ADC 值，最后执行 tare 操作以设置零点。校准完成后，将以平均滤波等级 5 显示重量。

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
from unit import MiniScaleUnit
import time


page0 = None
label_weight = None
button0 = None
label_tip = None
label_title = None
i2c0 = None
miniscales_0 = None
state = None
adc_0 = None
adc_100 = None
last_time = None
weight = None


def button0_short_clicked_event(event_struct):
    global \
        page0, \
        label_weight, \
        button0, \
        label_tip, \
        label_title, \
        i2c0, \
        miniscales_0, \
        state, \
        adc_0, \
        adc_100, \
        last_time, \
        weight
    Speaker.tone(888, 200)
    if state == 0:
        state = 1
        adc_0 = miniscales_0.adc
        print((str("ADC0 Value: ") + str(adc_0)))
        label_tip.set_text(str("Put 100g weight, then press button."))
    elif state == 1:
        state = 2
        adc_100 = miniscales_0.adc
        print((str("ADC100 Value: ") + str(adc_100)))
        print("do calibrate")
        miniscales_0.calibration(0, adc_0, 100, adc_100)
        label_tip.set_text(str("Remove all items, then press button."))
    elif state == 2:
        state = 3
        print("tare the scale")
        print((str("Tare: ") + str((str((miniscales_0.weight)) + str(" g")))))
        miniscales_0.tare()
        label_tip.set_text(str("Weight"))
        label_tip.set_flag(lv.obj.FLAG.HIDDEN, True)
        button0.set_flag(lv.obj.FLAG.HIDDEN, True)
        miniscales_0.set_average_filter_level(5)


def button0_event_handler(event_struct):
    global \
        page0, \
        label_weight, \
        button0, \
        label_tip, \
        label_title, \
        i2c0, \
        miniscales_0, \
        state, \
        adc_0, \
        adc_100, \
        last_time, \
        weight
    event = event_struct.code
    if event == lv.EVENT.SHORT_CLICKED and True:
        button0_short_clicked_event(event_struct)
    return


def setup():
    global \
        page0, \
        label_weight, \
        button0, \
        label_tip, \
        label_title, \
        i2c0, \
        miniscales_0, \
        state, \
        adc_0, \
        adc_100, \
        last_time, \
        weight

    M5.begin()
    Widgets.setRotation(1)
    m5ui.init()
    page0 = m5ui.M5Page(bg_c=0xFFFFFF)
    label_weight = m5ui.M5Label(
        "Weight: ",
        x=14,
        y=90,
        text_c=0x0000FF,
        bg_c=0xFFFFFF,
        bg_opa=0,
        font=lv.font_montserrat_24,
        parent=page0,
    )
    button0 = m5ui.M5Button(
        text="Button",
        x=116,
        y=160,
        bg_c=0x2196F3,
        text_c=0xFFFFFF,
        font=lv.font_montserrat_16,
        parent=page0,
    )
    label_tip = m5ui.M5Label(
        "Tip:",
        x=10,
        y=50,
        text_c=0x000000,
        bg_c=0xFFFFFF,
        bg_opa=0,
        font=lv.font_montserrat_16,
        parent=page0,
    )
    label_title = m5ui.M5Label(
        "MiniScales",
        x=93,
        y=5,
        text_c=0x0000FF,
        bg_c=0xFFFFFF,
        bg_opa=0,
        font=lv.font_montserrat_24,
        parent=page0,
    )

    button0.add_event_cb(button0_event_handler, lv.EVENT.ALL, None)

    i2c0 = I2C(0, scl=Pin(1), sda=Pin(2), freq=100000)
    miniscales_0 = MiniScaleUnit(i2c0)
    page0.screen_load()
    label_tip.set_text(str("Remove all items, then press button."))
    label_weight.set_text(str("Weight: -- g"))
    label_weight.align_to(page0, lv.ALIGN.CENTER, 0, 0)
    state = 0
    button0.set_size(100, 50)
    button0.align_to(page0, lv.ALIGN.CENTER, 0, 60)
    Speaker.begin()
    Speaker.setVolumePercentage(0.6)
    Speaker.tone(888, 200)


def loop():
    global \
        page0, \
        label_weight, \
        button0, \
        label_tip, \
        label_title, \
        i2c0, \
        miniscales_0, \
        state, \
        adc_0, \
        adc_100, \
        last_time, \
        weight
    M5.update()
    if state == 3:
        if (time.ticks_diff((time.ticks_ms()), last_time)) >= 1000:
            last_time = time.ticks_ms()
            weight = int(miniscales_0.weight)
            label_weight.set_text(str((str("Weight:  ") + str((str(weight) + str(" g"))))))
            label_weight.align_to(page0, lv.ALIGN.CENTER, 0, 0)


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参考

MiniScaleUnit

class unit.miniscale.MiniScaleUnit(i2c, address=0x26)

创建一个 MiniScaleUnit 对象。

参数:

i2c (I2C | PAHUBUnit) – 用于通信的 I2C 或 PAHUBUnit 实例。
address (int) – MiniScale 单元的 I2C 地址，默认为 0x26。

UiFlow2 代码块：

MicroPython 代码块：

from unit import MiniScaleUnit
from hardware import I2C, Pin

i2c0 = I2C(0, scl=Pin(1), sda=Pin(2), freq=100000)
miniscale_0 = MiniScaleUnit(i2c0)

adc()

读取原始 ADC 值（未处理）。

返回:: 原始 ADC 值（整数）。
返回类型:: int

UiFlow2 代码块：

MicroPython 代码块：

adc_value = miniscale_0.adc

weight()

读取当前重量（克）。

返回:: 实际重量（扣除皮重值后的 float）。
返回类型:: float

UiFlow2 代码块：

MicroPython 代码块：

weight_value = miniscale_0.weight

button()

读取按钮状态。

返回:: 按下时为 True，未按下时为 False。
返回类型:: bool

UiFlow2 代码块：

MicroPython 代码块：

button_state = miniscale_0.button

tare()

去皮操作。将当前重量记录为偏移值，使后续重量读数以当前值为零点。

UiFlow2 代码块：

MicroPython 代码块：

miniscale_0.tare()

set_led(r, g, b)

设置 RGB 指示灯颜色。

参数:

r (int) – 红色分量（0~255）。
g (int) – 绿色分量（0~255）。
b (int) – 蓝色分量（0~255）。

UiFlow2 代码块：

MicroPython 代码块：

miniscale_0.set_led(255, 0, 0)

reset()

重置模块内部重量寄存器（清零）。

UiFlow2 代码块：

MicroPython 代码块：

miniscale_0.reset()

calibration(weight1_g, weight1_adc, weight2_g, weight2_adc)

校准模块增益（GAP 值）。

校准流程示例：1. 重置 offset 2. 读取空载 ADC（RawADC_0g）3. 放置已知重量（例如 100 g）并读取 ADC（RawADC_100g）4. 计算 GAP = (RawADC_100g - RawADC_0g) / 100 5. 写入模块以保存校准系数

参数:

weight1_g (float) – 第一个点的重量（单位：g）。
weight1_adc (int) – 第一个点的 ADC 值。
weight2_g (float) – 第二个点的重量（单位：g）。
weight2_adc (int) – 第二个点的 ADC 值。

抛出:

ValueError – 如果两个权重相等。

UiFlow2 代码块：

MicroPython 代码块：

miniscale_0.calibration(0, adc_0, 100, adc_100)

set_low_pass_filter(enabled)

启用或禁用低通滤波器。

参数:: enabled (bool) – True 用于启用过滤器，False 用于禁用过滤器。

UiFlow2 代码块：

MicroPython 代码块：

miniscale_0.set_low_pass_filter(True)

get_low_pass_filter()

获取低通滤波器状态。

返回:: 如果已启用过滤器，则为 True。
返回类型:: bool

UiFlow2 代码块：

MicroPython 代码块：

filter_enabled = miniscale_0.get_low_pass_filter()

set_average_filter_level(level)

设置平均滤波等级。

参数:: level (int) – 平均计数等级（0~50），数值越高表示越平滑，但延迟越大。
抛出:: ValueError – 如果超出范围。

UiFlow2 代码块：

MicroPython 代码块：

miniscale_0.set_average_filter_level(10)

get_average_filter_level()

获取平均滤波等级。

返回:: 当前平均滤波等级（整数）。
返回类型:: int

UiFlow2 代码块：

MicroPython 代码块：

filter_level = miniscale_0.get_average_filter_level()

set_ema_filter_alpha(alpha)

设置指数移动平均（EMA）滤波器参数。

EMA（指数移动平均）滤波器相比平均滤波器对数据变化更敏感。

参数:: alpha (int) – EMA 滤波系数 (0~99)，数值越小越平滑，但响应延迟越大。
抛出:: ValueError – 如果超出范围。

UiFlow2 代码块：

MicroPython 代码块：

miniscale_0.set_ema_filter_alpha(50)

get_ema_filter_alpha()

获取 EMA 滤波器系数。

返回:: 当前 EMA alpha 值（整数）。
返回类型:: int

UiFlow2 代码块：

MicroPython 代码块：

ema_alpha = miniscale_0.get_ema_filter_alpha()