OpenOCD
Data Structures | Macros | Functions | Variables
esp32_apptrace.c File Reference
Include dependency graph for esp32_apptrace.c:

Go to the source code of this file.

Data Structures

struct  esp32_apptrace_block
 
struct  esp32_apptrace_dest_file_data
 
struct  esp32_apptrace_dest_tcp_data
 
struct  esp32_apptrace_target_state
 
struct  esp_apptrace_target2host_hdr
 

Macros

#define APPTRACE_BLOCK_SIZE_OFFSET   0
 
#define APPTRACE_WR_SIZE_OFFSET   2
 
#define ESP32_APPTRACE_CMD_NUM_ARG_CHECK(_cmd_, _arg_, _start_, _end_)
 
#define ESP32_APPTRACE_TGT_STATE_TMO   5000
 
#define ESP32_APPTRACE_USER_BLOCK_CORE(_v_)   ((_v_) >> 15)
 
#define ESP32_APPTRACE_USER_BLOCK_HDR_SZ   4
 
#define ESP32_APPTRACE_USER_BLOCK_LEN(_v_)   ((_v_) & ~BIT(15))
 
#define ESP_APPTRACE_BLOCKS_POOL_SZ   10
 
#define ESP_APPTRACE_CMD_MODE_GEN   0
 
#define ESP_APPTRACE_CMD_MODE_SYNC   3
 
#define ESP_APPTRACE_CMD_MODE_SYSVIEW   1
 
#define ESP_APPTRACE_CMD_MODE_SYSVIEW_MCORE   2
 

Functions

 COMMAND_HANDLER (esp32_cmd_apptrace)
 
 COMMAND_HANDLER (esp32_cmd_sysview)
 
 COMMAND_HANDLER (esp32_cmd_sysview_mcore)
 
static int esp32_apptrace_block_free (struct esp32_apptrace_cmd_ctx *ctx, struct esp32_apptrace_block *block)
 
static void esp32_apptrace_blocks_pool_cleanup (struct esp32_apptrace_cmd_ctx *ctx)
 
static int esp32_apptrace_check_connection (struct esp32_apptrace_cmd_ctx *ctx)
 
void esp32_apptrace_cmd_args_parse (struct esp32_apptrace_cmd_ctx *cmd_ctx, struct esp32_apptrace_cmd_data *cmd_data, const char **argv, int argc)
 
static int esp32_apptrace_cmd_cleanup (struct esp32_apptrace_cmd_ctx *cmd_ctx)
 
int esp32_apptrace_cmd_ctx_cleanup (struct esp32_apptrace_cmd_ctx *cmd_ctx)
 
int esp32_apptrace_cmd_ctx_init (struct esp32_apptrace_cmd_ctx *cmd_ctx, struct command_invocation *cmd, int mode)
 
static int esp32_apptrace_cmd_init (struct esp32_apptrace_cmd_ctx *cmd_ctx, struct command_invocation *cmd, int mode, const char **argv, int argc)
 
static void esp32_apptrace_cmd_stop (struct esp32_apptrace_cmd_ctx *ctx)
 
static int esp32_apptrace_connect_targets (struct esp32_apptrace_cmd_ctx *ctx, bool conn, bool resume_target)
 
static int esp32_apptrace_console_dest_cleanup (void *priv)
 
static int esp32_apptrace_console_dest_init (struct esp32_apptrace_dest *dest, const char *dest_name)
 
static int esp32_apptrace_console_dest_write (void *priv, uint8_t *data, int size)
 
static int esp32_apptrace_core_id_get (struct target *target, uint8_t *hdr_buf)
 
static int esp32_apptrace_data_processor (void *priv)
 
int esp32_apptrace_dest_cleanup (struct esp32_apptrace_dest dest[], unsigned int max_dests)
 
int esp32_apptrace_dest_init (struct esp32_apptrace_dest dest[], const char *dest_paths[], unsigned int max_dests)
 
static int esp32_apptrace_file_dest_cleanup (void *priv)
 
static int esp32_apptrace_file_dest_init (struct esp32_apptrace_dest *dest, const char *dest_name)
 
static int esp32_apptrace_file_dest_write (void *priv, uint8_t *data, int size)
 
static struct esp32_apptrace_block * esp32_apptrace_free_block_get (struct esp32_apptrace_cmd_ctx *ctx)
 
static int esp32_apptrace_get_data_info (struct esp32_apptrace_cmd_ctx *ctx, struct esp32_apptrace_target_state *target_state, uint32_t *fired_target_num)
 
static int esp32_apptrace_handle_trace_block (struct esp32_apptrace_cmd_ctx *ctx, struct esp32_apptrace_block *block)
 
static int esp32_apptrace_poll (void *priv)
 
static void esp32_apptrace_print_stats (struct esp32_apptrace_cmd_ctx *ctx)
 
static int esp32_apptrace_process_data (struct esp32_apptrace_cmd_ctx *ctx, unsigned int core_id, uint8_t *data, uint32_t data_len)
 
static struct esp32_apptrace_block * esp32_apptrace_ready_block_get (struct esp32_apptrace_cmd_ctx *ctx)
 
static int esp32_apptrace_ready_block_put (struct esp32_apptrace_cmd_ctx *ctx, struct esp32_apptrace_block *block)
 
static int esp32_apptrace_safe_halt_targets (struct esp32_apptrace_cmd_ctx *ctx, struct esp32_apptrace_target_state *targets)
 
static int esp32_apptrace_tcp_dest_cleanup (void *priv)
 
