Arduino/Radmon/Radmon.ino
1b3bfb01
 /*
  Background Radiation Monitor - Web Server
  
  A simple web server that makes available to clients over the Internet
  readings from a MightyOhm Geiger counter. The MightyOhm is connected to
  an Arduino Uno with attached Ethernet shield.  This software module
  runs on the Arduino Uno an embedded HTTP server by which Internet
  applications can query the MightyOhm for Geiger counter readings.
  Also, this software runs a Network Time Protocol (NTP) client, that
  periodically synchronizes the local system clock to network time.
  Included is a simple command line interface that may be used to change the
  network interface IP address, NTP server address, or configure a
  verbose output mode.
  
  Copyright 2018 Jeff Owrey
     This program is free software: you can redistribute it and/or modify
     it under the terms of the GNU General Public License as published by
     the Free Software Foundation, either version 3 of the License, or
     (at your option) any later version.
 
     This program is distributed in the hope that it will be useful,
     but WITHOUT ANY WARRANTY; without even the implied warranty of
     MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
     GNU General Public License for more details.
 
     You should have received a copy of the GNU General Public License
     along with this program.  If not, see http://www.gnu.org/license.
  
  Circuit:
  * Main components: Arduino Uno, Ethernet shield, Mighty Ohm Geiger counter
  * Ethernet shield attached to pins 10, 11, 12, 13
  * In order to allow the MightyOhm to operate on the Uno's 5 volt power
    supply, and thus make the MightyOhm's serial output compatible with the
    Uno, the following has to be done (see MightyOhm schematic):
      1. Change R6 to 1K Ohm.
      2. Change R11 to 330 Ohm.
      3. Connect +5v from the Uno to MightyOhm J6 pin 1.
      4. Connect GND from the Uno to MightyOhm J6 pin 3.
      5. Connect D5 from the Uno to MightyOhm J7 pin 5.
    
  Misc Notes:
    As of this release the Uno's SRAM gets entirely maxed out by
    this program.  Any modifications to this program that requires
    additional memory seriously entails the risk that the modifications
    will cause the program to become un-stable.
    
  Revision History:  
    * v10 released 25 Feb 2014 by J L Owrey
    * v11 released 24 Jun 2014 by J L Owrey
        - optimization of processRxByte function to conserve SRAM
        - removal of non-used function code
        - defaults to APIPA IP address in the event a DHCP address
          cannot be obtained
    * v12 released 20 Dec 2014 by J L Owrey
        - removed Timestamp global variable to make more dynamic
          memory available for local variables
        - optimized clock network synch algorithm
        - optimized serial update algorithm
    * v13 released 22 Jul 2015 by J L Owrey
        - add use of "F" function to store constant strings in
          program flash memory in order to save SRAM space
    * v14 released 19 Aug 2015 by J L Owrey
        - add ability to respond to web a client request with either
          a JSON compatible string or a standard HTML document
    * v15 released 20 Feb 2016 by J L Owrey
        - improved http request handling
        - simplified raw data request format
        - simplified serial data output
    * v16 released 16 Sep 2017 by J L Owrey
        - added capability of rebooting via network http request,
          i.e., "http://{device IP address}/reset"
 */
 
 /***  PREPROCESSOR DEFINES  ***/
 
 //#define DEBUG
 
 /*
  Define the header and version number displayed at startup
  and also by the 'view settings' command.
 */
 #define STARTUP_HEADER "\n\rRadmon v1.6 (c) 2018\n"
 #define RADMON_VERSION "v1.6"
 /*
  The following define sets the MAC address of the device.  This
  address is a permanent attribute of the device's Ethernet interface,
  and never, ever, should be changed.  This address was provided
  by the Arduino Ethernet shield manufacturer for use with this
  specific instance of the Ethernet shield.  This MAC address should
  be shown on a label affixed to the device housing.
 */
 #define ETHERNET_MAC_ADDRESS 0x90, 0xA2, 0xDA, 0x0D, 0x84, 0xF6
 /*
  The following defines an APIPA default address in the event that
  DHCP mode is ON and a DHCP address cannot be obtained.
 */
 #define DEFAULT_APIPA_IP_ADDRESS "169.254.100.10"
 /*
  The following define sets the period of a 'heartbeat' string sent
  out over the device's USB port.  This heartbeat consists of a serial
  data string containing the current radiation reading and GM time.
 */
 #define SERIAL_UPDATE_INTERVAL 5000  //milli-seconds
 /*
  The following define sets the port number the HTTP service will use to
  listen for requests from Internet clients.  Normally HTTP requests use
  port 80.
 */
 #define HTTP_SERVER_PORT 80
 /*
  The following defines are for configuring a local NTP client
  for synchronizing the local system clock to network time.
  Note that the default setting is the IP address of the following
  time server:
               time-c-b.nist.gov
 */
 #define DEFAULT_NTP_SERVER_IP_ADDR "132.163.96.3"
 #define NTP_PORT 8888
 #define NTP_PACKET_SIZE 48 // NTP time stamp is in the first 48 bytes of the message
 /*
  The following defines how often the system clock gets synchronized
  to network time.
 */
 #define NET_SYNCH_INTERVAL 43200 //number in seconds
 /*
  The following defines the size of the buffer space required for the
  serial data string from the Mighty Ohm Geiger counter.  The serial
  data string is defined as the text from newline character to newline
  character.
 */
 #define MIGHTYOHM_DATA_STRING_LENGTH 65
 /*
  The beginning of the MightyOhm data string always begins with the
  same three characters.  These three characters determine the 
  beginning of a new line of data from the MightyOhm.
 */
 #define MIGHTYOHM_DATA_STRING_HEADER "CPS"
 /*
  Set the depth of the string buffer that receives the http
  request header from the client.  Must be large enough to
  capture 'GET /rdata '.
 */
 #define REQUEST_STRING_BUFFER_LENGTH 24
 
 /***  LIBRARY MODULES USED  ***/
 
 #include <Time.h>
 #include <SPI.h>         
 #include <Ethernet.h>
 #include <EthernetUdp.h>
 #include <SoftwareSerial.h>
 #include <EEPROM.h>;
 
 /***  GLOBAL DECLARATIONS ***/
 
 /*
  Create and initialize a mac address object for the Ethernet interface. 
 */
 byte mac[] = { ETHERNET_MAC_ADDRESS };
 /*
  Create and initialize an HTTP server object.  The object is initialized
  to the TCP port the HTTP server will use to listen for clients.
 */
 EthernetServer httpServer(HTTP_SERVER_PORT);
 /*
  Create a UDP client object for sending packets to
  and receiveing packets from an NTP time server.
 */
 EthernetUDP Udp;
 /*
  Create a software serial port for receiving serial data from
  the MightyOhm. Note that the Uno pin 5 receives serial data
  FROM the MightyOhm.  The Uno's pin 6 is not used, as there is
  no need to send serial data to the MightyOhm. 
 */
 SoftwareSerial MightyOhmTxOut(5, 6);
 /*
  Create global variables to store the MightOhm data, next heartbeat
  time, and next synchronization time.
 */
 char mightOhmData[MIGHTYOHM_DATA_STRING_LENGTH + 1];
 unsigned long lastSerialUpdateTime;
 time_t nextClockSynchTime;
 /*
  Create global variables to store the verbose mode state (ON or OFF)
  and the IP address mode state (static or DHCP).
 */
 boolean bVerbose;
 boolean bUseStaticIP;
 /*
  Create and initialize global arrays to hold the current IP address
  and the NTP server IP address.
 */
 byte ipAddr[4];
 byte ntpIpAddr[4];
 
 /*** SYSTEM STARTUP  ***/
 
 void setup()
 {
   /*
    Open serial communications to and from the Uno's USB port.
   */
   Serial.begin(9600);
   /* 
    Print to the USB port a header showing Radmon
    version of this program and the copyright notice.
   */
   Serial.println(F(STARTUP_HEADER));
   /*
     Get the system configuration from EEPROM.
   */
   readSettingsFromEEPROM();
   /*
    Start up the Ethernet interface using either a static or
    DHCP supplied address (depending on stored system configuration).
   */
   if(bUseStaticIP)
   {
     Ethernet.begin(mac, ipAddr);
   } else {
     if ( Ethernet.begin(mac) == 0 )
     {
       /* DHCP not responding so use APIPA address */
       parseIpAddress(ipAddr, DEFAULT_APIPA_IP_ADDRESS);
       Ethernet.begin(mac, ipAddr);
       Serial.println(F("DHCP failed - using APIPA "));
     }
   }
   Serial.print(F("IP address: ")); Serial.println(Ethernet.localIP());
   /*
    Start up NTP client service.
   */
   Udp.begin(NTP_PORT);
   /*
     Synchronize the system clock to network time.
   */
   synchronizeSystemClock();
   /*
    Start up the HTTP server.
   */
   Serial.println(F("Starting http server..."));
   httpServer.begin();
   /*
     Open serial communications to the MightyOhm device.
   */  
   MightyOhmTxOut.begin(9600);
    /*
     Initialize initial time for sending out the hearbeat string. Normally
     the system clock will be at approx 3200 msec at this point. So allow
     some additional time for data to accumulate in MightyOhm data buffer.
   */
   lastSerialUpdateTime = -1;
   /*
    Initialize MightyOhm data string to empty.
   */
   mightOhmData[0] = 0;
   return;
 }
 
 /*** MAIN LOOP ***/
 
 void loop() {
   long currentTime;
 
   currentTime = millis();
   
   /*
    Check for user keyboard 'c' pressed.  This character switches
    to command mode.
   */   
   if ( Serial.available() ) {
     // get incoming byte
     if(Serial.read() == 'c') {
       commandMode();
     }
   }
   
   /*
     Poll serial input buffer from MightyOhm for new data and 
     process received bytes to form a complete data string.
   */
   while ( MightyOhmTxOut.available() ) {
     processRxByte( MightyOhmTxOut.read() );
   }
   
   /*
     In verbose mode, send the MightyOhm data string to the
     serial port at regular intervals.
   */
   if (bVerbose) {
     if (abs(millis() - lastSerialUpdateTime) > SERIAL_UPDATE_INTERVAL) {
       lastSerialUpdateTime = millis();
       Serial.println( mightOhmData );
     }
   }
   
   /*
    Periodically synchronize local system clock to time
    provided by NTP time server.
   */
   if ( now() > nextClockSynchTime ) {
     synchronizeSystemClock();
   }
   
   /*
    Listen for and and process requests from HTTP clients.
   */  
   listenForEthernetClients();
 
   #ifdef DEBUG
     Serial.print("lp time: "); Serial.println(millis() - currentTime);
   #endif
 }
 
 /*
  Synchronize the local system clock to
  network time provided by NTP time server.
 */
 void synchronizeSystemClock()
 {
   byte count;
   
   Serial.println(F("Synchronizing with network time server..."));
     
   for(count = 0; count < 3; count++)  // Attempt to synchronize 3 times
   {
     if(syncToNetworkTime() == 1)
     {
       //  Synchronization successful
       break;
     }
     delay(1000);
   } /* end for */ 
   if(count == 3) {
     Serial.println(F("synch failed"));
   }
   /* 
    Set the time for the next network NTP
    time synchronization to occur.
   */
   nextClockSynchTime = now() + NET_SYNCH_INTERVAL;
   return;
 }
 
 /*
   Handle HTTP GET requests from an HTTP client.
 */  
 void listenForEthernetClients()
 {
   // listen for incoming clients
   EthernetClient client = httpServer.available();
   if (client) {
     char sBuf[REQUEST_STRING_BUFFER_LENGTH];
     byte i;
     char c, c_prev;
     boolean processedCommand;
     boolean firstLineFound;
 
     Serial.println(F("\nclient request"));
 
     i = 0;
     c_prev = 0;
     sBuf[0] = 0;
     processedCommand = false;
     firstLineFound = false;
   
     /*
      * The beginning and end of an HTTP client request is always signaled
      * by a blank line, that is, by two consecutive line feed and carriage 
      * return characters "\r\n\r\n".  The following lines of code 
      * look for this condition, as well as the url extension (following
      * "GET").
      */
     
     while (client.connected())  {
       if (client.available()) {
         c = client.read();
 
         if (bVerbose) {
           Serial.print(c);
         }
               
         if (c == '\r') {
           continue; // discard character
         }  
         else if (c == '\n') {
           if (firstLineFound && c_prev == '\n') {
              break;
           }
         } 
         
         if (!processedCommand) {
           
           if (c != '\n') {
             if(i > REQUEST_STRING_BUFFER_LENGTH - 2) {
               i = 0;
               sBuf[0] = 0;
             }
             sBuf[i++] = c;
             sBuf[i] = 0;
           }
 
           if (!firstLineFound && strstr(sBuf, "GET /") != NULL) {
             firstLineFound = true;
             strcpy(sBuf, "/");
             i = 1;
           }
 
           if (firstLineFound && (c == '\n' || i > REQUEST_STRING_BUFFER_LENGTH - 2)) {
             processedCommand = true;
           }
         }
         c_prev = c;
       } // end single character processing
     } // end character processing loop
 
     /*
      Send a standard HTTP response header to the
      client's GET request.
     */
     transmitHttpHeader(client);
     
     char * pStr = strtok(sBuf, " ");
     if (pStr != NULL) {
       if (strcmp(pStr, "/rdata") == 0)
         transmitRawData(client);
       else if (strcmp(pStr, "/") == 0)
         transmitWebPage(client);
       else if(strcmp(pStr, "/reset") == 0) {
         client.print(F("ok"));
         delay(10);
         // close the connection and reboot:
         client.stop();
         software_Reset();
       }
       else 
         transmitErrorPage(client);
     }
 
     //Serial.println(mightOhmData);
     // give the web browser time to receive the data
     delay(10);
     // close the connection:
     client.stop();
   }
 }
 
 /*
  Send standard http response header back to
  requesting client,
 */
 void transmitHttpHeader(EthernetClient client) {
   client.print(F("HTTP/1.1 200 OK\r\n"          \
                  "Content-Type: text/html\r\n"  \
                  "Connnection: close\r\n"       \
                  "Refresh: 5\r\n"               \
                  "\r\n"                         \
                  ));
 }
 
 /*
  Send to the client the MightyOhm Geiger counter's
  current readings, embedded in an HTML document.
 */
 void transmitWebPage(EthernetClient client) {
   char strBuffer[MIGHTYOHM_DATA_STRING_LENGTH];
 
   strcpy(strBuffer, mightOhmData);
   /*
    * Send the actual HTML page the user will see in their web
    * browser.
   */
   client.print(F("<!DOCTYPE HTML>" \
                  "<html><head><title>Radiation Monitor</title>"  \
                  "<style>pre {font: 16px arial, sans-serif;}" \
                  "p {font: 16px arial, sans-serif;}"
                  "h2 {font: 24px arial, sans-serif;}</style>" \
                  "</head><body><h2>Radiation Monitor</h2>" \
                  "<p><a href=\"http://intravisions.com/radmon/\">" \
                  "<i>intravisions.com/radmon</i></a></p>" \
                  "<hr>"));
   /* Data Items */             
   client.print(F("<pre>UTC &#9;"));
   client.print(strtok(strBuffer, ","));
   client.print(F("<br>"));
   client.print(strtok(NULL, ", "));
   client.print(F(" &#9;"));
   client.print(strtok(NULL, ", "));
   client.print(F("<br>"));
   client.print(strtok(NULL, ", "));
   client.print(F(" &#9;"));
   client.print(strtok(NULL, ", "));
   client.print(F("<br>"));
   client.print(strtok(NULL, ", "));
   client.print(F(" &#9;"));
   client.print(strtok(NULL, ", "));
   client.print(F("<br>"));
   client.print(F("Mode &#9;"));
   client.print(strtok(NULL, ", "));
   client.print(F("<br></pre></body></html>"));
 }  
 
 /*
  Send to the client the MightyOhm Geiger counter's
  current readings, embedded in a JSON compatible string.
 */
 void transmitRawData(EthernetClient client) {
   char strBuffer[MIGHTYOHM_DATA_STRING_LENGTH];
 
   strcpy(strBuffer, mightOhmData);
   /*
    * Format and transmit a JSON compatible data string.
    */
   client.print(F("$,UTC="));
   client.print(strtok(strBuffer, " "));
   client.print(F(" "));
   client.print(strtok(NULL, ", "));
   client.print(F(","));
   client.print(strtok(NULL, ", "));
   client.print(F("="));
   client.print(strtok(NULL, ", "));
   client.print(F(","));
   client.print(strtok(NULL, ", "));
   client.print(F("="));
   client.print(strtok(NULL, ", "));
   client.print(F(","));
   client.print(strtok(NULL, ", "));
   client.print(F("="));
   client.print(strtok(NULL, ", "));
   client.print(F(","));
   client.print(F("Mode="));
   client.print(strtok(NULL, ", "));
   client.print(F(",#\n"));
 }
 
 /*
  * Send an error message web page back to the requesting
  * client when the client provides an invalid url extension.
  */
 void transmitErrorPage(EthernetClient client) {
   client.print(F("<!DOCTYPE HTML>" \
                  "<html><head><title>Radiation Monitor</title></head>"  \
                  "<body><h2>Invalid Url</h2>"  \
                  "<p>You have requested a service at an unknown " \
                  "url.</p><p>If you think you made this request in error, " \
                  "please disconnect and try your request again.</p>" \
                  "</body></html>"
                  ));
 }
 
 /*
  Process bytes received from the MightyOhm Geiger counter,
  one at a time, to create a well formed string.
 */
 void processRxByte( char RxByte )
 {
   static char readBuffer[MIGHTYOHM_DATA_STRING_LENGTH];
   static byte cIndex = 0;
   
   /*
      Discard carriage return characters.
   */
   if (RxByte == '\r')
   {
     return;
   }
   /*
    A new line character indicates the line of data from
    the MightyOhm is complete and can be written to the
    MightyOhm data buffer.
   */
   else if (RxByte == '\n')
   {
     /*
      First copy the timestamp to the MightyOhm data buffer. The "CPS"
      characters are not preserved in the temporary read buffer, so
      restore them to the MightyOhm data buffer, as well.
     */
     sprintf( mightOhmData, "%d:%02d:%02d %d/%d/%d, %s",       \
           hour(), minute(), second(), month(), day(), year(),  \
           MIGHTYOHM_DATA_STRING_HEADER );
     /*
      Now copy the rest of the data in the temporary read buffer to the
      MightyOhm data buffer.
     */ 
     strcat(mightOhmData, readBuffer);
     /*
      Flush the temporary read buffer.
     */
     cIndex = 0;
     readBuffer[0] = 0;
     return;
   }
   /* 
    A new line of data will always have "CPS" as the first
    three characters.  Therefore, when these characters occur in
    sequence, the read buffer should begin collecting characters.
    This is a kluge to deal with an inherent problem in the Software
    Serial library implementation that results in characters dropped
    from the software serial stream buffer.
   */
   if( strstr(readBuffer, MIGHTYOHM_DATA_STRING_HEADER) > 0 ) 
   {
     cIndex = 0;
   }
   /*
    Read characters into a temporary buffer until
    the line of data is complete or the buffer is full.
   */
   if(cIndex < MIGHTYOHM_DATA_STRING_LENGTH)
   {
     readBuffer[cIndex] = RxByte;
     cIndex += 1;
     readBuffer[cIndex] = 0;
   }
   return;
 } 
 
 /* 
   Send a UDP request packet to an NTP time server and listen for a reply.
   When the reply arrives, parse the received UPD packet and compute unix
   epoch time.  Then set the local system clock to the epoch time.
 */
 int syncToNetworkTime()
 {
   /*
    Send a request to the NTP time server.
   */
   byte packetBuffer[ NTP_PACKET_SIZE]; //buffer to hold outgoing and incoming packets 
   /*
    Send an NTP packet to the time server and allow for network lag
    before checking if a reply is available.
   */
   sendNTPpacket(packetBuffer);
   delay(2000);  // allow 2000 milli-seconds for network lag
 
   /*
    Wait for response from NTP time server.
   */
   if ( Udp.parsePacket() )
   {  
     /*
      A UDP packet has arrived, so read the data from it.
     */
     Udp.read( packetBuffer, NTP_PACKET_SIZE );
     /*
      The timestamp starts at byte 40 of the received packet and is four bytes,
      or two words, long. First, esxtract the two words.
     */
     unsigned long highWord = word(packetBuffer[40], packetBuffer[41]);
     unsigned long lowWord = word(packetBuffer[42], packetBuffer[43]);
     /*  
      Combine the four bytes (two words) into a long integer
      this is NTP time (seconds since Jan 1 1900).
     */
     unsigned long secsSince1900 = highWord << 16 | lowWord;
     /*  
      Now convert NTP time into UTC time.  Note that
      Unix time starts on Jan 1 1970. In seconds,
      that's 2208988800.  Therfore,
      
          epoch = secsSince1900 - 2208988800UL
          
      Set the local system clock with this value.
     */
     setTime(secsSince1900 - 2208988800UL);
     return 1;
   }
   else
   {
     return 0;
   } /* end if */
 }
 
 /*
   Send an NTP request to the NTP time server.
 */
 void sendNTPpacket( byte* packetBuffer )
 {
   /*
    Set all bytes in the buffer to 0.
   */
   memset( packetBuffer, 0, NTP_PACKET_SIZE );
   /*
    Initialize values needed to form NTP request.
   */
   packetBuffer[0] = 0b11100011;  // LI, Version, Mode
   packetBuffer[1] = 0;           // Stratum, or type of clock
   packetBuffer[2] = 6;           // Polling Interval
   packetBuffer[3] = 0xEC;        // Peer Clock Precision
   /*
    Set the remaining 8 bytes to zero for Root Delay & Root Dispersion.
   */
   packetBuffer[12]  = 49; 
   packetBuffer[13]  = 0x4E;
   packetBuffer[14]  = 49;
   packetBuffer[15]  = 52;
   /*
    All NTP fields have been given values, so now
    send a packet requesting a timestamp.
   */ 		
   Udp.beginPacket( ntpIpAddr, 123 ); //NTP requests are to port 123
   Udp.write( packetBuffer, NTP_PACKET_SIZE );
   Udp.endPacket();
   return;
 }
 
 /***  COMMAND LINE INTERFACE  ***/
 
 /*
  Print a command menu to the USB port.  Then wait for a
  response from the user.  When the response has been
  received, execute the command.
 */
 void commandMode()
 {
   char sCmdBuf[2];
   
   getCurrentIP();  //used for display of settings
   
   while(true)
   {
     /*
      Print the menu.
     */
     Serial.print( F("\n"                         \
                   "1 - view settings\r\n"        \
                   "2 - set IP address\r\n"       \
                   "3 - set NTP server\r\n"       \
                   "4 - toggle verbose\r\n"       \
                   "5 - exit without saving\r\n"  \
                   "6 - save & restart\r\n"       \
                   ">"));
     /*
      Get the command from the user.
     */
     getSerialLine(sCmdBuf, 2);
     Serial.print(F("\n\n\r"));
     /* 
      Execute the command.
     */
     switch (sCmdBuf[0])
     {
       case '1':
         displaySettings();
         break;
       case '2':
         setIP();
         break;
       case '3':
         setNTPIP();
         break;
       case '4':
         toggleVerbose();
         break;
       case '5':
         readSettingsFromEEPROM();
         return;
       case '6':
         writeSettingsToEEPROM();
         /*
          A software reboot is necessary to force the 
          Arduino to request an IP address from a DHCP
          server or to initialize the Ethernet interface
          with a static IP address.
         */
         software_Reset();
         return;
       default:
         Serial.println(F("invalid command"));
     } /* end switch */
   } /* end while */
   return;
 }
 
 /*
  Displays the current system settings.  Displays
  RadMon software version, local IP address, NTP server
  address, and verbose mode setting.
 */
 void displaySettings()
 {
   char sBuf[16];
   
   // Display RadMon version
   Serial.print(F("Firmware "));
   Serial.print(F(RADMON_VERSION));
   Serial.println();
 
   // Display local IP address
   sprintf(sBuf, "%d.%d.%d.%d", ipAddr[0], ipAddr[1], ipAddr[2], ipAddr[3]);
   if (bUseStaticIP)
   {
     Serial.print(F("Static IP: "));
   }
   else
   {
     Serial.print(F("DHCP IP: "));
   }
   Serial.println(sBuf);
   
   // Display NTP server IP address
   sprintf(sBuf, "%d.%d.%d.%d", ntpIpAddr[0], ntpIpAddr[1], ntpIpAddr[2], ntpIpAddr[3]);
   Serial.print(F("NTP server: ")); 
   Serial.println(sBuf);
 
   // Display verbose mode setting
   printVerboseMode();
   return;
 }
 
 /*
  Sets the local IP address. If the user sends a carriage
  return as the first character, then switch to acquiring
  IP address via DHCP server.
 */
 void setIP()
 {
   char sBuf[16];
 
   Serial.print(F("enter IP (<CR> for DHCP): "));
   getSerialLine(sBuf, 16);
   
   if(strlen(sBuf) == 0)
   {
     bUseStaticIP = false;
     strcpy(sBuf, "0.0.0.0");
     parseIpAddress(ipAddr, sBuf);
   }
   else
   {
     bUseStaticIP = true;
     parseIpAddress(ipAddr, sBuf);
   }
   Serial.println();
   return;
 }
 
 /*
  Sets the NTP server IP address.  If the user sends a
  carriage return as the first character, then use the
  default IP address for the NTP server.
 */
 void setNTPIP()
 {
   char sBuf[16];
   
   Serial.print(F("enter IP (<CR> for default): "));
   getSerialLine(sBuf, 16);
   
   if (strlen(sBuf) == 0)
   {
     strcpy(sBuf, DEFAULT_NTP_SERVER_IP_ADDR);
     parseIpAddress(ntpIpAddr, sBuf);
   }
   else
   {
     parseIpAddress(ntpIpAddr, sBuf);
   }
   Serial.println();
   return;
 }
 
 /*
  Turns verbose mode ON or OFF.
 */
 void toggleVerbose()
 {
   bVerbose = !bVerbose;
   printVerboseMode();
   return;
 }
 
 /***  GENERAL HELPER FUNCTIONS  ***/
 
 /*
  Print current verbose mode.
 */
 void printVerboseMode()
 {
   Serial.print(F("Verbose: "));
   if (bVerbose)
   {
     Serial.println(F("ON"));
   }
   else
   {
     Serial.println(F("OFF"));
   }
   return;
 }
 
 /*
  Get the current IP address from the Ethernet interface
 */
 void getCurrentIP()
 {
   ipAddr[0] = Ethernet.localIP()[0];
   ipAddr[1] = Ethernet.localIP()[1];
   ipAddr[2] = Ethernet.localIP()[2];
   ipAddr[3] = Ethernet.localIP()[3];
   return;
 }
 
 /*
  Gets a line of data from the user via USB port.
 */
 char* getSerialLine(char* sBuffer, int bufferLength)
 {
   byte index;
   char cRx;
 
   /* 
    Discard extranious characters that may still be in the
    USB serial stream read buffer.  Most often these characters
    will be unprocessed carriage return or line feed characters.
   */
   delay(10);
   while (Serial.available())
   {
     cRx = Serial.read();
   }
 
   /*
    Read and process characters from the user as they arrive in
    the USB serial read buffer.
   */
   index = 0;
   while(true)
   {
     /*
      Wait until the user starts pressing keys and bytes
      arrive in the serial read buffer.
     */
     if (Serial.available())
     {
       cRx = Serial.read();
       if (cRx == '\r' || cRx == '\n')
       {
         /*
          The user has finished typing the command and
          has pressed the Enter key. So, discard the
          carriage return and newline characters and then
          return control to the calling function.
         */
         break;
       }
       else if (cRx == 8 || cRx == 127)
       {
         if (index > 0)
         {
           /*
            The user has hit the delete-backspace key,
            so send out a backspace, followed by a space,
            followed by another backspace character.
            This allows for in-line ediiting.
           */
           Serial.write(8);
           Serial.write(32);
           Serial.write(8); 
           index -= 1;
         }
       }
       else if ( index < (bufferLength - 1) )
       {
         /*
          The received character is valid, so write it
          to the buffer. Once the buffer becomes full
          do not write any more characters to it.  When
          the user pressses the enter key, the string
          will be null terminated and control will pass
          back to the calling function.
         */
         Serial.write(cRx); // echo character to terminal
         sBuffer[index] = cRx;
         index += 1;
       } /* end if */
     } /* end if */
   } /* end while */
   sBuffer[index] = 0; // terminate the string
   return sBuffer;
 }
 
 /*
  Writes system configuration settings to non-volitile
  EEPROM.  The items written are the local IP address,
  the NTP server IP address, the state of verbose mode,
  and local IP mode (static or DHCP).
 */
 void writeSettingsToEEPROM()
 {
   byte ix;
   for (ix = 0; ix < 4; ix++)
   {
     EEPROM.write(ix, ipAddr[ix]);
     EEPROM.write(ix + 4, ntpIpAddr[ix]);
   }
   EEPROM.write(8, bVerbose);
   EEPROM.write(9, bUseStaticIP);
   return;
 }
 
 /*
  Reads system configuration settings from non-volitile
  EEPROM.  The items read are the local IP address,
  the NTP server IP address, the state of verbose mode,
  and local IP mode (static or DHCP).
 */
 void readSettingsFromEEPROM()
 {
   byte ix;
   for (ix = 0; ix < 4; ix++)
   {
     ipAddr[ix] = EEPROM.read(ix);
     ntpIpAddr[ix] = EEPROM.read(ix + 4);
   }
   bVerbose = EEPROM.read(8);
   bUseStaticIP = EEPROM.read(9);
   return;
 }
 
 /*
  Parses an IP address given in "nnn.nnn.nnn.nnn" string
  format into four bytes and stores them in an array. Note
  that this function destroys the contents of the sIP
  character array.  Therefore this array cannot be
  reinitialized after calling this function.
 */
 void parseIpAddress(byte* byBuf, char* sIP)
 {
   byBuf[0] = atoi(strtok(sIP, "."));
   byBuf[1] = atoi(strtok(NULL, "."));
   byBuf[2] = atoi(strtok(NULL, "."));
   byBuf[3] = atoi(strtok(NULL, "."));
   return;
 }
 
 /*
  Restarts the Uno and runs this program from beginning.  This
  function gets called after a change made from the user
  interface when the user selects "save and restart".
 */
 void software_Reset() 
 {
   asm volatile ("  jmp 0");
   return; 
 }