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

Bouffalo 实验室

BL602

此示例用作灯泡设备类型（具有开启/关闭功能）。 这些步骤已在 Bouffalo Lab BL602-IoT-Matter-V1 开发板 (Wi-Fi) 上进行了验证。

此示例使用测试供应商 ID (VID) 0xFFF1 和产品 ID (PID) 0x8005。

BL602 开发板的引脚图

初始设置

本文档中的步骤已在 Ubuntu 18.04 和 20.04 上进行了验证。

  1. 按照 connectedhomeip 代码库中指定的方式安装依赖项： 构建 Matter

  2. 克隆并初始化 connectedhomeip 代码库：

    git clone https://github.com/project-chip/connectedhomeip.git
cd connectedhomeip
git fetch origin v1.0-branch
git checkout FETCH_HEAD
./scripts/checkout_submodules.py --platform bouffalolab --recursive
source ./scripts/activate.sh

  3. 安装 Bouffalo Lab SDK：

    cd third_party/bouffalolab/repo
sudo bash scripts/setup.sh
export BOUFFALOLAB_SDK_ROOT=/opt/bouffalolab_sdk

构建映像并刷写开发板

  1. 构建 lighting-app 
    ./scripts/build/build_examples.py --target bouffalolab-bl602-iot-matter-v1-light-115200 build
  2. 将开发板连接到刷写站（MacOS、Ubuntu、Windows）。
  3. 将开发板设置为下载模式：
    1. 按住 BOOT 按钮。
    2. 按下重置按钮，然后松开手指。
    3. 松开 BOOT 按钮。

  4. 设备应在计算机上以 USB 串行设备的形式显示。您可在 /dev/ 中查找： 

    ls -la /dev/tty*

    例如，如果设备处于 /dev/ttyACM0 状态，您可以使用以下命令将映像刷写到开发板上：

    ./out/bouffalolab-bl602-iot-matter-v1-light-115200/chip-bl602-lighting-example.flash.py --port /dev/ttyACM0

  5. 如需擦除开发板上的现有映像，请在上述命令中附加 --erase。

验证示例

  1. 您可以使用 screen 或 minicom 打开串行控制台。例如，如果设备处于 /dev/ttyACM0 状态：
    screen /dev/ttyACM0 115200
  2. 如需重置开发板，请按 Reset（或 EN）按钮，您应该会在终端中看到如下输出：
    Starting bl602 now....
Booting BL602 Chip...
  3. 如需在成功调试开发板后控制开发板，请按 BOOT 按钮，您应该会在终端中看到如下所示的输出：
    [    404197][:588238200] Short press
[    404198][:588238200] receiving event type: 0
[    404203][:588238200] sending event type: 0
[    404207][:588238200] receiving event type: 0
[    404211][:588238200] Turning light ON
[    406211][:588238200] sending event type: 1
[    406212][:588238200] receiving event type: 1
[    406217][:588238200] Light ON
[    406220][:588238200] updating on/off = 1
  4. 如需使开发板恢复出厂设置，请按住 BOOT 按钮 5 秒，您应该会在终端中看到如下输出：
    [     37268][:588238200] LongLong press
[     37269][:588238200] receiving event type: 0
[     37274][:588238200] FactoryReset! please release button!!!
[     37279][:588238200] Toggling state to 1[     37283][:588238200] brightness: 255, mHue: 0, mSaturation: 0, red: 255, green: 255, blue: 255
[     37292][:588238200] red level: 10000
[     38296][:588238200] Toggling state to 0[     38297][:588238200] brightness: 0, mHue: 0, mSaturation: 0, red: 0, green: 0, blue: 0
[     38305][:588238200] red level: 0
[     39308][:588238200] Toggling state to 1[     39309][:588238200] brightness: 255, mHue: 0, mSaturation: 0, red: 255, green: 255, blue: 255
[     39318][:588238200] red level: 10000
[     42323][:588238200] [DL] Easyflash erase: f/1/n
[     42327][:588238200] [DL] Easyflash erase: f/1/i
[     42332][:588238200] [DL] Easyflash erase: f/1/r
[     42335][:588238200] [DL] Easyflash erase: f/1/m
[     42340][:588238200] [DL] Easyflash erase: f/1/o
[     42349][:588238200] [DIS] Fabric (0x1) deleted. Calling OnFabricDeletedFromStorage
[     42403][:588238200] [DL] Easyflash erase: f/1/k/0
[     42462][:588238200] [DL] Easyflash erase: f/1/g
[     42465][:588238200] [DMG] AccessControl: removing fabric 1

BL702

此示例还充当具有开启/关闭功能的灯泡设备类型。

这些步骤已在 Bouffalo Lab XT-ZB6-DevKit 开发板 (Thread) 上进行了验证。

此示例使用测试供应商 ID (VID) 0xFFF1 和产品 ID (PID) 0x8005。

BL702 开发板的引脚图

初始设置

按照 BL602 设置说明设置环境。

构建映像并刷写开发板

  1. 构建 lighting-app 
    ./scripts/build/build_examples.py --target bouffalolab-xt-zb6-devkit-light-115200 build
  2. 将开发板连接到刷写站（MacOS、Ubuntu、Windows）。
  3. 将开发板设置为下载模式：
    1. 按住 BOOT 按钮。
    2. 按下 EN 按钮，然后松开手指。
    3. 松开 BOOT 按钮。

  4. 设备应在计算机上以 USB 串行设备的形式显示。您可在 /dev/ 中查找： 

    ls -la /dev/tty*

    例如，如果设备处于 /dev/ttyACM0 状态，您可以使用以下命令将映像刷写到开发板上：

    ./out/bouffalolab-xt-zb6-devkit-light-115200/chip-bl702-lighting-example.flash.py --port /dev/ttyACM0

  5. 如需擦除开发板上的现有映像，请在上述命令中附加 --erase。

验证示例

请按照 BL602 验证说明验证 BL702 示例。

后续步骤

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