Skip to content

Latest commit

 

History

History
214 lines (154 loc) · 8.8 KB

README.md

File metadata and controls

214 lines (154 loc) · 8.8 KB

WoT-SYS

This is a project that contains the source code, description, guides etc. of the WoT System that will be used by students of ESI.

General

  • Clone this repo to get the code
  • All the devices are hard coded to connect the a TD Directory at 192.168.0.100. IF using another TD Directory please change the code accordingly.
  • Once all devices are running, you can access all the available TD by visiting the TD directory at 192.168.0.100:8080or TD-Directory.local:8080

Postman

The collections with all interactions are found under Postman and also here

The collection documentation is available here

Hostnames

Blue Mearm: TUMEIESI-MeArmPi-Blue Orange Mearm: TUMEIESI-MeArmPi-Orange Normal RPi Camera: TUMEIESI-Rpi-Camera IR RPi Camera: TUMEIESI-Rpi-Camera-IR Dotstar: TUMEIESI-DotStar Sensehat-106 : TUMEIESI-SenseHat-106 Sensehat-107 : TUMEIESI-SenseHat-107 Hue-related devices: Philips-hue

Mashup

Example mashups and clients for students are found under Mashups

ESP Light Sensor

Requirements

self contained - runs on micropython

What to Change

  • This connects to a WiFi with SSID and PW specified in the beginning of main.py. You should change them according to your WiFi setup
  • The provided TD will be updated in a new network since the IP address of the ESP will change

Installation

  • You will flash the program via the serial port. Make sure that you have read/write rights to the port by following this guide.
  • Get the micropython firmware from here or use version provided in at esp8266 folder.
  • Run pip install esptool to install the tool that allows you to flash programs to the ESP board
  • Run esptool.py --port <dev location, e.g. /dev/ttyUSB0> erase_flash to remove the previous program or firmware
  • Run esptool.py --port <dev location> --baud 460800 write_flash --flash_size=detect -fm dio 0 <name of the firmware> to download the firmware into ESP board. This is not your program, just the firmware.
  • Upload the main.py script to ESP8266 with ampy following the instructions from Adafruit
    • Install ampy: pip install adafruit-ampy
    • Check that it is installed with ampy --help
    • You can run the code with ampy --port /dev/ttyUSB0 run main.py
    • You can upload it as the main program via ampy --port /dev/ttyUSB0 put main.py /main.py
  • to use the REPL of the ESP8266, connect it to your USB port and use a serial communication program. Example under Linux: picocom <dev location> -b115200
    • You will need to press enter to enter into the console.
    • To exit, press CTRL+A+X
  • to find out the MAC address of the ESP, follow the instructions on https://forum.micropython.org/viewtopic.php?t=1890
  • assign a static IP adress to this MAC on the router's configuration page
    • You may not see it in the DHCP clients list
  • When you see the LED lit, it means that it has connected to WiFi

PiCamera

Network Configuration

  • WiFi SSID and password are stored at: /etc/wpa_supplicant/wpa_supplicant.conf
  • You can also launch the desktop and change to another WiFi

Requirements

  • python >= 3.5
  • picamera
  • flask

Installation

  • Install python: sudo apt-get install python3 python3-pip
  • install requirements: pip3 install -r requirement.txt
  • To run the program: python3 camera_server.py
  • Make sure that this script runs automatically on startup. Crontab can do this on Linux. Use crontab -e to configure crontab. Actually launch.sh does the launch
  • The server runs on port 8080

Warning

Keyboard Layout is American

DotStar

Requirements

  • flask
  • RPI.GPIO
  • adafruit-blinka
  • adafruit-circuitpython-dotstar
  • You have to enable SPI on the board.

Installation

  • Install python: sudo apt-get install python3 python3-pip
  • Install requirements: pip3 install -r requirement.txt
  • Enable SPI on the Raspberry Pi. You can use this in the GUI or the CLI config interface: raspi-config
  • To run the program: python3 dotstar.py
  • Make sure that this script runs automatically on startup. Crontab can do this on Linux.
  • The server runs on port 8080

