blob: ff77cb3317da58037171bee304af18856de463de [file] [log] [blame] [view]
# Netsim python gRPC library
This contains a python library to interact with Netsim gRPC frontend service
## Development
If you wish to do development you can create a virtual environment and
generate python files from .proto files by running:
. ./configure.sh
## Usage
NetsimClient() is the Netsim gRPC Frontend Client Service connecting to netsim daemon.
Users should use a NetsimClient to interact with netsim daemon by calling the provided APIs.
```python
from netsim import netsim
netsim_client = netsim.NetsimClient()
devices = netsim_client.get_devices()
```
The currently supported APIs include:
- `get_version()`: Get the version of the netsim daemon.
- `get_devices()`: Get detailed information for all devices connected to netsim daemon.
- `set_position()`: Set the position and/or orientation of the specified device.
- `set_radio()`: Set the specified radio chip's state of the specified device.
- `reset()`: Reset all devices.
## Adding dependencies
Configure will use the local python interpreter, which does not
have TLS support, so all the package must be made available locally!
If you need to add a package, make the source package available under the
repo directory. The easiest way to do this is:
pip3 install pip2pi
pip3 download --no-binary ":all:" my-package=1.2.3 -d repo
dir2pi repo