> ## Documentation Index
> Fetch the complete documentation index at: https://devzone.nayax.com/llms.txt
> Use this file to discover all available pages before exploring further.

# EMV Core RTOS SDK 发行说明

> 随版本发布，跟踪 EMV Core RTOS SDK 的变更。

Nayax 会在本页记录 EMV Core RTOS SDK 随版本发布的变更。订阅 RSS 即可在有新条目时收到通知。在本页网址末尾添加 `/rss.xml` 即可找到订阅地址。

发行说明分为三个类别，帮助您评估每次更新的影响：

* **Improvements**（改进）：新增 API 命令、扩展的平台和卡片支持以及性能提升。
* **Fixes**（修复）：已解决的缺陷和可靠性改进。
* **Known Issues**（已知问题）：当前的限制或待实现功能，并附有建议的解决方法。

<Update label="SDK Version 1.0" rss={{ title:"RTOS SDK Version 1.0：TLS 支持、外部结算和电子小票支持",description:"首个正式 RTOS SDK 版本：TLS 保护的服务器通信，TransactionComplete 中的外部结算和电子小票数据，以及 CLP 卡类型检测，并包含网络、日志、配置和读卡器通信方面的可靠性修复。" }}>
  *发布日期：2026 年 2 月 11 日*

  此版本包含以下针对 RTOS SDK 的改进、修复和已知问题：

  <Accordion title="改进" icon="rocket">
    ### **Linux 示例应用程序（可移植 C 源代码）**

    SDK 回调架构已重构，以提高编译器兼容性（RM7434）。示例应用程序现在默认记录 JSON-RPC 消息（RM7471）。

    ***

    ### **TLS 支持**

    通过 TLS 实现 TMS 和支付服务连接的安全服务器通信（RM7021）。

    ***

    ### **外部结算（远程结算）**

    `TransactionComplete` 现在返回一个 `Additional_Parameters` 字段，其中包含 Nayax 服务器到服务器外部结算（RM7549）所需的数据：

    * `SiteId`：交易站点的唯一标识符
    * `EntryMode`：交易输入方式（Swipe、Contact、NFC）
    * `MachineAuTime`：机器授权时间
    * `NayaxTransactionId`：交易 ID

    ***

    ### **电子小票支持**

    `TransactionComplete` 现在返回 Nayax 电子小票（e-Receipt）所需的数据。

    ***

    ### **CLP 卡类型检测**

    `TransactionComplete` 现在返回闭环卡类型。

    ***

    ### **保留以备将来使用**

    以下功能已包含在内，但尚未经过全面测试，请勿使用：

    * `UpdateMachineAttributes` API
    * 增强的 `SendToReader` 功能，支持基于 TLS 的权限
    * 推送服务集成
  </Accordion>

  <Accordion title="修复" icon="wrench">
    ### **libecodsdk 库**

    * 网络状态通知
    * 线程模型：双线程架构
    * `ecod_sdk_configs.h` 中的新配置选项：
      * `EC_ACK_TIMEOUT_MS`：ACK 响应的超时时间（默认：1000 ms）
      * `EC_ACK_MAX_RETRIES`：未确认帧的最大重试次数（默认：0）
      * `EC_SUPPORT_LONG_LIVED_SOCKETS`：启用持久套接字连接
    * 新状态值：`EC_DISABLED`，表示 EMV Core 处于禁用状态

    ***

    ### **平台层**

    * 新增 `ecod_platform_init()`，用于平台特定的初始化
    * 串口打开时刷新串口数据
    * Linux：SIGPIPE 信号处理，防止套接字断开连接时发生崩溃

    ***

    ### **日志记录**

    * 为保护关键操作，日志文件总量限制为 336 KB（RM7534）
    * 修复：日志上传现在包含最新条目（issue #7357）
    * 配置更改时自动清理多余的日志文件（RM7539）
    * 新日志级别：`EC_LOG_LEVEL_TRACE`，用于详细调试
    * 新增文件日志记录支持
    * 改进了日志格式，添加了模块前缀

    ***

    ### **配置与存储**

    * 定期清理文件系统以确保长期可靠性（RM7527）
    * 读卡器文件系统清理，以防止存储空间耗尽（RM7531）
    * 修复：更新过程中配置文件损坏（RM7533）

    ***

    ### **支付参数（`emvCorePaymentParameters`）**

    * 已移除：`fee_cents` 和 `currency_code`
    * 新增：`additional_receipt_data`、`is_final_amount`、`is_deferred`（RFU）

    ***

    ### **读卡器通信**

    * 向后兼容 ECOD v0.9
    * 当读卡器缺少配置文件时，设备会自动恢复（RM7573）
    * 通过重试机制提高了读卡器配置更新的可靠性（RM7575）
    * 改进了套接字响应超时处理（RM7578）
    * ACK/NAK 处理及自动重传
    * 更好地处理碎片化的串行消息
    * 帧大小验证

    ***

    ### **网络桥接器（Socket API）**

    * 为降低小数据包的延迟，已禁用 Nagle 算法
    * 优化的套接字数据到达通知
    * 自动网络连接监控（Linux）

    ***

    ### **用户界面**

    * 修复：`ReaderMessage` 事件现在包含正确的消息索引（RM7470）
    * 修复：“Present card”消息现在在 `PreAuthorize` 后立即显示（RM7553）
    * 修复：修正了轮询 EMV（RM7585）期间 LED 闪烁行为的问题

    ***

    ### **读卡器固件**

    * 安全双模操作（TLV 和 JSON-RPC）（RM7571、RM7572、RM7584）
    * 固件更新包大小已减小
  </Accordion>

  <Accordion title="已知问题" icon="exclamation-triangle">
    ### **间歇性 TLV 消息 (RM7586)**

    设备可能会间歇性地发送 TLV 格式的消息，而不是 JSON-RPC 消息。

    ***

    ### **重置后首次响应速度慢 (RM7592)**

    串行通信：重置后的首次响应可能较慢。

    ***

    ### **虚拟机设备发现**

    在虚拟 Linux 机器（例如 WSL 或 VirtualBox）上，主机示例应用程序在重启后找不到设备：

    ```text theme={null}
    SERIAL [ERROR] failed to open HID port /dev/hidraw0: No such file or directory
    ```

    这是因为虚拟操作系统以不同的名称（例如 `hidraw1`）挂载读卡器。与物理操作系统无关。
  </Accordion>
</Update>

### 版本历史

下表将更早的每个 RTOS SDK 版本压缩为一行。完整详情和链接请参阅上方的当前版本。

| 版本 | 日期 | 摘要 |
| :- | :- | :- |
| SDK Version 0.9 | 2025 年 7 月 31 日 | **新增**： <ul><li>可移植的 Linux 示例应用</li><li>帧式数据链路层</li><li>`GetCardToken`/`CardTokenReceived`/`GetAttribute` 命令</li></ul> **修复** (#7052, #7054, #7056, #7072, #7233)： <ul><li>LED 缺陷</li><li>Core 版本缺陷</li><li>Present Card 显示缺陷</li></ul> |
| SDK Version 0.2 | 2025 年 3 月 24 日 | **新增**： <ul><li>UART TTL 通信</li><li>UNO-8 Manager v4.0.0</li></ul> **修复** (#7077, #7043, #7051)： <ul><li>安全模式启动</li><li>交易期间并行进行 TMS 传输</li><li>毫秒级日志时间戳</li></ul> |
| SDK Version 0.1 | 2024 年 12 月 30 日 | 首个 RTOS SDK 版本 |


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.