Free & open source • IEC-103 master testing • relay evidence
IEC-103 master testing with readable relay evidence.
ArIEC103 is a free, open-source Windows desktop tool for protection relay communication checks. It actively connects to one IEC 60870-5-103 slave, runs a controlled relay test session, decodes relay responses, and keeps raw TX/RX evidence available for engineering review.
Free Apache-2.0
No license key
Active IEC-103 master
Single connection baseline
Relay timestamp SOE
User mapping profiles
Raw frame transparency
Reset FCB
General Interrogation
Bounded Class 1 drain
Relay timestamp event log
Value Viewer snapshot
Frame Trace evidence
User mapping import
Export selected evidence
Reset FCB
General Interrogation
Bounded Class 1 drain
Relay timestamp event log
Value Viewer snapshot
Frame Trace evidence
User mapping import
Export selected evidence
Why try it
Free, focused, and transparent enough for serious relay troubleshooting.
ArIEC103 is made for users who need a practical IEC-103 master tester without license friction. Download the portable package, connect to a relay or simulator, inspect readable evidence, and keep raw protocol detail available for escalation.
Core value
Built for relay engineers who need proof, not just a byte stream.
The main workflow starts with active master communication and ends with operator-readable evidence. Raw hex remains visible, but the primary screens explain what happened and what action the engineer should take.
Active master first
Open serial transport, reset link state, run GI, poll Class 2, and drain Class 1 only when the relay advertises pending events.
Operator evidence
Readable activity rows, values, event log entries, diagnostics, findings, and session history keep test work understandable.
User-owned mapping
Signal names and groups come from mapping files owned by the project. Unmapped points stay visible as raw FUN/INF.
Protocol transparency
Frame Trace preserves FT1.2 control, ASDU, COT, FUN, INF, value, timestamp, checksum, and raw frame evidence.
Application screens
A calm engineering cockpit for live IEC-103 observation.
Review the main workflow screens: connection setup, live operator evidence, relay values, event logs, diagnostics, and export-ready test records.
Operator Evidence
Meaning-first session rows for startup, GI, polling, event-drain, relay values, warnings, and faults.
Setup Overlay
Connection and polling parameters stay in a focused overlay so the cockpit remains a monitoring surface.
Value & Event Review
Decoded relay values and timestamped event rows give the user a cleaner review layer than a raw byte stream.
Protocol Visibility
Frame-level evidence stays available for engineering escalation, checksum review, mapping checks, and troubleshooting notes.
Polling policy
Controlled master behavior without noisy Class 1 bombardment.
ArIEC103 treats Class 2 as the normal background cycle. Class 1 is event-drain only: entered after ACD=1 or bounded GI follow-up, stopped when the relay returns no data, clears ACD, reaches GI end, reports DFC busy, hits configured drain limits, or times out safely.
StartupOpen transport, optional reset remote link, reset FCB, optional clock sync, optional GI.
Normal loopPoll Class 2 at the configured interval and keep visible UI buffers bounded.
Event drainRequest Class 1 only while pending event evidence is advertised or GI follow-up remains active.
ShutdownHold FCB on timeout/invalid response, then close cleanly when the user stops the session.
Evidence model
Readable first, raw evidence always available.
The app separates operator-facing evidence from expert protocol inspection. Event Log time comes from the relay ASDU timestamp when present. PC arrival time is forensic metadata only.
Value Viewer
Current relay snapshot updated in place, ordered for digital/status/protection points first.
Relay Event Log
SOE-style rows for state change, edge, and spontaneous events using relay timestamp basis.
Frame Trace
TX/RX transaction tracking with raw frame and protocol-aware selected-frame interpretation.
Diagnostics
Recoverable runtime exceptions become selectable diagnostic rows with recommendation detail.
Mapping profiles
User/project JSON profiles provide signal names. Built-in code decodes protocol fields only.
Export
Selected evidence grids export as tab-separated text suitable for review and escalation.
How to use
Start from setup, then read the evidence layer by layer.
The workflow is designed for engineers at a test bench: download the Windows portable package, configure the serial link, start the master session, check communication health, review decoded values/events, then export evidence when the result is clear.
1. DownloadGet the Windows portable ZIP from GitHub Releases and start the app using Start-ArIEC103.bat.
2. ConfigureSelect COM port, baudrate, link address, common address, timeout, GI, and optional mapping profile.
3. Start & verifyWatch Operator Evidence, Value Viewer, Relay Event Log, Frame Trace, and Diagnostics.
4. ExportExport Markdown or selected grid evidence for FAT/SAT records, troubleshooting notes, or handover.
Download package
Free portable Windows ZIP for test-bench evaluation.
Download the latest free open-source package from GitHub Releases, extract it, run Start-ArIEC103.bat, configure the relay serial settings, then start a focused IEC-103 master session. The package includes the desktop app, CLI tools, samples, quick-start notes, troubleshooting notes, and license files.
Portable ZIPDesktop app and CLI tools are packaged together for Windows users.
Start scriptRun Start-ArIEC103.bat after extracting the release package.
ChecksumSHA256SUMS.txt is provided so downloaded assets can be verified.
Quick startStep-by-step setup guide for the first relay communication check.
Test vectorsSanitized IEC-103 frames are included for parser and decoder smoke checks.
TroubleshootingPractical checks for no response, checksum errors, malformed frames, GI issues, and mapping gaps.
User benefits
Less time reading raw logs, more time proving relay behavior.
ArIEC103 helps protection and SCADA engineers run repeatable IEC-103 checks, explain each transaction, keep the relay timestamp basis visible, and export evidence that can be reviewed after the test session.
Practical advantages
Connect to one relay and keep the workflow focused on the active master session.
Use operator-readable evidence first, with raw frames still available for escalation.
Keep mapping profiles project-owned so signal names match the user's relay list.
Export selected evidence grids and Markdown evidence for reports, review, and handover.
FAQ
Questions before downloading ArIEC103.
These answers help new users understand what the tool does, what it does not claim, and how to start a safe IEC-103 relay communication check.
Is ArIEC103 free?
Yes. ArIEC103 is free and open source under Apache-2.0. There is no license key, account requirement, or subscription for trying the release package.
What is ArIEC103 used for?
ArIEC103 runs an active IEC 60870-5-103 master session against one relay, then shows decoded values, relay events, diagnostics, and raw TX/RX frame evidence.
Who should use it?
It is intended for protection, SCADA, commissioning, and panel/FAT engineers who need a focused IEC-103 communication check and evidence trail.
Does it require a vendor-specific relay database?
No. ArIEC103 decodes protocol fields and can load user-owned JSON mapping profiles so displayed signal names follow the project relay list.
Can it export FAT/SAT evidence?
Yes. It provides operator-readable evidence, frame trace transparency, diagnostics, and report output that can be reviewed after the test session.
Windows release
Download free, connect, and start a focused IEC-103 test session.
Use the free open-source Windows portable package for a test bench, then configure the relay connection, run the master session, inspect values and events, and export the evidence your team needs.