batch.h File Reference

Include dependency graph for batch.h:

This graph shows which files directly or indirectly include this file:

Go to the source code of this file.

Data Structures
struct	riscv_batch
struct	riscv_scan_delays

Macros
#define	RISCV_SCAN_DELAY_MAX   (INT_MAX / 2)

Enumerations
enum	riscv_scan_delay_class { RISCV_DELAY_BASE , RISCV_DELAY_ABSTRACT_COMMAND , RISCV_DELAY_SYSBUS_READ , RISCV_DELAY_SYSBUS_WRITE }
enum	riscv_scan_type { RISCV_SCAN_TYPE_INVALID , RISCV_SCAN_TYPE_NOP , RISCV_SCAN_TYPE_READ , RISCV_SCAN_TYPE_WRITE }

Functions
static size_t	riscv_batch_add_dm_read (struct riscv_batch *batch, uint32_t address, enum riscv_scan_delay_class delay_type)
static void	riscv_batch_add_dm_write (struct riscv_batch *batch, uint32_t address, uint32_t data, bool read_back, enum riscv_scan_delay_class delay_type)
size_t	riscv_batch_add_dmi_read (struct riscv_batch *batch, uint32_t address, enum riscv_scan_delay_class delay_class)
void	riscv_batch_add_dmi_write (struct riscv_batch *batch, uint32_t address, uint32_t data, bool read_back, enum riscv_scan_delay_class delay_class)
void	riscv_batch_add_nop (struct riscv_batch *batch)
struct riscv_batch *	riscv_batch_alloc (struct target *target, size_t scans)
size_t	riscv_batch_available_scans (struct riscv_batch *batch)
size_t	riscv_batch_finished_scans (const struct riscv_batch *batch)
void	riscv_batch_free (struct riscv_batch *batch)
bool	riscv_batch_full (struct riscv_batch *batch)
uint32_t	riscv_batch_get_dmi_read_data (const struct riscv_batch *batch, size_t key)
uint32_t	riscv_batch_get_dmi_read_op (const struct riscv_batch *batch, size_t key)
int	riscv_batch_run_from (struct riscv_batch *batch, size_t start_idx, const struct riscv_scan_delays *delays, bool resets_delays, size_t reset_delays_after)
bool	riscv_batch_was_batch_busy (const struct riscv_batch *batch)
static const char *	riscv_scan_delay_class_name (enum riscv_scan_delay_class delay_class)
static unsigned int	riscv_scan_get_delay (const struct riscv_scan_delays *delays, enum riscv_scan_delay_class delay_class)
static int	riscv_scan_increase_delay (struct riscv_scan_delays *delays, enum riscv_scan_delay_class delay_class)
static void	riscv_scan_set_delay (struct riscv_scan_delays *delays, enum riscv_scan_delay_class delay_class, unsigned int delay)

Macro Definition Documentation

RISCV_SCAN_DELAY_MAX

#define RISCV_SCAN_DELAY_MAX   (INT_MAX / 2)

Definition at line 55 of file batch.h.

Enumeration Type Documentation

riscv_scan_delay_class

enum riscv_scan_delay_class

Enumerator
RISCV_DELAY_BASE
RISCV_DELAY_ABSTRACT_COMMAND
RISCV_DELAY_SYSBUS_READ
RISCV_DELAY_SYSBUS_WRITE

Definition at line 20 of file batch.h.

riscv_scan_type

enum riscv_scan_type

Enumerator
RISCV_SCAN_TYPE_INVALID
RISCV_SCAN_TYPE_NOP
RISCV_SCAN_TYPE_READ
RISCV_SCAN_TYPE_WRITE

Definition at line 10 of file batch.h.

Function Documentation

riscv_batch_add_dm_read()

static size_t riscv_batch_add_dm_read ( struct riscv_batch *  batch, uint32_t  address, enum riscv_scan_delay_class  delay_type  )

inlinestatic

Definition at line 212 of file batch.h.

