pymscada 0.2.0rc6__py3-none-any.whl → 0.2.0rc8__py3-none-any.whl

pymscada/alarms.py

@@ -11,14 +11,12 @@ ALM = 0
 RTN = 1
 ACT = 2
 INF = 3
-
 KIND = {
     ALM: 'ALM',
     RTN: 'RTN',
     ACT: 'ACT',
     INF: 'INF'
 }
-
 NORMAL = 0
 ALARM = 1
 
@@ -46,8 +44,8 @@ def standardise_tag_info(tagname: str, tag: dict):
     if 'desc' not in tag:
         logging.warning(f"Tag {tagname} has no description, using name")
         tag['desc'] = tag['name']
-    if 'area' not in tag:
-        tag['area'] = ''
+    if 'group' not in tag:
+        tag['group'] = ''
     if 'multi' in tag:
         tag['type'] = int
     else:
@@ -107,7 +105,7 @@ class Alarm():
     Generates the ALM and RTN messages for Alarms to publish via rta_tag.
     """
 
-    def __init__(self, tagname: str, tag: dict, alarm: str, area: str, rta_cb, alarms) -> None:
+    def __init__(self, tagname: str, tag: dict, alarm: str, group: str, rta_cb, alarms) -> None:
         """Initialize alarm with tag and condition(s)."""
         self.alarm_id = f'{tagname} {alarm}'
         self.tag = Tag(tagname, tag['type'])
@@ -115,7 +113,7 @@ class Alarm():
         self.tag.dp = tag['dp']
         self.tag.units = tag['units']
         self.tag.add_callback(self.callback)
-        self.area = area
+        self.group = group
         self.rta_cb = rta_cb
         self.alarms = alarms
         self.alarm = split_operator(alarm)
@@ -166,7 +164,7 @@ class Alarm():
             'kind': kind,
             'desc': f'{self.tag.desc} {value:.{self.tag.dp}f}'
                     f' {self.tag.units}',
-            'group': self.area
+            'group': self.group
         })
 
     def check_duration(self, current_time_us: int):
@@ -224,9 +222,10 @@ class Alarms:
             standardise_tag_info(tagname, tag)
             if 'alarm' not in tag or tag['type'] not in (int, float):
                 continue
-            area = tag['area']
+            group = tag['group']
             for alarm in tag['alarm']:
-                new_alarm = Alarm(tagname, tag, alarm, area, self.rta_cb, self)
+                new_alarm = Alarm(tagname, tag, alarm, group, self.rta_cb,
+                                  self)
                 self.alarms.append(new_alarm)
         self.busclient = BusClient(bus_ip, bus_port, module='Alarms')
         self.rta = Tag(rta_tag, dict)

pymscada/bus_client.py

@@ -17,8 +17,8 @@ class BusClient:
     the client dies. A connection is mandatory for the client to run.
     """
 
-    def __init__(self, ip: str = '127.0.0.1', port: int = 1324, tag_info=None,
-                 module: str = '_unset_'):
+    def __init__(self, ip: str | None = '127.0.0.1', port: int | None = 1324,
+                 tag_info=None, module: str = '_unset_'):
         """Create bus server."""
         self.ip = ip
         self.port = port

pymscada/callout.py

