arm-jtag-ew.c File Reference

Include dependency graph for arm-jtag-ew.c:

Go to the source code of this file.

Data Structures
struct	armjtagew
struct	pending_scan_result

Macros
#define	ARMJTAGEW_EPT_BULK_IN   0x82u
#define	ARMJTAGEW_EPT_BULK_OUT   0x01u
#define	ARMJTAGEW_IN_BUFFER_SIZE   (4*1024)
#define	ARMJTAGEW_OUT_BUFFER_SIZE   (4*1024)
#define	ARMJTAGEW_TAP_BUFFER_SIZE   2048
#define	ARMJTAGEW_USB_TIMEOUT   2000
#define	CMD_GET_TAPHW_STATE   0x21
#define	CMD_GET_TCK_FREQUENCY   0x12
#define	CMD_GET_VERSION   0x00
#define	CMD_MEASURE_MAX_TCK_FREQ   0x15
#define	CMD_MEASURE_RTCK_RESPONSE   0x16
#define	CMD_SELECT_DPIMPL   0x10
#define	CMD_SET_TAPHW_STATE   0x20
#define	CMD_SET_TCK_FREQUENCY   0x11
#define	CMD_TAP_SHIFT   0x17
#define	CMD_TGPWR_SETUP   0x22
#define	MAX_PENDING_SCAN_RESULTS   256
#define	USB_PID   0x001e
#define	USB_VID   0x15ba

Functions
static void	armjtagew_end_state (tap_state_t state)
static int	armjtagew_execute_queue (struct jtag_command *cmd_queue)
static int	armjtagew_get_status (void)
static int	armjtagew_get_version_info (void)
static int	armjtagew_init (void)
static int	armjtagew_khz (int khz, int *jtag_speed)
static void	armjtagew_path_move (unsigned int num_states, tap_state_t *path)
static int	armjtagew_quit (void)
static void	armjtagew_reset (int trst, int srst)
static void	armjtagew_runtest (unsigned int num_cycles)
static void	armjtagew_scan (bool ir_scan, enum scan_type type, uint8_t *buffer, int scan_size, struct scan_command *command)
static int	armjtagew_speed (int speed)
static int	armjtagew_speed_div (int speed, int *khz)
static void	armjtagew_state_move (void)
static void	armjtagew_tap_append_scan (int length, uint8_t *buffer, struct scan_command *command)
static void	armjtagew_tap_append_step (int tms, int tdi)
static void	armjtagew_tap_ensure_space (int scans, int bits)
static int	armjtagew_tap_execute (void)
static void	armjtagew_tap_init (void)
static void	armjtagew_usb_close (struct armjtagew *armjtagew)
static int	armjtagew_usb_message (struct armjtagew *armjtagew, int out_length, int in_length)
static struct armjtagew *	armjtagew_usb_open (void)
static int	armjtagew_usb_read (struct armjtagew *armjtagew, int exp_in_length)
static int	armjtagew_usb_write (struct armjtagew *armjtagew, int out_length)
	COMMAND_HANDLER (armjtagew_handle_armjtagew_info_command)

Variables
struct adapter_driver	armjtagew_adapter_driver
static const struct command_registration	armjtagew_command_handlers []
static struct armjtagew *	armjtagew_handle
static struct jtag_interface	armjtagew_interface
static int	last_tms
static struct pending_scan_result	pending_scan_results_buffer [MAX_PENDING_SCAN_RESULTS]
static int	pending_scan_results_length
static int	tap_length
static uint8_t	tdi_buffer [ARMJTAGEW_TAP_BUFFER_SIZE]
static uint8_t	tdo_buffer [ARMJTAGEW_TAP_BUFFER_SIZE]
static uint8_t	tms_buffer [ARMJTAGEW_TAP_BUFFER_SIZE]
static uint8_t	usb_in_buffer [ARMJTAGEW_IN_BUFFER_SIZE]
static uint8_t	usb_out_buffer [ARMJTAGEW_OUT_BUFFER_SIZE]

Macro Definition Documentation

ARMJTAGEW_EPT_BULK_IN

#define ARMJTAGEW_EPT_BULK_IN   0x82u

Definition at line 21 of file arm-jtag-ew.c.

ARMJTAGEW_EPT_BULK_OUT

#define ARMJTAGEW_EPT_BULK_OUT   0x01u

Definition at line 20 of file arm-jtag-ew.c.

