Skip to content

Latest commit

 

History

History
95 lines (78 loc) · 6.64 KB

README.md

File metadata and controls

95 lines (78 loc) · 6.64 KB
Raw

Vör Sensor and Actuator Resources

Description

This part of the Vör project provides simple to use classes that wrap the handling of different sensors and actuators on Arduino based microcontrollers. This library uses some other external libraries to ease the use of HTTP clients, WebSocket clients (planned), JSON messages (planned) and protothreads (or this or this, planned).

The microcontrollers:

  • read raw sensor data, process it and sends the processed data as a JSON formatted message to a server
  • have either (wired) Ethernet (room) or Wi-Fi (bathroom) connectivity
  • are powered mainly from the grid for easy maintainability thus they require a stable power supply

Microcontrollers

Current work is mostly focused on the Arduino Yun Mini board. Other boards we are testing include:

Sensors

There are different sensor packages designed for different locations inside the office. Each package consist of a number of individual sensors which collect data that is meaningful in the context of a specific room's function.

Generic room sensor (e.g. meeting room)

Toilet sensor

Pool table button

  • Push button that sends a message to the server
  • Camera near the pool table that records video the whole time reacts to the button message and creates a video clip of the last 30 seconds of the pool game
  • The camera is associated with Vör service, but is not technically linked to the Arduino implementation

Food table switch

  • Switch to notify users if there is some food served on the kitchen table
  • Webcam attached to Raspberry Pi reacts to the switch message and takes a picture of the food and sends it to the server
  • The webcam is associated with Vör service, but is not technically linked to the Arduino implementation

Sauna

  • Electric current for checking if the sauna is turned on
  • Temperature sensor for checking if the sauna is warm

Installation

  1. Buy an Arduino Yun Mini board and sensors
  2. Upload a corresponding sketch to the board (modify the sketch if you want)
  3. 3D print a case for the sensors
  4. Solder or wire-wrap the sensors and put them inside the case
  5. Deploy the sensor package
  6. Use the Vör app to use servises tied to the sensor package

Arduino SDK

  • Download and install the Arduino SDK
    • You may need to (find and) install USB drivers more or less manually
  • When you run the Arduino IDE you need to setup:
    • Tools > Board (select the board you are developing for, e.g. "Arduino Yun" for Arduino Yun Mini)
    • Tools > Port (select the USB serial port the board is connected to)
  • Upload a sketch (*.ino) to the board by clicking the arrow button in the toolbar
  • You may print debugging info to Tools > Serial Monitor with Serial.print() and Serial.println() functions

Vör Arduino library

  • Proceed to installing this library once you have installed the Arduino SDK above
  • Download this repository and copy this folder (vor/vor-arduino/) into your Arduino external libraries folder (Arduino/libraries/)
  • Launch the Arduino IDE and you should see this library in Sketch > Include Library > vor-arduino
  • You can find example sketches under File > Examples > vor-arduino

LinkIt ONE

Arduino Yun and Arduino Yun Mini

  • Turn on Yun by connecting the mini USB cable
  • The first time Yun is turned on its Wi-Fi is unconfigured and Yun creates a network called LININO-*
    • On your computer connect to the network and go to http://linino.local or 192.168.240.1 with a browser
      • The default password of the configuration page is doghunter
      • Once logged in click Configure and configure Yun to connect to the desired network
    • After configuring Yun's Wi-Fi connect your computer to the same network Yun is connected to
    • You may reset the Wi-Fi configuration by holding the WLAN RST button on the board for more that 5 seconds and less than 30 seconds

Major Components List