blob: 202d02b4ab68a570086729fbb5491b60d3127a7f [file] [log] [blame] [view]
# CHIP RPC CONSOLE
This python application provides a console for interacting with rpc-enabled chip
devices.
The console uses the [pigweed pw_console](https://pigweed.dev/pw_console/), but
with customizations to work better with CHIP, including containing all rpc proto
files required for CHIP.
- [CHIP RPC CONSOLE](#chip-rpc-console)
- [Building](#building)
- [Running](#running)
---
## Building
If this is the first time using the checkout the environment must first be
bootstrapped to install all dependencies.
$ source ./scripts/bootstrap.sh
If bootstrap has previously be run simply activate.
$ source ./scripts/activate.sh
The python console is built and installed in the venv using gn:
$ gn gen out/debug
$ ninja -C out/debug
After building the output directory also contains a folder
(chip_rpc_console_wheels), with all the wheels required for the tool. These
can be used to install the console without needing the sdk. Simply install
all the wheels in the folder:
$ pip install chip_rpc_console_wheels/*.whl
## Running
To start the console provide the path to the device, for example:
$ chip-console --device /dev/ttyUSB0
An example RPC command:
$ rpcs.chip.rpc.DeviceCommon.GetDeviceInfo()