Bump to version 0.2.4

---

+ Update documentation for iedctrl.py

Author: MatrixEditor

docs/source/changelog.rst

@@ -4,6 +4,18 @@
 Changelog
 =========
 
+
+.. _v0.2.4:
+
+v0.2.4 :bdg-info:`beta-develop`
+----------------------------------
+
+**Added**
+
+- Example to control IEDs: ``iedctrl.py``
+- Add ``put`` command to ``mmsclient.py`` to transfer files to a MMS remote server
+- Add implementation to control IEDs
+
 .. _v0.2.3:
 
 v0.2.3 :bdg-info:`beta-develop`

docs/source/protocols/iec61850/_images/iedctrl-opertoggle.png

@@ -20,25 +20,11 @@ Examples
 
 Operate a control object with a specific value:
 
-.. code-block::
-
-    iedctrl.py -t 'simpleIOGenericIO/GGIO1.SPCSO3' --value true --check 127.0.0.1
-    [I] Associating MMS environment with peer 127.0.0.1:102...
-    [I] Control model for node: DIRECT_ENHANCED
-    [I] Value will be changed to: True
-    [I] Successfully completed operation on SPCSO3!
-    Current value: TRUE
+.. image:: _images/iedctrl-operw.png
 
 Toggle a boolean control object:
 
-.. code-block::
-
-    iedctrl.py -t 'simpleIOGenericIO/GGIO1.SPCSO4' --toggle --check 127.0.0.1
-    [I] Associating MMS environment with peer 127.0.0.1:102...
-    [I] Control model for node: SBO_ENHANCED
-    [I] Value will be changed from FALSE -> TRUE
-    [I] Successfully completed operation on SPCSO4!
-    Current value: TRUE
+.. image:: _images/iedctrl-opertoggle.png
 
 Notes
 -----

docs/source/protocols/iec61850/_images/iedctrl-operw.png

@@ -35,6 +35,25 @@ You will be dropped into an interactive shell similar to this:
         mmsclient.py <host> ls
 
 
+.. tip::
+
+    To view the help message for each implemented command, use ``--help``
+    together with the command:
+
+    .. code-block:: bash
+
+        mmsclient.py --help ls
+        Usage: ls [-h] [-l] [-a] [directory]
+
+        positional arguments:
+        directory   Remote directory to list (defaults to current remote directory)
+
+        optional arguments:
+        -h, --help  show this help message and exit
+        -l          Print output as a list (table) instead of filenames only
+        -a, --all   List all files, including ones in subdirectories
+
+
 Listing Files (``ls``)
 ----------------------
 
@@ -100,6 +119,19 @@ Arguments:
 .. image:: _images/mms-file-get.png
 
 
+Uploading Files (``put``)
+---------------------------
+
+The :code:`put` command transfers a local file to the remote MMS peer.
+
+Arguments:
+
+- ``local_name`` :octicon:`arrow-right` The local file name to transfer.
+- ``remote_name`` :octicon:`arrow-right` The file name on the remote MMS peer (optional).
+
+.. image:: _images/mms-file-put.png
+
+
 Deleting Files (``del``)
 ------------------------
 

docs/source/protocols/iec61850/iedctrl.rst

@@ -188,12 +188,12 @@ def cli_main():
                 logging.debug("Direct Control Nodel: Writing value...")
                 error = client.operate(co, ctl_val=args.var_value)
                 if error:
-                    logging.error("Failed to start opertation: %s", error.value)
+                    logging.error("Failed to start opertation: %s", repr(error.value))
                     sys.exit(1)
 
             case ControlModel.DIRECT_ENHANCED:
                 if error := client.operate(co, ctl_val=args.var_value):
-                    logging.error("Failed to start opertation: %s", error.value)
+                    logging.error("Failed to start opertation: %s", repr(error.value))
                     sys.exit(1)
 
                 with args.console.status("Waiting for operation to complete..."):
@@ -202,21 +202,21 @@ def cli_main():
             case ControlModel.SBO_NORMAL:
                 logging.debug("Selecting node before operation (SBO)...")
                 if error := client.select(co):
-                    logging.error("Failed to select node: %s", error.value)
+                    logging.error("Failed to select node: %s", repr(error.value))
                     sys.exit(1)
 
                 if error := client.operate(co, ctl_val=args.var_value):
-                    logging.error("Failed to start opertation: %s", error.value)
+                    logging.error("Failed to start opertation: %s", repr(error.value))
                     sys.exit(1)
 
             case ControlModel.SBO_ENHANCED:
                 logging.debug("Selecting node with value before operation (SBOw)...")
                 if error := client.select_with_value(co, ctl_val=args.var_value):
-                    logging.error("Failed to select node: %s", error.value)
+                    logging.error("Failed to select node: %s", repr(error.value))
                     sys.exit(1)
 
                 if error := client.operate(co, ctl_val=args.var_value):
-                    logging.error("Failed to start opertation: %s", error.value)
+                    logging.error("Failed to start opertation: %s", repr(error.value))
                     sys.exit(1)
 
                 with args.console.status("Waiting for operation to complete..."):

docs/source/protocols/mms/_images/mms-file-put.png

@@ -249,7 +249,7 @@ def get_operate_data(
             }
         ]
         if self.has_time_activated_oper:
-            ts = oper_time or Timestamp.from_datetime(datetime.datetime.now())
+            ts = oper_time or bytes(8)
             # operTm = <CO_CtrlObjectRef>$Oper$operTm
             items.append({"utc_time": bytes(ts)})