hl_layout_api_s Struct Reference

Data Fields
int(*	assert_srst )(void *handle, int srst)
int(*	close )(void *handle)
int(*	config_trace )(void *handle, bool enabled, enum tpiu_pin_protocol pin_protocol, uint32_t port_size, unsigned int *trace_freq, unsigned int traceclkin_freq, uint16_t *prescaler)
	Configure trace parameters for the adapter. More...
int(*	custom_command )(void *handle, const char *command)
int(*	halt )(void *handle)
int(*	idcode )(void *handle, uint32_t *idcode)
	Read the idcode of the target connected to the adapter. More...
int(*	open )(struct hl_interface_param_s *param, void **handle)
int(*	override_target )(const char *targetname)
int(*	poll_trace )(void *handle, uint8_t *buf, size_t *size)
	Poll for new trace data. More...
int(*	read_mem )(void *handle, uint32_t addr, uint32_t size, uint32_t count, uint8_t *buffer)
int(*	read_reg )(void *handle, unsigned int regsel, uint32_t *val)
	Read one register from the target. More...
int(*	read_regs )(void *handle)
int(*	reset )(void *handle)
int(*	run )(void *handle)
int(*	speed )(void *handle, int khz, bool query)
enum target_state(*	state )(void *fd)
int(*	step )(void *handle)
int(*	write_debug_reg )(void *handle, uint32_t addr, uint32_t val)
int(*	write_mem )(void *handle, uint32_t addr, uint32_t size, uint32_t count, const uint8_t *buffer)
int(*	write_reg )(void *handle, unsigned int regsel, uint32_t val)
	Write one register to the target. More...

Detailed Description

Definition at line 27 of file hla_layout.h.

Field Documentation

assert_srst

int(* hl_layout_api_s::assert_srst) (void *handle, int srst)

Definition at line 35 of file hla_layout.h.

Referenced by hl_interface_reset().

close

int(* hl_layout_api_s::close) (void *handle)

Definition at line 31 of file hla_layout.h.

Referenced by hl_interface_quit().

config_trace

int(* hl_layout_api_s::config_trace) (void *handle, bool enabled, enum tpiu_pin_protocol pin_protocol, uint32_t port_size, unsigned int *trace_freq, unsigned int traceclkin_freq, uint16_t *prescaler)

Configure trace parameters for the adapter.

Parameters

handle	A handle to adapter
enabled	Whether to enable trace
pin_protocol	Configured pin protocol
port_size	Trace port width for sync mode
trace_freq	A pointer to the configured trace frequency; if it points to 0, the adapter driver must write its maximum supported rate there

Returns

ERROR_OK on success, an error code on failure.

Definition at line 100 of file hla_layout.h.

Referenced by hl_interface_config_trace().

custom_command

int(* hl_layout_api_s::custom_command) (void *handle, const char *command)

Definition at line 85 of file hla_layout.h.

Referenced by COMMAND_HANDLER().

halt

int(* hl_layout_api_s::halt) (void *handle)

Definition at line 39 of file hla_layout.h.

idcode

int(* hl_layout_api_s::idcode) (void *handle, uint32_t *idcode)

Read the idcode of the target connected to the adapter.

If the adapter doesn't support idcode retrieval, this callback should store 0 to indicate a wildcard match.

Parameters

handle	A pointer to the device-specific handle
idcode	Storage for the detected idcode

Returns

ERROR_OK on success, or an error code on failure.

Definition at line 81 of file hla_layout.h.

Referenced by hl_interface_init_target().

open

int(* hl_layout_api_s::open) (struct hl_interface_param_s *param, void **handle)

Definition at line 29 of file hla_layout.h.

override_target

int(* hl_layout_api_s::override_target) (const char *targetname)

Definition at line 83 of file hla_layout.h.

Referenced by hl_interface_override_target().

poll_trace

int(* hl_layout_api_s::poll_trace) (void *handle, uint8_t *buf, size_t *size)

Poll for new trace data.

Parameters

handle	A handle to adapter
buf	A pointer to buffer to store received data
size	A pointer to buffer size; must be filled with the actual amount of bytes written

Returns

ERROR_OK on success, an error code on failure.

Definition at line 114 of file hla_layout.h.

Referenced by hl_interface_poll_trace().

read_mem

int(* hl_layout_api_s::read_mem) (void *handle, uint32_t addr, uint32_t size, uint32_t count, uint8_t *buffer)

Definition at line 64 of file hla_layout.h.

Referenced by hl_dcc_read().

read_reg

int(* hl_layout_api_s::read_reg) (void *handle, unsigned int regsel, uint32_t *val)

Read one register from the target.

Parameters

handle	A pointer to the device-specific handle
regsel	Register selection index compatible with all the values allowed by armv7m DCRSR.REGSEL
val	A pointer to retrieve the register value

Returns

ERROR_OK on success, or an error code on failure.

Definition at line 53 of file hla_layout.h.

read_regs

int(* hl_layout_api_s::read_regs) (void *handle)

Definition at line 43 of file hla_layout.h.

reset

int(* hl_layout_api_s::reset) (void *handle)

Definition at line 33 of file hla_layout.h.

run

int(* hl_layout_api_s::run) (void *handle)

Definition at line 37 of file hla_layout.h.

speed

int(* hl_layout_api_s::speed) (void *handle, int khz, bool query)

Definition at line 87 of file hla_layout.h.

Referenced by hl_interface_khz(), and hl_interface_speed().

state

enum target_state(* hl_layout_api_s::state) (void *fd)

Definition at line 114 of file hla_layout.h.

step

int(* hl_layout_api_s::step) (void *handle)

Definition at line 41 of file hla_layout.h.

write_debug_reg

int(* hl_layout_api_s::write_debug_reg) (void *handle, uint32_t addr, uint32_t val)

Definition at line 70 of file hla_layout.h.

write_mem

int(* hl_layout_api_s::write_mem) (void *handle, uint32_t addr, uint32_t size, uint32_t count, const uint8_t *buffer)

Definition at line 67 of file hla_layout.h.

Referenced by hl_dcc_read().

write_reg

int(* hl_layout_api_s::write_reg) (void *handle, unsigned int regsel, uint32_t val)

Write one register to the target.

Parameters

handle	A pointer to the device-specific handle
regsel	Register selection index compatible with all the values allowed by armv7m DCRSR.REGSEL
val	The value to be written in the register

Returns

ERROR_OK on success, or an error code on failure.

Definition at line 62 of file hla_layout.h.

---

The documentation for this struct was generated from the following file:

• hla_layout.h