Tool for Designing Smart Collaborative Things
Switch branches/tags
Nothing to show
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
arduino/delftToolkit
raspi
unity/delft-toolkit
.gitignore
.gitmodules
README.md

README.md

Delft AI Toolkit - Version 2

Visual Authoring Toolkit for Smart Things

This is a new 2.0 version of this project with a significantly changed architecture (original version). The NodeCanvas node system has been replaced with xNode, which is being enhanced by Siccity as part of this project. In addition, the system now communicates directly with the Raspberry Pi (instead of using node.js and bluetooth).

**As of November 2018, this version is going through significant changes. We hope to have a more stable release by the end of 2018. At that time, we'll post a RasPi image that's ready to go to use with the toolkit.

Description

The Delft Toolkit a system for designing smart things. It provides a visual authoring environment that incorporates machine learning, cognitive APIs, and other AI approaches, behavior trees, and data flow to create smart behavior in autonomous devices.

system diagram

The toolkit is currently in rough prototype form as a part of my research. It is likely to change significantly as I iteratively develop a technical and design strategy.

The goal of this project is to develop an authoring system approach that enables designers to easily and iteratively prototype smart things. This approach includes the ability to Wizard-of-Oz AI behaviors and simulate physical hardware in 3D, and then migrate these simulations to working prototypes that use machine learning and real hardware.

The system currently has two parts:

  • Authoring & Control System running on a computer
    • Visual Authoring with nodes in the Unity3D authoring environment
  • Robot/Device
    • Raspberry Pi
    • Arduino (we may transition to the Adafruit Crikit for RPi once it comes out and we have a chance to evaluate it)
    • Motors, servos, sensors, LEDs, microphone, speaker, camera, etc.

Each of these has a codebase, and includes a range of libraries. We are now using and funding a new version of the open source xNode Unity asset, and no longer using NodeCanvas.

Hardware Architecture hardware architecture

The below is currently being revised and is not complete. Stay Tuned.

Starting the system

  1. Power robot: Power on the Arduino and Raspberry Pi (RPi)
    • Batteries:
      • Arduino Powered by the USB cable from the RPi
      • Motors: Turn on the 6V AA battery pack
      • RPi: Connect the fast charging USB battery to the micro USB connector
  2. Login to RPi: Open a terminal app on your computer and login to the RPi by typing:
  3. Get IP addresses:
  4. Start software: In the following order
    • Motors: Power on the AA battery pack
    • RPi: Power and boot the RPi
      • In the terminal, connect to the RPi and start the toolkit software. In the below, change the server_ip IP address to that of your computer. After launching delfToolkit.py the software will take a minute or two to finish setting up the object recognition models.
ssh pi@delftbt0.local
cd /home/pi/tutorials/image/imagenet
python3 delftToolkit.py --server_ip 10.0.1.15
  • Unity3D:
    • Open the "delft-toolkit" project in Unity3D
    • In the Hierarchy, open the main scene
    • In the Graphs directory, double click on the toolkit visual graph you are currently using (or one of the example graphs)
    • If you are using the robot hardware, click on the simulated robot in the Hierarchy, and enable the "Physical Ding" script. If you are not using the physical robot, keep this script unchecked and inactive.
    • Click on the Play button
    • Click on the 3D window (this is to ensure Unity is receiving all commands -- if you find it is not responding to the keyboard or OSC, try this)

Installing The software

  1. Install dependencies: Unity3D
  2. Download the toolkit software and place on your computer drive
    • Unity project and Arduino code from github DelftToolkit
    • Disk image for RPi NEW VERSION NOT YET AVAILABLE
  3. Arduino:
    • Install delftToolkit.ino on your Arduino
  4. RPi: Burn the RPi image to your SD card
    • Set up your WiFi
    • Change the hostname from the default of delftbt0 (e.g. delftbt1, delftbt2, etc.) if you are using more than one robot on your network
  5. Unity3D:
    • Install NodeCanvas in the toolkit Project if it is not there
    • Click on the Project tab, and double click the "Main" scene