Tsi721 Windows 设备驱动和API用户参考指南（中文版）

### Tsi721 Windows 设备驱动和API用户参考指南（中文版）知识点解析 #### 一、概览 本文档旨在为熟悉RapidIO规范的软件开发人员提供关于Tsi721 Windows设备驱动程序及其API的详细介绍。文档不仅涵盖了驱动程序的基本信息，还深入探讨了API的功能和使用方法，并提供了具体的代码示例。 #### 二、Tsi721 设备驱动程序包 ##### 1. 组件构成 Tsi721 Windows设备驱动程序包包含了以下几个关键部分： - **内核模式设备驱动程序**：适用于Windows 7（32位和64位）及Windows XP的操作系统。该驱动程序以二进制文件的形式提供（`tsi721.sys`），确保与不同版本的Windows操作系统兼容。 - **用户模式API DLL**：名为`tsi721_api.dll`的动态链接库，用于简化设备驱动程序的访问和使用过程。 - **代码示例**：提供了两个示例项目来展示如何使用API。 - **第一个示例**：针对Tsi721评估板，但也可以轻松应用于用户的自定义配置。此示例还包含了使用Tsi721评估板进行测试的预构建二进制文件。 - **第二个示例**：适用于两个直接通过S-RIO链路连接的Tsi721设备。 - **自述文件**：提供关于更新和最后时刻文档变更的信息。 - **Tsi721 Windows设备驱动程序和API文档**：即本文档，包含了详细的驱动程序和API信息。 ##### 2. 版本历史 - **2013年10月30日**：发布了小更新，以改进Tsi721设备驱动程序包。 - **2013年5月6日**：更新了API参数的解释，并增加了新的测试代码示例。 - **2013年3月25日**：首次发布。 #### 三、Tsi721 设备驱动程序 ##### 1. 驱动程序概述 Tsi721设备驱动程序是专门为Windows设计的内核模式驱动程序，使用了Microsoft Windows内核模式驱动程序框架。由于Tsi721硬件和通用RapidIO互连架构的特点，该驱动程序提供了专门的IOCTL功能，以适应RapidIO架构的特殊需求，例如数据传输到RapidIO端点等操作。传统的读写接口并不适用于此类架构。 ##### 2. 功能特性 - **支持重叠I/O请求**：允许并发执行多个I/O操作。 - **多并行请求队列**：提供异步事件通知与同步数据传输和寄存器访问操作相结合的能力。 - **设备特定的IOCTL代码**：支持以下操作： - 对PCI Express配置空间中的本地Tsi721寄存器进行读/写访问。 - 对PCI Express I/O内存空间中的本地Tsi721寄存器进行读/写访问。 - 从远程S-RIO设备的CSR进行维护读/写操作（使用Tsi721 BDMA通道）。 - 从连接到RapidIO结构的远程端点进行寻址数据读/写操作（使用Tsi721 BDMA通道的NREAD、NWRITE、SWRITE）。 - 向/从RapidIO端点发送和接收门铃通知。入站门铃队列大小配置为最多存储512个条目。 - 发送和接收RapidIO邮箱消息(MBOX0–MBOX3)。入站消息传递仅支持具有匹配目标ID的消息队列。 - 将入站RapidIO内存地址映射到本地系统内存缓冲区。 - 从连接的RapidIO结构组件（交换机和端点）接收端口写入通知。 ##### 3. 不支持的功能 - **PCI Express到S-RIO内存映射窗口**：不支持的原因在于对于失败请求的错误处理具有挑战性，需要实现自定义机器检查处理程序。 - **具有不匹配目标ID的消息的入站消息队列**：不支持此类队列。 ##### 4. 与Linux内核RapidIO支持的区别 - **服务级别差异**：熟悉Linux内核RapidIO子系统的用户可能会注意到，Windows下的Tsi721设备驱动程序提供的服务级别与Linux不同。Windows操作系统本身并未提供对RapidIO的支持，因此用户需要自己实现S-RIO结构管理功能，例如枚举和发现、错误管理初始化和路由设置等功能。 #### 四、应用程序接口(API) ##### 1. API概述 Tsi721用户模式API DLL(`tsi721_api.dll`)提供了高级别的接口，使得开发者能够更加方便地与Tsi721设备交互。该API简化了设备驱动程序的访问和使用过程，包括但不限于寄存器读写、数据传输等功能。 ##### 2. 使用方法 - **代码示例**：文档中包含了多个示例项目，旨在帮助开发者理解API的使用方式。 - **API文档**：详细介绍了每个API函数的参数、返回值以及使用注意事项。 #### 五、结论 Tsi721 Windows设备驱动程序和API用户参考指南为开发者提供了全面的指导和支持，以确保他们能够有效地利用Tsi721设备的各项功能。通过对驱动程序和API的深入了解，开发者可以更好地集成Tsi721设备到他们的应用中，从而实现更高效的数据处理和通信。