Faces Calculator3 模块

Faces Calculator3 是一个计算器键盘模块。它通过回调报告释放的按键编码，默认使用 I2C 地址 0x08。

支持以下产品：

UiFlow2 应用示例

按键事件显示

该示例在 CoreS3 显示屏上报告释放的按键。回调函数会收到释放的按键编码，将其转换为字符并显示。

在 UiFlow2 中打开 faces_calculator3_cores3_example.m5f2 项目。

UiFlow2 代码块：

MicroPython 应用示例

按键事件显示

在主循环中定期调用 FacesCalculator3Module.tick()，轮询新的按键事件。

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

import os, sys, io
import M5
from M5 import *
from module import FacesCalculator3Module


title0 = None
label0 = None
faces_calculator3_0 = None


event_args = None


def faces_calculator3_0_key_event(args):
    global title0, label0, faces_calculator3_0, event_args
    event_args = chr(args)
    label0.setText(str((str("Key: ") + str(event_args))))


def setup():
    global title0, label0, faces_calculator3_0, event_args

    M5.begin()
    Widgets.setRotation(1)
    Widgets.fillScreen(0x222222)
    title0 = Widgets.Title(
        "Faces Calculator3 CoreS3 Example", 3, 0xFFFFFF, 0x0000FF, Widgets.FONTS.Montserrat18
    )
    label0 = Widgets.Label("label0", 1, 112, 1.0, 0xFFFFFF, 0x222222, Widgets.FONTS.Montserrat18)

    faces_calculator3_0 = FacesCalculator3Module(address=0x08)
    faces_calculator3_0.set_callback(faces_calculator3_0_key_event)


def loop():
    global title0, label0, faces_calculator3_0, event_args
    M5.update()
    faces_calculator3_0.tick()


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

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

API参考

class module.faces.FacesCalculator3Module(address=8)

基类：_FacesModule

创建 Faces Calculator3 Module 对象。

参数:: address (int) – I2C 地址，默认为 0x08。

UiFlow2 代码块：

MicroPython 代码块：

from module import FacesCalculator3Module

faces_calculator3 = FacesCalculator3Module()

set_callback(handler)

设置按键事件回调。

回调函数会收到释放的按键编码。传入 None 可禁用回调。

参数:: handler – 接收一个按键编码或 None 的可调用对象。
返回类型:: None

tick()

轮询一次；有按键事件时调用回调。

UiFlow2 代码块：

MicroPython 代码块：

faces_calculator3.tick()

返回类型:: None

get_device_id()

获取 Faces 模块的设备类型 ID。

返回:: 设备类型 ID。
返回类型:: int

UiFlow2 代码块：

MicroPython 代码块：

device.get_device_id()

get_firmware_version()

获取固件版本。

返回:: 固件版本。
返回类型:: int

UiFlow2 代码块：

MicroPython 代码块：

device.get_firmware_version()

get_i2c_address()

获取当前 7 位 I2C 地址。

返回:: 当前 I2C 地址。
返回类型:: int

UiFlow2 代码块：

MicroPython 代码块：

device.get_i2c_address()

get_uid()

获取 MCU 的 96 位唯一标识符。

返回:: 12 字节的唯一标识符。
返回类型:: bytes

UiFlow2 代码块：

MicroPython 代码块：

device.get_uid()

set_i2c_address(address)

设置并保存新的 7 位 I2C 地址。

参数:: address (int) – 新地址范围为 0x08 到 0x77。
返回类型:: None

UiFlow2 代码块：

MicroPython 代码块：

device.set_i2c_address(0x08)

计算器按键常量：

常量	值	按键
`KEY_BACKSPACE`	`0x08`	退格
`KEY_ENTER`	`0x0D`	回车
`KEY_AC`	`0x41`	全部清除
`KEY_MEMORY`	`0x4D`	存储器
`KEY_PERCENT`	`0x25`	百分比
`KEY_DIVIDE`	`0x2F`	除法
`KEY_MULTIPLY`	`0x2A`	乘法
`KEY_MINUS`	`0x2D`	减法
`KEY_PLUS`	`0x2B`	加法
`KEY_SIGN`	`0x60`	正负号
`KEY_EQUAL`	`0x3D`	等号