From 3b5d1ea99e787948775d1c3a4c299d008af4d299 Mon Sep 17 00:00:00 2001 From: Su Yang Date: Fri, 6 Nov 2026 20:43:53 +0800 Subject: [PATCH 1/2] Prepare 0.4.0 release --- CHANGELOG.en.md | 2 ++ CHANGELOG.md | 2 ++ CMakeLists.txt | 2 +- README.md | 4 ++-- README.zh-CN.md | 4 ++-- docs/README.md | 4 ++-- docs/en/releases.md | 19 +++++++++++++++++++ docs/zh/releases.md | 15 +++++++++++++++ 8 files changed, 45 insertions(+), 7 deletions(-) diff --git a/CHANGELOG.en.md b/CHANGELOG.en.md index 4a04ee8..757520a 100644 --- a/CHANGELOG.en.md +++ b/CHANGELOG.en.md @@ -4,6 +4,8 @@ English · [简体中文](CHANGELOG.md) ## Unreleased +## 0.4.0 — 2026-11-06 + - Synchronize source guides, backend contracts, API comments and validation inventory with native receive metadata, explicit frame formats and per-device Runtime ownership. Retain fixed-version evidence and distinguish Unreleased APIs from published SDKs. - Add explicit per-message classic/FD selection while preserving backend defaults, native receive timestamp metadata and opt-in SocketCAN/PCAN receive-own configuration. Reject unsupported vendor/SLCAN echo opt-in, preserve driver counters without epoch conversion, and add encoding, rollback, metadata routing and deployment-evidence regressions. No hand/arm integration or physical hardware acceptance is included; consumers must rebuild with matching headers and library. diff --git a/CHANGELOG.md b/CHANGELOG.md index 374c417..3719de1 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -4,6 +4,8 @@ ## 未发布 +## 0.4.0 — 2026-11-06 + - 同步源码指南、后端契约、接口注释和验证清单,修正原生接收元数据、显式帧格式及每设备 Runtime 所有权的过时说明;保留固定版本证据,并区分 Unreleased 接口与已发布 SDK。 - 新增逐帧显式经典/FD 类型、原生接收时间戳元数据和 SocketCAN/PCAN 自身发送帧接收选项,保留后端默认行为;vendor/SLCAN 拒绝不支持的回显开启,驱动计数器不推定纪元。补充编码、初始化回滚、元数据路由和部署证据回归。本次不接入 hand/arm、不计为实机验收,使用方须用匹配的头文件和库重新编译。 diff --git a/CMakeLists.txt b/CMakeLists.txt index 51b413c..459d3a9 100644 --- a/CMakeLists.txt +++ b/CMakeLists.txt @@ -1,5 +1,5 @@ cmake_minimum_required(VERSION 3.16) -project(linkerbot-transport VERSION 0.3.3 LANGUAGES CXX) +project(linkerbot-transport VERSION 0.4.0 LANGUAGES CXX) if(MSVC) add_compile_options(/utf-8) if(NOT DEFINED CMAKE_MSVC_RUNTIME_LIBRARY) diff --git a/README.md b/README.md index 35b3d25..0d444cf 100644 --- a/README.md +++ b/README.md @@ -15,10 +15,10 @@ matching belongs in the device SDK. The optional RTU module handles register transactions. Device register maps and motion control remain in the device SDK. See the [serial and RTU guide](docs/en/modbus-rtu.md). -Current source version: **0.3.3**, including optional serial and Modbus RTU modules. +Current source version: **0.4.0**, including optional serial and Modbus RTU modules. Published v0.3.2 packages do not contain those modules. See the [latest published stable release](https://github.com/linker-bot/linkerbot-transport-cpp/releases/latest). See [downloads, checksums and release documentation](docs/en/releases.md). -Source guides also cover [Unreleased changes](CHANGELOG.en.md); use the matching tag, +See the [changelog](CHANGELOG.en.md); use the matching tag, headers and bundled documentation to determine a published SDK's actual interfaces. The canonical package is `linkerbot-transport`; former `linkerbot-comm` calls and diff --git a/README.zh-CN.md b/README.zh-CN.md index bba04f4..d498219 100644 --- a/README.zh-CN.md +++ b/README.zh-CN.md @@ -13,9 +13,9 @@ CAN 模块负责物理连接、共享总线、接收路由和批次发送,CAN RTU 模块处理寄存器事务,设备寄存器映射和运动控制仍由上层 SDK 实现。 参见[串口与 RTU 指南](docs/zh/modbus-rtu.md)。 -当前源码版本:**0.3.3**,包含可选串口和 Modbus RTU 模块。已发布的 v0.3.2 包不包含这两项。下载[最新已发布的稳定版](https://github.com/linker-bot/linkerbot-transport-cpp/releases/latest)。 +当前源码版本:**0.4.0**,包含可选串口和 Modbus RTU 模块。已发布的 v0.3.2 包不包含这两项。下载[最新已发布的稳定版](https://github.com/linker-bot/linkerbot-transport-cpp/releases/latest)。 下载、校验及版本文档见[发行说明](docs/zh/releases.md)。 -源码指南也涵盖[未发布变更](CHANGELOG.md);已发布 SDK 的实际接口以对应标签、头文件和随包文档为准。 +变更见[版本记录](CHANGELOG.md);已发布 SDK 的实际接口以对应标签、头文件和随包文档为准。 规范包名为 `linkerbot-transport`;原 `linkerbot-comm` 查找入口和库文件继续兼容。 参见[命名迁移](docs/zh/naming.md)。 diff --git a/docs/README.md b/docs/README.md index 53107c0..148f77b 100644 --- a/docs/README.md +++ b/docs/README.md @@ -3,7 +3,7 @@ This index and the [English](../README.md) and [Chinese](../README.zh-CN.md) READMEs describe the current implementation. Each guide has an English and a Chinese edition. Historical hardware statements are separated in the validation guide. Source guides -include the Changelog's Unreleased APIs; published SDKs must be checked against their +cover the current source APIs; published SDKs must be checked against their matching tag, headers and bundled documentation, rather than the version number alone. ## English guides @@ -36,7 +36,7 @@ commands or validation scope must update both editions together. Keep identifier and fixed-commit evidence unchanged when translating. Historical translations belong under `docs/archive/`, with a historical-status notice and a link to this index. -本索引对应当前源码,包含 Changelog 的 Unreleased 接口;已发布 SDK 应核对对应标签、头文件 +本索引对应当前源码,包含当前源码接口;已发布 SDK 应核对对应标签、头文件 和随包文档,不能只按版本号推定包含所有新能力。先完成 FakeTransport 的离线构建和接入,再选择真实后端。 文档中的真实设备示例需要按已确认的硬件参数调整,不会由离线 CI 自动执行。 diff --git a/docs/en/releases.md b/docs/en/releases.md index 8f68d0f..bfd72eb 100644 --- a/docs/en/releases.md +++ b/docs/en/releases.md @@ -8,6 +8,25 @@ Current source uses the `linkerbot-transport` package name. Published releases through v0.3.2 retain `linkerbot-comm`; the 0.3.0 download example below deliberately uses its historical asset names and paths. See [name migration](naming.md). +## 0.4.0 + +[Version 0.4.0](https://github.com/linker-bot/linkerbot-transport-cpp/releases/tag/v0.4.0) +adds shared Runtime ownership, independent device Sessions and opt-in scheduling +controls on the existing writer. It adds explicit classic/FD transmit selection, +native receive timestamp metadata and opt-in SocketCAN/PCAN receive-own messages. +Vendor and SLCAN backends reject unsupported receive-own opt-in. + +Existing C++ signatures and default behavior are retained. Public structures have +grown: rebuild consumers with matching headers and libraries; binary ABI +compatibility with previous SDKs is not promised. Python pre-integration probes +are test fixtures, not a production Python binding or hand/arm integration. +Physical hardware acceptance remains pending. See [CAN metadata](can-metadata.md), +[device Sessions](device-sessions.md) and the [changelog](../../CHANGELOG.en.md). + +Release validation retains the twelve-target matrix below. Archive names begin +with `linkerbot-transport-0.4.0-`. Download assets only after publication and verify +the signed tag, manifest and checksums. Older release assets remain unchanged. + ## 0.3.3 [Version 0.3.3](https://github.com/linker-bot/linkerbot-transport-cpp/releases/tag/v0.3.3) diff --git a/docs/zh/releases.md b/docs/zh/releases.md index f5bb5b0..5895656 100644 --- a/docs/zh/releases.md +++ b/docs/zh/releases.md @@ -7,6 +7,21 @@ 当前源码使用 `linkerbot-transport` 包名。已发布至 v0.3.2 的包仍名为 `linkerbot-comm`; 下方 0.3.0 下载示例保留真实的旧资产名和安装路径。参见[命名迁移](naming.md)。 +## 0.4.0 + +[版本 0.4.0](https://github.com/linker-bot/linkerbot-transport-cpp/releases/tag/v0.4.0) +新增共享 Runtime 所有权、独立设备 Session,以及复用现有 writer 的可选调度控制。 +新增显式经典 CAN/FD 发送类型、原生接收时间戳元数据和 SocketCAN/PCAN 自身发送帧 +接收选项;vendor 与 SLCAN 拒绝不支持的自身发送帧接收开启配置。 + +保留现有 C++ 签名和默认行为。公共结构有新增字段,使用方须使用匹配的头文件和库 +重新编译,不承诺与旧 SDK 的二进制 ABI 兼容。Python 接入前探针属于测试夹具, +并非生产 Python 绑定或 hand/arm 接入;实机验收仍待完成。参见 +[CAN 元数据](can-metadata.md)、[设备 Session](device-sessions.md)及[版本记录](../../CHANGELOG.md)。 + +发布验证沿用下方十二目标矩阵,归档名前缀为 `linkerbot-transport-0.4.0-`。 +正式发布后再下载附件,并核对签名标签、manifest 和校验值。旧版本附件不变。 + ## 0.3.3 [版本 0.3.3](https://github.com/linker-bot/linkerbot-transport-cpp/releases/tag/v0.3.3) From 9771c062252e9743520fa7f10a216b6516a995c5 Mon Sep 17 00:00:00 2001 From: Su Yang Date: Fri, 6 Nov 2026 20:45:27 +0800 Subject: [PATCH 2/2] Keep release in the compatible 0.3 package series --- CHANGELOG.en.md | 2 +- CHANGELOG.md | 2 +- CMakeLists.txt | 2 +- README.md | 2 +- README.zh-CN.md | 2 +- docs/en/releases.md | 6 +++--- docs/zh/releases.md | 6 +++--- 7 files changed, 11 insertions(+), 11 deletions(-) diff --git a/CHANGELOG.en.md b/CHANGELOG.en.md index 757520a..53db2b2 100644 --- a/CHANGELOG.en.md +++ b/CHANGELOG.en.md @@ -4,7 +4,7 @@ English · [简体中文](CHANGELOG.md) ## Unreleased -## 0.4.0 — 2026-11-06 +## 0.3.4 — 2026-11-06 - Synchronize source guides, backend contracts, API comments and validation inventory with native receive metadata, explicit frame formats and per-device Runtime ownership. Retain fixed-version evidence and distinguish Unreleased APIs from published SDKs. diff --git a/CHANGELOG.md b/CHANGELOG.md index 3719de1..ea8082c 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -4,7 +4,7 @@ ## 未发布 -## 0.4.0 — 2026-11-06 +## 0.3.4 — 2026-11-06 - 同步源码指南、后端契约、接口注释和验证清单,修正原生接收元数据、显式帧格式及每设备 Runtime 所有权的过时说明;保留固定版本证据,并区分 Unreleased 接口与已发布 SDK。 diff --git a/CMakeLists.txt b/CMakeLists.txt index 459d3a9..99ea1fd 100644 --- a/CMakeLists.txt +++ b/CMakeLists.txt @@ -1,5 +1,5 @@ cmake_minimum_required(VERSION 3.16) -project(linkerbot-transport VERSION 0.4.0 LANGUAGES CXX) +project(linkerbot-transport VERSION 0.3.4 LANGUAGES CXX) if(MSVC) add_compile_options(/utf-8) if(NOT DEFINED CMAKE_MSVC_RUNTIME_LIBRARY) diff --git a/README.md b/README.md index 0d444cf..f1a7e60 100644 --- a/README.md +++ b/README.md @@ -15,7 +15,7 @@ matching belongs in the device SDK. The optional RTU module handles register transactions. Device register maps and motion control remain in the device SDK. See the [serial and RTU guide](docs/en/modbus-rtu.md). -Current source version: **0.4.0**, including optional serial and Modbus RTU modules. +Current source version: **0.3.4**, including optional serial and Modbus RTU modules. Published v0.3.2 packages do not contain those modules. See the [latest published stable release](https://github.com/linker-bot/linkerbot-transport-cpp/releases/latest). See [downloads, checksums and release documentation](docs/en/releases.md). See the [changelog](CHANGELOG.en.md); use the matching tag, diff --git a/README.zh-CN.md b/README.zh-CN.md index d498219..0de33e2 100644 --- a/README.zh-CN.md +++ b/README.zh-CN.md @@ -13,7 +13,7 @@ CAN 模块负责物理连接、共享总线、接收路由和批次发送,CAN RTU 模块处理寄存器事务,设备寄存器映射和运动控制仍由上层 SDK 实现。 参见[串口与 RTU 指南](docs/zh/modbus-rtu.md)。 -当前源码版本:**0.4.0**,包含可选串口和 Modbus RTU 模块。已发布的 v0.3.2 包不包含这两项。下载[最新已发布的稳定版](https://github.com/linker-bot/linkerbot-transport-cpp/releases/latest)。 +当前源码版本:**0.3.4**,包含可选串口和 Modbus RTU 模块。已发布的 v0.3.2 包不包含这两项。下载[最新已发布的稳定版](https://github.com/linker-bot/linkerbot-transport-cpp/releases/latest)。 下载、校验及版本文档见[发行说明](docs/zh/releases.md)。 变更见[版本记录](CHANGELOG.md);已发布 SDK 的实际接口以对应标签、头文件和随包文档为准。 diff --git a/docs/en/releases.md b/docs/en/releases.md index bfd72eb..373cc99 100644 --- a/docs/en/releases.md +++ b/docs/en/releases.md @@ -8,9 +8,9 @@ Current source uses the `linkerbot-transport` package name. Published releases through v0.3.2 retain `linkerbot-comm`; the 0.3.0 download example below deliberately uses its historical asset names and paths. See [name migration](naming.md). -## 0.4.0 +## 0.3.4 -[Version 0.4.0](https://github.com/linker-bot/linkerbot-transport-cpp/releases/tag/v0.4.0) +[Version 0.3.4](https://github.com/linker-bot/linkerbot-transport-cpp/releases/tag/v0.3.4) adds shared Runtime ownership, independent device Sessions and opt-in scheduling controls on the existing writer. It adds explicit classic/FD transmit selection, native receive timestamp metadata and opt-in SocketCAN/PCAN receive-own messages. @@ -24,7 +24,7 @@ Physical hardware acceptance remains pending. See [CAN metadata](can-metadata.md [device Sessions](device-sessions.md) and the [changelog](../../CHANGELOG.en.md). Release validation retains the twelve-target matrix below. Archive names begin -with `linkerbot-transport-0.4.0-`. Download assets only after publication and verify +with `linkerbot-transport-0.3.4-`. Download assets only after publication and verify the signed tag, manifest and checksums. Older release assets remain unchanged. ## 0.3.3 diff --git a/docs/zh/releases.md b/docs/zh/releases.md index 5895656..721902e 100644 --- a/docs/zh/releases.md +++ b/docs/zh/releases.md @@ -7,9 +7,9 @@ 当前源码使用 `linkerbot-transport` 包名。已发布至 v0.3.2 的包仍名为 `linkerbot-comm`; 下方 0.3.0 下载示例保留真实的旧资产名和安装路径。参见[命名迁移](naming.md)。 -## 0.4.0 +## 0.3.4 -[版本 0.4.0](https://github.com/linker-bot/linkerbot-transport-cpp/releases/tag/v0.4.0) +[版本 0.3.4](https://github.com/linker-bot/linkerbot-transport-cpp/releases/tag/v0.3.4) 新增共享 Runtime 所有权、独立设备 Session,以及复用现有 writer 的可选调度控制。 新增显式经典 CAN/FD 发送类型、原生接收时间戳元数据和 SocketCAN/PCAN 自身发送帧 接收选项;vendor 与 SLCAN 拒绝不支持的自身发送帧接收开启配置。 @@ -19,7 +19,7 @@ 并非生产 Python 绑定或 hand/arm 接入;实机验收仍待完成。参见 [CAN 元数据](can-metadata.md)、[设备 Session](device-sessions.md)及[版本记录](../../CHANGELOG.md)。 -发布验证沿用下方十二目标矩阵,归档名前缀为 `linkerbot-transport-0.4.0-`。 +发布验证沿用下方十二目标矩阵,归档名前缀为 `linkerbot-transport-0.3.4-`。 正式发布后再下载附件,并核对签名标签、manifest 和校验值。旧版本附件不变。 ## 0.3.3