jt_instr.c File Reference

#include <stdlib.h>
#include <stdio.h>
#include <stdint.h>
#include <string.h>
#include "dbg_msg.h"
#include "jt_tap.h"
#include "jt_instr.h"
#include "jt_arm.h"
#include "jt_flash.h"
#include "jedec_vendorID.h"

Data Structures

struct string_description
struct translateID

Functions

int jtag_exchange_instr (const char *cmd_out, char *cmd_in)
int jtag_exchange_data (int len, char *data_out, char *data_in)
static int jt_info_idcode (int val)
int jtag_identify_devices (void)
void jtag_eos (int now)
void jtag_start (void)
void jtag_reset (void)
void jtag_hard_reset (void)
void jtag_linger (int delay)

Variables

static char jedec_unknown [] = "vendor unknown"
const char instr_extest [] = {0,0,0,0,'$'}
const char instr_scan_n [] = {0,0,1,0,'$'}
const char instr_sample [] = {0,0,1,1,'$'}
const char instr_restart [] = {0,1,0,0,'$'}
const char instr_clamp [] = {0,1,0,1,'$'}
const char instr_highz [] = {0,1,1,1,'$'}
const char instr_dapabort [] = {1,0,0,0,'$'}
const char instr_clampz [] = {1,0,0,1,'$'}
const char instr_dpacc [] = {1,0,1,0,'$'}
const char instr_apacc [] = {1,0,1,1,'$'}
const char instr_intest [] = {1,1,0,0,'$'}
const char instr_idcode [] = {1,1,1,0,'$'}
const char instr_bypass [] = {1,1,1,1,'$'}
const int instr_length = 4
static char jtag_data_IDcode [32]
static const int data_length_of_IDCODE = 32
int active_jtag_device = 0
const char instr_str91xFlash_bypass [] = {1,1,1,1, 1,1,1,1, '$'}
0xFF Bypass 1 bit len
const char instr_str91xFlash_idcode [] = {1,1,1,1, 1,1,1,0, '$'}
0xFE Idcode 32 bit len
const char instr_str91xFlash_usercode [] = {0,0,0,0, 0,1,1,0, '$'}
0x06 Usercode 32 bit len
const char instr_str91xFlash_isc_configuration [] = {0,0,0,0, 0,1,1,1, '$'}
0x07 Sector-Protect 64 bit len
const char instr_str91xFlash_isc_enable [] = {0,0,0,0, 1,1,0,0, '$'}
0x0C ISC_Enable 8 bit len
const char instr_str91xFlash_isc_disable [] = {0,0,0,0, 1,1,1,1, '$'}
0x0F ISC_Default 8 bit len
const char instr_str91xFlash_isc_noop [] = {0,0,0,1, 0,0,0,0, '$'}
0x10 ISC_Default 8 bit len
const char instr_str91xFlash_isc_address_shift [] = {0,0,0,1, 0,0,0,1, '$'}
0x11 ISC_Address 8 bit len
const char instr_str91xFlash_isc_clr_status [] = {0,0,0,1, 0,0,1,1, '$'}
0x13 ISC_Default 8 bit len
const char instr_str91xFlash_isc_program [] = {0,0,1,0, 0,0,0,0, '$'}
0x20 ISC_Data 64 bit len
const char instr_str91xFlash_isc_program_security [] = {0,0,1,0, 0,0,1,0, '$'}
0x22 ISC_Default 8 bit len
const char instr_str91xFlash_isc_program_uc [] = {0,0,1,0, 0,0,1,1, '$'}
0x23 Usercode 32 bit len
const char instr_str91xFlash_isc_erase [] = {0,0,1,1, 0,0,0,0, '$'}
0x30 ISC_Sector 64 bit len
const char instr_str91xFlash_isc_read [] = {0,1,0,1, 0,0,0,0, '$'}
0x50 ISC_Data 64 bit len
const char instr_str91xFlash_isc_blank_check [] = {0,1,1,0, 0,0,0,0, '$'}
0x60 ISC_Sector 64 bit len
const int instr_str91xFlash_length = 8
const int instr_stm32F10xTMC_length = 5
static struct string_description dev_description []
static struct string_description cap_description []
static char unknown_description [] = "unknown"
static struct translateID translateID []

Detailed Description

Intructions send to the TAP Controller

Support functions to access the JTAG interface via parallel port

Function Documentation

int jtag_exchange_instr	(	const char *	cmd_out,
		char *	cmd_in
	)

Place a command into the JTAG instruction register (IR) of the active device.
Each bit value is held within a single char.
It must be either 0 or 1 (but not '0' nor '1').

Note this function is called in an more or less "human readable notation" with
MSB shiftet in first and MSB shifted out first
while Hardware makes in real live;
LSB shifted in first and LSB shifted out first

So the bit order of the send data is swapped

Parameters:

	cmd_out	pointer to string of bits sent to the IR.
	cmd_in	pointer to string of bits received from the IR.

Returns:: true = 1 on success else false = 0

References active_jtag_device, DBG_LEVEL_JTAG_INSTR, IF_DBG, chain_info::instr_len, chain_info::prev, tap_instr(), transactionActivate(), transactionCreate(), transactionErase(), transactionGet(), and transaction::uplevel.

Referenced by jtag_identify_devices().