References address, riscv_batch_add_dmi_read(), riscv_get_dmi_address(), and riscv_batch::target.

Referenced by abstract_cmd_fill_batch(), abstract_data_read_fill_batch(), dm_read_exec(), read_memory_bus_v1(), read_memory_progbuf_inner_fill_batch(), and sample_memory_bus_v1().

riscv_batch_add_dm_write()

static void riscv_batch_add_dm_write ( struct riscv_batch *  batch, uint32_t  address, uint32_t  data, bool  read_back, enum riscv_scan_delay_class  delay_type  )

inlinestatic

Definition at line 197 of file batch.h.

References address, riscv_batch_add_dmi_write(), riscv_get_dmi_address(), and riscv_batch::target.

Referenced by abstract_cmd_fill_batch(), abstract_data_write_fill_batch(), batch_fill_sb_write_address(), sample_memory_bus_v1(), write_memory_bus_v1(), and write_memory_progbuf_fill_batch().

riscv_batch_add_dmi_read()

size_t riscv_batch_add_dmi_read	(	struct riscv_batch *	batch,
		uint32_t	address,
		enum riscv_scan_delay_class	delay_class
	)

Definition at line 361 of file batch.c.

References address, riscv_batch::allocated_scans, riscv_batch::data_in, riscv_batch::data_out, riscv_batch::delay_classes, DMI_SCAN_BUF_SIZE, DMI_SCAN_MAX_BIT_LENGTH, riscv_batch::fields, get_dmi_scan_length(), scan_field::in_value, riscv_batch::last_scan, scan_field::num_bits, scan_field::out_value, riscv_batch::read_keys, riscv_batch::read_keys_used, riscv_fill_dm_nop(), riscv_fill_dmi_read(), RISCV_SCAN_TYPE_READ, riscv_batch::target, and riscv_batch::used_scans.

Referenced by dmi_read(), and riscv_batch_add_dm_read().

riscv_batch_add_dmi_write()

void riscv_batch_add_dmi_write	(	struct riscv_batch *	batch,
		uint32_t	address,
		uint32_t	data,
		bool	read_back,
		enum riscv_scan_delay_class	delay_class
	)

Definition at line 331 of file batch.c.

References address, riscv_batch::allocated_scans, riscv_batch::data_in, riscv_batch::data_out, riscv_batch::delay_classes, DMI_SCAN_BUF_SIZE, DMI_SCAN_MAX_BIT_LENGTH, riscv_batch::fields, get_dmi_scan_length(), scan_field::in_value, riscv_batch::last_scan, NULL, scan_field::num_bits, scan_field::out_value, riscv_fill_dm_nop(), riscv_fill_dmi_write(), RISCV_SCAN_TYPE_WRITE, riscv_batch::target, and riscv_batch::used_scans.

Referenced by dmi_write(), and riscv_batch_add_dm_write().

riscv_batch_add_nop()

void riscv_batch_add_nop

(

struct riscv_batch *

batch

)

Definition at line 409 of file batch.c.

References riscv_batch::allocated_scans, riscv_batch::data_in, riscv_batch::data_out, riscv_batch::delay_classes, DMI_SCAN_BUF_SIZE, DMI_SCAN_MAX_BIT_LENGTH, riscv_batch::fields, get_dmi_scan_length(), scan_field::in_value, riscv_batch::last_scan, scan_field::num_bits, scan_field::out_value, RISCV_DELAY_BASE, riscv_fill_dm_nop(), RISCV_SCAN_TYPE_NOP, riscv_batch::target, and riscv_batch::used_scans.

Referenced by batch_run(), and batch_run_timeout().

riscv_batch_alloc()

struct riscv_batch* riscv_batch_alloc	(	struct target *	target,
		size_t	scans
	)

Definition at line 31 of file batch.c.