Warning

Keyboard Layout is German

MeArmPi

Network Configuration

  • WiFi SSID and password are stored at: /etc/wpa_supplicant/wpa_supplicant.conf
  • You can also launch the desktop and change to another WiFi

Requirements

  • NodeJS 8 or newer
  • You have to enable SPI on the board.

Installation

  • get the latest node:
curl -sL https://deb.nodesource.com/setup_8.x | sudo -E bash -
sudo apt-get install -y nodejs
  • cd inside the wot-mearmpi folder and run: npm install
  • Build: npm run build
  • To run the program: node index.js
  • Make sure that this script runs automatically on startup. Crontab can do this on Linux. Run sudo crontab -e to get its config
  • The server runs on port 8080

Warning

Keyboard Layout is German

Philips HUE Bridge

This bridge has been configured using the white light starter pack that contains 3 white lights and a switch.

Get it running

  • Follow the Philips HUE in-app guide to get your bridge started.
  • Follow the developer page to get an API Key
  • The base URI is using our API Key, replace it with yours:
    • Look for the base URI in the TD
    • Replace the part after /api/ with your API key.
    • This TD uses Philips-hue as hostname, in case you have multiple HUE Bridges, you will need to change this in the base URI as well

Philips HUE Lights

This is a TD of a light bulb that connects to a Philips HUE Bridge.

Get it running

  • Follow the Philips HUE in-app guide to get your bridge started.
  • Follow the developer page to get an API Key
  • The base URI is using our API Key and Light number, replace them with yours:
    • Look for the base URI in the TD
    • Replace the part between /api/ and /lights/ with your API key.
    • This TD is representing light number 1. You should replace the part after /lights/ with your light's number.
    • This TD uses Philips-hue as hostname, in case you have multiple HUE Bridges, you will need to change this in the base URI as well

Philips HUE Dimmer Switch

This is a TD of a dimmer switch that connects to a Philips HUE Bridge and that can be used to turn on and off different HUE Lights.

Get it running

  • Follow the Philips HUE in-app guide to get your bridge started.
  • Follow the developer page to get an API Key
  • The base URI is using our API Key and Sensor number, replace them with yours:
    • Look for the base URI in the TD
    • Replace the part between /api/ and /sensors/ with your API key.
    • This TD is representing the sensor number 2. You should replace the part after /sensors/ with your sensor's number.
    • This TD uses Philips-hue as hostname, in case you have multiple HUE Bridges, you will need to change this in the base URI as well

Philips HUE Software-based Daylight Sensor

This is a TD of a daylight sensor that runs on a Philips HUE Bridge and that can be used to learn whether there is daylight in the Bridge's location or not. It is based on the GPS location.

Get it running

  • Follow the Philips HUE in-app guide to get your bridge started.
  • Follow the developer page to get an API Key
  • The base URI is using our API Key and Sensor number, replace them with yours:
    • Look for the base URI in the TD
    • Replace the part between /api/ and /sensors/ with your API key.
    • This TD is representing the sensor number 1. You should replace the part after /sensors/ with your sensor's number.
    • This TD uses Philips-hue as hostname, in case you have multiple HUE Bridges, you will need to change this in the base URI as well

Motor Controller (Pololu TB9051FTG Dual)

Pinout

  • Left Motor negative pole -> M1A

  • Left Motor positive pole -> M1B

  • Right Motor negative pole -> M2B

  • Right Motor positive pole -> M2A

  • Battery Positive -> VIN

  • Battery GND ->GND

  • No need to make any changes between controller hat and raspberry pi, pins may vary between other brands and controllers which can be changed in motorDriver.js

Installation

  • get the latest node:
curl -sL https://deb.nodesource.com/setup_8.x | sudo -E bash -
sudo apt-get install -y nodejs
  • cd inside the motor-driver folder and run: npm install
  • To run the program: npm start
  • npm run debug can be used to control motors via wasdx or arrow keys
  • npm run debug-only for disabling Wot and only using keyboard input while testing or debugging