pdf-icon

Unit CamS3-5MP Home Assistant 集成

简介

Unit CamS3-5MP 是一款紧凑型 ESP32-S3 Wi-Fi 摄像头模块,采用 5MP PY260 传感器(2592×1944,88° DFoV),配备 8MB PSRAM 和 16MB 闪存。支持 microSD 存储、PDM 音频录制、USB 固件更新/串行通信和板载下载接头。具有内置固件用于图像捕获和 EzData 云上传,非常适合远程监控、延时摄影和工业自动化。

准备工作

  • Home Assistant 主机
  • 在 Home Assistant 中安装并启用 ESPHome Builder
提示
本教程使用 ESPHome 2025.12.5 编译和上传固件。如果遇到编译/上传问题,请考虑切换 ESPHome 版本。

步骤 1. 创建新设备

  • 点击右下角的绿色按钮创建设备。

步骤 2. 创建设备名称

  • 点击 CONTINUE

  • 点击 New Device Setup

  • 输入设备名称,然后点击 NEXT

步骤 3. 选择设备类型

  • 点击 ESP32-S3

  • 点击 SKIP

步骤 4. 开始编辑 YAML 文件

  • 点击 EDIT。我们可以通过 YAML 文件自定义设备功能。

设备设置

以下是代码的核心部分。下面提供了相关的参考和说明。

PSRAM 配置

psram:
  mode: octal
  speed: 80MHz 

开关配置

switch:
  - platform: gpio
    name: "Active LED"
    pin:
      number: GPIO14
      inverted: true
    restore_mode: ALWAYS_ON

I2C 总线配置

  • 添加 I2C 组件
i2c:
  - id: camera_i2c
    sda: GPIO17
    scl: GPIO41
    scan: true

摄像头配置

esp32_camera:
  name: "PY260 camera"
  external_clock:
    pin: GPIO11
    frequency: 20MHz
  i2c_id: camera_i2c
  data_pins: [GPIO6, GPIO15, GPIO16, GPIO7, GPIO5, GPIO10, GPIO4, GPIO13]
  vsync_pin: GPIO42
  href_pin: GPIO18
  pixel_clock_pin: GPIO12
  reset_pin: GPIO21
  resolution: 1024x768
  jpeg_quality: 12

固件构建

  • 再次点击 INSTALL 来刷写固件并等待完成。

  • 进行更改后,点击右上角的 SAVEINSTALL,然后在弹出窗口中选择 Manual Download

  • 固件编译完成后,点击 Download 并选择 Factory format(Previously Modern)

提示
点击 Unit CamS3-5MP 查看完整的示例配置。首次构建可能需要一些时间,具体取决于 Home Assistant 主机的性能和网络质量。

固件上传

  • 硬件连接指南

将摄像头模块连接到 4 针电缆 → 将电缆的另一端插入 USB 适配器 → 使用 USB-C 数据线连接到计算机或电源 → 通电后,设备即可进行固件刷写或数据传输。

  • 通过 USB Type‑C 数据线将设备连接到主机。打开 ESPHome Web 并点击 CONNECT 以连接到设备。

  • 定位相应的串口号

  • 点击 INSTALL

  • 选择之前编译的固件上传。

提示
请注意,下载完成后,设备必须重置。

Home Assistant 集成

  • 点击 Settings -> Device & services 检查设备。

  • 我们可以在 Discover 部分找到相应的设备。

  • 添加设备后,数据将正确显示。

  • 最后,我们将这些实体添加到 Dashboard,以下是其显示结果。

On This Page