@@ -0,0 +1,203 @@
+"""Callout handling."""
+import logging
+import socket
+import time
+from pymscada.bus_client import BusClient
+from pymscada.periodic import Periodic
+from pymscada.tag import Tag
+
+
+"""
+Callout monitors alarms and sends SMS notifications to configured callees.
+
+Configuration:
+- callees: list of recipients with SMS numbers, delays, and group filters
+- alarms_tag: RTA tag receiving alarms from alarms.py
+- ack_tag: tag for receiving acknowledgments
+- rta_tag: tag for configuration updates and SMS requests
+
+Operation:
+1. Collect alarms from alarms_tag (kind=ALM)
+2. For each callee, check if alarms match their group filter and delay
+3. Send SMS via rta_tag when conditions are met
+4. Track sent notifications in alarm['sent'] hash
+5. Remove alarms when callee acknowledges (matches their group)
+"""
+
+ALM = 0
+IDLE = 0
+NEW_ALM = 1
+CALLOUT = 2
+
+
+def normalise_callees(callees: list | None):
+    """Normalise callees to include delay_ms and remove delay."""
+    if callees is None:
+        return []
+    for callee in callees:
+        if 'sms' not in callee:
+            raise ValueError(f'Callee {callee["name"]} has no sms number')
+        if 'delay' in callee:
+            callee['delay_ms'] = callee['delay'] * 1000
+            del callee['delay']
+        else:
+            callee['delay_ms'] = 0
+        if 'group' not in callee:
+            callee['group'] = []
+    callees.sort(key=lambda x: x['delay_ms'])
+    return callees
+
+
+def alarm_in_callee_group(alarm_group: list, callee_group: list):
+    """Check if alarm_group is in callee_group."""
+    if not callee_group:
+        if not alarm_group:
+            return ''
+        return alarm_group[0]
+    if not alarm_group:
+        return None
+    for group in alarm_group:
+        if group in callee_group:
+            return group
+    return None
+
+
+class Callout:
+    """Connect to bus_ip:bus_port, monitor alarms and manage callouts."""
+
+    def __init__(
+        self,
+        bus_ip: str | None = '127.0.0.1',
+        bus_port: int | None = 1324,
+        rta_tag: str = '__callout__',
+        alarms_tag: str | None = None,
+        ack_tag: str | None = None,
+        status_tag: str | None = None,
+        callees: list | None = None,
+        groups: list | None = None
+    ) -> None:
+        """
+        Connect to bus_ip:bus_port, monitor alarms and manage callouts.
+
+        Monitor alarms via alarms_tag and manage callout messages to callees
+        based on configured delays and area filters.
+
+        Event loop must be running.
+
+        For testing only: bus_ip can be None to skip connection.
+        """
+        if bus_ip is None:
+            logging.warning('Callout has bus_ip=None, only use for testing')
+        else:
+            try:
+                socket.gethostbyname(bus_ip)
+            except socket.gaierror as e:
+                raise ValueError(f'Cannot resolve IP/hostname: {e}')
+            if not isinstance(bus_port, int):
+                raise TypeError('bus_port must be an integer')
+            if not 1024 <= bus_port <= 65535:
+                raise ValueError('bus_port must be between 1024 and 65535')
+        if not isinstance(rta_tag, str) or not rta_tag:
+            raise ValueError('rta_tag must be a non-empty string')
+
+        logging.warning(f'Callout {bus_ip} {bus_port} {rta_tag}')
+        self.alarms = []
+        self.callees = normalise_callees(callees)
+        self.groups = []
+        if groups is not None:
+            self.groups = groups
+        self.status = None
+        if status_tag is not None:
+            self.status = Tag(status_tag, int)
+            self.status.value = IDLE
+        self.busclient = BusClient(bus_ip, bus_port, module='Callout')
+        self.busclient.add_callback_rta(alarms_tag, self.alarms_cb)
+        self.busclient.add_callback_rta(ack_tag, self.ack_cb)
+        self.rta = Tag(rta_tag, dict)
+        self.rta.value = {}
+        self.busclient.add_callback_rta(rta_tag, self.rta_cb)
+        self.periodic = Periodic(self.periodic_cb, 1.0)
+
+    def alarms_cb(self, request):
+        """Handle alarm messages from alarms.py."""
+        if request['kind'] != ALM:
+            return
+        alarm = {
+            'date_ms': request['date_ms'],
+            'alarm_string': request['alarm_string'],
+            'desc': request['desc'],
+            'group': request['group'],
+            'sent': {}
+        }
+        self.alarms.append(alarm)
+        logging.info(f'Added alarm to list: {alarm}')
+
+    def ack_cb(self, ack: str):
+        """Handle ACK requests for alarm acknowledgment."""
+        if ack == '__all':
+            self.alarms = []
+            return
+        callee = None
+        for c in self.callees:
+            if ack == c['sms']:
+                callee = c
+                break
+            if ack == c['name']:
+                callee = c
+                break
+        if callee is None:
+            logging.warning(f'ACK rejected: {ack}')
+            return
+        logging.info(f'ACK accepted: {ack}')
+        group = callee['group']
+        remaining_alarms = []
+        for alarm in self.alarms:
+            alarm_group = alarm_in_callee_group(alarm['group'], group)
+            if alarm_group is None:
+                remaining_alarms.append(alarm)
+        self.alarms = remaining_alarms
+
+    def rta_cb(self, request):
+        """Handle RTA requests for callout configuration."""
+        if 'action' not in request:
+            logging.warning(f'rta_cb malformed {request}')
+        elif request['action'] == 'MODIFY':
+            for callee in self.callees:
+                if callee['name'] == request['name']:
+                    if 'delay' in request:
+                        callee['delay_ms'] = request['delay'] * 1000
+                    if 'group' in request:
+                        callee['group'] = request['group']
+                    logging.info(f'Modified callee with {request}')
+
+    def check_callouts(self):
+        """Check alarms and send callouts. Can be called independently for testing."""
+        time_ms = int(time.time() * 1000)
+        for callee in self.callees:
+            message = ''
+            count = 0
+            group = callee['group']
+            notify_ms = time_ms - callee['delay_ms']
+            for alarm in self.alarms:
+                if alarm['date_ms'] < notify_ms:
+                    alarm_group = alarm_in_callee_group(alarm['group'], group)
+                    if alarm_group is not None and callee['name'] not in alarm['sent']:
+                        count += 1
+                        message += f"{alarm['alarm_string']}\n"
+                        alarm['sent'][callee['name']] = time_ms
+            if count > 0:
+                send_message = f"{alarm_group} {count} unack alarms\n{message}"
+                logging.warning(f'Callout to {callee["name"]}: {send_message}')
+                self.rta.value = {'action': 'SMS', 'sms': callee['sms'],
+                                  'message': send_message}
+                if self.status is not None:
+                    self.status.value = CALLOUT
+
+    async def periodic_cb(self):
+        """Periodic callback to check alarms and send callouts."""
+        self.check_callouts()
+
+    async def start(self):
+        """Async startup."""
+        await self.busclient.start()
+        await self.periodic.start()

