请注意!新的开发者预览版计划即将推出。点击此处申请,抢先试用新工具并提供反馈。

Espressif

ESP32

这个支持 Matter 的示例可用作灯泡设备类型,具有开启/关闭功能。

初始设置

  1. 克隆 Espressif ESP-IDF 并查看 v4.4.2 标记:
    mkdir ${HOME}/tools
    cd ${HOME}/tools
    git clone https://github.com/espressif/esp-idf.git
    cd esp-idf
    git checkout v4.4.2
    git submodule update --init
    export IDF_PATH=${HOME}/tools/esp-idf
    ./install.sh
  2. 克隆并初始化 connectedhomeip 代码库:
    git clone https://github.com/project-chip/connectedhomeip.git
    cd connectedhomeip
    git fetch origin v1.0-branch
    git checkout FETCH_HEAD
    git submodule update --init --recursive
    source ./scripts/activate.sh
  3. 初始化示例:
    cd examples/all-clusters-app/esp32
    source ${IDF_PATH}/export.sh
    对于 MacOS 用户,如果您在此步骤中看到有关 Bash 版本的错误,可能是因为预安装的 Bash 版本太旧。您可以通过切换到 zsh 来解决此问题:chsh -s /bin/zsh
  4. 如需设置 IDF 目标,请根据您的开发板运行 set-target
    idf.py set-target esp32
  5. 更新示例设置:
    idf.py menuconfig
    1. Demo -> Device Type 设置为您的开发板

构建映像并刷写开发板

  1. 构建 Matter 示例:
    idf.py build
  2. 通过 USB 连接设备。然后运行以下命令,将演示应用刷写到设备上:
    idf.py -p /dev/ttyUSB0 flash
    如有必要,请将 /dev/ttyUSB0 (Linux) 替换为您系统的正确 USB 设备名称(例如 MacOS 上的 /dev/tty.SLAB_USBtoUART/dev/tty.usbserial)。
  3. 设备的串行控制台可作为 Linux 主机上的 USB Tty 设备提供。它通常名为 /dev/ttyUSB0,但如果您已插入其他 USB 串行设备,那么它可能为 /dev/ttyUSB1 或更高版本。ESP32 WROVER 套件提供了两台 USB Tty 设备,它将是显示设备日志的第二台设备。

    如需连接到串行终端,请使用 screenminicom 等工具或您首选的串行终端程序。例如,如果设备处于 /dev/ttyUSB0 状态:

    screen /dev/ttyUSB0 115200

  4. 调试完成后,网络配置会保留在设备上。如需将其清除,只需运行:

    idf.py -p /dev/ttyUSB0 erase-flash

后续步骤

成功构建 Matter 示例后,创建开发者项目