在虚拟 IoT 设备上集成 VL53L0X 距离传感器：IoT-For-Beginners 水果质量检测项目实战-育师

在虚拟 IoT 设备上集成 VL53L0X 距离传感器：IoT-For-Beginners 水果质量检测项目实战

【免费下载链接】IoT-For-Beginners12 Weeks, 24 Lessons, IoT for All!项目地址: https://gitcode.com/GitHub_Trending/io/IoT-For-Beginners

本篇技术指南围绕开源课程项目 IoT-For-Beginners 第 4 章「Trigger fruit quality detection from a sensor」中的虚拟设备环节展开，讲解如何在 CounterFit 模拟器中创建一个虚拟距离传感器，并通过distance-sensor.py以每秒一次的频率读取距离数据。读完本文后，你将掌握 CounterFit 虚拟硬件的工作原理、VL53L0X 飞行时间（Time-of-Flight）传感器的 I2C 配置要点，以及如何用「距离读数」作为水果质量检测系统的触发信号。

背景：距离传感器在水果质量检测中的角色

在完整的果蔬品控原型中，传送带上的水果需要被自动检测、拍照、分类。整个应用可抽象为「Things（设备）— Insights（洞察）— Actions（动作）」三层：带接近传感器的 IoT 设备负责检测水果是否到达拍照位置，这是整个流水线第一环的触发器。正如 4-trigger-fruit-detector 课程说明所描述，传感器通过测量与水果之间的距离来判断其是否到达传送带上的正确位置，一旦距离满足阈值即可触发相机拍照与边缘端图像分类。

接近传感器的工作原理是发射一束电磁辐射（如激光或红外光），再检测物体反射回来的信号，通过发射与回波之间的时间差计算距离。VL53L0X 正是这样一颗基于激光测距模块的飞行时间传感器。在真实硬件上它通过 I2C 总线与开发板通信，而在虚拟设备方案中，我们使用 CounterFit 模拟器配合 shim 库来模拟同样的行为。

前置条件：虚拟 IoT 硬件方案与 CounterFit

本环节面向「单板计算机 - 虚拟设备」路径，也就是说你不需要真实的 Raspberry Pi 或 Wio Terminal 硬件，只需：

已创建好的fruit-quality-detectorPython 项目（VS Code 中打开，并激活虚拟环境）；
正在运行的CounterFit Web 应用——它是一个图形化模拟器，可创建虚拟传感器并随机或手动调整读数；
额外的 shim 包counterfit-shims-rpi-vl53l0x，用于在 CounterFit 中模拟rpi-vl53l0xPip 包的行为。

💡 用 CounterFit 模拟多个 IoT 设备有一个简单技巧：把每个设备写成独立的 Python 文件，然后同时运行它们。这样单台开发机即可模拟「距离传感器设备 + 相机设备 + LED 通知设备」的完整多设备架构。

第一步：在 CounterFit 中添加虚拟距离传感器

在fruit-quality-detector项目中，按以下步骤在 CounterFit 中创建距离传感器：

打开 VS Code 中的fruit-quality-detector代码，确保虚拟环境已激活；
在已激活虚拟环境的终端中安装 shim 包：
```
pip install counterfit-shims-rpi-vl53l0x
```
该包模拟的是 rpi-vl53l0x——一个与 VL53L0X 飞行时间距离传感器交互的 Python 包，而 VL53L0X 对应 Grove Time of Flight 距离传感器；
确保 CounterFit Web 应用已运行；
在Sensors面板的Create sensor区域创建距离传感器：
- 在Sensor type下拉框中选择Distance；
- Units保持默认的Millimeter（毫米）；
- 将 I2C 地址设为0x29。若使用真实的 VL53L0X 传感器，该地址同样是硬编码的；
- 点击Add按钮完成创建。

创建成功后，传感器会出现在传感器列表中，可随时修改其读数以模拟水果靠近/远离。

第二步：编写 distance-sensor.py 读取距离

在fruit-quality-detector项目中新建文件distance-sensor.py，逐段加入以下代码。

1. 建立与 CounterFit 的连接

from counterfit_connection import CounterFitConnection CounterFitConnection.init('127.0.0.1', 5000)

这里通过本机127.0.0.1:5000端口连接 CounterFit 服务。

2. 导入 shim 传感器库

import time from counterfit_shims_rpi_vl53l0x.vl53l0x import VL53L0X

该导入引用的是 VL53L0X 飞行时间传感器的 CounterFit shim 库，API 与真实硬件库保持一致，便于日后无缝迁移到物理设备。

3. 声明并初始化传感器

distance_sensor = VL53L0X() distance_sensor.begin()

声明一个距离传感器实例，然后调用begin()启动传感器。

4. 无限循环读取距离

while True: distance_sensor.wait_ready() print(f'Distance = {distance_sensor.get_distance()} mm') time.sleep(1)

wait_ready()等待传感器产生一个可读的测量值，get_distance()返回以毫米为单位的距离，随后每秒打印一次。

5. 运行并验证

运行前请注意：文件名为distance-sensor.py，务必用 Python 直接运行它，而不是app.py。

python distance-sensor.py

在 CounterFit 中手动修改距离值或开启随机值，控制台会实时更新输出：

(.venv) ➜ fruit-quality-detector python distance-sensor.py Distance = 37 mm Distance = 42 mm Distance = 29 mm

至此，你的虚拟接近传感器程序已经成功运行。

仓库源码佐证：完整实现与多平台对照

本教程的完整可运行代码已保存在仓库中，可直接对照阅读：

虚拟设备版本：distance_sensor.py 与上文代码完全一致，包含 CounterFit 连接初始化、VL53L0X()实例化、begin()、wait_ready()/get_distance()循环的完整调用链；
Raspberry Pi 版本：pi 版本 distance_sensor.py 展示了从虚拟到真实的迁移方式——将counterfit_shims_rpi_vl53l0x替换为真实的rpi_vl53l0x.vl53l0x与grove.i2c.Bus，并通过VL53L0X(bus = Bus().bus)传入 I2C 总线。两者的while True读取循环结构完全相同，这正是 shim 方案的设计价值：应用层代码无需大改即可切换硬件；
Wio Terminal 版本：wio-terminal 工程使用 C++ 与 PlatformIO，在platformio.ini中通过lib_deps引入seeed-studio/Grove Ranging sensor - VL53L0X，在setup中调用VL53L0X_common_init()与VL53L0X_high_accuracy_ranging_init()，在loop中用PerformSingleRangingMeasurement()获取RangeMilliMeter读数——三种平台实现同一逻辑，便于理解底层 SDK 的异同。