jtag-axi 0.1.2

JTAG to AXI bridge python I/F

JTAG to AXI master

Table of Contents

• Description
• Encoding of AXI registers
• License

Description

This design implements a JTAG interface that is capable of dispatching AXI Lite transactions into an AXI bus. Its main ob jectives are:

1. To debug SoC peripherals connected to an AXI bus - dispatch read / write single beat burst AXI transactions.
2. Program memories in SoCs to act as a bootloader interface.

Name	Encoding (4 bits)	Access (RW/RO)	Bit length	Description
EXTEST	0000	TBD	TBD	TBD
SAMPLE_PRELOAD	1010	TBD	TBD	TBD
IC_RESET	1100	RW	IC_RST_WIDTH - Def. 4	Programmable register to be used to control external resets
IDCODE	1110	RO	32	Returns the IDCODE of the device - 0xBADC0FFE
BYPASS	1111	RW	1	Standard bypass jtag register
ADDR_AXI_REG	0001	RW	ADDR_AXI_WIDTH - Def. 32	Indicates the AXI address of the transaction
DATA_W_AXI_REG	0010	RW	DATA_AXI_WIDTH - Def. 64	Indicates the AXI data to be written
DATA_R_AXI_REG	0011	RO	DATA_AXI_WIDTH - Def. 64	Indicates the AXI read data
CTRL_AXI_REG	0100	RW	2	Controls AXI master I/F dispatch
STATUS_AXI_REG	0101	RO	3	Return the status of the AXI transaction

Encoding of AXI registers

The registers CTRL_AXI_REG and STATUS_AXI_REG follow a specific format and the its encoding is detailed down below.

STATUS_AXI_REG

STATUS_AXI_REG	AXI Data Read (32 bits)	Status (3 bits)
Bit order	MSB	LSB
Access (RW/RO)	RO	RO
Description	When read transaction is performed, its data will be written here in order as dispatched	Current status of last transaction

Status decoding:

Status code	Status alias	Description
0	JTAG_IDLE	That is the default state of the design when no transactions (txn) have been dispatched
1	JTAG_RUNNING	When a transaction (txn) is started, the design will change to this state. It should stay there until a response is received or it times out.
2	JTAG_TIMEOUT	Indicates a transaction timeout
3	JTAG_AXI_OKAY	Indicates a transaction response: AXI OKAY
4	JTAG_AXI_EXOKAY	Indicates a transaction response: AXI EXOKAY
5	JTAG_AXI_SLVERR	Indicates a transaction response: AXI SLVERR
6	JTAG_AXI_DECER	Indicates a transaction response: AXI DECER

CTRL_AXI_REG

CTRL_AXI_REG	Start (1 bit)	Txn type (1 bit)	Free Slots (3 bits)	Size AXI txn (3 bits)
Bit order	MSB	...	...	LSB
Access (RW/RO)	RW	RW	RO	RW
Description	Once written 1, dispatches an AXI transaction	1 - Write, 0 - Read	Number of slots available in the Asynchronous FIFO	Size of the AXI transaction following AXIv4 encoding

AXI Write - Flow sequence

For a write sequence:

sequenceDiagram
JTAG Debug Adapter (PC) ->> JTAG I/F: Shift-IR: IDCODE
JTAG I/F ->> JTAG Debug Adapter (PC): Shift-DR: Get 0xBADC0FFE 
Note left of JTAG Debug Adapter (PC): Check whether the IDCODE <br/> matches 0xBADC0FFE
JTAG Debug Adapter (PC) --> JTAG I/F: Set txn addr
JTAG Debug Adapter (PC) ->> JTAG I/F: Shift-IR: ADDR_AXI_REG
JTAG Debug Adapter (PC) ->> JTAG I/F: Shift-DR: Shift the address of the txn
JTAG Debug Adapter (PC) ->> JTAG I/F: Update-DR
JTAG Debug Adapter (PC) --> JTAG I/F: Set txn data to be written
JTAG Debug Adapter (PC) ->> JTAG I/F: Shift-IR: DATA_W_AXI_REG
JTAG Debug Adapter (PC) ->> JTAG I/F: Shift-DR: Shift the data of the txn
JTAG Debug Adapter (PC) ->> JTAG I/F: Update-DR
JTAG Debug Adapter (PC) --> JTAG I/F: Start txn
JTAG Debug Adapter (PC) ->> JTAG I/F: Shift-IR: CTRL_AXI_REG
JTAG Debug Adapter (PC) ->> JTAG I/F: Shift-DR: Shift the control values of the txn
JTAG Debug Adapter (PC) ->> JTAG I/F: Update-DR

