Real network traffic. Controllable lab scenarios.
A native Windows engineering surface controls an embedded real-time publisher. The sample clock and Ethernet transmission run on the ESP32-P4—not from a Windows application timer.
IEC 61850 Sampled Values
4 current + 4 voltage, 64-byte payload, one ASDU, 4 kHz, sequenced `smpCnt`, configurable waveform magnitudes and phase angles.
PTP Grandmaster simulation
Layer-2 Announce, Sync and hardware-timestamp-derived Follow_Up on an isolated bench. SOURCE retains clock continuity across operator SV STOP / START.
Studio & wire evidence
Windows Qt control, phasor/waveform previews, supervised firmware recovery, USB hotplug detection and independent PCAP capture/reporting.
ARStack StudioWindows setup · USB OTG control
ESP32-P4 EthernetEMAC hardware timestamp + 4 kHz SV grid
PTP · Announce / Sync / Follow_Up
SV · 4I+4V · smpSynch AUTO
Independent PCAP: 44 Announce, 43 Sync and 43 Follow_Up, contiguous sequences. M3.H capture was stopped at 40.763 seconds although Studio was configured to request 120 seconds. Physical relay lock and alarm-free SV acceptance remain untested; this is a laboratory emulator, not a UTC-traceable clock reference.
+ Independent PCAP: 44 Announce, 43 Sync and 43 Follow_Up, contiguous sequences. The M3.H reference capture documents measured SV/PTP traffic and locally qualified synchronization in an isolated laboratory setup. Detailed results and measurement context are available in the release technical record.
- First packet in four steps.
Install StudioUse Windows Setup or Portable; both include the matched firmware and flashing tool.
Flash ESP32-P4Connect USB OTG and install the matching firmware from the release.
Select lab timingUse PTP SOURCE / INTERNAL_GM_ONLY and smpSynch AUTO on an isolated Ethernet LAN.
Start and captureRun 4I+4V, then inspect SV 0x88BA and PTP 0x88F7 in ARSAS, DigSubAnalyzer or Wireshark.
First packet in four steps.
Install StudioUse Windows Setup or Portable; both include the matched firmware and flashing tool.
Flash ESP32-P4Connect USB OTG and install the matching firmware from the release.
Select lab timingUse PTP SOURCE / INTERNAL_GM_ONLY and smpSynch AUTO on an isolated Ethernet LAN.
Start and captureRun 4I+4V, then inspect SV 0x88BA and PTP 0x88F7 in ARSAS, DigSubAnalyzer or Wireshark.
Download the latest release.
Choose the installer, portable application or matched board firmware from the latest stable GitHub release. Downloads update automatically when a new verified release is published.
Windows Installer
Windows x64 · setup and bundled dependencies
Portable ZIP
Windows x64 · run without a separate installation
diff --git a/scripts/check_product_naming.py b/scripts/check_product_naming.py
index bd1506fb4..5c55cbfd8 100644
--- a/scripts/check_product_naming.py
+++ b/scripts/check_product_naming.py
@@ -1,11 +1,13 @@
#!/usr/bin/env python3
-"""Keep public product copy vendor-neutral and prevent legacy competitor naming in code."""
+"""Keep user-facing ARStack copy consistent and vendor-neutral."""
from pathlib import Path
import subprocess
import sys
ROOT = Path(__file__).resolve().parents[1]
-# Split literals so this policy file does not itself introduce indexed brand mentions.
+
+# Keep competitor names out of product copy, without corrupting historical
+# interoperability test fixtures and source-code regression evidence.
PROHIBITED = (
"ied" + "scout",
"omi" + "cron",
@@ -14,23 +16,32 @@
)
PUBLIC_PATHS = (
"README.md",
+ "index.html",
+ "CONTRIBUTING.md",
+ "SUPPORT.md",
+ "docs/GETTING_STARTED.md",
+ "docs/INSTALL.md",
+ "docs/COMMUNITY_TESTING.md",
+ "docs/DEVELOPER_GUIDE.md",
"apps/arstack_studio/README.md",
"apps/ied_simulator/README.md",
- "docs/INSTALL.md",
"docs/releases/PROCESS_BUS_SIMULATOR_M3H_PUBLIC_20261024.md",
)
+
tracked = subprocess.run(
["git", "ls-files", "-z"], cwd=ROOT, capture_output=True, check=True
).stdout.split(b"\0")
violations = []
+tracked_paths = set()
for item in tracked:
if not item:
continue
relative = item.decode("utf-8", errors="surrogateescape")
+ tracked_paths.add(relative)
lower_name = relative.casefold()
if PROHIBITED[0] in lower_name:
violations.append("filename: " + relative)
- if relative not in PUBLIC_PATHS:
+ if relative not in PUBLIC_PATHS and not relative.startswith(".github/ISSUE_TEMPLATE/"):
continue
path = ROOT / relative
if not path.is_file():
@@ -39,6 +50,11 @@
for term in PROHIBITED:
if term in data:
violations.append(f"public copy: {relative} contains restricted term")
+
+for required in ("docs/GETTING_STARTED.md", "docs/COMMUNITY_TESTING.md", "CONTRIBUTING.md", "SUPPORT.md"):
+ if required not in tracked_paths:
+ violations.append("missing public entrypoint: " + required)
+
if violations:
sys.stderr.write("REPOSITORY_NAMING_GUARD_FAIL\n" + "\n".join(violations) + "\n")
raise SystemExit(1)