@@ -49,8 +49,19 @@ import json

 import ina260 # power sensor

 import tmp102 # temperature sensor

+# Import custom libraries

+import smsalert

+

     ### ENVIRONMENT ###

+

 _USER = os.environ['USER']

+_HOSTNAME = os.uname()[1]

+

+    ### SMS RECIPIENTS ###

+

+_SMS_CALLSIGN = '{your callsign}'

+_SMS_PASSCODE = '{your passcode}'

+_SMS_PHONE_NUMBER = '{your phone number}'

     ### SENSOR BUS ADDRESSES ###

@@ -89,11 +100,16 @@ _CHART_WIDTH = 600

 _CHART_HEIGHT = 150

 # chart average line color

 _AVERAGE_LINE_COLOR = '#006600'

+# low voltage alert threshold

+_DEFAULT_CRITICAL_LOW_VOLTAGE = 12.0

    ### GLOBAL VARIABLES ###

-# Container for sensor objects.

-dSensors = {}

+# Sensor instance objects.

+power1 = None

+battemp = None

+ambtemp = None

+sms = None

 # turns on or off extensive debugging messages

 debugMode = False

@@ -107,6 +123,8 @@ chartUpdateInterval = _CHART_UPDATE_INTERVAL

 failedUpdateCount = 0

 # sensor status

 deviceOnline = False

+# sms message sent status

+bSMSmsgSent = False

   ###  PRIVATE METHODS  ###

@@ -182,11 +200,11 @@ def getSensorData(dData):

     dData["time"] = getTimeStamp()

     try:

-        dData["current"] = dSensors['power'].getCurrent()

-        dData["voltage"] = dSensors['power'].getVoltage()

-        dData["power"] = dSensors['power'].getPower()

-        dData["battemp"] = dSensors['battemp'].getTempF()

-        dData["ambtemp"] = dSensors['ambtemp'].getTempF()

+        dData["current"] = power1.getCurrent()

+        dData["voltage"] = power1.getVoltage()

+        dData["power"] =   power1.getPower()

+        dData["battemp"] = battemp.getTempF()

+        dData["ambtemp"] = ambtemp.getTempF()

     except Exception as exError:

         print("%s sensor error: %s" % (getTimeStamp(), exError))

         return False

@@ -196,6 +214,34 @@ def getSensorData(dData):

     return True

 ## end def

+def convertData(dData):

+    """

+    Converts data items and verifies threshold crossings.

+    Parameters: dData - a dictionary object that contains the sensor data

+    Returns: True if successful, False otherwise

+    """

+    global bSMSmsgSent

+

+    if not bSMSmsgSent and dData["voltage"] <= _DEFAULT_CRITICAL_LOW_VOLTAGE:

+        # Format a text alert message.

+        message = "%s %s low voltage alert: %s volts" % \

+                  (getTimeStamp(), _HOSTNAME, dData["voltage"])

+        print(message)

+        # Send the text alert to recipient phone numbers.

+        sms.sendSMS(_SMS_PHONE_NUMBER, message)

+        bSMSmsgSent = True

+    elif bSMSmsgSent and dData["voltage"] > _DEFAULT_CRITICAL_LOW_VOLTAGE:

+        # Format a text alert message.

+        message = "%s %s voltage normal: %s volts" % \

+                  (getTimeStamp(), _HOSTNAME, dData["voltage"])

+        print(message)

+        # Send the text alert to recipient phone numbers.

+        sms.sendSMS(_SMS_PHONE_NUMBER, message)

+        bSMSmsgSent = False

+    ## end if

+    return True

+## end def