pymscada/demo/callout.yaml

@@ -0,0 +1,16 @@
+bus_ip: 127.0.0.1
+bus_port: 1324
+rta_tag: __callout__
+alarms: __alarms__
+ack: SI_Alarm_Ack
+status: SO_Alarm_Status
+callees:
+- name: A name
+  sms: A number
+- name: B name
+  sms: B number
+groups:
+- name: Aniwhenua Station
+  group:
+- name: Aniwhenua System
+  group: System

pymscada/demo/pymscada-io-witsapi.service

@@ -0,0 +1,15 @@
+[Unit]
+    Description=pymscada - WITS client
+    BindsTo=pymscada-bus.service
+    After=pymscada-bus.service
+
+[Service]
+    WorkingDirectory=__DIR__
+    ExecStart=__PYMSCADA__ witsapiclient --config __DIR__/config/witsapi.yaml
+    Restart=always
+    RestartSec=5
+    User=__USER__
+    Group=__USER__
+
+[Install]
+    WantedBy=multi-user.target

pymscada/demo/tags.yaml

@@ -113,10 +113,14 @@ localhost_ping:
   desc: Ping time to localhost
   type: float
   units: ms
+  alarm: '> 500 for 300'
+  group: System
 google_ping:
   desc: Ping time to google
   type: float
   units: ms
+  alarm: '> 100 for 30'
+  group: System
 Murupara_Temp:
   desc: Murupara Temperature
   type: float

pymscada/module_config.py

@@ -9,14 +9,14 @@ from pymscada.config import Config
 class ModuleArgument:
     def __init__(self, args: tuple[str, ...], kwargs: dict[str, Any]):
         self.args = args
-        self.kwargs = kwargs
+        self.kwargs = kwargs 
 
 class ModuleDefinition:
     """Defines a module's configuration and behavior."""
-    def __init__(self, name: str, help: str, module_class: Type[Any], *,
+    def __init__(self, name: str, help: str, module_class: Any, *,
                  config: bool = True, tags: bool = True,
                  epilog: Optional[str] = None,
-                 extra_args: list[ModuleArgument] = None,
+                 extra_args: Optional[list[ModuleArgument]] = None,
                  await_future: bool = True):
         self.name = name
         self.help = help
@@ -63,6 +63,12 @@ def create_module_registry():
             help='alarms',
             module_class='pymscada.alarms:Alarms'
         ),
