This roadmap outlines the development path for iolinki, enabling a fully compliant, open-source IO-Link Device Stack (Spec V1.1.5).
Test-Driven from Ground Zero: All development is built on mocks and abstractions. Every component is testable without hardware. Conformance verification runs against a virtual IO-Link Master on each release.
Goal: Minimum slice that can plug into a real IO-Link Master and survive bring-up.
- PHY bring-up essentials:
phy_generic, C/Q control, wake-up detection, SIO/SDCI switching. - DLL robustness: Awaiting Comm + ESTAB_COM + Fallback states, retry logic, error counters.
- Portable timing monitors and reporting for
t_ren,t_cycle,t_dwu; wire response-time evidence has the separate scope below. - On-Request Data (OD): negotiation + status/events content for real parameterization.
- Conformance tests: Wake-up timing path, ESTAB_COM transitions, CRC fallback recovery (36 total tests).
Goal: Establish core protocol logic with complete hardware independence and comprehensive test coverage.
- Directory structure and build system (CMake)
- CI/CD pipeline groundwork (Linting, Doxygen)
- Zephyr module structure definition
- Test framework setup (CMocka)
- PHY Interface Definition: Define
iolink_phy_apistruct for complete hardware decoupling. - Mock PHY Driver:
phy_mockfor unit testing (built FIRST). - Virtual PHY Driver:
phy_virtualfor integration with virtual IO-Link Master. - Generic PHY Template:
phy_genericas reference for real hardware ports. - SIO Mode Support: PHY-level SIO/SDCI mode switching.
- Wake-up Pulse: Device wake-up request handling (80μs pulse detection).
- C/Q Line Control: Pin state management abstraction.
- L+ Voltage Monitoring: Power supply monitoring (18-30V).
- Short Circuit Detection: Pin protection and current limiting.
- Baudrate Switching Protocol: Full handshake sequence for baudrate changes.
- State Machine: Implement "Startup" and "Pre-operate" transitions.
- Unit tests using
phy_mockfor each state transition. - Awaiting Communication State: Pre-startup state.
- ESTAB_COM State: Communication establishment handshake.
- Fallback State: Error recovery state.
- State Transition Validation: Guards for illegal transitions.
- Unit tests using
- M-Sequence Handling:
- M-Type 0 framing (OD payload implemented) with mock testing.
- M-Type 1_1 (Process Data, 8-bit OD).
- M-Type 1_2 (Process Data, 8-bit OD with ISDU).
- M-Type 1_V (Process Data, variable PD, 8-bit OD).
- M-Type 2_1 (Process Data, 16-bit OD).
- M-Type 2_2 (Process Data, 16-bit OD with ISDU).
- M-Type 2_V (Process Data, variable PD, 16-bit OD).
- On-Request Data (OD):
- OD length negotiation (8/16/32 bits).
- OD content definition (status, events).
- OD consistency mechanism.
- Timing Control:
- Abstract timer interface for portable DLL timing observations (receive/dequeue timestamps).
- Mock timer for deterministic unit testing.
- Checksum calculation and verification (V1.1 CRC).
- CRC Frame: 6-bit CRC for M-sequence Type 2_x.
- Legacy
t_rensend-completion watchdog and counters; this is not wiret_A. -
t_cyclevalidation between valid OPERATE request starts. - Physical-target qualification of inter-byte (
t_byte) and bit timing (t_bit). -
t_dwu: Wake-up delay (80μs). -
t_pd: Power-on delay.
- Frame Retry Logic: Automatic retransmission on CRC errors.
- Frame Synchronization: Bit-level synchronization.
- Error Counters: Track CRC, timeout, framing errors.
- Communication Quality Metrics: Link quality and error rate tracking.
IO-Link t_A is the gap at C/Q from the end of the last master stop bit to the
first device start bit. The requirement is 1 T_BIT <= t_A <= 10 T_BIT
(Interface Specification V1.1.4, A.3.5).
At COM3 (230.4 kbit/s), this is 4.340–43.403 us. The previous 230 us roadmap
claim was incorrect for COM3 t_A.
The STM32G0 reference separately implements a baud-derived response-start floor
from the last RX interrupt observation and a configurable EN-to-first-TDR guard
(6 us by default). The floor protects the minimum response delay; the guard
allows PHY enable time. The TIOL112 switching characteristics
give 4 us as a typical enable time, so the 6 us guard is an engineering
assumption pending hardware validation. Neither mechanism
guarantees the maximum t_A under arbitrary application or interrupt load.
The native LabWired oracle checks both bounds at modeled C/Q on every reply,
including startup; portable DLL dequeue timestamps cannot replace that check.
The legacy response_time_us/t_ren metric ends when phy->send returns. In the
G0 adapter that is UART TC, after the entire reply, so its completion threshold
must not be interpreted as a first-start-bit deadline. The protocol rig uses a
separate 20 ms completion limit. Manual builds default timing enforcement to 0;
the CI protocol artifact and recorded images below explicitly use
IOLINK_RIG_TIMING_ENFORCE=1.
Recorded native runs use STM32G0B1RE at a fixed 64 MHz operating point, TIOL112, and TYPE_2_V with PDout1/PDin32/OD1:
| Image / mode | OPERATE replies checked | Recorded cyclic C/Q t_A |
|---|---|---|
| GCC/newlib, COM3 | 4 READ + 4 WRITE + 8 application-cadence replies | 29.738203–39.816328 us |
| Clang/LLD, COM3 | 100 READ + 100 WRITE + 8 application-cadence replies | 28.003828–41.300703 us |
| Clang/LLD, COM2 | 100 READ + 100 WRITE + 8 application-cadence replies | 29.132299–31.679174 us |
The source and exact ELF identities in PR49
keep the GCC source 807f9ced separate from the Clang source 10e8196e and their
different run lengths. These are model results with configured PHY delays,
ideal MCU VDD and uncalibrated silicon/Flash wait-state execution costs.
GCC COM2, IAR 9.70, physical-master interoperability and hardware worst-case
timing remain unverified. A source merge does not change those evidence limits.
- Virtual IO-Link Master: Python-based virtual Master with pty UART.
- Integration Test Suite: Full-stack lifecycle testing (
test_integration_full.c). - Reference Stack Demo: Host-based executable demonstrating protocol without any hardware.
- Python Virtual Master: Phase 1 complete (M-sequence Type 0, CRC, UART).
- Docker Test Suite: Virtual Master integrated into automated tests.
Goal: Achieve full compliance with IO-Link Interface Specification V1.1.5.
- Process Data (PD): API for application to update/read cyclic data.
- Variable PD Length: Support 1-32 byte PD via configuration.
- PD Consistency: Toggle bit mechanism.
- PD Validity: Data quality status flags (Valid bit, Qualifier).
- ISDU Framework:
- Basic segmentation and reassembly.
- Basic Read/Write services.
- Segmentation Control: First/Last/Middle segment handling.
- Transport Flow Control: Pending-dispatch Busy (
0x01), duplicate request COUNT handling, response COUNT replay (including the final segment), COUNT wrap and ABORT reset. - Deferred Application Services: General asynchronous completion/cancellation API; the vendor-service callback remains synchronous.
- Record Boundaries: 232 application bytes per read/write request; larger images require multiple records.
- 16-bit Index Support: Support full 16-bit index.
- Write Verification: Readback after write.
The master's five-second ISDU acknowledgment watchdog (Interface Specification V1.1.4, Tables 53 and 102) ends when the first non-Busy response begins, not when every response segment has transferred. Applications must provide that response within the master's window. Supported Busy/retry transport cases do not establish general deferred application completion. See the protocol regression scope and separate hosted fixture; their synthetic clocks are not wire-timing measurements.
- Mandatory ISDU Indices:
- 0x0000: Direct Parameter Page 1 (read, packed identification/communication page)
- 0x0001: Direct Parameter Page 2 (read/write, device-specific)
- 0x0002: System Command (Table B.9: 0x80 Device Reset, 0x81 Application Reset, 0x82 Restore Factory Settings, 0x83 Back-to-box, 0x01-0x06 parameter transfer)
- 0x0003: DataStorageIndex (B.10 subindices 01-05 are not implemented; the stack serves the serialized image through subindex 0)
- 0x000C: Device Access Locks (Parameter, DS, local parameterization, local UI)
- 0x000D: Profile Characteristic
- 0x0010-0x0017: identification strings (vendor, product, serial, hardware/firmware revision)
- 0x0018-0x001A: Application/Function/Location tag (writable, DS-backed)
- 0x001B: Product URI (optional)
- 0x0020: ErrorCount (2 octets)
- 0x0024: DeviceStatus (1 octet)
- 0x0025: DetailedDeviceStatus (Table B.14, subindex 0 only)
- 0x0028: ProcessDataInput descriptor
- 0x0040-0x00FE Preferred and 0x0100+ Extended indices reach the vendor callback when one is registered
- Data Storage (DS):
- Implement parameter checksum generation.
- "Upload/Download" state machine for automatic parameter server.
- Real parameter serialization/restore over DS_Data index 0x0003.
- Integration with Device Access Locks (0x000C).
- DS Commands: Upload Start/End, Download Start/End.
- Checksum mismatch recovery (device re-serializes actual params; mismatch re-triggers download).
- Block Parameterization: Efficient bulk data transfer.
- Events: Diagnostic event queue and transmission logic.
- Standard Event Codes (V1.1.5 Annex D Table D.1 constants + iolink_event_classify):
- 0x1xxx: Device events (general malfunction)
- 0x4xxx: Temperature events
- 0x5xxx: Hardware / power-supply events
- 0x6xxx: Software / parameter events
- 0x7xxx: Wiring events (wire break, short, ground)
- 0x8Cxx: Application / maintenance events
- Event Qualifier: spec-correct MODE/TYPE/SOURCE/INSTANCE encoding (0x1C).
- Event Mode: Single/Multiple event mode.
- Event Instance: Multiple instances of same event.
- Event Acknowledgment: Master ACK mechanism.
- Standard Event Codes (V1.1.5 Annex D Table D.1 constants + iolink_event_classify):
- SIO Mode: Fallback to standard digital I/O when validation fails.
- Mode Switching: Dynamic SIO ↔ SDCI transitions.
- AutoComm: Automatic communication startup.
- Baudrate negotiation with Master.
- Runtime baudrate switching.
- Fallback to COM1 on errors.
- Error Events: Trigger events on CRC, timeout, framing errors.
- Error Recovery: Retry logic, state reset mechanisms.
- Error Reporting: ISDU index for error statistics.
- Timing Violation Events: Trigger on t_ren, t_cycle violations.
Goal: Simplify adoption, ensure quality, and prepare for official certification.
- Unit Tests: Comprehensive coverage of state machines using mocks.
- Virtual Conformance Testing:
- Automated integration test suite.
- Protocol sequence verification (Startup -> Operate).
- Timing Analysis: Native C/Q
t_Aassertions for the pinned evaluation images and run lengths documented above.
- IODD Generator: Python script to generate XML from JSON/C metadata.
- Device Simulator: pure-software host demo for simplified testing.
- Pre-compliance Testing: Run against official IO-Link Test Specification using standard testers.
- Documentation: "Certification Guide" for end-users.
Goal: Enable deployment across diverse hardware and RTOS environments.
- Zephyr RTOS Integration: Module structure, Kconfig, example app.
- Bare Metal Support: Platform abstraction for no-OS environments.
- Linux Host Simulation: POSIX-based testing environment.
- Docker Test Environment: Automated testing with CMocka and Virtual Master.
- Hardware Ports: Reference implementations for STM32, NXP, Nordic, Espressif.
Goal: Close all gaps identified in compliance analysis to achieve certification readiness.
- Complete mandatory System Command handlers (0x80-0x83, 0x01-0x06)
- Complete mandatory ID indices (see 2.2)
- Implement Device Access Locks (Index 0x000C), restored to the state of delivery by 0x81/0x82/0x83 (Table 101) and persisted across power cycles
- Implement M-sequence Type 1_x (8-bit OD variants)
- Implement M-sequence Type 2_x (ISDU + PD combined)
- Implement On-Request Data (OD) mechanism
- Implement SIO Mode switching logic
- Implement Wake-up pulse handling
- Map Standard Event Codes (0x1xxx-0x8xxx ranges)
- Implement completion-duration and OPERATE cycle monitors; wire
t_Ahas the separate response-time scope above. - Add frame retry logic for communication errors
- Implement error counters and reporting
- Device Profiles: Generic Device, Smart Sensor, IO-Link Safety
- Isochrone Mode: Synchronized operation with Master
- Device Variant: Multiple device configurations
- Condition Monitoring: Advanced diagnostics and predictive maintenance
- Backup/Restore: Full parameter backup and restore
- Test Mode: Factory test and loopback support
- Operating Hours: Device runtime tracking
- Implement Diagnosis features
Goal: Make stack production-ready for resource-constrained embedded systems.
- Context-Based API: Remove all global state (
g_dll_ctx,g_isdu, etc.), pass context pointers to all functions. - Logging Abstraction: Replace
printf()calls with configurable logging hooks or compile-time disable. - Configuration System: Create
iolink_config.hfor compile-time tuning (buffer sizes, queue depths). - Memory Documentation: Document RAM/ROM budgets and provide memory calculator tool.
- Critical Sections: Add
enter_critical()/exit_critical()hooks for thread safety. - Reentrancy: Eliminate static locals in functions, make all APIs reentrant.
- FreeRTOS Example: Demonstrate multi-task integration with proper synchronization.
- ISR Safety: Document which APIs are interrupt-safe vs require task context.
- DMA Support: Extend PHY API for DMA-based transfers (zero-copy).
- The STM32G0B1RE example now supplies selectable CMSIS DMA and optional ST HAL UART/DMA transports behind the existing synchronous PHY contract. These move UART bytes through DMA and wait for USART TC before releasing TIOL112 EN. A portable asynchronous/zero-copy PHY API remains separate work; this example does not introduce one. See its README and exact-ELF validation evidence.
- IRQ Mode: Add interrupt-driven receive mode to PHY abstraction.
- GPIO Control: Abstract C/Q line control for PHY implementations.
- Timer Abstraction: Formalize timer requirements beyond time_utils.
- Error Callbacks: Implement
iolink_error_tenum and user-provided error callback system. - Power Management: Add
iolink_suspend()/iolink_resume()APIs for low-power modes. - Watchdog Integration: Define watchdog kick points in processing loop.
- MISRA Audit: Initial cleanup of NULL checks and unsigned literals (v0.11.0).
- Stack Analysis: Document worst-case stack depth for each API call.
Goal: Leverage the stack for business opportunities (as per Business Case).
- Consulting Packages: Define "Integration Support" and "Custom Sensor Development" service offerings.
- Training Material: Create "Zero to IO-Link" workshop content.
- Showcases: Publish case studies of the stack running on diverse hardware (STM32, NXP, Nordic, Espressif).
Completed in this release (see CHANGELOG for the authoritative list):
- OPERATE M-sequence reply layout corrected to Figures A.9/A.10/A.13/A.14:
READ replies are
[OD][PD-in] CKS, WRITE replies are[PD-in] CKS, withiolinki-master1.1.0 in lockstep. - EventQualifier INSTANCE corrected to
0x04(Application, Table A.17) in the event memory and the DetailedDeviceStatus builder. - Device fault events use Table D.1 codes (
0x5110,0x5111,0x7710) instead of the mislabelled Master/Port codes0x1805/0x1806; negative PHY voltage readings are "measurement unavailable" instead of a fault. - Preferred Indices
0x0040-0x00FEroute to the vendor service (B.2.27). - GPLv3 grant unrestricted; physical bench runner and evidence bundle added.
Follow-ups split out of this work:
- Decide the operating-baudrate source for recovery; five sites still hard-code
COM1 in
src/dll.c(Figure 31 allows one supported rate, but no clause names the recovery rate) — maintainer decision needed before changing behavior. - Physical-master re-validation of the corrected reply layout.