References riscv_batch::allocated_scans, BATCH_RESERVED_SCANS, riscv_batch::bscan_ctxt, bscan_tunnel_ir_width, riscv_batch::data_in, riscv_batch::data_out, riscv_batch::delay_classes, DMI_SCAN_BUF_SIZE, riscv_batch::fields, riscv_batch::last_scan, riscv_batch::last_scan_delay, LOG_ERROR, NULL, riscv_batch::read_keys, riscv_batch_free(), RISCV_SCAN_TYPE_INVALID, target, riscv_batch::target, and riscv_batch::was_run.

Referenced by dm_read_exec(), dmi_read(), dmi_write(), read_abstract_arg(), read_memory_bus_v1(), read_memory_progbuf_inner_try_to_read(), register_write_abstract(), riscv013_execute_abstract_command(), sample_memory_bus_v1(), sb_write_address(), write_memory_bus_v1(), and write_memory_progbuf_try_to_write().

riscv_batch_available_scans()

size_t riscv_batch_available_scans

(

struct riscv_batch *

batch

)

Definition at line 432 of file batch.c.

References riscv_batch::allocated_scans, BATCH_RESERVED_SCANS, and riscv_batch::used_scans.

Referenced by abstract_cmd_fill_batch(), read_memory_progbuf_inner_fill_batch(), riscv_batch_full(), write_memory_bus_v1(), and write_memory_progbuf_fill_batch().

riscv_batch_finished_scans()

size_t riscv_batch_finished_scans

(

const struct riscv_batch *

batch

)

Definition at line 446 of file batch.c.

References riscv_batch_was_batch_busy(), riscv_batch_was_scan_busy(), and riscv_batch::used_scans.

Referenced by batch_run_timeout().

riscv_batch_free()

void riscv_batch_free

(

struct riscv_batch *

batch

)

Definition at line 96 of file batch.c.

References riscv_batch::bscan_ctxt, riscv_batch::data_in, riscv_batch::data_out, riscv_batch::delay_classes, riscv_batch::fields, and riscv_batch::read_keys.

Referenced by dm_read_exec(), dmi_read(), dmi_write(), read_abstract_arg(), read_memory_bus_v1(), read_memory_progbuf_inner_try_to_read(), register_write_abstract(), riscv013_execute_abstract_command(), riscv_batch_alloc(), sample_memory_bus_v1(), sb_write_address(), write_memory_bus_v1(), and write_memory_progbuf_try_to_write().

riscv_batch_full()

bool riscv_batch_full

(

struct riscv_batch *

batch

)

Definition at line 107 of file batch.c.

References riscv_batch_available_scans().

riscv_batch_get_dmi_read_data()

uint32_t riscv_batch_get_dmi_read_data	(	const struct riscv_batch *	batch,
		size_t	key
	)

Definition at line 399 of file batch.c.

References buf_get_u32(), riscv_batch::data_in, DMI_SCAN_BUF_SIZE, DTM_DMI_DATA_LENGTH, DTM_DMI_DATA_OFFSET, and riscv_batch::read_keys.

Referenced by abstract_cmd_batch_check_and_clear_cmderr(), abstract_data_get_from_batch(), dm_read_exec(), dmi_read(), read_memory_bus_v1(), read_memory_progbuf_inner_extract_batch_data(), and sample_memory_bus_v1().

riscv_batch_get_dmi_read_op()

uint32_t riscv_batch_get_dmi_read_op	(	const struct riscv_batch *	batch,
		size_t	key
	)

Definition at line 389 of file batch.c.

References buf_get_u32(), riscv_batch::data_in, DMI_SCAN_BUF_SIZE, DTM_DMI_OP_LENGTH, DTM_DMI_OP_OFFSET, and riscv_batch::read_keys.

Referenced by read_memory_progbuf_inner_extract_batch_data(), and sample_memory_bus_v1().

riscv_batch_run_from()

int riscv_batch_run_from	(	struct riscv_batch *	batch,
		size_t	start_idx,
		const struct riscv_scan_delays *	delays,
		bool	resets_delays,
		size_t	reset_delays_after
	)

Definition at line 278 of file batch.c.

