Phase 2 Plan: Workshop Preparation (Weeks 11-12)
Scope
- Workshop preparation buffer (15 Jun - 28 Jun)
- Produce and validate 5 interoperability artifacts as hex dumps
- Rehearse live exchange and decode workflows
Objectives
- Ensure workshop-ready interoperability baseline
- Detect wire-format incompatibilities before Phase 3 complexity
- Build confidence in repeatable artifact generation/consumption
Why This Phase Exists
- This phase de-risks interoperability before Phase 3 introduces state-machine and session-control complexity.
- Workshop artifact discipline forces byte-level precision, which directly improves conformance outcomes.
- Rehearsal converts interoperability from a one-time event into a repeatable engineering capability.
Artifact Production Plan
- Type F1 PLCW
- Report Value 127, Retransmit false, PCID 0, Expedited Counter 3
- Type F2 PLCW
- Report Value 500, Retransmit true, PCID 1, Expedited Counter 6
- Variable-length SPDU
- Type 1 Directive, SET V(R), SEQ_CTRL_FSN 42
- P-frame Version-3
- Contains artifact #1, Expedited QoS
- U-frame Version-3
- 10-byte payload 0x00-0x09, Sequence Controlled QoS, seq 7
Rationale for this artifact set:
- F1/F2 PLCWs validate both report classes and control signaling behavior.
- Directive SPDU with SET V(R) validates resynchronization-critical control semantics.
- P-frame and U-frame artifacts validate encapsulation and standalone frame behavior under expected QoS modes.
Role Assignment
- Engineer A
- Verifies bit-level compliance of each artifact
- Signs off section-trace references
- Engineer B
- Defines artifact verification scripts and expected decode outcomes
- Engineer C
- Owns live exchange choreography and partner-team handoff procedure
- Owns incident checklist for workshop-day troubleshooting
- Developer A
- Implements deterministic artifact generator CLI
- Developer B
- Implements parser/checker CLI and exchange harness
- Developer C
- Implements automated artifact diffing, metadata validation, and replay tooling
Execution Steps
Step 1: Deterministic Generation
- Freeze serialization options and endian assumptions
- Generate artifacts from known seed inputs
- Export canonical hex files with metadata
Why this step matters:
- Canonical generation ensures every team member and external partner can reproduce identical byte streams.
Step 2: Independent Decode Verification
- Run decode on a separate tool path (avoid same-code false confidence)
- Validate fields against expected values
- Capture mismatch reports if any
Why this step matters:
- Independent decode avoids self-validation bias where generator and parser share the same hidden bug.
Step 3: Exchange Drill
- Simulate partner-team exchange loop locally
- Execute send -> receive -> decode -> compare cycle
- Record turnaround time and failure cases
Why this step matters:
- Simulated exchange exposes framing, transport, and operational issues that unit tests alone cannot reveal.
Step 4: Live Demo Rehearsal
- Timebox demo script to 15 minutes
- Include malformed frame example and graceful handling
- Produce one-page runbook for workshop operators
Why this step matters:
- Operator readiness prevents avoidable execution errors during high-pressure live interoperability sessions.
Deliverables
- 5 artifact hex dumps with metadata
- Artifact generator/validator tools
- Interoperability rehearsal report
- Workshop runbook
Acceptance Criteria
- Every artifact decodes byte-accurately to expected field values
- Generation and parsing are reproducible on clean environment
- Team can execute exchange demo without ad-hoc fixes
Why these criteria:
- They validate both technical correctness (byte-accurate decode) and operational reliability (repeatable execution).
Risks and Mitigations
- Risk: hidden parser/generator coupling bugs
- Mitigation: independent validation path and randomized negative tests
- Risk: workshop day operational confusion
- Mitigation: operator runbook and role-based live checklist
⬆️ Back to Top ⬆️