static int esp32_apptrace_tcp_dest_init (struct esp32_apptrace_dest *dest, const char *dest_name)
 
static int esp32_apptrace_tcp_dest_write (void *priv, uint8_t *data, int size)
 
static uint32_t esp32_apptrace_usr_block_check (struct esp32_apptrace_cmd_ctx *ctx, uint8_t *hdr_buf)
 
static uint32_t esp32_apptrace_usr_block_len_get (struct target *target, uint8_t *hdr_buf, uint32_t *wr_len)
 
static int esp32_apptrace_wait4halt (struct esp32_apptrace_cmd_ctx *ctx, struct target *target)
 
static int esp32_apptrace_wait_tracing_finished (struct esp32_apptrace_cmd_ctx *ctx)
 
static int esp32_cmd_apptrace_generic (struct command_invocation *cmd, int mode, const char **argv, int argc)
 
static int esp32_sysview_start (struct esp32_apptrace_cmd_ctx *ctx)
 
static int esp32_sysview_stop (struct esp32_apptrace_cmd_ctx *ctx)
 
int esp_apptrace_usr_block_write (const struct esp32_apptrace_hw *hw, struct target *target, uint32_t block_id, const uint8_t *data, uint32_t size)
 
static bool is_sysview_mode (int mode)
 

Variables

const struct command_registration esp32_apptrace_command_handlers []
 
static const bool s_time_stats_enable = true
 

Macro Definition Documentation

◆ APPTRACE_BLOCK_SIZE_OFFSET

#define APPTRACE_BLOCK_SIZE_OFFSET   0

Definition at line 69 of file esp32_apptrace.c.

◆ APPTRACE_WR_SIZE_OFFSET

#define APPTRACE_WR_SIZE_OFFSET   2

Definition at line 70 of file esp32_apptrace.c.

◆ ESP32_APPTRACE_CMD_NUM_ARG_CHECK

