diff --git a/CHANGELOG.en.md b/CHANGELOG.en.md index 4a04ee8..53db2b2 100644 --- a/CHANGELOG.en.md +++ b/CHANGELOG.en.md @@ -4,6 +4,8 @@ English · [简体中文](CHANGELOG.md) ## Unreleased +## 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. - 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..ea8082c 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -4,6 +4,8 @@ ## 未发布 +## 0.3.4 — 2026-11-06 + - 同步源码指南、后端契约、接口注释和验证清单,修正原生接收元数据、显式帧格式及每设备 Runtime 所有权的过时说明;保留固定版本证据,并区分 Unreleased 接口与已发布 SDK。 - 新增逐帧显式经典/FD 类型、原生接收时间戳元数据和 SocketCAN/PCAN 自身发送帧接收选项,保留后端默认行为;vendor/SLCAN 拒绝不支持的回显开启,驱动计数器不推定纪元。补充编码、初始化回滚、元数据路由和部署证据回归。本次不接入 hand/arm、不计为实机验收,使用方须用匹配的头文件和库重新编译。 diff --git a/CMakeLists.txt b/CMakeLists.txt index 51b413c..99ea1fd 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.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 35b3d25..f1a7e60 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.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). -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..0de33e2 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.3.4**,包含可选串口和 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..373cc99 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.3.4 + +[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. +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.3.4-`. 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..721902e 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.3.4 + +[版本 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 拒绝不支持的自身发送帧接收开启配置。 + +保留现有 C++ 签名和默认行为。公共结构有新增字段,使用方须使用匹配的头文件和库 +重新编译,不承诺与旧 SDK 的二进制 ABI 兼容。Python 接入前探针属于测试夹具, +并非生产 Python 绑定或 hand/arm 接入;实机验收仍待完成。参见 +[CAN 元数据](can-metadata.md)、[设备 Session](device-sessions.md)及[版本记录](../../CHANGELOG.md)。 + +发布验证沿用下方十二目标矩阵,归档名前缀为 `linkerbot-transport-0.3.4-`。 +正式发布后再下载附件,并核对签名标签、manifest 和校验值。旧版本附件不变。 + ## 0.3.3 [版本 0.3.3](https://github.com/linker-bot/linkerbot-transport-cpp/releases/tag/v0.3.3)