RPC Console and Device Tracing#

Using RPC Console#

You can use the rpc default config to setup everything correctly for RPCs:

$ export SDKCONFIG_DEFAULTS=$PROJECT_ROOT/examples/all-clusters-app/esp32/sdkconfig_m5stack_rpc.defaults
$ rm sdkconfig
$ idf.py fullclean

Alternatively, Enable RPCs in the build using menuconfig:

  • Enable the RPC library and Disable ENABLE_CHIP_SHELL

    Component config → CHIP Core → General Options → Enable Pigweed PRC library
    Component config → CHIP Core → General Options → Disable CHIP Shell
    
  • Ensure the UART is correctly configured for your board, for m5stack:

    PW RPC Debug channel → UART port number → 0
    PW RPC Debug channel → UART communication speed → 115200
    PW RPC Debug channel → UART RXD pin number → 3
    PW RPC Debug channel → UART TXD pin number → 1
    

After configuring you can build and flash normally:

$ idf.py build
$ idf.py flash

After flashing a build with RPCs enabled you can use the rpc console to send commands to the device.

Build or install the rpc console

Start the console

chip-console --device /dev/ttyUSB0

From within the console you can then invoke rpcs:

  • Configure WiFi

    rpcs.chip.rpc.WiFi.Connect(ssid=b"MySSID", secret=b"MyPASSWORD")
    rpcs.chip.rpc.WiFi.GetIP6Address()
    
  • Control Lighting

    rpcs.chip.rpc.Lighting.Get()
    rpcs.chip.rpc.Lighting.Set(on=True, level=128, color=protos.chip.rpc.LightingColor(hue=5, saturation=5))
    
  • Control Lock

    rpcs.chip.rpc.Locking.Get()
    rpcs.chip.rpc.Locking.Set(locked=True)
    
  • OTA Requestor

    rpcs.chip.rpc.Device.TriggerOta()
    

Device Tracing#

Device tracing is available to analyze the device performance. To turn on tracing, build with RPC enabled.

Obtain tracing json file.

$ ./{PIGWEED_REPO}/pw_trace_tokenized/py/pw_trace_tokenized/get_trace.py -d {PORT} -o {OUTPUT_FILE} \
    -t {ELF_FILE} {PIGWEED_REPO}/pw_trace_tokenized/pw_trace_protos/trace_rpc.proto