Mini ToF-90° Unit

这是 Mini ToF-90° Unit 的驱动库，用于从距离传感器获取数据。

支持以下产品：

UiFlow2 应用示例

获取距离值

在 UiFlow2 中打开 tof90_core2_example.m5f2 项目。

该示例获取 Mini ToF-90° Unit 的距离值，并将其显示在屏幕上。

UiFlow2 代码块：

示例输出：

None

MicroPython 应用示例

获取距离值

该示例获取 Mini ToF-90° Unit 的距离值，并将其显示在屏幕上。

MicroPython 代码块：

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

import os, sys, io
import M5
from M5 import *
from hardware import I2C
from hardware import Pin
from unit import ToF90Unit


title0 = None
label0 = None
label1 = None
i2c0 = None
minitof90_0 = None


def setup():
    global title0, label0, label1, i2c0, minitof90_0

    M5.begin()
    Widgets.fillScreen(0x222222)
    title0 = Widgets.Title(
        "Core2 Mini ToF-90  Example", 3, 0xFFFFFF, 0x0000FF, Widgets.FONTS.DejaVu18
    )
    label0 = Widgets.Label("label0", 2, 110, 1.0, 0xFFFFFF, 0x222222, Widgets.FONTS.DejaVu18)
    label1 = Widgets.Label("label1", -85, 149, 1.0, 0xFFFFFF, 0x222222, Widgets.FONTS.DejaVu18)

    i2c0 = I2C(0, scl=Pin(33), sda=Pin(32), freq=100000)
    minitof90_0 = ToF90Unit(i2c0, 0x29)
    minitof90_0.start_continuous()


def loop():
    global title0, label0, label1, i2c0, minitof90_0
    M5.update()
    if minitof90_0.get_data_ready():
        label0.setText(str((str("Distance:") + str((str((minitof90_0.get_range())) + str("mm"))))))


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")

示例输出：

None

API参考

ToF90Unit

class unit.tof.ToF90Unit(i2c, address=41)

基类：VL53L0X

创建一个 VL53L0X 对象。

参数:

i2c (I2C) – VL53L0X 连接到的 I2C 总线。
address (int) – VL53L0X 的 I2C 地址。默认值为 0x29。

UiFlow2 代码块：

MicroPython 代码块：

from unit import ToF90Unit

i2c0 = I2C(0, scl=Pin(1), sda=Pin(2), freq=100000)
tof_0 = ToF90Unit(i2c0)

VL53L0X

class driver.vl53l0x.VL53L0X(i2c, address=41, io_timeout_ms=0)

基类：object

创建一个 VL53L0X 对象。

参数:

i2c (I2C) – VL53L0X 连接到的 I2C 总线。
address (int) – VL53L0X 的 I2C 地址。默认值为 0x29。
io_timeout_ms (int) – I/O 操作的超时时间。默认值为 0。

MicroPython 代码块：

from driver import VL53L0X

i2c0 = I2C(0, scl=Pin(1), sda=Pin(2), freq=100000)
vl53l0x_0 = VL53L0X(i2c0)

get_measurement_timing_budget()

获取以微秒为单位的测量时序预算。

返回:: 测量时序预算（以微秒为单位）。
返回类型:: int

UiFlow2 代码块：

MicroPython 代码块：

budget_ms = vl53l0x_0.get_measurement_timing_budget()

set_measurement_timing_budget(budget_us)

设置测量时序预算，单位为微秒。

参数:: budget_us (int) – 测量时序预算（单位：微秒，范围 20000 - 200000）。
返回类型:: None

UiFlow2 代码块：

MicroPython 代码块：

budget_ms = vl53l0x_0.get_measurement_timing_budget()

get_distance()

对传感器前方的物体执行一次测距，并以厘米为单位返回距离。

返回:: 以厘米为单位的距离。
返回类型:: float

MicroPython 代码块：

distance = vl53l0x_0.get_distance()

get_range()

对传感器前方的物体执行一次测距，并返回以毫米为单位的距离。

返回:: 以毫米为单位的距离。
返回类型:: float

UiFlow2 代码块：

MicroPython 代码块：

distance = vl53l0x_0.get_range()

get_data_ready()

获取传感器的数据就绪状态。

返回:: 传感器的数据就绪状态。
返回类型:: bool

UiFlow2 代码块：

MicroPython 代码块：

data_ready = vl53l0x_0.get_data_ready()

is_continuous_mode()

获取传感器的连续模式状态。

返回:: 传感器的连续模式状态。
返回类型:: bool

UiFlow2 代码块：

MicroPython 代码块：

continuous_mode = vl53l0x_0.is_continuous_mode()

start_continuous()

将传感器设置为连续模式。

UiFlow2 代码块：

MicroPython 代码块：

vl53l0x_0.start_continuous()

返回类型:: None

stop_continuous()

将传感器设置为单次测距模式。

UiFlow2 代码块：

MicroPython 代码块：

vl53l0x_0.stop_continuous()

返回类型:: None

set_address(new_address=41)

为传感器设置新的 I2C 地址。

参数:: new_address (int) – 要分配给 VL53L0X 传感器的 7 位 int。
返回类型:: None

UiFlow2 代码块：

MicroPython 代码块：

vl53l0x_0.set_address(0x2A)