CHIP Ameba Lighting Example

This example demonstrates the Matter Lighting application on Ameba platform.

• CHIP Ameba Lighting Example
  • Supported Device
  • Building the Example Application
  • Commissioning and cluster control
    • Commissioning
      • BLE mode
      • IP mode
    • Cluster control

Supported Device

The CHIP demo application is supported on Ameba RTL8722DM Board.

Building the Example Application

• Pull docker image:

    $ docker pull connectedhomeip/chip-build-ameba:latest
  

• Run docker container:

    $ docker run -it -v ${CHIP_DIR}:/root/chip connectedhomeip/chip-build-ameba:latest
  

• Setup build environment:

    $ source ./scripts/bootstrap.sh
  

• To build the demo application:

    $ ./scripts/build/build_examples.py --target ameba-amebad-lighting build
  

  The output image files are stored in out/ameba-amebad-lighting/asdk/image folder.

  The bootloader image files are stored in out/ameba-amebad-lighting/asdk/bootloader folder.

• After building the application, Ameba Image Tool is used to flash it to Ameba board.

1. Connect your device via USB and open Ameba Image Tool.
2. Select correct serial port and set baudrate as 115200.
3. Browse and add the corresponding image files in the Flash Download list to the correct locations
4. Click Download button.

Commissioning and Cluster Control

Commissioning

There are two commissioning modes supported by Ameba platform:

BLE mode

1. In “connectedhomeip/config/ameba/args.gni”

   • Set chip_config_network_layer_ble = true

2. In “connectedhomeip/src/platform/Ameba/CHIPDevicePlatformConfig.h”

   • Set #define CHIP_DEVICE_CONFIG_ENABLE_CHIPOBLE 1

3. Build and Flash

4. The example will run automatically after booting the Ameba board.

5. Test with Chip-Tool

IP mode

1. In “connectedhomeip/config/ameba/args.gni”

   • Set chip_config_network_layer_ble = false

2. In “connectedhomeip/src/platform/Ameba/CHIPDevicePlatformConfig.h”

   • Set #define CHIP_DEVICE_CONFIG_ENABLE_CHIPOBLE 0

3. Build and Flash

4. The example will run automatically after booting the Ameba board.

5. Connect to AP using ATW0, ATW1, ATWC commands

6. Test with Chip-Tool

Cluster Control

After successful commissioning, use the OnOff cluster command to control the OnOff attribute. This allows you to toggle a parameter implemented by the device to be On or Off.

• Via Chip-Tool

    $ ./chip-tool onoff on ${NODE_ID_TO_ASSIGN} 1
    $ ./chip-tool onoff off ${NODE_ID_TO_ASSIGN} 1