ARMJTAGEW_IN_BUFFER_SIZE

#define ARMJTAGEW_IN_BUFFER_SIZE   (4*1024)

Definition at line 25 of file arm-jtag-ew.c.

ARMJTAGEW_OUT_BUFFER_SIZE

#define ARMJTAGEW_OUT_BUFFER_SIZE   (4*1024)

Definition at line 26 of file arm-jtag-ew.c.

ARMJTAGEW_TAP_BUFFER_SIZE

#define ARMJTAGEW_TAP_BUFFER_SIZE   2048

Definition at line 505 of file arm-jtag-ew.c.

ARMJTAGEW_USB_TIMEOUT

#define ARMJTAGEW_USB_TIMEOUT   2000

Definition at line 23 of file arm-jtag-ew.c.

CMD_GET_TAPHW_STATE

#define CMD_GET_TAPHW_STATE   0x21

Definition at line 37 of file arm-jtag-ew.c.

CMD_GET_TCK_FREQUENCY

#define CMD_GET_TCK_FREQUENCY   0x12

Definition at line 32 of file arm-jtag-ew.c.

CMD_GET_VERSION

#define CMD_GET_VERSION   0x00

Definition at line 29 of file arm-jtag-ew.c.

CMD_MEASURE_MAX_TCK_FREQ

#define CMD_MEASURE_MAX_TCK_FREQ   0x15

Definition at line 33 of file arm-jtag-ew.c.

CMD_MEASURE_RTCK_RESPONSE

#define CMD_MEASURE_RTCK_RESPONSE   0x16

Definition at line 34 of file arm-jtag-ew.c.

CMD_SELECT_DPIMPL

#define CMD_SELECT_DPIMPL   0x10

Definition at line 30 of file arm-jtag-ew.c.

CMD_SET_TAPHW_STATE

#define CMD_SET_TAPHW_STATE   0x20

Definition at line 36 of file arm-jtag-ew.c.

CMD_SET_TCK_FREQUENCY

#define CMD_SET_TCK_FREQUENCY   0x11

Definition at line 31 of file arm-jtag-ew.c.

CMD_TAP_SHIFT

#define CMD_TAP_SHIFT   0x17

Definition at line 35 of file arm-jtag-ew.c.

CMD_TGPWR_SETUP

#define CMD_TGPWR_SETUP   0x22

Definition at line 38 of file arm-jtag-ew.c.

MAX_PENDING_SCAN_RESULTS

#define MAX_PENDING_SCAN_RESULTS   256

Definition at line 519 of file arm-jtag-ew.c.

USB_PID

#define USB_PID   0x001e

Definition at line 18 of file arm-jtag-ew.c.

USB_VID

#define USB_VID   0x15ba

Definition at line 17 of file arm-jtag-ew.c.

Function Documentation

armjtagew_end_state()

static void armjtagew_end_state ( tap_state_t  state )

static

Definition at line 256 of file arm-jtag-ew.c.

References LOG_ERROR, state, tap_is_state_stable(), and tap_set_end_state().

Referenced by armjtagew_execute_queue(), armjtagew_runtest(), and armjtagew_scan().

armjtagew_execute_queue()

static int armjtagew_execute_queue ( struct jtag_command *  cmd_queue )

static

Definition at line 88 of file arm-jtag-ew.c.

References armjtagew_end_state(), armjtagew_path_move(), armjtagew_reset(), armjtagew_runtest(), armjtagew_scan(), armjtagew_state_move(), armjtagew_tap_execute(), buffer, cmd, jtag_build_buffer(), JTAG_PATHMOVE, JTAG_RESET, JTAG_RUNTEST, JTAG_SCAN, jtag_scan_type(), JTAG_SLEEP, jtag_sleep(), JTAG_TLR_RESET, LOG_DEBUG_IO, LOG_ERROR, TAP_RESET, tap_set_state, and type.

armjtagew_get_status()

static int armjtagew_get_status ( void  )

static

Definition at line 399 of file arm-jtag-ew.c.

References armjtagew_handle, armjtagew_usb_message(), buf_get_u32(), CMD_GET_TAPHW_STATE, ERROR_OK, LOG_ERROR, LOG_INFO, usb_in_buffer, and usb_out_buffer.

Referenced by armjtagew_init().

armjtagew_get_version_info()

static int armjtagew_get_version_info ( void  )

static

Definition at line 426 of file arm-jtag-ew.c.

