该应用通过调用双目摄像头同时采集左右目画面，利用双目视差原理计算目标距离，并提供了摄像头标定、参数调节等辅助功能，可作为双目测距、立体视觉及机器人视觉导航类应用的参考示例。
该应用通过调用双目摄像头同时采集左右目画面，利用双目视差原理计算目标距离，并提供了摄像头标定、参数调节等辅助功能，可作为双目测距、立体视觉及机器人视觉导航类应用的参考示例。
| 配件名称 | 数量 | 规格参数 |
|---|---|---|
| Quectel Pi H1智能主控板 | 1 块 | Quectel Pi H1智能主控板 |
| USB双目摄像头 | 1 个 | 推荐分辨率：2560×720（左右各 1280×720 ）；输出格式：YUYV/MJPG |
| 电源适配器 | 1 个 | 27 W USB Type-C接口充电器 1.2 米线长中规电源PD电源 适用于树莓派 5 代 |
| USB-C DP显示线/HDMI 线 | 1 根 | 规格：DP 1.4；线长：1 m；接口：USB-C（公头）- USB-C（公头） 规格：HDMI 2.0；线长：1 m；接口：HDMI-A（公头）-HDMI-D（公头） |
| CPU散热风扇（可。 | 1 个 | 树莓派 5 代官方原装散热器带导热贴 |
| 显示屏 | 1 个 | 24 英寸HDMI显示器 |
| 棋盘格标定板（可。 | 1 个 | 规格：9×6 内角点（可用手机屏幕显示） |
Quectel Pi H1智能主控板出厂默认搭载Debian 13系统镜像，因此无需再次烧录镜像，仅需按照如下步骤操作即可。
将HDMI线一端接入智能主控板的HDMI接口，另一端接入显示器的HDMI接口。
将USB键盘、鼠标接入智能主控板的两个USB-A接口上，若用无线输入设备，将接收器插入USB口即可。
将USB双目摄像头接入智能主控板的USB-A接口。
将网线一端接入智能主控板的千兆网口，另一端接入路由器的网口（确保路由器已联网）。
将USB电源线的USB-A端接入电源适配器，USB-C端接入智能主控板的电源口（通常标注POWER IN）。
确认有网络连接后，打开终端输入命令：
上述命令将更新软件源并安装项目运行所需的一些库，具体包括：
v4l2-ctl等摄像头工具，用于读取和设置摄像头参数；依赖包说明：
运行标定图像采集工具：
程序会自动检测双目摄像头并显示预览画面，按照提示操作：
采集完成后，运行标定参数生成工具：
程序会自动读取标定图像并计算双目标定参数，生成tools/stereo_calib_params.npz文件。
完成标定后，运行主程序：
程序启动后将显示图形界面，提供以下功能：
| 按钮 | 功能说明 |
|---|---|
| Left Camera Preview | 左摄像头单独预览，观察画面 |
| Right Camera Preview | 右摄像头单独预览，观察画面 |
| Take Left/Right Picture | 双目拍照，检查左右画面是否存在偏移，有偏移说明双目摄像头工作正常 |
| Start Ranging Mode | 进入测距模式，点击预览画面即可测量目标距离 |
右侧上方区域可输出应用运行过程中的日志信息。
程序右侧提供摄像头参数调节面板，可调节以下参数（也可根据具体摄像头可调节参数设置范围）：
| 参数 | 说明 | 范围 |
|---|---|---|
| Brightness | 亮度 | -64 ~ 64 |
| Contrast | 对比度 | 0 ~ 95 |
| Saturation | 饱和度 | 0 ~ 100 |
| Hue | 色调 | -2000 ~ 2000 |
| Gamma | 伽马值 | 100 ~ 300 |
| Sharpness | 锐度 | 1 ~ 7 |
| Backlight Comp | 背光补偿 | 0 / 1 |
| Exposure Time | 曝光时间 | 3 ~ 2047 |
| WB Temp | 白平衡色温 | 2800 ~ 6500 |