OpenOCD
Functions | Variables
etb.c File Reference
Include dependency graph for etb.c:

Go to the source code of this file.

Functions

 COMMAND_HANDLER (handle_etb_config_command)
 
 COMMAND_HANDLER (handle_etb_trigger_percent_command)
 
struct reg_cache * etb_build_reg_cache (struct etb *etb)
 
static int etb_get_reg (struct reg *reg)
 
static void etb_getbuf (jtag_callback_data_t arg)
 
static int etb_init (struct etm_context *etm_ctx)
 
static int etb_read_ram (struct etb *etb, uint32_t *data, int num_frames)
 
static int etb_read_reg (struct reg *reg)
 
static int etb_read_reg_w_check (struct reg *, uint8_t *, uint8_t *)
 
static int etb_read_trace (struct etm_context *etm_ctx)
 
static int etb_scann (struct etb *etb, uint32_t new_scan_chain)
 
static int etb_set_instr (struct etb *etb, uint32_t new_instr)
 
static int etb_set_reg (struct reg *reg, uint32_t value)
 
static int etb_set_reg_w_exec (struct reg *, uint8_t *)
 
static int etb_start_capture (struct etm_context *etm_ctx)
 
static trace_status_t etb_status (struct etm_context *etm_ctx)
 
static int etb_stop_capture (struct etm_context *etm_ctx)
 
static int etb_write_reg (struct reg *, uint32_t)
 

Variables

struct etm_capture_driver etb_capture_driver
 
static const struct command_registration etb_command_handlers []
 
static const struct command_registration etb_config_command_handlers []
 
static const char *const etb_reg_list []
 
static const struct reg_arch_type etb_reg_type
 

Function Documentation

◆ COMMAND_HANDLER() [1/2]

COMMAND_HANDLER ( handle_etb_config_command  )

Definition at line 318 of file etb.c.

References etm_context::capture_driver_priv, CMD, CMD_ARGC, CMD_ARGV, command_print(), etb::cur_scan_chain, ERROR_COMMAND_SYNTAX_ERROR, ERROR_FAIL, ERROR_OK, arm::etm, get_target(), is_arm(), jtag_tap_by_string(), LOG_ERROR, NULL, etb::ram_depth, etb::ram_width, etb::reg_cache, etb::tap, target, and target_to_arm().

◆ COMMAND_HANDLER() [2/2]

COMMAND_HANDLER ( handle_etb_trigger_percent_command  )

Definition at line 364 of file etb.c.

References etm_context::capture_driver, etm_context::capture_driver_priv, CMD, CMD_ARGC, CMD_ARGV, CMD_CTX, COMMAND_PARSE_NUMBER, command_print(), ERROR_FAIL, ERROR_OK, etb_capture_driver, arm::etm, get_current_target(), is_arm(), target, target_to_arm(), and etb::trigger_percent.

◆ etb_build_reg_cache()

struct reg_cache* etb_build_reg_cache ( struct etb *  etb)

Definition at line 113 of file etb.c.

References etb_reg::addr, reg::arch_info, reg::dirty, etb_reg::etb, etb_reg_list, etb_reg_type, reg::name, reg_cache::name, reg_cache::next, NULL, reg_cache::num_regs, reg_cache::reg_list, reg::size, reg::type, reg::valid, and reg::value.

Referenced by etm_build_reg_cache().

◆ etb_get_reg()

static int etb_get_reg ( struct reg *  reg)
static

Definition at line 89 of file etb.c.

References ERROR_OK, etb_read_reg(), jtag_execute_queue(), and LOG_ERROR.

Referenced by etb_status().

◆ etb_getbuf()

static void etb_getbuf ( jtag_callback_data_t  arg)
static

Definition at line 148 of file etb.c.

References buf_get_u32().

Referenced by etb_read_ram().

◆ etb_init()

static int etb_init ( struct etm_context *  etm_ctx)
static

Definition at line 438 of file etb.c.

References buf_get_u32(), etm_context::capture_driver_priv, ERROR_OK, ETB_RAM_DEPTH, ETB_RAM_WIDTH, etb_read_reg(), etb::etm_ctx, jtag_execute_queue(), etb::ram_depth, etb::ram_width, etb::reg_cache, reg_cache::reg_list, etb::trigger_percent, and reg::value.

◆ etb_read_ram()

static int etb_read_ram ( struct etb *  etb,
uint32_t *  data,
int  num_frames 
)
static

Definition at line 155 of file etb.c.

References buf_set_u32(), ERROR_OK, etb_getbuf(), etb_scann(), etb_set_instr(), scan_field::in_value, jtag_add_callback(), jtag_add_dr_scan(), jtag_execute_queue(), NULL, scan_field::num_bits, scan_field::out_value, etb::tap, and TAP_IDLE.

