> ## 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 是一个可移植的 C99 库，用于为基于 MCU 和 RTOS 的硬件添加 EMV 支付功能。您的应用程序调用 SDK API；SDK 负责处理读卡、授权和服务器通信。

<Note>
  本文档涵盖适用于 MCU 和 RTOS 平台的 SDK v1.0。有关 Android 或 Linux SDK，请参阅 [Android 安装](/docs/zh/integrate-pos-device/emv-core/get-started/emv-core-android-installation) 或 [Linux 安装](/docs/zh/integrate-pos-device/emv-core/get-started/emv-core-linux-installation)。
</Note>

## SDK 亮点

* **C99 源代码**，专为嵌入式系统设计
* **完整的 EMV 交易处理**，包括命令处理和授权
* **平台抽象层**，无需修改代码即可在任何 RTOS 上运行
* **Linux 参考实现**，随 SDK 提供
* **示例应用程序**，用于快速测试您的设置

## 系统概述

Nayax Embedded 解决方案包含三个要素：

<Columns cols={3}>
  <Card title="非现金读卡器硬件">
    运行 EMV Core 固件的 UNO-mini 读卡器，提供 JSON 支付 API 和网络套接字接口。
  </Card>

  <Card title="SDK 示例代码">
    C99 示例代码实现了网络套接字和支付 API 调用。
  </Card>

  <Card title="Nayax 服务器（Nayax Core）">
    用于远程终端管理和交易清算的云服务。
  </Card>
</Columns>

<Frame>
  <img src="https://mintcdn.com/nayax-44d6e37b/mqSvbg9R3CfdCY1b/images/docs/rtos-overview/system-overview.png?fit=max&auto=format&n=mqSvbg9R3CfdCY1b&q=85&s=78224b2d4308bb6f3978f5b7803f2853" width="998" height="447" data-path="images/docs/rtos-overview/system-overview.png" />
</Frame>

## 硬件和软件架构

运行 EMV Core 的 UNO-mini 读卡器通过 UART TTL 或 USB HID 连接到主机平台（MCU/RTOS）。

<Frame>
  <img src="https://mintcdn.com/nayax-44d6e37b/mqSvbg9R3CfdCY1b/images/docs/rtos-overview/hw-sw-architecture.png?fit=max&auto=format&n=mqSvbg9R3CfdCY1b&q=85&s=eb18a2f451cc17e0407751eebe4faf0c" width="674" height="337" data-path="images/docs/rtos-overview/hw-sw-architecture.png" />
</Frame>

<Frame>
  <img src="https://mintcdn.com/nayax-44d6e37b/mqSvbg9R3CfdCY1b/images/docs/rtos-overview/hw-sw-architecture-2.png?fit=max&auto=format&n=mqSvbg9R3CfdCY1b&q=85&s=6042b64d50ff6d8f1c83ff36fcd59f5c" width="988" height="301" data-path="images/docs/rtos-overview/hw-sw-architecture-2.png" />
</Frame>

### 应用层

通信按以下层次传递：

| 层 | 描述 |
| :- | :- |
| **应用层** | 您的代码调用 SDK API（例如 `EcodSdk_PreAuthorize()`） |
| **JSON-RPC 层** | 将 API 调用转换为带有数据链路帧的 JSON-RPC 消息 |
| **串行传输** | 通过 UART（`/dev/ttyUSB0`）或 HID（`/dev/hidraw0`）发送成帧的消息 |
| **EMV Core 设备** | 处理支付请求并返回响应 |
| **回调系统** | 通过已注册的回调函数传递异步响应 |

## 需求概述

| 要求 | 详情 |
| :- | :- |
| **设备连接** | USB HID 或 UART TTL |
| **最低内存** | 64 KB（可配置以适应较小的系统） |
| **读卡器供电** | 5–14 VDC，空闲 0.7 W / 峰值 3 W |
| **网络** | IPv4 TCP 套接字、DNS 解析、仅客户端 |
| **编译器** | 支持 C99 的 GCC 4.8+ 或 Clang 3.5+ |

## 后续步骤

<Columns cols={3}>
  <Card title="开始" icon="link" href="/docs/zh/integrate-pos-device/emv-core/rtos/rtos-get-started">
    SDK 交付、固件安装和获取您的设备 ID。
  </Card>

  <Card title="集成指南" icon="link" href="/docs/zh/integrate-pos-device/emv-core/rtos/rtos-integration-guide">
    线程、回调、错误处理和配置。
  </Card>

  <Card title="C API 参考" icon="link" href="/docs/zh/integrate-pos-device/emv-core/rtos/rtos-c-api">
    完整的 C API 函数参考和关键数据类型。
  </Card>
</Columns>


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