Skip to content

Latest commit

 

History

History
140 lines (81 loc) · 6.27 KB

README.md

File metadata and controls

140 lines (81 loc) · 6.27 KB
Raw

GroMon

Basic wireless monitoring platform for experimentation and rapid prototyping.

  • Raspberry Pi
  • Arduino
  • Node.js
  • Bluetooth
  • Awesome!

#Bill of Materials This is "must have" list for building the GroMon system. Each "half" of the solution is broken out separately. You can absolutely build either half independently, allowing you to split the purchase in two but still keep hacking.

Server-side

Arduino-side

Stuff you probably have

But if not, you really should buy it.

  • Micro USB cable
  • Mini USB cable
  • Some way of supplying power to the USB cables (like a wall wart, powered USB hub, etc)

Optional fancy stuff

#Raspberry Pi Setup This is a fairly high-level overview of how to set up the Raspberry Pi to host the GroMon application.

  1. Pop in your wifi and bluetooth devices.

  2. Download and install Raspbian onto an sdcard. (we downloaded 2013-02-09-wheezy-raspbian.zip)

  3. Slap in wifi dongle and configure wifi (/etc/wpa_supplicant/wpa_supplicant.conf, ifdown wlan0, ifup wlan0)

  4. Patch to current (sudo apt-get update && sudo apt-get upgrade). This does take a while.

  5. Install bluetooth support (sudo apt-get install bluetooth). This also takes a while.

  6. Quickly test bluetooth (hcitool scan)

  7. Download and compile node.js 0.10.x. This takes a long time, almost 3hrs. If you are able to cross-compile for arm, do that.

#Bluetooth Bee Setup Simple instructions on how to assemble and program your Bluetooth Bee.

  1. Mount the Bluetooth Bee on the XBee Carrier, leave the switch in the "Off" position.

  2. Connect the temperature probe to the port labeled "D6D5" on the XBee Carrier.

  3. Connect the USB cable to the XBee Carrier and your computer. Even if the switch is in the "Off" position, you'll get some LED activity. It's okay.

  4. Flip the XBee Carrier switch into the "On" position. You should see a ton of LED activity now.

  5. Fire up the Arduino IDE

  6. Check under "Tools > Serial Port" and ensure you have a device listed.

  7. Under the "Tools > Board" menu, select "Arduino Nano w/ATMega168".

  8. Open the file GroMon.ino, search for "ProbeMon" and replace it with something more clever.

  9. When ready, click the "Upload" button. If we're lucky everything will "just work"!

  10. After uploading, power-cycle the XBee carrier. Your wireless probe is now programmed.

#Connecting the Raspberry Pi to the Bluetooth Bee

  1. Power up the Bluetooth Bee and then log into the Raspberry Pi. The remainder of these steps will be performed on the Pi.

  2. Check to see if bluetooth is running (service bluetooth status), if not, start it up (sudo service bluetooth start)

  3. Search for the Bluetooth Bee (hcitool scan), it's either named "GroMon" or you changed it (which I hope you did). Take note of the hardware ID.

  4. Check to see if bluetooth is running (service bluetooth status)

  5. Run "sudo bluetooth-agent 0000 &". If you changed the PIN in the Arduino sketch, then use that in place of the zeros.

  6. Run "sudo rfcomm release 0". If it says "Can't release device: No such device", that's totally okay.

  7. Run "sudo rfcomm bind 0 1", this creates a serial port at /dev/rfcomm0, now we can eat it with Node.js!

  8. Start the web app (cd ~/gromon/Web; node app.js). Within a few moments you should see messages flowing back and forth.

#Misc notes and whatnot

  1. Sometimes, when you rename the Bluetooth Bee, the old name persists when you run "hcitool scan" or "bluez-test-discovery". You can edit /var/lib/bluetooth//names to correct this problem.

  2. The normal boot cycle of the bluetooth bee is: booting = blinking blue led.. waiting to pair = alternating blue and red leds... paired = blinking blue led

How to Use the Simulator

Directions for running the full solution coming soon. Until then, here's how you can simulate the remote sensor and get a feel for how things work.

Linux (OSX?)

  1. Open a terminal, then clone the GroMon repo.

    git clone [email protected]:aulvi/gromon.git

  2. Navigate into the Web directory, then install modules.

    cd gromon/Web; npm install

  3. Fire up socat and create a couple of serial ptys. This will take over your terminal.

    socat -d -d pty,raw,echo=0 pty,raw,echo=0

This command will return two devices in the output (ie, "N PTY is /dev/pts/5").

  1. Open another terminal and start the dummy probe using the first device from the command above:

    node dummy-probe.js --port=/dev/pts/5

  2. Start the web app using the other device:

    node app.js --probePort=/dev/pts/6

  3. Within a few seconds you should see messages moving back and forth.

License

Copyright (C) 2013 Adam Ulvi

Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.