reorg

README.md

@@ -1,2 +1,119 @@
 # raspberry-beacons
 
+The intent of this is to provide a quick, simple, fun and inexpensive alerting beacon that can be connected to any type of service and used as a visual notification that "something" is happening.
+
+Ok, so the more concrete use is for when you have a need for a visual queue, like your latest build has hit production, your site goes down and you've turned your devices to "silent", or you want to know when a specific application crosses some threshold.  The big boys use huge LED monitors to do the same but you and I know that it can all be done with just one LED.
+
+# Hardware
+
+Most likely you'll already have some of these components, but if not you can click on the links below and grab them.
+
+* Raspberry Pi (The A+ is ideal for this project) - [Buy from adafruit](https://www.adafruit.com/products/2266): $24.95
+* Ledborg add on board - [Buy from piborg](https://www.piborg.org/ledborg): $5.20
+* 8gb SD with NOOBS 1.4 already loaded - [Buy from adafruit](https://www.adafruit.com/products/1583): $11.95
+* Miniature WiFi (802.11b/g/n) Module: For Raspberry Pi - [Buy from adafruit](https://www.adafruit.com/product/814): $11.95
+* 5V 2A Switching Power Supply w/ 20AWG 6' MicroUSB Cable - [Buy from adafruit](https://www.adafruit.com/products/1995): $7.95
+* Adafruit Pi Box Plus - Enclosure for Raspberry Pi Model A+ - [Buy from adafruit](https://www.adafruit.com/products/2280): $12:50 (optional)
+
+# Software
+
+You have a handful of options that you can go with. For instance I chose to go with [node.js](https://nodejs.org/), I could've just as easily built the beacon in [python](https://www.python.org/) especially since PiBorg seems to have the majority of their samples and code in the form of python.  
+
+Also, in the build that I describe below I used [NOOBs bootloader](http://www.raspberrypi.org/introducing-noobs/).  You can usually buy an SD with it already on it and it makes it dead simple to get a Raspbian environment up in no time.  You can alternatively [grab the latest Raspbian distribution](http://www.raspberrypi.org/downloads/) and prep your own SD card. There are several great [tutorials](http://www.raspberrypi.org/documentation/installation/installing-images/) out there on how to get that done.
+
+* [NOOBs 1.4](http://www.raspberrypi.org/documentation/installation/noobs.md)
+* [Node.js 0.12.0](https://nodejs.org/)
+* [pi-gpio](https://www.npmjs.com/package/pi-gpio)
+* [quick2wire-gpio-admin](https://github.com/quick2wire/quick2wire-gpio-admin)
+
+# Setup
+
+**Put the hardware together**
+
+* Place your LedBorg board on the Pi. The easiest way to know you're seating the board correctly is to make sure that the piborg icon looks like it's almost standing on top of the raspberry.  Have a look at the [piborg site](https://www.piborg.org/ledborg) if you are still unsure.
+* Make sure to add your USB wifi adapter before turning your Pi on
+* Insert your SD card in the underside of the Pi and you'll be good to go.
+
+**Setup the RaspberryPi/Raspbian environment**
+
+The second thing you are going to want to do is setup your RaspberryPi/Raspbian environment. Adafruit has an amazing [walk-through](https://learn.adafruit.com/adafruits-raspberry-pi-lesson-2-first-time-configuration/overview) on this (some of the screen shots are out of date with recent distros).
+
+**Setup the Wifi**
+
+Again the folks at Adafruit have a great [walk-through](https://learn.adafruit.com/adafruits-raspberry-pi-lesson-3-network-setup/setting-up-wifi-with-raspbian) on how to setup wifi.  Anyone who was running older versions of Raspbian probably remember how painful getting wifi working on your Pi was - not so anymore!
+
+**Setup Node.js**
+
+This is amazingly simple to do as well. Just open a Terminal window and use the following commands below provided from the Adafruit [walk-through](https://learn.adafruit.com/node-embedded-development/installing-node-dot-js).
+
+Update the package index
+
+```
+sudo apt-get update
+
+```
+
+Install the newest versions of all of the packages
+
+```
+sudo apt-get upgrade
+
+```
+
+Pull down the latest version of Node
+
+```
+wget http://node-arm.herokuapp.com/node_latest_armhf.deb
+
+```
+
+Install it...
+
+```
+sudo dpkg -i node_latest_armhf.deb
+
+```
+
+Verify
+
+```
+pi@raspberrypi ~ $ node -v
+
+```
+
+**Enable GPIO **
+
+So this is where it get a bit choppy.  There have been several updates to Raspbian which is fantastic, however the two tools we are going to use to access and use GPIO have a few bugs as a result of those updates. But **don't fret** these changes are fairly straight forward and can be made as we go. 
+
+As a side note this complexity is added here because the Raspberry Pi GPIO pins require you to have *ROOT* to use them. So to keep us safe and secure we are going to use gpio-admin to help us out.
+
+**Installing gpio-admin**
+
+```
+git clone git://github.com/quick2wire/quick2wire-gpio-admin.git
+cd quick2wire-gpio-admin
+make
+sudo make install
+sudo adduser $USER gpio
+
+```
+
+Then simply logout and log back in.
+
+**Installing pi-gpio**
+
+```
+npm install pi-gpio
+
+```
+
+You now have enough of an environment to run the ledborg test harness I have. This is going to help you know if you are going to need to modify gpio-admin and pi-gpio for your given environment.
+
+** Getting the beacon setup **
+
+From the terminal:
+
+```
+git clone 
+
+```

beacon.js → newrelic_insights_beacon.js

@@ -4,7 +4,7 @@ gu = require('./gpio_utils')
 
 var insightsApiKey, newrelicAccountId, insightsHost;
 
-// node beacon.js HrurPdQHISZ4ESs8iydk34u7tKHv1zXU 429813 staging-insights-api.newrelic.com
+// node newrelic_insights_beacon.js HrurPdQHISZ4ESs8iydk34u7tKHv1zXU 429813 staging-insights-api.newrelic.com
 if(!process.argv[2]){
 	throw ({'error':'Please supply an New Relic Insights query key'});
 }