int jtag_exchange_data	(	int	len,
		char *	data_out,
		char *	data_in
	)

Place a value into the JTAG data register (DR) of the active device.
Each bit value is held within a single char.
It must be either 0 or 1 (but not '0' nor '1').

Note this function is called in an more or less "human readable notation" with
MSB shiftet in first and MSB shifted out first
while Hardware makes in real live;
LSB shifted in first and LSB shifted out first

So the bit order of the send and received data is swapped

Parameters:

	len	number of data bit to send and receive
	data_out	pointer to string of bits send to the DR.
	data_in	pointer to string of bits received from the DR.

Returns:: true = 1 on success else false = 0

References active_jtag_device, DBG_LEVEL_JTAG_INSTR, IF_DBG, transaction::parameter, tap_data(), transactionActivate(), transactionCreate(), transactionErase(), transactionGet(), and transaction::uplevel.

Referenced by jt_str91xflash_EraseSector(), jt_str91xflash_GetConfig(), jt_str91xflash_ReadSector(), jt_str91xflash_SectorBlankCheck(), jt_str91xflash_WriteSector(), jtag_arm720_CP15DataExchange(), jtag_arm720_CP15InstrReg(), jtag_arm7_mov_chain1_data(), jtag_arm920_CP15Interpret(), jtag_arm920_CP15PhysRegRead(), jtag_arm920_CP15PhysRegWrite(), jtag_arm926_CP15RegRead(), jtag_arm926_CP15RegWrite(), jtag_arm966_CP15RegRead(), jtag_arm966_CP15RegWrite(), jtag_arm9_mov_chain1_data(), jtag_arm_IceRT_RegRead(), jtag_arm_IceRT_RegRead_Once(), jtag_arm_IceRT_RegWrite(), jtag_arm_IceRT_RegWrite_getPrevData(), jtag_arm_set_chain(), jtag_cortex_apacc_RegRead(), jtag_cortex_apacc_RegWrite(), jtag_cortex_dpacc_RegRead(), jtag_cortex_dpacc_RegWrite(), and jtag_identify_devices().

static int jt_info_idcode ( int val ) [static]

Extract all kind of informations located inside of the IDCODE and show them.

Return values:

	1	if it is a valid idcode
	0	otherwise

References ARM_CAP_E_HC, ARM_CAP_E_SC, ARM_CAP_HC, ARM_CAP_J_HC, ARM_CAP_J_SC, ARM_CAP_SC, ARM_DEV_NUM_CORE_ONLY, ARM_DEV_NUM_WITH_MMU, ARM_DEV_NUM_WITH_MMU_HALFSIZE_CACHE, ARM_DEV_NUM_WITH_MMU_TIGHTLY_COUP_MEM, ARM_DEV_NUM_WITH_MMU_V6, ARM_DEV_NUM_WITH_MPU, ARM_DEV_NUM_WITH_MPU_TIGHTLY_COUP_MEM, ARM_DEV_NUM_WITH_TIGHTLY_COUP_MEM, ARM_FAMILY_ARM10, ARM_FAMILY_ARM11, ARM_FAMILY_ARM7, ARM_FAMILY_ARM9, ARM_PART_ARM7_OR_ARM9, ARM_PART_ARM7_SOFT_CORE, ARM_PART_CORTEX_M3, translateID::armJtagID, DBG_LEVEL_GDB_ARM_INFO, dbgPrintf(), jedec_unknown, LAST_JEDEC_VENDOR, translateID::realJtagID, string_description::string, and unknown_description.

Referenced by jtag_identify_devices().

int jtag_identify_devices ( void )

Try to identify the devices in the JTAG chain.
Currently the first ARM-device will be the active device in the chain.

Returns:: (element pos of IDcode in list starting at 1) if matches with one known device IDCODE else 0 the IDCODE is stored in global variable jtag_data_IDcode

References active_jtag_device, data_length_of_IDCODE, DBG_LEVEL_GDB_ARM_INFO, DBG_LEVEL_GDB_ARM_WARN, DBG_LEVEL_JTAG_INSTR, dbgPrintf(), chain_info::has_idcode, chain_info::idcode, IF_DBG, instr_idcode, chain_info::instr_len, instr_length, instr_stm32F10xTMC_length, instr_str91xFlash_idcode, instr_str91xFlash_length, jt_info_idcode(), jt_str91xflash_GetConfig(), jtag_data_IDcode, jtag_exchange_data(), jtag_exchange_instr(), jtag_send_instr(), jtag_supp_bitstr2int_MSB_First(), chain_info::next, chain_info::prev, STM32F10XXX_TMC_IDCODE_MSK, STM32F10XXX_TMC_IDCODE_PART, STR91X_ARM_IDCODE, STR91X_FLASH_IDCODE, STR91X_IR_SECURITY, tap_discover_chain(), tap_hard_reset(), tap_idle(), and tap_reset().

Referenced by jtag_arm_identify().

void jtag_eos ( int now )

End Of Sequence
This Signal set TAP controller into run/idle state.
Step from RESET, Update-DR, Update-IR or Run/Idle state into Run/Idle state
e.g. this indicates an end of a debug communication and releases the CPU to work in non blocking normal mode.

Parameters:

now

set 1 to enter TAP Run/Idle state now