References armjtagew_handle, armjtagew_usb_message(), CMD_GET_VERSION, ERROR_JTAG_DEVICE_ERROR, ERROR_OK, LOG_ERROR, LOG_INFO, LOG_WARNING, usb_in_buffer, and usb_out_buffer.

Referenced by armjtagew_init().

armjtagew_init()

static int armjtagew_init ( void  )

static

Definition at line 210 of file arm-jtag-ew.c.

References armjtagew_get_status(), armjtagew_get_version_info(), armjtagew_handle, armjtagew_reset(), armjtagew_speed(), armjtagew_tap_init(), armjtagew_usb_open(), ERROR_JTAG_INIT_FAILED, ERROR_OK, LOG_ERROR, and LOG_INFO.

armjtagew_khz()

static int armjtagew_khz ( int  khz, int *  jtag_speed  )

static

Definition at line 196 of file arm-jtag-ew.c.

References ERROR_OK.

armjtagew_path_move()

static void armjtagew_path_move ( unsigned int  num_states, tap_state_t *  path  )

static

Definition at line 282 of file arm-jtag-ew.c.

References armjtagew_tap_append_step(), LOG_ERROR, tap_get_state(), tap_set_end_state(), tap_set_state, tap_state_name(), and tap_state_transition().

Referenced by armjtagew_execute_queue().

armjtagew_quit()

static int armjtagew_quit ( void  )

static

Definition at line 247 of file arm-jtag-ew.c.

References armjtagew_handle, armjtagew_usb_close(), and ERROR_OK.

armjtagew_reset()

static void armjtagew_reset ( int  trst, int  srst  )

static

Definition at line 359 of file arm-jtag-ew.c.

References armjtagew_handle, armjtagew_usb_write(), CMD_SET_TAPHW_STATE, LOG_DEBUG, LOG_ERROR, and usb_out_buffer.

Referenced by armjtagew_execute_queue(), and armjtagew_init().

armjtagew_runtest()

static void armjtagew_runtest ( unsigned int  num_cycles )

static

Definition at line 306 of file arm-jtag-ew.c.

References armjtagew_end_state(), armjtagew_state_move(), armjtagew_tap_append_step(), tap_get_end_state(), tap_get_state(), and TAP_IDLE.

Referenced by armjtagew_execute_queue().

armjtagew_scan()

static void armjtagew_scan ( bool  ir_scan, enum scan_type  type, uint8_t *  buffer, int  scan_size, struct scan_command *  command  )

static

Definition at line 326 of file arm-jtag-ew.c.

References armjtagew_end_state(), armjtagew_state_move(), armjtagew_tap_append_scan(), armjtagew_tap_append_step(), armjtagew_tap_ensure_space(), buffer, TAP_DRPAUSE, TAP_DRSHIFT, tap_get_end_state(), tap_get_state(), TAP_IRPAUSE, TAP_IRSHIFT, and tap_set_state.

Referenced by armjtagew_execute_queue().

armjtagew_speed()

static int armjtagew_speed ( int  speed )

static

Definition at line 168 of file arm-jtag-ew.c.

References armjtagew_handle, armjtagew_usb_message(), buf_get_u32(), buf_set_u32(), CMD_GET_TCK_FREQUENCY, CMD_SET_TCK_FREQUENCY, ERROR_JTAG_DEVICE_ERROR, ERROR_OK, LOG_ERROR, LOG_INFO, usb_in_buffer, and usb_out_buffer.

Referenced by armjtagew_init().

armjtagew_speed_div()

static int armjtagew_speed_div ( int  speed, int *  khz  )

static

Definition at line 203 of file arm-jtag-ew.c.

References ERROR_OK.

armjtagew_state_move()

static void armjtagew_state_move ( void  )

static

Definition at line 267 of file arm-jtag-ew.c.

References armjtagew_tap_append_step(), tap_get_end_state(), tap_get_state(), tap_get_tms_path(), tap_get_tms_path_len(), and tap_set_state.

Referenced by armjtagew_execute_queue(), armjtagew_runtest(), and armjtagew_scan().

armjtagew_tap_append_scan()

void armjtagew_tap_append_scan ( int  length, uint8_t *  buffer, struct scan_command *  command  )

static

Definition at line 565 of file arm-jtag-ew.c.

References armjtagew_tap_append_step(), pending_scan_result::buffer, buffer, pending_scan_result::command, pending_scan_result::first, pending_scan_result::length, length, pending_scan_results_buffer, pending_scan_results_length, and tap_length.

