diff --git a/README.txt b/README.txt new file mode 100644 index 0000000..69d1ff9 --- /dev/null +++ b/README.txt @@ -0,0 +1,20 @@ +Arduino Nagios Display + +For creating an WiFi-enabled, Arduino-powered 8x5 LED matrix that displays Nagios status information +Intentionally kept hackable, with lots of commented-out sections and debugging information available, because everyone's environment is slightly different. + +Included in distribution: +- ArduinoNagiosDisplay.pde, based on Arduino SimpleClient and shiftOutCode Hello World examples +- nag.php, based on GPL-licensed code by Jason Antman +- ShiftOutExample images, copyright Arduino + +This program connects to a matching script on your Nagios server + (it must return a string like $00001000200002100000 -- see included php script.) + +To assemble the hardware, I recommend an Arduino Diamondback, which is essentially an Arduino + WiShield. +Look at the included ShiftOutExample images which are taken from the Shift Out Arduino tutorial at http://arduino.cc/en/Tutorial/ShiftOut +The only difference is that the Diamondback/WiShield uses pins 14, 11, and 12 so I'm using pins 5,7, and 8 instead. + +To get the microcontroller software working, look at the ArduinoNagiosDisplay.pde comments. + +Also, put the nag.php script on your Nagios server outside of any authentication requirements. I put it at /var/www/nag.php . See the comment in the file and modify settings as needed. diff --git a/ShiftOutExampleBreadboard.gif b/ShiftOutExampleBreadboard.gif new file mode 100644 index 0000000..01ca5b9 Binary files /dev/null and b/ShiftOutExampleBreadboard.gif differ diff --git a/ShiftOutExampleSchematic.gif b/ShiftOutExampleSchematic.gif new file mode 100644 index 0000000..7cb1aed Binary files /dev/null and b/ShiftOutExampleSchematic.gif differ diff --git a/nag.php b/nag.php index 3777ebc..daec9d2 100644 --- a/nag.php +++ b/nag.php @@ -35,6 +35,8 @@ // change the statusFile to the location of status.dat on your Nagios system $statusFile = "/var/cache/nagios3/status.dat"; +// ------------- end config + $nag_version = getFileVersion($statusFile); // returns integer 2 or 3 $created_ts = 0;