REN-Rio-APN-20170627.pdf
需积分: 1 150 浏览量
2023-06-06
10:55:25
上传
评论
收藏 286KB PDF 举报
1©2017 Integrated Device Technology, Inc. June 26, 2017
Overview
RapidIO software support consists of three interrelated source code projects/repositories:
▪ A character mode driver for the Linux operating system
▪ Ethernet frame transport over RapidIO network, known as “riosocket”
▪ Application (“user mode”) code which leverages the character mode driver for the following functions:
— An application library (libmport) for the character mode driver interfaces
— RapidIO network enumeration and management
— The RapidIO device driver library, which provides a consistent interface for the following hardware functions: port configuration,
routing table manipulation, error management, and statistics counters
— An example file transfer application, which leverages libmport to perform RDMA style file transfer over the RapidIO network
— The “goodput” performance measurement and debug utility, which leverages libmport to measure latency and goodput for direct
I/O, DMA, and messaging.
The RapidIO software is freely available from the following public GitHub repositories:
▪ https://github.com/RapidIO/kernel-rapidio
▪ https://github.com/RapidIO/riosocket
▪ https://github.com/RapidIO/RapidIO_RRMAP
Note that private versions of the above repositories exist, and may be accessed by members of RapidIO.org. The private repositories
contain additional functionality and features, and also contain significant test infrastructure to aid software developers.
Linux Character Mode Driver for RapidIO
RapidIO support in the Linux operating system is based on the concept of a “master port” (mport), which is a RapidIO port on an endpoint.
The RapidIO port can provide direct I/O, DMA, messaging, doorbell, and other RapidIO capabilities. The RapidIO subsystem leverages
these capabilities to provide the following services:
▪ RapidIO network enumeration and discovery for multiple mports and redundant hosts
▪ A sysfs file subsystem for each discovered mport and switch, exposing some attributes of each device
The character mode driver allows application software to access the direct I/O, DMA, messaging, and doorbell capabilities, if any, of the
local mport(s). The libmport library, found in the RapidIO_RRMAP repository, presents the following capabilities using a standard
C interface:
▪ Handle management – List available mports, list devices accessible from each mport, query the capabilities of each device
▪ Direct I/O – Map inbound and outbound windows for an mport, allowing RapidIO read and write transactions to be generated from
processor reads and writes
▪ DMA – Perform read and write transactions over the RapidIO network
▪ Events – Manage event usage for an mport, and send/receive events over the RapidIO network
▪ Messaging – A channelized messaging (CM) capability to allow a single messaging resource to be shared using a socket-like interface
The character mode driver uses drivers for individual devices. Currently, all RapidIO switch devices are supported. The Tsi721
PCIe-to-RapidIO bridge, and some Freescale and Texas Instruments processors/DSPs, are also supported by the character mode driver.
For more information, refer to the documentation for the character mode driver found in the kernel-rapidio repository, and the wiki page
for the libmport library:
https://github.com/RapidIO/RapidIO_RRMAP/wiki/2.-LIBMPORT:-RapidIO-Kernel-Driver-Library
AN-974
Application Note
RapidIO Software Support
资源评论