Referenced by armjtagew_scan().

armjtagew_tap_append_step()

static void armjtagew_tap_append_step ( int  tms, int  tdi  )

static

Definition at line 541 of file arm-jtag-ew.c.

References ARMJTAGEW_TAP_BUFFER_SIZE, bit(), last_tms, LOG_ERROR, tap_length, tdi_buffer, and tms_buffer.

Referenced by armjtagew_path_move(), armjtagew_runtest(), armjtagew_scan(), armjtagew_state_move(), armjtagew_tap_append_scan(), and armjtagew_tap_execute().

armjtagew_tap_ensure_space()

static void armjtagew_tap_ensure_space ( int  scans, int  bits  )

static

Definition at line 532 of file arm-jtag-ew.c.

References ARMJTAGEW_TAP_BUFFER_SIZE, armjtagew_tap_execute(), bits, MAX_PENDING_SCAN_RESULTS, pending_scan_results_length, and tap_length.

Referenced by armjtagew_scan().

armjtagew_tap_execute()

static int armjtagew_tap_execute ( void  )

static

Definition at line 583 of file arm-jtag-ew.c.

References armjtagew_handle, armjtagew_tap_append_step(), armjtagew_tap_init(), armjtagew_usb_message(), buf_get_u32(), buf_set_buf(), buf_set_u32(), pending_scan_result::buffer, buffer, CMD_TAP_SHIFT, pending_scan_result::command, ERROR_JTAG_QUEUE_FAILED, ERROR_OK, pending_scan_result::first, flip_u32(), jtag_read_buffer(), last_tms, pending_scan_result::length, length, LOG_DEBUG_IO, LOG_ERROR, pending_scan_results_buffer, pending_scan_results_length, tap_length, tdi_buffer, tdo_buffer, tms_buffer, usb_in_buffer, and usb_out_buffer.

Referenced by armjtagew_execute_queue(), and armjtagew_tap_ensure_space().

armjtagew_tap_init()

static void armjtagew_tap_init ( void  )

static

Definition at line 526 of file arm-jtag-ew.c.

References pending_scan_results_length, and tap_length.

Referenced by armjtagew_init(), and armjtagew_tap_execute().

armjtagew_usb_close()

static void armjtagew_usb_close ( struct armjtagew *  armjtagew )

static

Definition at line 700 of file arm-jtag-ew.c.

References armjtagew::usb_handle.

Referenced by armjtagew_quit().

armjtagew_usb_message()

static int armjtagew_usb_message ( struct armjtagew *  armjtagew, int  out_length, int  in_length  )

static

Definition at line 707 of file arm-jtag-ew.c.

References armjtagew_usb_read(), armjtagew_usb_write(), and LOG_ERROR.

Referenced by armjtagew_get_status(), armjtagew_get_version_info(), armjtagew_speed(), and armjtagew_tap_execute().

armjtagew_usb_open()

static struct armjtagew * armjtagew_usb_open ( void  )

static

Definition at line 670 of file arm-jtag-ew.c.

References config, ERROR_OK, jtag_libusb_open(), NULL, armjtagew::usb_handle, USB_PID, and USB_VID.

Referenced by armjtagew_init().

armjtagew_usb_read()

static int armjtagew_usb_read ( struct armjtagew *  armjtagew, int  exp_in_length  )

static

Definition at line 754 of file arm-jtag-ew.c.

References ARMJTAGEW_EPT_BULK_IN, ARMJTAGEW_USB_TIMEOUT, ERROR_OK, jtag_libusb_bulk_read(), LOG_DEBUG_IO, armjtagew::usb_handle, and usb_in_buffer.

Referenced by armjtagew_usb_message().

armjtagew_usb_write()

static int armjtagew_usb_write ( struct armjtagew *  armjtagew, int  out_length  )

static

Definition at line 728 of file arm-jtag-ew.c.

References ARMJTAGEW_EPT_BULK_OUT, ARMJTAGEW_OUT_BUFFER_SIZE, ARMJTAGEW_USB_TIMEOUT, ERROR_OK, jtag_libusb_bulk_write(), LOG_DEBUG_IO, LOG_ERROR, armjtagew::usb_handle, and usb_out_buffer.

Referenced by armjtagew_reset(), and armjtagew_usb_message().

COMMAND_HANDLER()

COMMAND_HANDLER

