XJAPI軟件&硬件接口介紹

XJAPI一個(gè)簡(jiǎn)單易用的連接硬件的DLL應(yīng)用程序接口（API）, 進(jìn)入JTAG鏈通過(guò)XJLink或是PXI硬件，易于集成更廣泛的系統(tǒng)，例如開(kāi)發(fā)評(píng)估板，測(cè)試系統(tǒng)…

USB到JTAG硬件和軟件的接口是由一個(gè)高速USB到JTAG硬件模塊（ XJLink / XJLink2 ）和XJAPI ，使您能夠直接訪問(wèn)和控制JTAG鏈。

到JTAG的PXI總線的硬件和軟件的接口是由一個(gè)高速的PXI到JTAG硬件模塊（PXI-XJLink2）和XJAPI 。

主要優(yōu)點(diǎn)

• 快速通信/下載 USB (480 Mbps), JTAG (60 Mbps peak)；
• USB 到JTAG: 小巧，輕便的硬件設(shè)計(jì) — 用于實(shí)驗(yàn)室和現(xiàn)場(chǎng)工作；
• PXI 到 JTAG 也可提供外形: 所有軟件兼容USB到JTAG版本（ 3U/32位的PXI /PCI總線接口）；
• 自載許可，使得XJTAG可隨意安裝在多臺(tái)機(jī)器上；
• 可用于任何pinout, ARM, Xilinx, Altera, 等等；
• 易控制。

特點(diǎn)

• 兼容JTAG/IEEE 1149.x；
• 高速的 USB 2.0 接口 (480 Mbps), 向下兼容USB 1.0 & 1.1；
• USB 總線供電 (無(wú)需額外的 PSU)；
• 可供給目標(biāo)板電源 (3.3V, < 100 mA)；
• TCK 時(shí)鐘頻率可達(dá) 60 MHz；
• 可調(diào)的JTAG信號(hào)終端；
• 自動(dòng)信號(hào)偏差控制；
• 軟件配置Pin mapping；
• JTAG 信號(hào)支持到 +5V ；
• 在JTAG連接器上多余的信號(hào)可以用來(lái)控制其他項(xiàng)目，例如 控制目標(biāo)重置/啟動(dòng)電源；
• 提供所有的文件，庫(kù)和應(yīng)用實(shí)例；
• 設(shè)計(jì)應(yīng)用在C或是C++；
• 提供XJDemo板；
• 運(yùn)行在Windows? 10 / 8 / 7 / Vista。

XJAPI函數(shù)

1. 初始化&設(shè)置和結(jié)束API
2. 底層次的JTAG掃描函數(shù)，底層次的訪問(wèn)JTAG.
3. 高層次的JTAG函數(shù)

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

以下是功能的總結(jié):

[]()

初始化&結(jié)束函數(shù)

建立硬件和引腳視圖的函數(shù)。 指定所需的頻率赫茲（XJAPI將設(shè)置接近MHz），所需的引腳映射和是否對(duì)板加電。

XJAPI_HardwareSetup( frequency, pinMap, powerOn );

解除硬件函數(shù)。在退出之前調(diào)用。

XJAPI_HardwareRelease( );

功能設(shè)置引腳圖–這個(gè)函數(shù)接受一個(gè)參數(shù)，是20個(gè)元素的數(shù)組，對(duì)應(yīng)的20個(gè)引腳。每個(gè)值應(yīng)該是引腳的類型i+1，下列固定引腳除外:

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

注意：該數(shù)組從0開(kāi)始，但引腳從1開(kāi)始，因此引腳10的設(shè)置將被寫(xiě)入陣列[9]。

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

[]()

底層次的訪問(wèn)JTAG

設(shè)置頻率函數(shù) — 必須在100 KHz 和 60 MHz之間

XJAPI_SetFrequency( frequency );

請(qǐng)求TMS reset函數(shù)

XJAPI_TmsReset( );

進(jìn)入具體的JTAG狀態(tài)函數(shù)

XJAPI_GotoState( state );

設(shè)置最終的狀態(tài)函數(shù)系統(tǒng)進(jìn)入DR或是IR掃描操作之后。默認(rèn)情況下，兩者掃描進(jìn)入JTAG_IDLE狀態(tài)

XJAPI_SetEndState( endir, enddr );

JTAG鏈時(shí)鐘函數(shù)，一個(gè)具體倍數(shù)

XJAPI_ClockChain( count );

[]()

高層次的掃描函數(shù)

執(zhí)行JTAG/DR/IR掃描周期的函數(shù)。默認(rèn)情況下，在掃描之后處在JTAG_IDLE狀態(tài)。指定不同的結(jié)束狀態(tài)，使用：“XJAPI_SetEndState”。

不同的掃描（DR或 IR）被指定時(shí)，掃描位數(shù)，數(shù)據(jù)緩沖區(qū)的地址：“outData”是被移出的數(shù)據(jù)， 0字節(jié)的0位先移出；“inDATA”是移入數(shù)據(jù)，0字節(jié)的0位先移入。

XJAPI_Scan( scanType, length, outData, inData );

執(zhí)行多重掃描的函數(shù)。這個(gè)函數(shù)用于掃描（nScans）多個(gè)混合（DR and IR scans）型和混合長(zhǎng)度的鏈。

注意：“scanTypes”，“長(zhǎng)度”，“outData”“INDATA”數(shù)組的長(zhǎng)度都是“nScan”的長(zhǎng)度 。

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