Primarily, this is meant to be a set of libraries to connect to vector via BLE. It just so happens that there's also a CLI that utilizes them built in.
- You'll need to install libsodium for your OS. Specific instructions vary by OS
To build the binary, run
$ make build
You'll have to do something like this on the built binary
$ sudo setcap 'cap_net_raw,cap_net_admin+eip' /path/to/fileCompletely untested, but let me know!
Doesn't work yet...
There are more features in the library than are currently available in the CLI, but here's whats currently available
| Name | Description |
|---|---|
| scan | runs a BLE scan and displays an appropriate list of devices |
| connect | connect to a vector via ID (displayed in the scan) |
| authorize | performs a cloud authorization (but you'll need to find your token!) |
| configure | allows you to make/change configuration |
| get-status | displays the status of your vector |
| wifi-scan | scan for a list of available wifi networks |
| wifi-connect | connect to a wifi network |
| wifi-forget | tell vector to forget a wifi network |
| wifi-ip | display IP information of the robot |
| ota-start | perform an OTA code download |
| ota-cancel | stops an in-progress OTA download |
| logs | download logs from your robot |
| Name | Description |
|---|---|
| Timezone | Input a valid timezone. A handy list of timezone options are listed under the "TZ Database Name" column on Wikipedia |
| Default Location | Input a valid location. Format is /<State (if applicable)>/ |
| Locale | Determines wake word ("Hey Vector") accent detection. Available options are listed in the list_locales file. |
| Data Analytics | Set to "true" to allow Vector to upload crash logs and other non-personal logs to DDL. Note: This data is not sold or released to any third party. |
| Distance Units | Set to "true" to measure distance in metric units. Set to "false" to measure distance in imperial units. |
| Temperature Units | Set to "true" to measure temperature in metric units. Set to "false" to measure distance in imperial units. |
This is an early release, and not all features are implemented in either the CLI or in the library itself.