(

armjtagew_handle_armjtagew_info_command

)

Definition at line 462 of file arm-jtag-ew.c.

Variable Documentation

armjtagew_adapter_driver

struct adapter_driver armjtagew_adapter_driver

Initial value:

= {
    .name = "arm-jtag-ew",
    .transports = jtag_only,
    .commands = armjtagew_command_handlers,
 
    .init = armjtagew_init,
    .quit = armjtagew_quit,
    .speed = armjtagew_speed,
    .khz = armjtagew_khz,
    .speed_div = armjtagew_speed_div,
 
    .jtag_ops = &armjtagew_interface,
}

Definition at line 462 of file arm-jtag-ew.c.

armjtagew_command_handlers

const struct command_registration armjtagew_command_handlers[]

static

Initial value:

= {
    {
        .name = "armjtagew_info",
        .handler = &armjtagew_handle_armjtagew_info_command,
        .mode = COMMAND_EXEC,
        .help = "query armjtagew info",
        .usage = "",
    },
    COMMAND_REGISTRATION_DONE
}

Definition at line 462 of file arm-jtag-ew.c.

armjtagew_handle

struct armjtagew* armjtagew_handle

static

Definition at line 83 of file arm-jtag-ew.c.

Referenced by armjtagew_get_status(), armjtagew_get_version_info(), armjtagew_init(), armjtagew_quit(), armjtagew_reset(), armjtagew_speed(), and armjtagew_tap_execute().

armjtagew_interface

struct jtag_interface armjtagew_interface

static

Initial value:

= {
    .execute_queue = armjtagew_execute_queue,
}

Definition at line 462 of file arm-jtag-ew.c.

last_tms

int last_tms

static

Definition at line 524 of file arm-jtag-ew.c.

Referenced by armjtagew_tap_append_step(), armjtagew_tap_execute(), linuxgpiod_write(), and sysfsgpio_write().

pending_scan_results_buffer

struct pending_scan_result pending_scan_results_buffer[MAX_PENDING_SCAN_RESULTS]

static

Definition at line 521 of file arm-jtag-ew.c.

Referenced by armjtagew_tap_append_scan(), and armjtagew_tap_execute().

pending_scan_results_length

int pending_scan_results_length

static

Definition at line 521 of file arm-jtag-ew.c.

Referenced by armjtagew_tap_append_scan(), armjtagew_tap_ensure_space(), armjtagew_tap_execute(), and armjtagew_tap_init().

tap_length

int tap_length

static

Definition at line 507 of file arm-jtag-ew.c.

Referenced by armjtagew_tap_append_scan(), armjtagew_tap_append_step(), armjtagew_tap_ensure_space(), armjtagew_tap_execute(), and armjtagew_tap_init().

tdi_buffer

uint8_t tdi_buffer[ARMJTAGEW_TAP_BUFFER_SIZE]

static

Definition at line 509 of file arm-jtag-ew.c.

Referenced by angie_queue_scan(), armjtagew_tap_append_step(), armjtagew_tap_execute(), jtag_debug_state_machine_(), and ulink_queue_scan().

tdo_buffer

uint8_t tdo_buffer[ARMJTAGEW_TAP_BUFFER_SIZE]

static

Definition at line 510 of file arm-jtag-ew.c.

Referenced by angie_queue_scan(), armjtagew_tap_execute(), cmsis_dap_add_jtag_sequence(), and ulink_queue_scan().

tms_buffer

uint8_t tms_buffer[ARMJTAGEW_TAP_BUFFER_SIZE]

static

Definition at line 508 of file arm-jtag-ew.c.

Referenced by armjtagew_tap_append_step(), armjtagew_tap_execute(), and jtag_debug_state_machine_().

usb_in_buffer

uint8_t usb_in_buffer[ARMJTAGEW_IN_BUFFER_SIZE]

static

Definition at line 41 of file arm-jtag-ew.c.

Referenced by armjtagew_get_status(), armjtagew_get_version_info(), armjtagew_speed(), armjtagew_tap_execute(), and armjtagew_usb_read().

usb_out_buffer

uint8_t usb_out_buffer[ARMJTAGEW_OUT_BUFFER_SIZE]

static

Definition at line 42 of file arm-jtag-ew.c.

Referenced by armjtagew_get_status(), armjtagew_get_version_info(), armjtagew_reset(), armjtagew_speed(), armjtagew_tap_execute(), and armjtagew_usb_write().