Skip to content

Latest commit

 

History

History
102 lines (60 loc) · 5.16 KB

README.md

File metadata and controls

102 lines (60 loc) · 5.16 KB
Raw

VectorPlus

A C# library, framework and server for defining and managing new behaviours for the Vector robot (created by Anki, now supported by Digital Dream Labs).

VectorPlus communicates with your robot using the unofficial C# library Anki.Vector.SDK. It is designed to run continuously and maintain a connection to your Vector robot over your home wifi network.

Context

The SDK allows programs to access and control the Vector robot. Some capabilities require that the SDK take full control of the robot. While that is happening, the robot is locked.

VectorPlus creates behaviours that only take control of the robot as they need it, and release that control afterwards.

Current state

The project is still in early stages. You can launch it using VisualStudio and connect to your robot, or run it in a Docker container on any machine.

In planning:

  • Some better state tracking facilities.
  • Some more interesting demo behaviours.
  • Some documentation for writing your own behaviour modules.
  • Fix the docker container segmentation fault issue.
  • Combine VectorPlus.Capabilities.Vision and VectorPlus.Lib.
  • Distribute VectorPlus.Lib as a Nuget package for developers to build against.

Running your VectorPlus server

VectorPlus is under development - some of these details may change going forward.

Due to issues with Docker, I recommend launching the application through Visual Studio.

Launching with Visual Studio

  • Download and run the VectorPlus.Web project from the Visual Studio solution.
  • It's a web server, so visit: http://localhost:5000 to test it on your own machine.

Launching through Docker

There are a number of scripts to help you get started running the app in a Docker container:

  • docker-build.sh - this builds a docker image tagged vectorplusapp using VectorPlus.Web/Dockerfile.
  • docker-run.sh - this starts a docker container named vectorplus, running the app published on port 5000.
  • docker-stop.sh - this stops and removes the vectorplus docker container.
  • docker-shell.sh - this will open a bash shell inside the docker container (helpful if you want to examine it while it's running).
  • docker-launch-bash.sh - this will launch the docker container, but start a bash shell instead of the VectorPlus web server.

Running the web server

NB. Right now, the docker container throws a segmentation fault and halts shortly after launching the application. I'm still exploring options to fix this.

Debugging the container

For the clearest view of what is happening in a vectorplusapp Docker container:

  • Launch one with: docker-launch-bash.sh - this will give you a bash terminal into the container.
  • Launch the web application itself with: dotnet VectorPlus.Web.dll

Connecting to the robot

By default, the application will pick up your Vector SDK if you have that set up. If you're running on a personal machine where you've already set up the SDK, you don't need to do anything.

If you haven't set up the SDK, or you're running VectorPlus as a server on a separate machine (or inside Docker), you can configure the SDK connection to the robot through the Connection page.

Enabling behaviours

Head over to the Configuration page, and upload a module.

Plugins/2020-08-15 demo-behaviour.zip is a zip of the output binaries from VectorPlus.Demo.Behaviours project (which you could build yourself as a part of this Visual Studio solution).

Once you've selected the zip file, press the Upload button.

NB. There's currently a UX bug - so it's not clear that you've selected the file and that it's waiting for you to press Upload.

Once loaded, you can activate a number of different example behaviours to try out with Vector.

Demo behaviours

These behaviours will remain active while the web server runs.

Developing new behaviours

VectorPlus is intended to make it easy to build new behaviours that can co-exist. They can be bundled up and distributed as modules in DLL form for others to install.

Credit

Huge credit to Digital Dream Labs for picking up where Anki left off, maintaining and supporting both Cosmo and Vector robots. If you haven't already purchased a subscription to updates, you can do so at their site.

Other useful tools