Referenced by etb_read_trace().

◆ etb_read_reg()

static int etb_read_reg ( struct reg *  reg)
static

Definition at line 84 of file etb.c.

References etb_read_reg_w_check(), and NULL.

Referenced by etb_get_reg(), etb_init(), etb_read_trace(), and etb_status().

◆ etb_read_reg_w_check()

static int etb_read_reg_w_check ( struct reg *  reg,
uint8_t *  check_value,
uint8_t *  check_mask 
)
static

Definition at line 202 of file etb.c.

References etb_reg::addr, reg::arch_info, buf_set_u32(), scan_field::check_mask, scan_field::check_value, ERROR_OK, etb_reg::etb, etb_scann(), etb_set_instr(), scan_field::in_value, jtag_add_dr_scan(), jtag_add_dr_scan_check(), LOG_DEBUG, NULL, scan_field::num_bits, scan_field::out_value, etb::tap, TAP_IDLE, and reg::value.

Referenced by etb_read_reg().

◆ etb_read_trace()

static int etb_read_trace ( struct etm_context *  etm_ctx)
static

Definition at line 509 of file etb.c.

References buf_get_u32(), etm_context::capture_driver_priv, etm_context::control, ERROR_OK, ETB_RAM_READ_POINTER, ETB_RAM_WRITE_POINTER, etb_read_ram(), etb_read_reg(), ETB_STATUS, etb_write_reg(), etb::etm_ctx, ETM_PORT_4BIT, ETM_PORT_8BIT, ETM_PORT_WIDTH_MASK, ETMV1_TRACESYNC_CYCLE, ETMV1_TRIGGER_CYCLE, etmv1_trace_data::flags, jtag_execute_queue(), NULL, etmv1_trace_data::packet, etmv1_trace_data::pipestat, etb::ram_depth, etb::reg_cache, reg_cache::reg_list, STAT_TR, etm_context::trace_data, etm_context::trace_depth, and reg::value.

◆ etb_scann()

static int etb_scann ( struct etb *  etb,
uint32_t  new_scan_chain 
)
static

Definition at line 57 of file etb.c.

References buf_set_u32(), etb::cur_scan_chain, DIV_ROUND_UP, ERROR_OK, etb_set_instr(), scan_field::in_value, jtag_add_dr_scan(), NULL, scan_field::num_bits, scan_field::out_value, etb::tap, and TAP_IDLE.

Referenced by etb_read_ram(), etb_read_reg_w_check(), and etb_write_reg().

◆ etb_set_instr()

static int etb_set_instr ( struct etb *  etb,
uint32_t  new_instr 
)
static

Definition at line 31 of file etb.c.

References buf_get_u32(), buf_set_u32(), jtag_tap::cur_instr, DIV_ROUND_UP, ERROR_FAIL, ERROR_OK, scan_field::in_value, jtag_tap::ir_length, jtag_add_ir_scan(), NULL, scan_field::num_bits, scan_field::out_value, etb::tap, and TAP_IDLE.

Referenced by etb_read_ram(), etb_read_reg_w_check(), etb_scann(), and etb_write_reg().

◆ etb_set_reg()

static int etb_set_reg ( struct reg *  reg,
uint32_t  value 
)
static

Definition at line 253 of file etb.c.

References buf_set_u32(), reg::dirty, ERROR_OK, etb_write_reg(), LOG_ERROR, reg::size, reg::valid, and reg::value.

Referenced by etb_set_reg_w_exec().

◆ etb_set_reg_w_exec()

static int etb_set_reg_w_exec ( struct reg *  reg,
uint8_t *  buf 
)
static

Definition at line 270 of file etb.c.

References buf_get_u32(), ERROR_OK, etb_set_reg(), jtag_execute_queue(), LOG_ERROR, and reg::size.

◆ etb_start_capture()

static int etb_start_capture ( struct etm_context *  etm_ctx)
static

Definition at line 639 of file etb.c.

References etm_context::capture_driver_priv, etm_context::capture_status, etm_context::control, ERROR_ETM_PORTMODE_NOT_SUPPORTED, ERROR_OK, ETB_CTRL, ETB_RAM_WRITE_POINTER, ETB_TRIGGER_COUNTER, etb_write_reg(), etb::etm_ctx, ETM_PORT_8BIT, ETM_PORT_DEMUXED, ETM_PORT_MODE_MASK, ETM_PORT_MUXED, ETM_PORT_WIDTH_MASK, jtag_execute_queue(), LOG_ERROR, etb::ram_depth, etb::reg_cache, reg_cache::reg_list, TRACE_RUNNING, and etb::trigger_percent.

◆ etb_status()

static trace_status_t etb_status ( struct etm_context *  etm_ctx)
static

Definition at line 457 of file etb.c.

