nanoFramework.Iot.Device.Vl53L0X 1.2.590

VL53L0X - 距离传感器

VL53L0X 传感器是一种时间-of-飞行传感器，可以精确测量距离。该传感器允许您获取精确的短距离测量（从 5 毫米到 2 米），以及长距离测量（最高可达 8 米，但精度降低）。此传感器是激光测距传感器。它使用激光脉冲来测量距离。

文档

VL53L0X 数据表

您可以在以下位置找到此设备："距离传感器" 或 "Adafruit VL53L0X 时间-of-飞行距离传感器 - ~30 到 1000mm"

板

用法

重要：在创建 I2cDevice 之前，请确保正确设置 I2C 引脚，特别是对于 ESP32，确保已安装 nanoFramework.Hardware.ESP32 nuget

//////////////////////////////////////////////////////////////////////
// when connecting to an ESP32 device, need to configure the I2C GPIOs
// used for the bus
Configuration.SetPinFunction(21, DeviceFunction.I2C1_DATA);
Configuration.SetPinFunction(22, DeviceFunction.I2C1_CLOCK);

对于其他设备（如 STM32），请确保您正在使用所需 I2C 总线的预设引脚。

所有校准和传感器设置都完全透明地为您完成。只需创建一个类，读取一次距离，或使用连续测量方法。

Vl53L0X vL53L0X = new Vl53L0X(I2cDevice.Create(new I2cConnectionSettings(1, Vl53L0X.DefaultI2cAddress)));
Debug.WriteLine($"Rev: {vL53L0X.Information.Revision}, Prod: {vL53L0X.Information.ProductId}, Mod: {vL53L0X.Information.ModuleId}");
while (true)
{
    try
    {
        Debug.WriteLine($"Distance: {vL53L0X.Distance}");
    }
    catch (Exception ex)
    {
        Debug.WriteLine($"Exception: {ex.Message}");
    }
    Thread.Sleep(500);
}

请注意，在使用连续或单次测量功能读取距离时，可能会遇到异常，您应该捕获它。

您还可以获取单次测量，在这种情况下，精度可能较低。使用 MeasurementMode 属性来更改模式。

您还可以调整所需测量的类型。默认情况下，传感器设置为长距离模式。这确实允许在 2 米范围内获得相当准确的（±5%）精度，但仍可以测量到 8 米的距离（精度明显不正确）。您可以使用 SetPrecision 函数切换到短距离模式。如果想要设置自己的模式，应结合使用 SetSignalRateLimit 和 SetVcselPulsePeriod 函数以及 HighResolution 属性，如下例所示

HighResolution = false;
SetSignalRateLimit(0.25);
SetVcselPulsePeriod(VcselType.VcselPeriodPreRange, PeriodPulse.Period14);
SetVcselPulsePeriod(VcselType.VcselPeriodFinalRange, PeriodPulse.Period10);

请参考文档以了解更改各种脉冲以及使用高分辨率精度测量的影响。传感器在长距离上无法保持精度，通常情况下，它能看到的距离越长，数据就越不精确。高分辨率将返回更精确的测量值，但主要在短距离内。

更改默认 I2C 地址

您可以调整用于此传感器的 I2C 地址。以下是解释如何做到这一点的代码片段

// Code snippet to change the address of a sensor
byte newAddress = 0x28; // You can change for any valid supported address
I2cDevice connectionToCurrentAddress = I2cDevice.Create(new I2cConnectionSettings(1, Vl53L0X.DefaultI2cAddress));
Vl53L0X.ChangeI2cAddress(connectionToCurrentAddress, newAddress);
I2cDevice connectionToChangedAddress = I2cDevice.Create(new I2cConnectionSettings(1, newAddress));
using Vl53L0X vlWithChangedAddress = new(connectionToChangedAddress);
// Do what you'd like to do here
// Soft reset the device to setup the default address again
vlWithChangedAddress.Reset();
// Now the address is reset to the default one