Skip to content

Commit

Permalink
Improve doc, prepare release 0.6.0
Browse files Browse the repository at this point in the history
  • Loading branch information
pirquessa committed Mar 14, 2020
1 parent 2ab0f1b commit a9e7e37
Show file tree
Hide file tree
Showing 2 changed files with 33 additions and 10 deletions.
41 changes: 32 additions & 9 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -3,25 +3,48 @@
## Why this fork ?

1. Main project is quite hard to read, I'm trying to clean it a little bit so it can be extended !
2. Robots using main project are updated each time a commit is done in the repo. Robots that use this project will be updated based on releases.
2. Robots using main project are updated each time a commit is done in the repo. Robots that use this project will be updated based on stable releases.
3. Pull request are not very welcome in the main project. Feel free to contribute here :)

## Versions names

Release names are composed like: X.Y.Z
* X: Updated when there is a protocol change. **Update to this release is mandatory.**
* Y: Updated when there is a major change in the project. Update to this release is optionnal.
* Z: Updated when there is a minor change in the project. Update to this release is optionnal.

* X: Updated when there is a protocol change. **Update to this release is mandatory.**
* Y: Updated when there is a major change in the project. Update to this release is optionnal.
* Z: Updated when there is a minor change in the project. Update to this release is optionnal.

## Installation

1. Follow steps of the [main project](https://github.com/vigibot/vigiclient)
2. Override with ssh files in `/usr/local/vigiclient` with the last [release](https://github.com/pirquessa/vigiclient/releases) of this project
3. Use new files:
3. Update your robot config:
* Edit your robot **Configuration matérielle**
* Use **Config effective** tab
* Switch editor mode to **Code**
* Add/Edit the **PLUGINS** section with an array of your needed plugins. Eg:
* `"PLUGINS": [
"Safety",
"VideoDiffusion",
"AudioDiffusion"
]`
4. Use new files:
* Install new dependencies: `npm install`
* Restart client: `systemctl restart vigiclient`

## Customization with plugins

1. Create a plugin in the plugins folder. (Look at `SerialSlave.js` as exemple)
2. Declare your plugin in clientrobotpi.js. (Add the class file name in the list. Just like for `SerialSlave.js`)
## Available plugins
| Plugin name | Description |
|--|--|
| Safety | **Mandatory**, it manage the safety of your robot: it will cut the motors if some lag appear |
| VideoDiffusion | **Mandatory**, it allow to display the video of the robot |
| AudioDiffusion | If you have a microphone on your robot, it can stream its audio feed |
| TextToSpeech | Allow your robot to speak when the user type something in the chat |
| SerialSlave | Allow to forward communication to a slave throw **serial** communication. Useful if you use an arduino paired with the Raspberry Pi. |
More to come, feel free to contribute !!!

## Customization with plugins
1. Create a plugin in the *plugins* folder. (Look at [SerialSlave.js](https://github.com/pirquessa/vigiclient/blob/master/plugins/SerialSlave.js) as exemple)
* Your plugin class need to extend [AbstractPlugin] (https://github.com/pirquessa/vigiclient/blob/master/utils/AbstractPlugin.js)
* Override the method you need
2. Declare your plugin in the **Configuration matérielle** of your robot, see installation instructions
3. Restart the client process (Can be done from the UI with icon ![enter image description here](https://www.vigibot.com/ihm/exit.png))
2 changes: 1 addition & 1 deletion package.json
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
{
"name": "vigiclient",
"version": "0.5.1",
"version": "0.6.0",
"description": "Raspberry PI robot client for Vigibot.com",
"main": "clientrobotpi.js",
"dependencies": {
Expand Down

0 comments on commit a9e7e37

Please sign in to comment.