Skip to main content
Nayax 会在本页记录 EMV Core RTOS SDK 随版本发布的变更。订阅 RSS 即可在有新条目时收到通知。在本页网址末尾添加 /rss.xml 即可找到订阅地址。 发行说明分为三个类别,帮助您评估每次更新的影响:
  • Improvements(改进):新增 API 命令、扩展的平台和卡片支持以及性能提升。
  • Fixes(修复):已解决的缺陷和可靠性改进。
  • Known Issues(已知问题):当前的限制或待实现功能,并附有建议的解决方法。
发布日期:2026 年 2 月 11 日此版本包含以下针对 RTOS SDK 的改进、修复和已知问题:

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 的权限
  • 推送服务集成

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)
  • 固件更新包大小已减小

间歇性 TLV 消息 (RM7586)

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

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

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

虚拟机设备发现

在虚拟 Linux 机器(例如 WSL 或 VirtualBox)上,主机示例应用程序在重启后找不到设备:
这是因为虚拟操作系统以不同的名称(例如 hidraw1)挂载读卡器。与物理操作系统无关。

版本历史

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