+

 def writeOutputFile(dData):

     """

     Write sensor data items to the output data file, formatted as 

@@ -492,13 +538,15 @@ def getCLarguments():

         index += 1

 ##end def

-def main():

+def main_setup():

     """

     Handles timing of events and acts as executive routine managing

     all other functions.

     Parameters: none

     Returns: nothing

     """

+    global power1, battemp, ambtemp, sms

+

     signal.signal(signal.SIGTERM, terminateAgentProcess)

     signal.signal(signal.SIGINT, terminateAgentProcess)

@@ -518,15 +566,15 @@ def main():

         exit(1)

     # Create sensor objects.  This also initializes each sensor.

-    dSensors['power'] = ina260.ina260(_PWR_SENSOR_ADDR, _BUS_NUMBER,

+    power1 = ina260.ina260(_PWR_SENSOR_ADDR, _BUS_NUMBER,

                             debug=debugMode)

-    dSensors['battemp'] = tmp102.tmp102(_BAT_TMP_SENSOR_ADDR, _BUS_NUMBER,

+    battemp = tmp102.tmp102(_BAT_TMP_SENSOR_ADDR, _BUS_NUMBER,

                             debug=debugMode)

-    dSensors['ambtemp'] = tmp102.tmp102(_AMB_TMP_SENSOR_ADDR, _BUS_NUMBER,

+    ambtemp = tmp102.tmp102(_AMB_TMP_SENSOR_ADDR, _BUS_NUMBER,

                             debug=debugMode)

+    # Create instance of SMS alert class

+    sms = smsalert.smsalert(_SMS_CALLSIGN, _SMS_PASSCODE, debug=debugMode)

-    # Enter main loop.

-    main_loop()

 ## end def

 def main_loop():

@@ -550,9 +598,13 @@ def main_loop():

             dData = {}

             # Get the data from the sensors.

-            result =getSensorData(dData)

+            result = getSensorData(dData)

-            # If get data successful, write data to data files.

+            # If get data successful, convert the data and verify thresholds.

+            if result:

+                result = convertData(dData)

+

+            # If convert data successful, write data to data files.

             if result:

                 result = writeOutputFile(dData)

@@ -589,4 +641,5 @@ def main_loop():

 ## end def

 if __name__ == '__main__':

-    main()

+    main_setup()

+    main_loop()

new file mode 100755

@@ -0,0 +1,79 @@

+#!/usr/bin/python

+

+# courtsey ruler for editing script - 80 characters max line length

+#2345678901234567890123456789012345678901234567890123456789012345678901234567890

+

+import telnetlib

+

+_DEFAULT_HOST = '{your APRS-IS server hostname}'

+_DEFAULT_PORT = '{your APRS-IS message port}'

+_DEFAULT_SERVER = '{your APRS-IS server name}'

+

+class smsalert:

+

+    def __init__(self, callsign, passcode, host=_DEFAULT_HOST, \

+      port=_DEFAULT_PORT, server=_DEFAULT_SERVER, debug=False):

+        """

+        Initialize an instance of this class.

+        Parameters:

+          callsign - amateur radio callsign of user (must be verified)

+          passcode - passcode for verified callsign

+          host - domain name or IP address of APRS-IS server

+          port - port on which the APRS-IS server receives messages

+          server - APRS service name

+          debug - set equal to True for debug output

+        Returns: nothing

+        """

+        # Initialize class instance variables.

+        self.callsign = callsign

+        self.passcode = passcode

+        self.host = host

+        self.port = port

+        self.server = server

+        self.debug = debug

+    ## end def

+

+    def sendSMS(self, phone_number, text_message):

+        """

+        Sends an SMS text message to the provided phone number.

+        Parameters:

+          phone_number - phone number to which to send the text message

+          text_message - text message to be sent to the provided phone number

+        Returns: True if successful, False otherwise

+        """

+        # Establish network connection to APRS-IS server.

+        tn = telnetlib.Telnet(self.host, self.port)

+        tn.read_until('# aprsc 2.1.8-gf8824e8')

+

+        # Login and verify passcode accepted.

+        tn.write('user ' + self.callsign + ' pass ' + self.passcode + '\n')

+        response = tn.read_until(self.server)

+        if self.debug:

+            print('response: ' + response[2:])

+        if not response.find('verified'):

+            print('smsalert error: unverified user')

+            del tn

+            return False

+

+        # Format and send SMS message to SMS gateway.

+        cmd = '%s>%s::SMSGTE:@%s %s' % \

+          (self.callsign, self.server, phone_number, text_message)

+        if self.debug:

+            print('cmd: ' + cmd)

+        tn.write(cmd + '\n')

+        del tn

+        return True

+    ## end def

+## end class

+

+def test_smsalert():

+    # Initialize a telnet instance.  Default host, port, and server

+    # automatically defined if not included in function call.

+    sm = smsalert('{your callsign}', '{your passcode}', debug=True)

+

+    # Send a text message to a phone number.

+    sm.sendSMS('{your phone number}', 'Test message send from smsalert.py')

+## end def

+

+if __name__ == '__main__':

+    test_smsalert()