Industrial / PHP + Rust + Go

One micro-kernelfor 39 protocols

Install protocol packages on demand while the kernel handles connections, health checks and gateway rules.

Chixiaolun the gear mascot, the industrial-protocols project pet

Kernel defines a protocol

The kernel contains no protocol implementations; it provides ProtocolRegistry, ConnectionManager and six core interfaces, while packages are discovered and registered through the extra field.

Connection management offers three strategies; the gateway engine, circuit breaker, four retry policies, Prometheus metrics, PSR-14 events and PSR-3 logging are all handled by the kernel.

  • Kernel and SDK split
  • 15 pure PHP packages
  • 25 Bridge packages
39Protocol packages
772Test cases
7Framework runtimes
Chixiaolun the gear mascot Smile expression

Chixiaolun

A gear sprite wearing a hard hat and trailing a network cable, with chest signal lights that correspond to 39 industrial protocol packages.

Leave the protocols to my gears.

Beyond protocols

Six kernel duties, configured once.

Micro-kernel discovery

Composer extra discovers protocol packages and registers them in ProtocolRegistry at boot.

Connection management

Three connection strategies manage device links, with health checks returning state and latency.

Gateway engine

Orchestrate cross-protocol read and write rules so business code need not reach every device.

Circuit breaker and retries

Four retry policies plus a circuit breaker keep a failing device from taking down the chain.

Prometheus

Connection, request and error metrics are exposed for Prometheus to scrape.

Seven runtimes

Six frameworks plus plain PHP share one Kernel and connection manager.

Same capability, Rust and Go

Beyond PHP, separate Rust and Go implementations cover their own protocol sets.

Rust v1.1.2 Rust 1.75 / workspace

industrial-protocols-rust

38 protocols in Rust

Rust micro-kernel and SDK covering 38 protocols, with 45 crates pulled in on demand.

  • 38 industrial protocols
  • 45 on-demand crates
  • Optional tokio layer
View Rust repository
Go v1.1.4 Go 1.24 / go.work

industrial-protocols-go

40 protocols in Go

Go micro-kernel and SDK covering 40 protocols, with 14 pure software and 26 hardware SDKs.

  • 40 industrial protocols
  • 14 pure software
  • 26 hardware SDKs
View Go repository

From protocol coverage to tests

Every version maps to real commits, covering bug fixes and added tests.

v1.1.4

Release wrap-up

Release v1.1.4 as the latest version in the 1.1 series.

v1.1.3

Unit tests for every module

Add 752 cases and 2,092 assertions and fix 8 protocol bugs.

v1.1.2

Code review fixes 31 bugs

Review the kernel and 39 protocol packages and fix 31 defects.

v1.1.1

Package name unification

Rename packages to erikwang2013/industrial-protocols-* and unify the prefix.

Changelog

Recent releases; the full list is on GitHub Releases.

Latest v1.1.4 All versions
v1.1.42026-09-29

Release v1.1.4 as the latest version in the 1.1 series.

v1.1.32026-08-27

Add 752 cases and 2,092 assertions and fix 8 protocol bugs.

v1.1.22026-07-26

Code review fixes 31 bugs across the kernel and 39 packages.

v1.1.12026-07-22

Unify package names and vendor prefix as erikwang2013.

v1.1.0-worldfip2026-07-22

Release the WorldFIP package and document kernel dependencies.

v1.1.0-wirelesshart2026-07-22

Release WirelessHART and document kernel dependencies.

Install and use

Install the kernel and a protocol package, then read a register.

PHP >= 8.1Full README
Install
composer require erikwang2013/industrial-protocols-kernel erikwang2013/industrial-protocols-modbus
Minimal example
use Erikwang2013\IndustrialProtocols\Kernel;
use Erikwang2013\IndustrialProtocols\Modbus\ModbusProtocol;

$kernel = new Kernel(['config_path' => __DIR__ . '/industrial-protocols.php']);
$kernel->getProtocolRegistry()->register(new ModbusProtocol());
$kernel->boot();

$conn = $kernel->getConnectionManager()->connect('plc-001');
$result = $conn->read('40001');
echo $result['40001'];

Chixiaolun expressions

Hover and it changes mood.

Search this site

Try “upload”, “migration” or “JWT”.