Add GOOSE / SampledValues Client (Publisher and Observer)

---

+ add disclaimer to documentation

Examples:
+ Update mms_utility to display timestamp values

proto.mms.data:
+ Add UTCTime conversion

proto.iec61850:
+ Add GOOSE and SampledValues cliant that is able to receive and publish messages

Author: MatrixEditor

README.md

@@ -41,7 +41,23 @@ too).
 pip install git+https://github.com/MatrixEditor/icspacket
 ```
 
+## Disclaimer
 
+This project is shared openly to help the community explore, learn, and advance
+research on industrial control systems, networking protocols, and related
+technologies. Our goal is to provide a resource that encourages experimentation,
+collaboration, and education.
+
+The material in this repository is **for research and learning only**. It is not
+intended for direct use in production systems or commercial deployments,
+especially within live industrial environments where safety and reliability are
+critical.
+
+If you decide to build on this work, we encourage you to adopt secure coding
+practices, apply a structured security development process, and consider how
+you’ll generate and track indicators of compromise in line with your specific
+goals. Together, we can strengthen the security and resilience of ICS
+technologies while keeping experimentation safe and responsible.
 
 ## License
 

src/icspacket/examples/mms_utility.py

@@ -22,6 +22,7 @@
 #   - Variables: read, write, query info
 #   - Domain: list, and list variables
 #   - identify
+import datetime
 import pathlib
 import shlex
 import sys
@@ -43,6 +44,7 @@
 from icspacket.proto.mms.connection import MMS_Connection
 from icspacket.proto.mms.exceptions import MMSConnectionError
 from icspacket.proto.mms.data import (
+    Timestamp,
     get_floating_point_value,
     create_floating_point_value,
 )
@@ -74,6 +76,10 @@ def data_to_str(data: Data) -> str | dict | list:
             return "[green]TRUE[/]" if data.boolean else "FALSE"
         case Data.PRESENT.PR_array:
             return [data_to_str(item) for item in data.array]
+        case Data.PRESENT.PR_utc_time:
+            ts = Timestamp.from_utc_time(data.utc_time)
+            dt = datetime.datetime.fromtimestamp(ts.seconds)
+            return dt.strftime("%Y-%m-%d %H:%M:%S")
         case Data.PRESENT.PR_structure:
             return {
                 item.present.name[3:].lower(): data_to_str(item)
@@ -299,9 +305,16 @@ def do_variable_list(args, conn: MMS_Connection):
             list_name_safe = object_name_to_string(variable_list_name).replace("$", ".")
             logging.debug("Reading %s from peer...", list_name_safe)
             with args.console.status("Awaiting access results..."):
-                results = conn.read_variables(list_name=variable_list_name, spec_in_result=True)
+                results = conn.read_variables(
+                    list_name=variable_list_name, spec_in_result=True
+                )
 
-            table = Table(title=list_name_safe, safe_box=True, expand=False, box=box.ASCII_DOUBLE_HEAD)
+            table = Table(
+                title=list_name_safe,
+                safe_box=True,
+                expand=False,
+                box=box.ASCII_DOUBLE_HEAD,
+            )
             table.add_column("Variable", justify="left")
             table.add_column("Value", justify="left")
             for object_name, result in zip(targets, results):
@@ -323,6 +336,7 @@ def do_variable_list(args, conn: MMS_Connection):
 
             args.console.print(table)
 
+
 def cli_main():
     import argparse
 

src/icspacket/proto/iec61850/_iec61850.pyi

@@ -444,6 +444,81 @@ class IECGoosePdu(_Asn1Type): # SEQUENCE
 class UtcTime(_Asn1BasicType[bytes]):
 	pass
 
+class IEC61850_9_2_Specific_Protocol(_Asn1Type): # CHOICE
+	class PRESENT(EXT_IntEnum):
+		PR_NOTHING = 0
+		PR_savPdu = 1
+
+	@property
+	def present(self) -> PRESENT: ...
+	savPdu: SavPdu | None
+	def __init__(
+		self, /, *,
+		savPdu: SavPdu = ...,
+	) -> None: ...
+
+class SavPdu(_Asn1Type): # SEQUENCE
+
+	class seqASDU_TYPE(_Asn1Type):
+		def __init__(self, values: EXT_Iterable[ASDU] | None = ...) -> None: ...
+		def __getitem__(self, index: int) -> ASDU: ...
+		def __setitem__(self, index: int, value: ASDU) -> None: ...
+		def add(self, value: ASDU) -> None: ...
+		def extend(self, values: EXT_Iterable[ASDU]) -> None: ...
+		def clear(self) -> None: ...
+		def __len__(self) -> int: ...
+		def __delitem__(self, index: int) -> None: ...
+
+	seqASDU: seqASDU_TYPE
+	noASDU: int
+	security: bytes | None
+	def __init__(
+		self, /, *,
+		noASDU: int = ...,
+		security: bytes = ...,
+		seqASDU: seqASDU_TYPE = ...,
+	) -> None: ...
+
+class ASDU(_Asn1Type): # SEQUENCE
+	svID: str
+	datSet: str | None
+	smpCnt: int
+	confRev: int
+	@property
+	def refrTm(self) -> UtcTime | None: ...
+	@refrTm.setter
+	def refrTm(self, value: UtcTime | bytes | None) -> None: ...
+
+	class smpSynch_VALUES(EXT_IntEnum):
+		V_none = 0
+		V_local = 1
+		V_global = 2
+
+	smpSynch: smpSynch_VALUES | None
+	smpRate: int | None
+	seqData: bytes
+
+	class smpMod_VALUES(EXT_IntEnum):
+		V_samplesPerNormalPeriod = 0
+		V_samplesPerSecond = 1
+		V_secondsPerSample = 2
+
+	smpMod: smpMod_VALUES | None
+	gmidData: bytes | None
+	def __init__(
+		self, /, *,
+		svID: str = ...,
+		datSet: str = ...,
+		smpCnt: int = ...,
+		confRev: int = ...,
+		refrTm: UtcTime = ...,
+		smpSynch: smpSynch_VALUES = ...,
+		smpRate: int = ...,
+		seqData: bytes = ...,
+		smpMod: smpMod_VALUES = ...,
+		gmidData: bytes = ...,
+	) -> None: ...
+
 class EXTERNAL(_Asn1Type): # SEQUENCE
 
 	class encoding_TYPE(_Asn1Type): # CHOICE