This is a project that contains the source code, description, guides etc. of the WoT System that will be used by students of ESI.
- 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:8080orTD-Directory.local:8080
The collections with all interactions are found under Postman and also here
The collection documentation is available here
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
Example mashups and clients for students are found under Mashups
self contained - runs on micropython
- 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
- 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 esptoolto install the tool that allows you to flash programs to the ESP board - Run
esptool.py --port <dev location, e.g. /dev/ttyUSB0> erase_flashto 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.pyscript to ESP8266 withampyfollowing 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
- Install ampy:
- 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
- WiFi SSID and password are stored at: /etc/wpa_supplicant/wpa_supplicant.conf
- You can also launch the desktop and change to another WiFi
- python >= 3.5
- picamera
- flask
- 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 -eto configure crontab. Actually launch.sh does the launch - The server runs on port 8080
Keyboard Layout is American
- flask
- RPI.GPIO
- adafruit-blinka
- adafruit-circuitpython-dotstar
- You have to enable SPI on the board.
- 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
Keyboard Layout is German
- WiFi SSID and password are stored at: /etc/wpa_supplicant/wpa_supplicant.conf
- You can also launch the desktop and change to another WiFi
- NodeJS 8 or newer
- You have to enable SPI on the board.
- get the latest node:
curl -sL https://deb.nodesource.com/setup_8.x | sudo -E bash -
sudo apt-get install -y nodejscdinside 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 -eto get its config - The server runs on port 8080
Keyboard Layout is German
This bridge has been configured using the white light starter pack that contains 3 white lights and a switch.
- 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-hueas hostname, in case you have multiple HUE Bridges, you will need to change this in the base URI as well
This is a TD of a light bulb that connects to a Philips HUE Bridge.
- 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-hueas hostname, in case you have multiple HUE Bridges, you will need to change this in the base URI as well
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.
- 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-hueas hostname, in case you have multiple HUE Bridges, you will need to change this in the base URI as well
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.
- 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-hueas hostname, in case you have multiple HUE Bridges, you will need to change this in the base URI as well
-
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
- get the latest node:
curl -sL https://deb.nodesource.com/setup_8.x | sudo -E bash -
sudo apt-get install -y nodejscdinside the motor-driver folder and run:npm install- To run the program:
npm start npm run debugcan be used to control motors via wasdx or arrow keysnpm run debug-onlyfor disabling Wot and only using keyboard input while testing or debugging