• Home
  • Line#
  • Scopes#
  • Navigate#
  • Raw
  • Download
1# Avatar
2
3Avatar aims to provide a scalable multi-platform Bluetooth testing tool capable
4of running any Bluetooth test cases virtually and physically. It aims to
5complete PTS-bot in the Pandora testing suite.
6
7## Install
8
9```bash
10git submodule update --init
11python -m venv venv
12source venv/bin/activate.fish # or any other shell
13pip install [-e] bt-test-interfaces/python
14pip install [-e] third-party/bumble
15pip install [-e] .
16```
17
18## Rebuild gRPC Bluetooth test interfaces
19
20```bash
21pip install grpcio-tools==1.46.3
22./bt-test-interfaces/python/_build/grpc.py
23```
24
25## Usage
26
27```bash
28python examples/example.py -c examples/simulated_bumble_android.yml --verbose
29```
30
31## Development
32
331. Make sure to have a `root-canal` instance running somewhere.
34```bash
35root-canal
36```
37
381. Run the example using Bumble vs Bumble config file. The default `6402` HCI port of `root-canal` may be changed in this config file.
39```
40python examples/example.py -c examples/simulated_bumble_bumble.yml --verbose
41```
42
433. Lint with `pyright` and `mypy`
44```
45pyright
46mypy
47```
48
493. Format & imports style
50```
51black avatar/ examples/
52isort avatar/ examples/
53```
54