References add_idle_before_batch(), riscv_batch::bscan_ctxt, bscan_tunnel_ir_width, buffer_shr(), DMI_SCAN_BUF_SIZE, ERROR_FAIL, ERROR_OK, riscv_batch::fields, get_delay(), jtag_add_dr_scan(), jtag_add_runtest(), jtag_execute_queue(), keep_alive(), riscv_batch::last_scan, riscv_batch::last_scan_delay, log_batch(), LOG_TARGET_DEBUG, LOG_TARGET_ERROR, riscv_add_bscan_tunneled_scan(), riscv_batch_was_scan_busy(), RISCV_SCAN_TYPE_NOP, target::tap, TAP_IDLE, riscv_batch::target, riscv_batch::used_scans, and riscv_batch::was_run.

Referenced by batch_run(), and batch_run_timeout().

riscv_batch_was_batch_busy()

bool riscv_batch_was_batch_busy

(

const struct riscv_batch *

batch

)

Definition at line 438 of file batch.c.

References riscv_batch::last_scan, riscv_batch_was_scan_busy(), RISCV_SCAN_TYPE_NOP, riscv_batch::used_scans, and riscv_batch::was_run.

Referenced by batch_run(), batch_run_timeout(), riscv_batch_finished_scans(), write_memory_bus_v1(), and write_memory_progbuf_run_batch().

riscv_scan_delay_class_name()

static const char* riscv_scan_delay_class_name ( enum riscv_scan_delay_class  delay_class )

inlinestatic

Definition at line 32 of file batch.h.

References NULL, RISCV_DELAY_ABSTRACT_COMMAND, RISCV_DELAY_BASE, RISCV_DELAY_SYSBUS_READ, and RISCV_DELAY_SYSBUS_WRITE.

Referenced by batch_run_timeout(), riscv_scan_increase_delay(), and riscv_scan_set_delay().

riscv_scan_get_delay()

static unsigned int riscv_scan_get_delay ( const struct riscv_scan_delays *  delays, enum riscv_scan_delay_class  delay_class  )

inlinestatic

Definition at line 65 of file batch.h.

References riscv_scan_delays::ac_delay, riscv_scan_delays::base_delay, RISCV_DELAY_ABSTRACT_COMMAND, RISCV_DELAY_BASE, RISCV_DELAY_SYSBUS_READ, RISCV_DELAY_SYSBUS_WRITE, riscv_scan_delays::sb_read_delay, and riscv_scan_delays::sb_write_delay.

Referenced by add_idle_before_batch(), batch_run_timeout(), deassert_reset(), get_delay(), and riscv_scan_increase_delay().

riscv_scan_increase_delay()

static int riscv_scan_increase_delay ( struct riscv_scan_delays *  delays, enum riscv_scan_delay_class  delay_class  )

inlinestatic

Definition at line 105 of file batch.h.

References ERROR_FAIL, ERROR_OK, LOG_ERROR, riscv_scan_delay_class_name(), RISCV_SCAN_DELAY_MAX, riscv_scan_get_delay(), and riscv_scan_set_delay().

Referenced by increase_ac_busy_delay(), increase_dmi_busy_delay(), read_memory_bus_v1(), sample_memory_bus_v1(), and write_memory_bus_v1().

riscv_scan_set_delay()

static void riscv_scan_set_delay ( struct riscv_scan_delays *  delays, enum riscv_scan_delay_class  delay_class, unsigned int  delay  )

inlinestatic

Definition at line 82 of file batch.h.

References riscv_scan_delays::ac_delay, riscv_scan_delays::base_delay, LOG_DEBUG, RISCV_DELAY_ABSTRACT_COMMAND, RISCV_DELAY_BASE, RISCV_DELAY_SYSBUS_READ, RISCV_DELAY_SYSBUS_WRITE, riscv_scan_delay_class_name(), RISCV_SCAN_DELAY_MAX, riscv_scan_delays::sb_read_delay, and riscv_scan_delays::sb_write_delay.

Referenced by batch_run_timeout(), deassert_reset(), and riscv_scan_increase_delay().