ASR Getting Started Guide

The ASR platform is a Matter platform that uses ASR FreeRTOS SDK.

Supported Chips

The ASR platform is supported on:

Matter Example Applications

Sample Matter applications are provided for the ASR platform. They can be used to speed up development. You can find them in the samples with /asr subfolder.

Building the Example Application

  • Setup Matter Environment

  • Setup toolchain

    • for ASR582X
      cd toolchain
wget https://developer.arm.com/-/media/Files/downloads/gnu-rm/9-2019q4/RC2.1/gcc-arm-none-eabi-9-2019-q4-major-x86_64-linux.tar.bz2
tar -jxvf gcc-arm-none-eabi-9-2019-q4-major-x86_64-linux.tar.bz2
export ASR_TOOLCHAIN_PATH={abs-path-to-toolchain}/gcc-arm-none-eabi-9-2019-q4-major/bin/
    • for ASR595X
      git clone --depth=1 https://github.com/asriot/Tools.git
cd Tools/toolchain
cat asr_riscv_gnu_toolchain_10.2_ubuntu-16.04.tar.bz2.part* > asr_riscv_gnu_toolchain_10.2_ubuntu-16.04.tar.bz2
mkdir -p asr_riscv_gnu_toolchain_10.2_ubuntu-16.04
tar -jxvf asr_riscv_gnu_toolchain_10.2_ubuntu-16.04.tar.bz2 -C asr_riscv_gnu_toolchain_10.2_ubuntu-16.04/
export ASR_TOOLCHAIN_PATH={abs-path-to-toolchain}/asr_riscv_gnu_toolchain_10.2_ubuntu-16.04/bin/

  • Setup Chip environment

    • for ASR582X:
      export ASR_BOARD=asr582x
    • for ASR595X:
      export ASR_BOARD=asr595x

  • Building the Application

    If the lighting example is to be built:

    ./scripts/build/build_examples.py --target asr-$ASR_BOARD-lighting build

  • The output image files are stored in the subdirectories under out, the subdirectory name is the same as the argument specified after the option --target when build the examples.

  • After building the application, DOGO tool is used to flash it to the board.

Commissioning

There are two commissioning modes supported by ASR platform:

BLE mode

  1. Build and Flash
  2. The example will run automatically after booting the ASR board.
  3. Restore factory settings using command recovery
  4. Commissioning with Chip-Tool,for example:
    ./chip-tool pairing ble-wifi <node_id> <ssid> <password> <pin_code> <discriminator>

IP mode

  1. Build and Flash
  2. The example will run automatically after booting the ASR board.
  3. Restore factory settings using command recovery
  4. Connect to AP using command wifi_open sta [ssid] [password]
  5. Commissioning with Chip-Tool,for example:
    ./chip-tool pairing onnetwork-long <node_id> <pin_code> <discriminator>

Shell

  1. To build the example with Matter shell, exactly the same steps as above but add argument -shell when using the build_examples.py script. For example: ./scripts/build/build_examples.py --target asr-$ASR_BOARD-lighting-shell build
  2. The example will run automatically after booting the ASR board.
  3. Use help command to list all supported commands:
    help
base64          Base64 encode / decode utilities
exit            Exit the shell application
help            List out all top level commands
version         Output the software version
ble             BLE transport commands
wifi            Usage: wifi <subcommand>
config          Manage device configuration. Usage to dump value: config [param_name] and to set some values (discriminator): config [param_name] [param_value].
device          Device management commands
onboardingcodes Dump device onboarding codes. Usage: onboardingcodes none|softap|ble|onnetwork [qrcode|qrcodeurl|manualpairingcode]
dns             Dns client commands
OnOff           OnOff commands. Usage: OnOff [on|off]
Done

OTA

To build the example with the Matter OTA Requestor functionality, exactly the same steps as above but add argument -ota when using the build_examples.py script. For example: ./scripts/build/build_examples.py --target asr-$ASR_BOARD-lighting-ota build