+        ModuleDefinition(
+            name='callout',
+            help='alarm callout notifications',
+            module_class='pymscada.callout:Callout',
+            tags=False
+        ),
         ModuleDefinition(
             name='validate',
             help='validate config files',

{pymscada-0.2.0rc6.dist-info → pymscada-0.2.0rc8.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: pymscada
-Version: 0.2.0rc6
+Version: 0.2.0rc8
 Summary: Shared tag value SCADA with python backup and Angular UI
 Author-email: Jamie Walton <jamie@walton.net.nz>
 License: GPL-3.0-or-later

{pymscada-0.2.0rc6.dist-info → pymscada-0.2.0rc8.dist-info}/RECORD

@@ -1,8 +1,9 @@
 pymscada/__init__.py,sha256=NV_cIIwe66Ugp8ns426rtfJIIyskWbqwImD9p_5p0bQ,739
 pymscada/__main__.py,sha256=WcyVlrYOoDdktJhOoyubTOycMwpayksFdxwelRU5xpQ,272
-pymscada/alarms.py,sha256=iGRf_ybe2KGiFpN7EwAHzqiCyyPYaWgL5zd34SSdrU8,12895
-pymscada/bus_client.py,sha256=ROShMcR2-y_i5CIvPxRdCRr-NpnMANjKFdLjKjMTRwo,9117
+pymscada/alarms.py,sha256=eo-9-DSwV825ihuHApaYkADPpLouKbNLHyh0z4bdPoU,12936
+pymscada/bus_client.py,sha256=eRGvHQ4sFM_n3rKvKDWZQJPQJqvKMWvxbH3MjtT2WBo,9131
 pymscada/bus_server.py,sha256=k7ht2SAr24Oab0hBOPeW4NRDF_RK-F46iE0cMzh7K4w,12323
+pymscada/callout.py,sha256=o_GCB-3IFG-QIcHfrmW-N9CTTlsIu9nMLC-F1jQu1hQ,7274
 pymscada/checkout.py,sha256=RLuCMTEuUI7pp1hIRAUPbo8xYFta8TjArelx0SD4gOY,3897
 pymscada/config.py,sha256=vwGxieaJBYXiHNQEOYVDFaPuGmnUlCnbNm_W9bugKlc,1851
 pymscada/console.py,sha256=EEsJLCvn8AFimN8qGNilX0ks6t3OFcGW5nw6OVAXfac,8850
@@ -10,7 +11,7 @@ pymscada/files.py,sha256=iouEOPfEkVI0Qbbf1p-L324Y04zSrynVypLW0-1MThA,2499
 pymscada/history.py,sha256=7UEOeMnlSMv0LoWTqLWx7QwOW1FZZ4wAvzH6v6b0_vI,11592
 pymscada/main.py,sha256=d6EnK4-tEcvM5AqMHYhvqlnSh-E_wd0Tuxk-kXYSiDw,1854
 pymscada/misc.py,sha256=0Cj6OFhQonyhyk9x0BG5MiS-6EPk_w6zvavt8o_Hlf0,622
-pymscada/module_config.py,sha256=sEoLUhMUFJfalH3CbhNPIqQd1bAL7bWCyPSMUKs6HJ4,9370
+pymscada/module_config.py,sha256=K-ZBO-2rZTdlDbVkeQ3_4uI75EUxVMmanVzDuuDNsao,9564
 pymscada/opnotes.py,sha256=MKM51IrB93B2-kgoTzlpOLpaMYs-7rPQHWmRLME-hQQ,7952
 pymscada/periodic.py,sha256=MLlL93VLvFqBBgjO1Us1t0aLHTZ5BFdW0B__G02T1nQ,1235
 pymscada/protocol_constants.py,sha256=lPJ4JEgFJ_puJjTym83EJIOw3UTUFbuFMwg3ohyUAGY,2414
@@ -23,6 +24,7 @@ pymscada/demo/__init__.py,sha256=WsDDgkWnZBJbt2-cJCdc2NvRAv_T4a7WOC1Q0k_l0gI,29
 pymscada/demo/accuweather.yaml,sha256=Fk4rV0S8jCau0173QCzKW8TdUbc4crYVi0aD8fPLNgU,322
 pymscada/demo/alarms.yaml,sha256=Ea8tLZ0aEiyKM_m5MN1TF6xS-lI5ReXiz2oUPO8GvmQ,110
 pymscada/demo/bus.yaml,sha256=zde5JDo2Yv5s7NvJ569gAEoTDvsvgBwRPxfrYhsxj3w,26
+pymscada/demo/callout.yaml,sha256=ze2UfAymU05lzVp-t8wSa9hYJMGSkhT4FwL4rVJQG4o,270
 pymscada/demo/files.yaml,sha256=XWtmGDJxtD4qdl2h7miUfJYkDKsvwNTgQjlGpR6LQNs,163
 pymscada/demo/history.yaml,sha256=c0OuYe8LbTeZqJGU2WKGgTEkOA0IYAjO3e046ddQB8E,55
 pymscada/demo/logixclient.yaml,sha256=G_NlJhBYwT1a9ceHDgO6fCNKFmBM2pVO_t9Xa1NqlRY,912
@@ -43,11 +45,12 @@ pymscada/demo/pymscada-io-modbusserver.service,sha256=g7Rzm6zGLq_qvTJRL_pcLl4Ps7
 pymscada/demo/pymscada-io-openweather.service,sha256=SQnZ-cq1V3qvZY7EgR_Vx36vCOw1ipfGoLoutHsxtNk,359
 pymscada/demo/pymscada-io-ping.service,sha256=Fm8qR4IVq0NupEvHLGONXGwjjQsx5VqaBYPewhg7-k4,329
 pymscada/demo/pymscada-io-snmpclient.service,sha256=Rsm8uiwnoGx-1MkXqYgtj4UP9-r7AEEeB9yoR0y0oVA,343
+pymscada/demo/pymscada-io-witsapi.service,sha256=ZjNwUnZg7WZsCaBFk8aNibnCbwqtbhl1i9D8tdUGXiQ,343
 pymscada/demo/pymscada-opnotes.service,sha256=TlrTRgP3rzrlXT8isAGT_Wy38ScDjT1VvnlgW84XiS8,354
 pymscada/demo/pymscada-wwwserver.service,sha256=7Qy2wsMmFEsQn-b5mgAcsrAQZgXynkv8SpHD6hLvRGc,370
 pymscada/demo/snmpclient.yaml,sha256=z8iACrFvMftYUtqGrRjPZYZTpn7aOXI-Kp675NAM8cU,2013
-pymscada/demo/tags.yaml,sha256=9xydsQriKT0lNAW533rz-FMVgoedn6Lwc50AnNig7-k,2733
-pymscada/demo/wits.yaml,sha256=B8F136jvLIYU8t-pOdsEU_j97qMo3RgGQ1Rs4ExhmeE,289
+pymscada/demo/tags.yaml,sha256=1HH9SqevBE0P0NXHK0Slfu68gwx5iKpgyirClmAcXGY,2814
+pymscada/demo/witsapi.yaml,sha256=B8F136jvLIYU8t-pOdsEU_j97qMo3RgGQ1Rs4ExhmeE,289
 pymscada/demo/wwwserver.yaml,sha256=mmwvSLUXUDCIPaHeCJdCETAp9Cc4wb5CuK_aGv01KWk,2759
 pymscada/demo/__pycache__/__init__.cpython-311.pyc,sha256=tpxZoW429YA-2mbwzOlhBmbSTcbvTJqgKCfDRMrhEJE,195
 pymscada/iodrivers/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
@@ -70,9 +73,9 @@ pymscada/pdf/two.pdf,sha256=TAuW5yLU1_wfmTH_I5ezHwY0pxhCVuZh3ixu0kwmJwE,1516
 pymscada/pdf/__pycache__/__init__.cpython-311.pyc,sha256=4KTfXrV9bGDbTIEv-zgIj_LvzLbVTj77lEC1wzMh9e0,194
 pymscada/tools/snmp_client2.py,sha256=pdn5dYyEv4q-ubA0zQ8X-3tQDYxGC7f7Xexa7QPaL40,1675
 pymscada/tools/walk.py,sha256=OgpprUbKLhEWMvJGfU1ckUt_PFEpwZVOD8HucCgzmOc,1625
-pymscada-0.2.0rc6.dist-info/licenses/LICENSE,sha256=OXLcl0T2SZ8Pmy2_dmlvKuetivmyPd5m1q-Gyd-zaYY,35149
-pymscada-0.2.0rc6.dist-info/METADATA,sha256=QdAhMpE2X7HmhVO0H6XvXjnjQO7JZka7zlWoXKle2vg,2393
-pymscada-0.2.0rc6.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
-pymscada-0.2.0rc6.dist-info/entry_points.txt,sha256=2UJBi8jrqujnerrcXcq4F8GHJYVDt26sacXl94t3sd8,56
-pymscada-0.2.0rc6.dist-info/top_level.txt,sha256=LxIB-zrtgObJg0fgdGZXBkmNKLDYHfaH1Hw2YP2ZMms,9
-pymscada-0.2.0rc6.dist-info/RECORD,,
+pymscada-0.2.0rc8.dist-info/licenses/LICENSE,sha256=OXLcl0T2SZ8Pmy2_dmlvKuetivmyPd5m1q-Gyd-zaYY,35149
+pymscada-0.2.0rc8.dist-info/METADATA,sha256=vL-9rZ1w6VfZfJe6AHLdxIzQmu5ncN9q10k-GE1DfVE,2393
+pymscada-0.2.0rc8.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+pymscada-0.2.0rc8.dist-info/entry_points.txt,sha256=2UJBi8jrqujnerrcXcq4F8GHJYVDt26sacXl94t3sd8,56
+pymscada-0.2.0rc8.dist-info/top_level.txt,sha256=LxIB-zrtgObJg0fgdGZXBkmNKLDYHfaH1Hw2YP2ZMms,9
+pymscada-0.2.0rc8.dist-info/RECORD,,