#define ESP32_APPTRACE_CMD_NUM_ARG_CHECK (   _cmd_,
  _arg_,
  _start_,
  _end_ 
)
Value:
do { \
if ((_arg_) == 0 && (_start_) == (_end_)) { \
command_print(_cmd_, "Invalid '" # _arg_ "' arg!"); \
return; \
} \
} while (0)

Definition at line 506 of file esp32_apptrace.c.

◆ ESP32_APPTRACE_TGT_STATE_TMO

#define ESP32_APPTRACE_TGT_STATE_TMO   5000

Definition at line 48 of file esp32_apptrace.c.

◆ ESP32_APPTRACE_USER_BLOCK_CORE

#define ESP32_APPTRACE_USER_BLOCK_CORE (   _v_)    ((_v_) >> 15)

Definition at line 38 of file esp32_apptrace.c.

◆ ESP32_APPTRACE_USER_BLOCK_HDR_SZ

#define ESP32_APPTRACE_USER_BLOCK_HDR_SZ   4

Definition at line 41 of file esp32_apptrace.c.

◆ ESP32_APPTRACE_USER_BLOCK_LEN

#define ESP32_APPTRACE_USER_BLOCK_LEN (   _v_)    ((_v_) & ~BIT(15))

Definition at line 39 of file esp32_apptrace.c.

◆ ESP_APPTRACE_BLOCKS_POOL_SZ

#define ESP_APPTRACE_BLOCKS_POOL_SZ   10

Definition at line 49 of file esp32_apptrace.c.

◆ ESP_APPTRACE_CMD_MODE_GEN

#define ESP_APPTRACE_CMD_MODE_GEN   0

Definition at line 43 of file esp32_apptrace.c.

◆ ESP_APPTRACE_CMD_MODE_SYNC

#define ESP_APPTRACE_CMD_MODE_SYNC   3

Definition at line 46 of file esp32_apptrace.c.

◆ ESP_APPTRACE_CMD_MODE_SYSVIEW

#define ESP_APPTRACE_CMD_MODE_SYSVIEW   1

Definition at line 44 of file esp32_apptrace.c.

◆ ESP_APPTRACE_CMD_MODE_SYSVIEW_MCORE

#define ESP_APPTRACE_CMD_MODE_SYSVIEW_MCORE   2

Definition at line 45 of file esp32_apptrace.c.

Function Documentation

◆ COMMAND_HANDLER() [1/3]

COMMAND_HANDLER ( esp32_cmd_apptrace  )

Definition at line 1591 of file esp32_apptrace.c.

References CMD, CMD_ARGC, CMD_ARGV, esp32_cmd_apptrace_generic(), and ESP_APPTRACE_CMD_MODE_GEN.

◆ COMMAND_HANDLER() [2/3]

COMMAND_HANDLER ( esp32_cmd_sysview  )

Definition at line 1596 of file esp32_apptrace.c.

References CMD, CMD_ARGC, CMD_ARGV, esp32_cmd_apptrace_generic(), and ESP_APPTRACE_CMD_MODE_SYSVIEW.

◆ COMMAND_HANDLER() [3/3]

COMMAND_HANDLER ( esp32_cmd_sysview_mcore  )

Definition at line 1601 of file esp32_apptrace.c.

References CMD, CMD_ARGC, CMD_ARGV, esp32_cmd_apptrace_generic(), and ESP_APPTRACE_CMD_MODE_SYSVIEW_MCORE.

◆ esp32_apptrace_block_free()

static int esp32_apptrace_block_free ( struct esp32_apptrace_cmd_ctx *  ctx,
struct esp32_apptrace_block *  block 
)
static

Definition at line 375 of file esp32_apptrace.c.

References ERROR_OK, esp32_apptrace_cmd_ctx::free_trace_blocks, INIT_LIST_HEAD(), list_add(), and esp32_apptrace_block::node.

Referenced by esp32_apptrace_data_processor(), and esp32_apptrace_poll().

◆ esp32_apptrace_blocks_pool_cleanup()

static void esp32_apptrace_blocks_pool_cleanup ( struct esp32_apptrace_cmd_ctx *  ctx)
static

Definition at line 311 of file esp32_apptrace.c.

References esp32_apptrace_block::data, esp32_apptrace_cmd_ctx::free_trace_blocks, list_del(), list_entry, list_for_each_safe, esp32_apptrace_block::node, and esp32_apptrace_cmd_ctx::ready_trace_blocks.

Referenced by esp32_apptrace_cmd_ctx_cleanup(), and esp32_apptrace_cmd_ctx_init().

◆ esp32_apptrace_check_connection()

static int esp32_apptrace_check_connection ( struct esp32_apptrace_cmd_ctx *  ctx)
static

Definition at line 967 of file esp32_apptrace.c.

References conn, esp32_apptrace_cmd_ctx::cores_num, esp32_apptrace_cmd_ctx::cpus, esp32_apptrace_hw::ctrl_reg_read, esp32_apptrace_hw::ctrl_reg_write, duration_start(), ERROR_FAIL, ERROR_OK, ERROR_WAIT, esp32_apptrace_cmd_ctx::hw, esp32_apptrace_cmd_ctx::idle_time, LOG_ERROR, LOG_TARGET_WARNING, LOG_WARNING, NULL, esp32_apptrace_hw::status_reg_read, and esp32_apptrace_cmd_ctx::stop_tmo.

Referenced by esp32_apptrace_poll().

◆ esp32_apptrace_cmd_args_parse()

void esp32_apptrace_cmd_args_parse ( struct esp32_apptrace_cmd_ctx *  cmd_ctx,
struct esp32_apptrace_cmd_data *  cmd_data,
const char **  argv,
int  argc 
)

Definition at line 514 of file esp32_apptrace.c.

References esp32_apptrace_cmd_ctx::cmd, ESP32_APPTRACE_CMD_NUM_ARG_CHECK, esp32_apptrace_cmd_data::max_len, esp32_apptrace_cmd_data::poll_period, esp32_apptrace_cmd_data::skip_len, esp32_apptrace_cmd_ctx::stop_tmo, and esp32_apptrace_cmd_data::wait4halt.

Referenced by esp32_apptrace_cmd_init(), and esp32_sysview_cmd_init().

◆ esp32_apptrace_cmd_cleanup()

static int esp32_apptrace_cmd_cleanup ( struct esp32_apptrace_cmd_ctx *  cmd_ctx)
static

Definition at line 607 of file esp32_apptrace.c.

References esp32_apptrace_cmd_ctx::cmd_priv, esp32_apptrace_cmd_data::data_dest, ERROR_OK, esp32_apptrace_cmd_ctx_cleanup(), esp32_apptrace_dest_cleanup(), and NULL.

Referenced by esp32_apptrace_cmd_stop(), and esp32_cmd_apptrace_generic().

◆ esp32_apptrace_cmd_ctx_cleanup()

int esp32_apptrace_cmd_ctx_cleanup ( struct esp32_apptrace_cmd_ctx *  cmd_ctx)

Definition at line 500 of file esp32_apptrace.c.

References ERROR_OK, and esp32_apptrace_blocks_pool_cleanup().

Referenced by esp32_apptrace_cmd_cleanup(), esp32_apptrace_cmd_ctx_init(), esp32_apptrace_cmd_init(), esp32_sysview_cmd_cleanup(), and esp32_sysview_cmd_init().

◆ esp32_apptrace_cmd_ctx_init()

int esp32_apptrace_cmd_ctx_init ( struct esp32_apptrace_cmd_ctx *  cmd_ctx,
struct command_invocation *  cmd,
int  mode 
)

Definition at line 404 of file esp32_apptrace.c.

References esp_xtensa_common::apptrace, target::arch_info, cmd, esp32_apptrace_cmd_ctx::cmd, CMD_CTX, command_print(), xtensa::common_magic, esp32_apptrace_cmd_ctx::cores_num, esp32_apptrace_cmd_ctx::cpus, esp32_apptrace_block::data, duration_start(), ERROR_FAIL, ERROR_OK, esp32_apptrace_blocks_pool_cleanup(), esp32_apptrace_cmd_ctx_cleanup(), esp32_apptrace_data_processor(), ESP32_APPTRACE_MAX_CORES_NUM, ESP_APPTRACE_BLOCKS_POOL_SZ, ESP_APPTRACE_CMD_MODE_SYNC, foreach_smp_target, esp32_apptrace_cmd_ctx::free_trace_blocks, get_current_target(), esp32_apptrace_cmd_ctx::hw, esp_xtensa_apptrace_info::hw, esp32_apptrace_cmd_ctx::idle_time, INIT_LIST_HEAD(), list_add(), LOG_INFO, esp32_apptrace_hw::max_block_size_get, esp32_apptrace_cmd_ctx::max_trace_block_sz, esp32_apptrace_cmd_stats::min_blk_proc_time, esp32_apptrace_cmd_stats::min_blk_read_time, mode, esp32_apptrace_cmd_ctx::mode, esp32_apptrace_block::node, esp32_apptrace_cmd_ctx::ready_trace_blocks, esp32_apptrace_cmd_ctx::running, s_time_stats_enable, target::smp, target::smp_targets, target::state, esp32_apptrace_cmd_ctx::stats, target, esp32_apptrace_cmd_ctx::target, target_list::target, target_register_timer_callback(), esp32_apptrace_cmd_ctx::target_state, TARGET_TIMER_TYPE_PERIODIC, target_to_esp_xtensa(), target_was_examined(), and XTENSA_COMMON_MAGIC.

Referenced by esp32_apptrace_cmd_init(), and esp32_sysview_cmd_init().

◆ esp32_apptrace_cmd_init()

static int esp32_apptrace_cmd_init ( struct esp32_apptrace_cmd_ctx *  cmd_ctx,
struct command_invocation *  cmd,
int  mode,
const char **  argv,
int  argc 
)
static

Definition at line 553 of file esp32_apptrace.c.

References cmd, esp32_apptrace_cmd_ctx::cmd_priv, command_print(), esp32_apptrace_format::core_id_get, esp32_apptrace_cmd_ctx::cores_num, esp32_apptrace_cmd_data::data_dest, ERROR_FAIL, ERROR_OK, esp32_apptrace_cmd_args_parse(), esp32_apptrace_cmd_ctx_cleanup(), esp32_apptrace_cmd_ctx_init(), esp32_apptrace_core_id_get(), esp32_apptrace_dest_init(), ESP32_APPTRACE_USER_BLOCK_HDR_SZ, esp32_apptrace_usr_block_len_get(), esp32_apptrace_format::hdr_sz, LOG_USER, esp32_apptrace_cmd_data::max_len, mode, esp32_apptrace_cmd_data::poll_period, esp32_apptrace_cmd_ctx::running, esp32_apptrace_cmd_data::skip_len, esp32_apptrace_cmd_ctx::stop_tmo, esp32_apptrace_cmd_ctx::trace_format, esp32_apptrace_format::usr_block_len_get, and esp32_apptrace_cmd_data::wait4halt.

Referenced by esp32_cmd_apptrace_generic().

◆ esp32_apptrace_cmd_stop()

static void esp32_apptrace_cmd_stop ( struct esp32_apptrace_cmd_ctx *  ctx)
static

Definition at line 1224 of file esp32_apptrace.c.

References duration_measure(), ERROR_OK, esp32_apptrace_cmd_cleanup(), esp32_apptrace_connect_targets(), esp32_apptrace_poll(), esp32_apptrace_print_stats(), esp32_apptrace_wait_tracing_finished(), esp32_sysview_stop(), is_sysview_mode(), LOG_ERROR, esp32_apptrace_cmd_ctx::mode, esp32_apptrace_cmd_ctx::read_time, TARGET_RUNNING, esp32_apptrace_cmd_ctx::target_state, and target_unregister_timer_callback().

Referenced by esp32_cmd_apptrace_generic().

◆ esp32_apptrace_connect_targets()

static int esp32_apptrace_connect_targets ( struct esp32_apptrace_cmd_ctx *  ctx,
bool  conn,
bool  resume_target 
)
static

Definition at line 753 of file esp32_apptrace.c.

References esp32_apptrace_target_state::block_id, esp32_apptrace_cmd_ctx::cmd, command_print(), conn, esp32_apptrace_cmd_ctx::cores_num, esp32_apptrace_cmd_ctx::cpus, esp32_apptrace_hw::ctrl_reg_write, ERROR_OK, ESP32_APPTRACE_MAX_CORES_NUM, esp32_apptrace_safe_halt_targets(), esp32_apptrace_cmd_ctx::hw, LOG_DEBUG, LOG_INFO, LOG_USER, target::smp, and target_resume().

Referenced by esp32_apptrace_cmd_stop(), and esp32_cmd_apptrace_generic().

◆ esp32_apptrace_console_dest_cleanup()

static int esp32_apptrace_console_dest_cleanup ( void *  priv)
static

Definition at line 148 of file esp32_apptrace.c.

References ERROR_OK.

Referenced by esp32_apptrace_console_dest_init().

◆ esp32_apptrace_console_dest_init()

static int esp32_apptrace_console_dest_init ( struct esp32_apptrace_dest *  dest,
const char *  dest_name 
)
static

Definition at line 153 of file esp32_apptrace.c.

References esp32_apptrace_dest::clean, ERROR_OK, esp32_apptrace_console_dest_cleanup(), esp32_apptrace_console_dest_write(), esp32_apptrace_dest::log_progress, NULL, esp32_apptrace_dest::priv, and esp32_apptrace_dest::write.

Referenced by esp32_apptrace_dest_init().

◆ esp32_apptrace_console_dest_write()

static int esp32_apptrace_console_dest_write ( void *  priv,
uint8_t *  data,
int  size 
)
static

Definition at line 142 of file esp32_apptrace.c.

References ERROR_OK, LOG_USER_N, and size.

Referenced by esp32_apptrace_console_dest_init().

◆ esp32_apptrace_core_id_get()

static int esp32_apptrace_core_id_get ( struct target *  target,
uint8_t *  hdr_buf 
)
static

Definition at line 542 of file esp32_apptrace.c.

References APPTRACE_BLOCK_SIZE_OFFSET, ESP32_APPTRACE_USER_BLOCK_CORE, and target_buffer_get_u16().

Referenced by esp32_apptrace_cmd_init().

◆ esp32_apptrace_data_processor()

static int esp32_apptrace_data_processor ( void *  priv)
static

Definition at line 940 of file esp32_apptrace.c.

References esp32_apptrace_block::data_len, ERROR_OK, esp32_apptrace_block_free(), esp32_apptrace_handle_trace_block(), esp32_apptrace_ready_block_get(), LOG_ERROR, priv, and esp32_apptrace_cmd_ctx::running.

Referenced by esp32_apptrace_cmd_ctx_init(), and esp32_apptrace_wait_tracing_finished().

◆ esp32_apptrace_dest_cleanup()

int esp32_apptrace_dest_cleanup ( struct esp32_apptrace_dest  dest[],
unsigned int  max_dests 
)

Definition at line 296 of file esp32_apptrace.c.

References esp32_apptrace_dest::clean, ERROR_OK, NULL, priv, and esp32_apptrace_dest::priv.

Referenced by esp32_apptrace_cmd_cleanup(), esp32_sysview_cmd_cleanup(), and esp32_sysview_cmd_init().

◆ esp32_apptrace_dest_init()

int esp32_apptrace_dest_init ( struct esp32_apptrace_dest  dest[],
const char *  dest_paths[],
unsigned int  max_dests 
)

Definition at line 272 of file esp32_apptrace.c.

References ERROR_OK, esp32_apptrace_console_dest_init(), esp32_apptrace_file_dest_init(), esp32_apptrace_tcp_dest_init(), LOG_ERROR, and NULL.

Referenced by esp32_apptrace_cmd_init(), and esp32_sysview_cmd_init().

◆ esp32_apptrace_file_dest_cleanup()

static int esp32_apptrace_file_dest_cleanup ( void *  priv)
static

Definition at line 108 of file esp32_apptrace.c.

References ERROR_OK, esp32_apptrace_dest_file_data::fout, and priv.

Referenced by esp32_apptrace_file_dest_init().

◆ esp32_apptrace_file_dest_init()

static int esp32_apptrace_file_dest_init ( struct esp32_apptrace_dest *  dest,
const char *  dest_name 
)
static

Definition at line 118 of file esp32_apptrace.c.

References esp32_apptrace_dest::clean, ERROR_FAIL, ERROR_OK, esp32_apptrace_file_dest_cleanup(), esp32_apptrace_file_dest_write(), esp32_apptrace_dest_file_data::fout, LOG_ERROR, LOG_INFO, esp32_apptrace_dest::log_progress, O_BINARY, esp32_apptrace_dest::priv, and esp32_apptrace_dest::write.

Referenced by esp32_apptrace_dest_init().

◆ esp32_apptrace_file_dest_write()

static int esp32_apptrace_file_dest_write ( void *  priv,
uint8_t *  data,
int  size 
)
static

Definition at line 96 of file esp32_apptrace.c.

References ERROR_FAIL, ERROR_OK, esp32_apptrace_dest_file_data::fout, LOG_ERROR, priv, and size.

Referenced by esp32_apptrace_file_dest_init().

◆ esp32_apptrace_free_block_get()

struct esp32_apptrace_block * esp32_apptrace_free_block_get ( struct esp32_apptrace_cmd_ctx *  ctx)
static

Definition at line 338 of file esp32_apptrace.c.

References esp32_apptrace_cmd_ctx::free_trace_blocks, list_del(), list_empty(), list_first_entry, esp32_apptrace_block::node, and NULL.

Referenced by esp32_apptrace_poll(), and esp32_sysview_stop().

◆ esp32_apptrace_get_data_info()

int esp32_apptrace_get_data_info ( struct esp32_apptrace_cmd_ctx *  ctx,
struct esp32_apptrace_target_state *  target_state,
uint32_t *  fired_target_num 
)
static

Definition at line 850 of file esp32_apptrace.c.

References esp32_apptrace_cmd_ctx::cores_num, esp32_apptrace_cmd_ctx::cpus, esp32_apptrace_hw::data_len_read, ERROR_OK, esp32_apptrace_cmd_ctx::hw, LOG_ERROR, LOG_TARGET_DEBUG, and target_name().

Referenced by esp32_apptrace_poll(), esp32_sysview_start(), and esp32_sysview_stop().

◆ esp32_apptrace_handle_trace_block()

static int esp32_apptrace_handle_trace_block ( struct esp32_apptrace_cmd_ctx *  ctx,
struct esp32_apptrace_block *  block 
)
static

Definition at line 916 of file esp32_apptrace.c.

References esp32_apptrace_format::core_id_get, esp32_apptrace_block::data, esp32_apptrace_block::data_len, ERROR_OK, esp32_apptrace_usr_block_check(), esp32_apptrace_format::hdr_sz, LOG_DEBUG, LOG_ERROR, esp32_apptrace_cmd_ctx::process_data, esp32_apptrace_cmd_ctx::target, and esp32_apptrace_cmd_ctx::trace_format.

Referenced by esp32_apptrace_data_processor(), esp32_apptrace_poll(), and esp32_sysview_stop().

◆ esp32_apptrace_poll()

static int esp32_apptrace_poll ( void *  priv)
static

Definition at line 1019 of file esp32_apptrace.c.

References esp32_apptrace_cmd_ctx::auto_clean, esp32_apptrace_cmd_ctx::cores_num, esp32_apptrace_cmd_ctx::cpus, esp32_apptrace_hw::ctrl_reg_write, esp32_apptrace_block::data, esp32_apptrace_block::data_len, esp32_apptrace_hw::data_read, duration_elapsed(), duration_measure(), duration_start(), ERROR_FAIL, ERROR_OK, ERROR_WAIT, esp32_apptrace_block_free(), esp32_apptrace_check_connection(), esp32_apptrace_free_block_get(), esp32_apptrace_get_data_info(), esp32_apptrace_handle_trace_block(), ESP32_APPTRACE_MAX_CORES_NUM, esp32_apptrace_ready_block_put(), ESP_APPTRACE_CMD_MODE_SYNC, esp32_apptrace_cmd_ctx::hw, esp32_apptrace_cmd_ctx::idle_time, esp32_apptrace_cmd_ctx::last_blk_id, LOG_ERROR, LOG_TARGET_DEBUG, LOG_TARGET_ERROR, esp32_apptrace_cmd_stats::max_blk_proc_time, esp32_apptrace_cmd_stats::max_blk_read_time, esp32_apptrace_hw::max_block_id, esp32_apptrace_cmd_ctx::max_trace_block_sz, esp32_apptrace_cmd_stats::min_blk_proc_time, esp32_apptrace_cmd_stats::min_blk_read_time, esp32_apptrace_cmd_ctx::mode, priv, esp32_apptrace_cmd_ctx::raw_tot_len, esp32_apptrace_cmd_ctx::read_time, esp32_apptrace_cmd_ctx::running, s_time_stats_enable, esp32_apptrace_cmd_ctx::stats, esp32_apptrace_cmd_ctx::stop_tmo, and esp32_apptrace_cmd_ctx::tot_len.

Referenced by esp32_apptrace_cmd_stop(), and esp32_cmd_apptrace_generic().

◆ esp32_apptrace_print_stats()

static void esp32_apptrace_print_stats ( struct esp32_apptrace_cmd_ctx *  ctx)
static

Definition at line 618 of file esp32_apptrace.c.

References esp32_apptrace_cmd_ctx::cmd_priv, duration_kbps(), esp32_apptrace_cmd_stats::incompl_blocks, LOG_USER, esp32_apptrace_cmd_stats::lost_bytes, esp32_apptrace_cmd_stats::max_blk_proc_time, esp32_apptrace_cmd_stats::max_blk_read_time, esp32_apptrace_cmd_data::max_len, esp32_apptrace_cmd_stats::min_blk_proc_time, esp32_apptrace_cmd_stats::min_blk_read_time, esp32_apptrace_cmd_ctx::raw_tot_len, esp32_apptrace_cmd_ctx::read_time, esp32_apptrace_cmd_ctx::running, s_time_stats_enable, esp32_apptrace_cmd_data::skip_len, esp32_apptrace_cmd_ctx::stats, and esp32_apptrace_cmd_ctx::tot_len.

Referenced by esp32_apptrace_cmd_stop(), and esp32_cmd_apptrace_generic().

◆ esp32_apptrace_process_data()

static int esp32_apptrace_process_data ( struct esp32_apptrace_cmd_ctx *  ctx,
unsigned int  core_id,
uint8_t *  data,
uint32_t  data_len 
)
static

Definition at line 874 of file esp32_apptrace.c.

References esp32_apptrace_cmd_ctx::cmd_priv, esp32_apptrace_cmd_data::data_dest, duration_measure(), ERROR_FAIL, ERROR_OK, LOG_DEBUG, LOG_ERROR, esp32_apptrace_dest::log_progress, LOG_USER, esp32_apptrace_cmd_data::max_len, esp32_apptrace_dest::priv, esp32_apptrace_cmd_ctx::read_time, esp32_apptrace_cmd_ctx::running, esp32_apptrace_cmd_data::skip_len, esp32_apptrace_cmd_ctx::tot_len, and esp32_apptrace_dest::write.

Referenced by esp32_cmd_apptrace_generic().

◆ esp32_apptrace_ready_block_get()

static struct esp32_apptrace_block* esp32_apptrace_ready_block_get ( struct esp32_apptrace_cmd_ctx *  ctx)
static

Definition at line 361 of file esp32_apptrace.c.

References list_del(), list_empty(), list_last_entry, esp32_apptrace_block::node, NULL, and esp32_apptrace_cmd_ctx::ready_trace_blocks.

Referenced by esp32_apptrace_data_processor().

◆ esp32_apptrace_ready_block_put()

static int esp32_apptrace_ready_block_put ( struct esp32_apptrace_cmd_ctx *  ctx,
struct esp32_apptrace_block *  block 
)
static

Definition at line 351 of file esp32_apptrace.c.

References ERROR_OK, INIT_LIST_HEAD(), list_add(), LOG_DEBUG, esp32_apptrace_block::node, and esp32_apptrace_cmd_ctx::ready_trace_blocks.

Referenced by esp32_apptrace_poll().

◆ esp32_apptrace_safe_halt_targets()

int esp32_apptrace_safe_halt_targets ( struct esp32_apptrace_cmd_ctx *  ctx,
struct esp32_apptrace_target_state *  targets 
)
static

Definition at line 660 of file esp32_apptrace.c.

References BKPT_HARD, esp32_apptrace_target_state::block_id, breakpoint_add(), breakpoint_remove(), esp32_apptrace_cmd_ctx::cores_num, esp32_apptrace_cmd_ctx::cpus, esp32_apptrace_target_state::data_len, esp32_apptrace_hw::data_len_read, DBG_REASON_BREAKPOINT, DBG_REASON_UNDEFINED, target::debug_reason, ERROR_OK, ESP32_APPTRACE_TGT_STATE_TMO, esp32_apptrace_cmd_ctx::hw, esp32_apptrace_hw::leave_trace_crit_section_start, esp32_apptrace_hw::leave_trace_crit_section_stop, LOG_DEBUG, LOG_ERROR, target::state, esp32_apptrace_hw::status_reg_read, target_halt(), TARGET_HALTED, target_name(), target_resume(), target_wait_state(), and target_was_examined().

Referenced by esp32_apptrace_connect_targets(), and esp32_sysview_stop().

◆ esp32_apptrace_tcp_dest_cleanup()

static int esp32_apptrace_tcp_dest_cleanup ( void *  priv)
static

Definition at line 174 of file esp32_apptrace.c.

References close_socket(), ERROR_OK, priv, and esp32_apptrace_dest_tcp_data::sockfd.

Referenced by esp32_apptrace_tcp_dest_init().

◆ esp32_apptrace_tcp_dest_init()

static int esp32_apptrace_tcp_dest_init ( struct esp32_apptrace_dest *  dest,
const char *  dest_name 
)
static

Definition at line 184 of file esp32_apptrace.c.

References esp32_apptrace_dest::clean, close_socket(), ERROR_COMMAND_ARGUMENT_INVALID, ERROR_FAIL, ERROR_OK, esp32_apptrace_tcp_dest_cleanup(), esp32_apptrace_tcp_dest_write(), LOG_DEBUG, LOG_ERROR, LOG_INFO, esp32_apptrace_dest::log_progress, LOG_WARNING, esp32_apptrace_dest::priv, sockfd, esp32_apptrace_dest_tcp_data::sockfd, and esp32_apptrace_dest::write.

Referenced by esp32_apptrace_dest_init().

◆ esp32_apptrace_tcp_dest_write()

static int esp32_apptrace_tcp_dest_write ( void *  priv,
uint8_t *  data,
int  size 
)
static

Definition at line 163 of file esp32_apptrace.c.

References ERROR_FAIL, ERROR_OK, LOG_ERROR, priv, size, esp32_apptrace_dest_tcp_data::sockfd, and write_socket().

Referenced by esp32_apptrace_tcp_dest_init().

◆ esp32_apptrace_usr_block_check()

static uint32_t esp32_apptrace_usr_block_check ( struct esp32_apptrace_cmd_ctx *  ctx,
uint8_t *  hdr_buf 
)
static

Definition at line 838 of file esp32_apptrace.c.

References esp32_apptrace_cmd_stats::incompl_blocks, LOG_ERROR, esp32_apptrace_cmd_stats::lost_bytes, esp32_apptrace_cmd_ctx::stats, esp32_apptrace_cmd_ctx::target, esp32_apptrace_cmd_ctx::trace_format, and esp32_apptrace_format::usr_block_len_get.

Referenced by esp32_apptrace_handle_trace_block().

◆ esp32_apptrace_usr_block_len_get()

static uint32_t esp32_apptrace_usr_block_len_get ( struct target *  target,
uint8_t *  hdr_buf,
uint32_t *  wr_len 
)
static

Definition at line 547 of file esp32_apptrace.c.

References APPTRACE_BLOCK_SIZE_OFFSET, APPTRACE_WR_SIZE_OFFSET, ESP32_APPTRACE_USER_BLOCK_LEN, and target_buffer_get_u16().

Referenced by esp32_apptrace_cmd_init().

◆ esp32_apptrace_wait4halt()

static int esp32_apptrace_wait4halt ( struct esp32_apptrace_cmd_ctx *  ctx,
struct target *  target 
)
static

Definition at line 644 of file esp32_apptrace.c.

References alive_sleep(), target::cmd_name, ERROR_OK, LOG_USER, openocd_is_shutdown_pending(), target::state, TARGET_HALTED, and target_poll().

Referenced by esp32_cmd_apptrace_generic().

◆ esp32_apptrace_wait_tracing_finished()

static int esp32_apptrace_wait_tracing_finished ( struct esp32_apptrace_cmd_ctx *  ctx)
static

Definition at line 384 of file esp32_apptrace.c.

References alive_sleep(), ERROR_FAIL, ERROR_OK, esp32_apptrace_data_processor(), list_empty(), LOG_ERROR, LOG_LEVEL_IS, LOG_LVL_DEBUG, esp32_apptrace_cmd_ctx::ready_trace_blocks, esp32_apptrace_cmd_ctx::running, target_unregister_timer_callback(), and timeval_ms().

Referenced by esp32_apptrace_cmd_stop(), and esp32_cmd_apptrace_generic().

◆ esp32_cmd_apptrace_generic()

static int esp32_cmd_apptrace_generic ( struct command_invocation *  cmd,
int  mode,
const char **  argv,
int  argc 
)
static

Definition at line 1434 of file esp32_apptrace.c.

References esp32_apptrace_cmd_ctx::auto_clean, cmd, CMD_CTX, esp32_apptrace_cmd_ctx::cmd_priv, command_print(), duration_measure(), ERROR_COMMAND_SYNTAX_ERROR, ERROR_FAIL, ERROR_OK, esp32_apptrace_cmd_cleanup(), esp32_apptrace_cmd_init(), esp32_apptrace_cmd_stop(), esp32_apptrace_connect_targets(), esp32_apptrace_poll(), esp32_apptrace_print_stats(), esp32_apptrace_process_data(), esp32_apptrace_wait4halt(), esp32_apptrace_wait_tracing_finished(), esp32_sysview_cmd_cleanup(), esp32_sysview_cmd_init(), esp32_sysview_process_data(), esp32_sysview_start(), ESP_APPTRACE_CMD_MODE_SYSVIEW_MCORE, foreach_smp_target, get_current_target(), is_sysview_mode(), LOG_ERROR, LOG_WARNING, mode, openocd_is_shutdown_pending(), esp32_apptrace_cmd_data::poll_period, esp32_apptrace_cmd_ctx::process_data, esp32_apptrace_cmd_ctx::read_time, esp32_apptrace_cmd_ctx::running, esp32_apptrace_cmd_data::skip_len, target::smp, target::smp_targets, target::state, esp32_apptrace_cmd_ctx::stop_tmo, target_list::target, target_call_timer_callbacks(), target_name(), target_register_timer_callback(), TARGET_RUNNING, TARGET_TIMER_TYPE_PERIODIC, target_was_examined(), and esp32_apptrace_cmd_data::wait4halt.

Referenced by COMMAND_HANDLER().

◆ esp32_sysview_start()

static int esp32_sysview_start ( struct esp32_apptrace_cmd_ctx *  ctx)
static

Definition at line 1251 of file esp32_apptrace.c.

References esp32_apptrace_cmd_ctx::cmd_priv, esp32_apptrace_cmd_ctx::cpus, ERROR_OK, esp32_apptrace_get_data_info(), ESP32_APPTRACE_MAX_CORES_NUM, esp_apptrace_usr_block_write(), esp32_apptrace_cmd_ctx::hw, LOG_ERROR, SEGGER_SYSVIEW_COMMAND_ID_START, and esp32_sysview_cmd_data::sv_trace_running.

Referenced by esp32_cmd_apptrace_generic().

◆ esp32_sysview_stop()

static int esp32_sysview_stop ( struct esp32_apptrace_cmd_ctx *  ctx)
static

Definition at line 1280 of file esp32_apptrace.c.

References esp32_apptrace_cmd_ctx::cmd_priv, esp32_apptrace_cmd_ctx::cores_num, esp32_apptrace_cmd_ctx::cpus, esp32_apptrace_hw::ctrl_reg_write, esp32_apptrace_block::data, esp32_apptrace_block::data_len, esp32_apptrace_hw::data_read, duration_elapsed(), duration_measure(), duration_start(), ERROR_FAIL, ERROR_OK, esp32_apptrace_free_block_get(), esp32_apptrace_get_data_info(), esp32_apptrace_handle_trace_block(), ESP32_APPTRACE_MAX_CORES_NUM, esp32_apptrace_safe_halt_targets(), esp_apptrace_usr_block_write(), esp32_apptrace_cmd_ctx::hw, LOG_ERROR, LOG_INFO, LOG_LEVEL_IS, LOG_LVL_DEBUG, SEGGER_SYSVIEW_COMMAND_ID_STOP, target::smp, esp32_sysview_cmd_data::sv_trace_running, target_name(), and target_resume().

Referenced by esp32_apptrace_cmd_stop().

◆ esp_apptrace_usr_block_write()

int esp_apptrace_usr_block_write ( const struct esp32_apptrace_hw *  hw,
struct target *  target,
uint32_t  block_id,
const uint8_t *  data,
uint32_t  size 
)

Definition at line 815 of file esp32_apptrace.c.

References ARRAY_SIZE, esp_apptrace_host2target_hdr::block_sz, esp32_apptrace_hw::buffs_write, ERROR_FAIL, LOG_ERROR, size, and esp32_apptrace_hw::usr_block_max_size_get.

Referenced by esp32_sysview_start(), esp32_sysview_stop(), and esp_xtensa_apptrace_usr_block_write().

◆ is_sysview_mode()

static bool is_sysview_mode ( int  mode)
inlinestatic

Definition at line 1219 of file esp32_apptrace.c.

References ESP_APPTRACE_CMD_MODE_SYSVIEW, ESP_APPTRACE_CMD_MODE_SYSVIEW_MCORE, and mode.

Referenced by esp32_apptrace_cmd_stop(), and esp32_cmd_apptrace_generic().

Variable Documentation

◆ esp32_apptrace_command_handlers

const struct command_registration esp32_apptrace_command_handlers[]
Initial value:
= {
{
.name = "apptrace",
.handler = esp32_cmd_apptrace,
.mode = COMMAND_EXEC,
.help =
"App Tracing: application level trace control. Starts, stops or queries tracing process status.",
.usage =
"(start <destination> [poll_period [trace_size [stop_tmo [wait4halt [skip_size]]]]) | (stop) | (status) | (dump <destination>)",
},
{
.name = "sysview",
.handler = esp32_cmd_sysview,
.mode = COMMAND_EXEC,
.help =
"App Tracing: SEGGER SystemView compatible trace control. Starts, stops or queries tracing process status.",
.usage =
"(start file://<outfile1> [file://<outfile2>] [poll_period [trace_size [stop_tmo [wait4halt [skip_size]]]]) | (stop) | (status)",
},
{
.name = "sysview_mcore",
.handler = esp32_cmd_sysview_mcore,
.mode = COMMAND_EXEC,
.help =
"App Tracing: Espressif multi-core SystemView trace control. Starts, stops or queries tracing process status.",
.usage =
"(start file://<outfile> [poll_period [trace_size [stop_tmo [wait4halt [skip_size]]]]) | (stop) | (status)",
},
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:253
COMMAND_EXEC
@ COMMAND_EXEC
Definition: command.h:40

Definition at line 1601 of file esp32_apptrace.c.

◆ s_time_stats_enable

const bool s_time_stats_enable = true
static

Definition at line 90 of file esp32_apptrace.c.

Referenced by esp32_apptrace_cmd_ctx_init(), esp32_apptrace_poll(), and esp32_apptrace_print_stats().