XJAPI软件&硬件接口介绍

XJAPI一个简单易用的连接硬件的DLL应用程序接口（API）, 进入JTAG链通过XJLink或是PXI硬件，易于集成更广泛的系统，例如开发评估板，测试系统…

USB到JTAG硬件和软件的接口是由一个高速USB到JTAG硬件模块（ XJLink / XJLink2 ）和XJAPI ，使您能够直接访问和控制JTAG链。

到JTAG的PXI总线的硬件和软件的接口是由一个高速的PXI到JTAG硬件模块（PXI-XJLink2）和XJAPI 。

主要优点

• 快速通信/下载 USB (480 Mbps), JTAG (60 Mbps peak)；
• USB 到JTAG: 小巧，轻便的硬件设计 — 用于实验室和现场工作；
• PXI 到 JTAG 也可提供外形: 所有软件兼容USB到JTAG版本（ 3U/32位的PXI /PCI总线接口）；
• 自载许可，使得XJTAG可随意安装在多台机器上；
• 可用于任何pinout, ARM, Xilinx, Altera, 等等；
• 易控制。

特点

• 兼容JTAG/IEEE 1149.x；
• 高速的 USB 2.0 接口 (480 Mbps), 向下兼容USB 1.0 & 1.1；
• USB 总线供电 (无需额外的 PSU)；
• 可供给目标板电源 (3.3V, < 100 mA)；
• TCK 时钟频率可达 60 MHz；
• 可调的JTAG信号终端；
• 自动信号偏差控制；
• 软件配置Pin mapping；
• JTAG 信号支持到 +5V ；
• 在JTAG连接器上多余的信号可以用来控制其他项目，例如 控制目标重置/启动电源；
• 提供所有的文件，库和应用实例；
• 设计应用在C或是C++；
• 提供XJDemo板；
• 运行在Windows® 10 / 8 / 7 / Vista。

XJAPI函数

1. 初始化&设置和结束API
2. 底层次的JTAG扫描函数，底层次的访问JTAG.
3. 高层次的JTAG函数

完整的C文件可供下载: XJAPI.h

以下是功能的总结:

[]()

初始化&结束函数

建立硬件和引脚视图的函数。 指定所需的频率赫兹（XJAPI将设置接近MHz），所需的引脚映射和是否对板加电。

XJAPI_HardwareSetup( frequency, pinMap, powerOn );

解除硬件函数。在退出之前调用。

XJAPI_HardwareRelease( );

功能设置引脚图–这个函数接受一个参数，是20个元素的数组，对应的20个引脚。每个值应该是引脚的类型i+1，下列固定引脚除外:

• pin 1 – VCC
• pin 2 – NC
• pin 4 – GND
• pin 20 – GND

注意：该数组从0开始，但引脚从1开始，因此引脚10的设置将被写入阵列[9]。

XJAPI_SetPinMap( pinMapping, pinTypes[20], powerOn );

[]()

底层次的访问JTAG

设置频率函数 — 必须在100 KHz 和 60 MHz之间

XJAPI_SetFrequency( frequency );

请求TMS reset函数

XJAPI_TmsReset( );

进入具体的JTAG状态函数

XJAPI_GotoState( state );

设置最终的状态函数系统进入DR或是IR扫描操作之后。默认情况下，两者扫描进入JTAG_IDLE状态

XJAPI_SetEndState( endir, enddr );

JTAG链时钟函数，一个具体倍数

XJAPI_ClockChain( count );

[]()

高层次的扫描函数

执行JTAG/DR/IR扫描周期的函数。默认情况下，在扫描之后处在JTAG_IDLE状态。指定不同的结束状态，使用：“XJAPI_SetEndState”。

不同的扫描（DR或 IR）被指定时，扫描位数，数据缓冲区的地址：“outData”是被移出的数据， 0字节的0位先移出；“inDATA”是移入数据，0字节的0位先移入。

XJAPI_Scan( scanType, length, outData, inData );

执行多重扫描的函数。这个函数用于扫描（nScans）多个混合（DR and IR scans）型和混合长度的链。

注意：“scanTypes”，“长度”，“outData”“INDATA”数组的长度都是“nScan”的长度 。

XJAPI_ScanMultiple( nScans, scanTypes, length, outData, inData );