samples: monitoring: add Application Monitor sample

Signed-off-by: David Escalona <david.escalona@digi.com>

Author: daescalona

samples/monitoring/AppMonitor/README.md

@@ -0,0 +1,56 @@
+Application Monitor Sample Application
+======================================
+
+This sample Python application shows how to use the application monitor daemon
+API.
+
+The sample registers the application in the application monitor daemon and
+starts refreshing it. After 5 loops, the application stops refreshing and waits
+to be killed by the application monitor daemon.
+
+Requirements
+------------
+To run this example you will need:
+
+* An XBee Gateway device.
+
+Setup
+-----
+No special setup is required.
+
+Run
+---
+1. The example is already configured, so all you need to do is to build and run
+   the project in the XBee Gateway.
+
+2. Upon start, the application registers to the application monitor daemon and 
+   starts refreshing it.
+
+3. After 5 refresh loops, the application stops refreshing and waits to be
+   killed by the application monitor daemon.
+
+Supported platforms
+-------------------
+* IX15
+
+License
+-------
+Copyright (c) 2022, Digi International, Inc.
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

samples/monitoring/AppMonitor/main.py

@@ -0,0 +1,47 @@
+# Copyright 2022, Digi International Inc.
+#
+# Permission to use, copy, modify, and/or distribute this software for any
+# purpose with or without fee is hereby granted, provided that the above
+# copyright notice and this permission notice appear in all copies.
+#
+# THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
+# WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
+# MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
+# ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
+# WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
+# ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
+# OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
+
+from digidevice import appmonitor
+from digidevice.appmonitor import AppMonitorAction, AppMonitorError
+
+import sys
+import time
+
+APP_TIMEOUT = 5000
+
+
+def main():
+    print(" +----------------------------+")
+    print(" | Application Monitor Sample |")
+    print(" +----------------------------+\n")
+
+    try:
+        print("Registering application...")
+        mon_handle = appmonitor.register_app(APP_TIMEOUT, AppMonitorAction.KILL)
+        print("Registration succeed:\n  - Timeout: %s\n  - Action: %s\n  "
+              "- Restart command: '%s'\n" % (mon_handle.timeout, mon_handle.action.name,
+                                             mon_handle.restart_command))
+        for loop in range(1, 6):
+            print("Refreshing application... %s" % loop)
+            mon_handle.refresh()
+            time.sleep(0.5 * APP_TIMEOUT / 1000)
+        print("\nStopped refreshing! Application should be killed in a while...")
+        time.sleep(sys.maxsize)
+    except AppMonitorError as exc:
+        print(str(exc))
+        sys.exit(1)
+
+
+if __name__ == '__main__':
+    main()