References buf_get_u32(), etm_context::capture_driver_priv, etm_context::capture_status, ETB_CTRL, etb_get_reg(), etb_read_reg(), ETB_STATUS, etb::etm_ctx, jtag_execute_queue(), LOG_ERROR, LOG_WARNING, etb::reg_cache, reg_cache::reg_list, status, TRACE_COMPLETED, TRACE_IDLE, TRACE_OVERFLOWED, TRACE_RUNNING, TRACE_TRIGGERED, and reg::value.

◆ etb_stop_capture()

static int etb_stop_capture ( struct etm_context *  etm_ctx)
static

Definition at line 671 of file etb.c.

◆ etb_write_reg()

static int etb_write_reg ( struct reg *  reg,
uint32_t  value 
)
static

Definition at line 284 of file etb.c.

References etb_reg::addr, reg::arch_info, buf_set_u32(), ERROR_OK, etb_reg::etb, etb_scann(), etb_set_instr(), scan_field::in_value, jtag_add_dr_scan(), LOG_DEBUG, NULL, scan_field::num_bits, scan_field::out_value, etb::tap, and TAP_IDLE.

Referenced by etb_read_trace(), etb_set_reg(), and etb_start_capture().

Variable Documentation

◆ etb_capture_driver

struct etm_capture_driver etb_capture_driver
Initial value:
= {
.name = "etb",
.commands = etb_command_handlers,
.init = etb_init,
.status = etb_status,
.start_capture = etb_start_capture,
.stop_capture = etb_stop_capture,
.read_trace = etb_read_trace,
}
etb_stop_capture
static int etb_stop_capture(struct etm_context *etm_ctx)
Definition: etb.c:671
etb_command_handlers
static const struct command_registration etb_command_handlers[]
Definition: etb.c:427
etb_read_trace
static int etb_read_trace(struct etm_context *etm_ctx)
Definition: etb.c:509
etb_init
static int etb_init(struct etm_context *etm_ctx)
Definition: etb.c:438
etb_status
static trace_status_t etb_status(struct etm_context *etm_ctx)
Definition: etb.c:457
etb_start_capture
static int etb_start_capture(struct etm_context *etm_ctx)
Definition: etb.c:639

Definition at line 671 of file etb.c.

Referenced by COMMAND_HANDLER().

◆ etb_command_handlers

const struct command_registration etb_command_handlers[]
static
Initial value:
= {
{
.name = "etb",
.mode = COMMAND_ANY,
.help = "Embedded Trace Buffer command group",
.chain = etb_config_command_handlers,
.usage = "",
},
COMMAND_REGISTRATION_DONE
}
COMMAND_REGISTRATION_DONE
#define COMMAND_REGISTRATION_DONE
Use this as the last entry in an array of command_registration records.
Definition: command.h:247
COMMAND_ANY
@ COMMAND_ANY
Definition: command.h:42
etb_config_command_handlers
static const struct command_registration etb_config_command_handlers[]
Definition: etb.c:406
command_registration::usage
const char * usage
a string listing the options and arguments, required or optional
Definition: command.h:235

Definition at line 364 of file etb.c.

◆ etb_config_command_handlers

const struct command_registration etb_config_command_handlers[]
static
Initial value:
= {
{
.name = "config",
.handler = handle_etb_config_command,
.mode = COMMAND_CONFIG,
.help = "Associate ETB with target and JTAG TAP.",
.usage = "target tap",
},
{
.name = "trigger_percent",
.handler = handle_etb_trigger_percent_command,
.mode = COMMAND_EXEC,
.help = "Set percent of trace buffer to be filled "
"after the trigger occurs (2..100).",
.usage = "[percent]",
},
COMMAND_REGISTRATION_DONE
}
COMMAND_CONFIG
@ COMMAND_CONFIG
Definition: command.h:41
COMMAND_EXEC
@ COMMAND_EXEC
Definition: command.h:40

Definition at line 364 of file etb.c.

◆ etb_reg_list

const char* const etb_reg_list[]
static
Initial value:
= {
"ETB_identification",
"ETB_ram_depth",
"ETB_ram_width",
"ETB_status",
"ETB_ram_data",
"ETB_ram_read_pointer",
"ETB_ram_write_pointer",
"ETB_trigger_counter",
"ETB_control",
}

Definition at line 17 of file etb.c.

Referenced by etb_build_reg_cache().

◆ etb_reg_type

const struct reg_arch_type etb_reg_type
static
Initial value:
= {
.get = etb_get_reg,
.set = etb_set_reg_w_exec,
}
etb_set_reg_w_exec
static int etb_set_reg_w_exec(struct reg *, uint8_t *)
Definition: etb.c:270
etb_get_reg
static int etb_get_reg(struct reg *reg)
Definition: etb.c:89

Definition at line 89 of file etb.c.

Referenced by etb_build_reg_cache().