JTAG I/F ->> AXI Master I/F: Txn written into Async. FIFO
AXI Master I/F ->> AXI Bus: Txn issued on the AXI Bus
JTAG Debug Adapter (PC) --> AXI Bus: ...
AXI Bus ->> AXI Master I/F: AXI Slave response from AXI Bus
AXI Master I/F ->> JTAG I/F: Txn response written into Async. FIFO

JTAG Debug Adapter (PC) --> JTAG I/F: Monitor txn status
JTAG Debug Adapter (PC) ->> JTAG I/F: Shift-IR: STATUS_AXI_REG
Note right of JTAG I/F: Whenever Update-DR is selected <br/> with IR set to STATUS_AXI_REG <br/> the latest status will be updated <br/> into STATUS_AXI_REG shift register
Note left of JTAG Debug Adapter (PC): If txn_status != JTAG_RUNNING <br/> txn has finished
JTAG I/F ->> JTAG Debug Adapter (PC): Shift-DR: Get STATUS_AXI_REG

Note left of JTAG Debug Adapter (PC): If txn_status == RUNNING <br/> move to Update-DR and then back to Shift-DR <br/> this will update the STATUS_AXI_REG

AXI Read - Flow sequence

For a read sequence:

sequenceDiagram
JTAG Debug Adapter (PC) ->> JTAG I/F: Shift-IR: IDCODE
JTAG I/F ->> JTAG Debug Adapter (PC): Shift-DR: Get 0xBADC0FFE 
Note left of JTAG Debug Adapter (PC): Check whether the IDCODE <br/> matches 0xBADC0FFE
JTAG Debug Adapter (PC) --> JTAG I/F: Set txn addr
JTAG Debug Adapter (PC) ->> JTAG I/F: Shift-IR: ADDR_AXI_REG
JTAG Debug Adapter (PC) ->> JTAG I/F: Shift-DR: Shift the address of the txn
JTAG Debug Adapter (PC) ->> JTAG I/F: Update-DR
JTAG Debug Adapter (PC) --> JTAG I/F: Start txn
JTAG Debug Adapter (PC) ->> JTAG I/F: Shift-IR: CTRL_AXI_REG
JTAG Debug Adapter (PC) ->> JTAG I/F: Shift-DR: Shift the control values of the txn
JTAG Debug Adapter (PC) ->> JTAG I/F: Update-DR

JTAG I/F ->> AXI Master I/F: Txn written into Async. FIFO
AXI Master I/F ->> AXI Bus: Txn issued on the AXI Bus
JTAG Debug Adapter (PC) --> AXI Bus: ...
AXI Bus ->> AXI Master I/F: AXI Slave response from AXI Bus
AXI Master I/F ->> JTAG I/F: Txn response written into Async. FIFO

JTAG Debug Adapter (PC) --> JTAG I/F: Monitor txn status
JTAG Debug Adapter (PC) ->> JTAG I/F: Shift-IR: STATUS_AXI_REG
Note right of JTAG I/F: Whenever Update-DR is selected <br/> with IR set to STATUS_AXI_REG <br/> the latest status will be updated <br/> into STATUS_AXI_REG shift register
Note left of JTAG Debug Adapter (PC): If txn_status != RUNNING <br/> txn has finished
JTAG I/F ->> JTAG Debug Adapter (PC): Shift-DR: Get STATUS_AXI_REG

Note left of JTAG Debug Adapter (PC): If txn_status == RUNNING <br/> move to Update-DR and then back to Shift-DR <br/> this will update the STATUS_AXI_REG

jtag
> cable jlink
> frequency 10000000
> detect

---

License

jtag_axi is licensed under the permissive MIT license.Please refer to the LICENSE file for details.