"""LAN reachability verification for the IEC 60870-5-104 simulator listener. Run after a simulator bind-address change (or before a LAN bench session) to confirm the listener is bound to 0.0.0.0 and answers STARTDT on local IPv4 addresses. It starts the local lvgl_sim binary in headless IEC104 duration mode. Prerequisites: simulator/build/Debug/lvgl_sim.exe exists with the IEC104 CLI contract, Get-NetTCPConnection is available, and local IPv4 is configured. A missing binary, wrong bind address, bad STARTDT reply or simulator exits nonzero returns 1; a PowerShell/tooling error returns 2. This checks the same host only: it does not prove another LAN device can pass through a firewall. """ import argparse import hashlib import json import pathlib import re import socket import subprocess import sys import time def parser(): p = argparse.ArgumentParser(description=__doc__.splitlines()[0]) p.add_argument("--exe", type=pathlib.Path, default=pathlib.Path(__file__).resolve().parents[2] / "simulator/build/Debug/lvgl_sim.exe", help="lvgl_sim executable to start") p.add_argument("--output", type=pathlib.Path, default=pathlib.Path(__file__).resolve().parents[2] / "ci-artifacts/iec104-lan", help="directory for report.json") p.add_argument("--duration", type=int, default=12, help="simulator lifetime in seconds") p.add_argument("--lan-ip", default=None, help="extra local IPv4 address to probe; auto-detected when present") return p def powershell(code): r = subprocess.run(["powershell.exe", "-NoProfile", "-Command", code], capture_output=True, text=True, timeout=15) assert r.returncode == 0, (r.returncode, r.stdout, r.stderr) return r.stdout.strip() def main(): args = parser().parse_args() exe = args.exe.resolve() out = args.output.resolve() if not exe.is_file(): print("MISSING exe: %s" % exe) return 2 out.mkdir(parents=True, exist_ok=True) try: ips = json.loads(powershell( "ConvertTo-Json -Compress -InputObject @(Get-NetIPAddress " "-AddressFamily IPv4 | Select-Object -ExpandProperty IPAddress)")) if args.lan_ip: ips.append(args.lan_ip) process = subprocess.Popen( [str(exe), "--iec104", "--iec104-headless", "--iec104-port", "0", "--iec104-duration", str(args.duration)], stdout=subprocess.PIPE, stderr=subprocess.PIPE, text=True) try: ready = process.stdout.readline().strip() match = re.search(r"port=(\d+)", ready) assert match, ready port = int(match.group(1)) listeners = json.loads(powershell( "ConvertTo-Json -Compress -InputObject @(Get-NetTCPConnection " "-State Listen -LocalPort %d | Select-Object LocalAddress,LocalPort,OwningProcess)" % port)) assert any(x["LocalAddress"] == "0.0.0.0" and x["OwningProcess"] == process.pid for x in listeners), listeners results = [] targets = ["127.0.0.1"] + ([args.lan_ip] if args.lan_ip else []) for host in targets: time.sleep(0.25) with socket.create_connection((host, port), timeout=3) as sock: sock.settimeout(3) sock.sendall(bytes.fromhex("680407000000")) data = b"" while len(data) < 6: data += sock.recv(6 - len(data)) assert data == bytes.fromhex("68040b000000"), data.hex() results.append({"target": host, "sent": "680407000000", "received": data.hex(), "scope": "same-host only"}) stdout, stderr = process.communicate(timeout=args.duration + 10) assert process.returncode == 0, (process.returncode, stderr) leftovers = json.loads(powershell( "ConvertTo-Json -Compress -InputObject @(Get-NetTCPConnection -State Listen " "-LocalPort %d -ErrorAction SilentlyContinue | Where-Object OwningProcess -eq %d)" % (port, process.pid))) assert not leftovers, leftovers report = {"exe": str(exe), "sha256": hashlib.sha256(exe.read_bytes()).hexdigest(), "pid": process.pid, "ready": ready, "local_ipv4": ips, "listeners": listeners, "handshakes": results, "exit_code": process.returncode, "stdout": stdout, "stderr": stderr, "remote_firewall_verified": False, "listener_after_exit": False} (out / "report.json").write_text(json.dumps(report, indent=2), encoding="utf-8") print(json.dumps(report, indent=2)) return 0 finally: if process.poll() is None: process.terminate() process.communicate(timeout=5) except (OSError, subprocess.SubprocessError, ValueError, AssertionError) as exc: print("FAIL: %s" % type(exc).__name__) print(str(exc)[:1000]) return 1 if __name__ == "__main__": raise SystemExit(main())