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

Go to the source code of this file.

Data Structures

struct  cmsis_dap_backend_data
 

Macros

#define CMSIS_DAP_PACKET_SIZE   1024
 
#define CMSIS_DAP_TCP_PORT   4441
 
#define DAP_PKT_HDR_SIGNATURE   0x00504144
 
#define DAP_PKT_TYPE_REQUEST   0x01
 
#define DAP_PKT_TYPE_RESPONSE   0x02
 
#define DEFAULT_MIN_TIMEOUT_MS   150
 
#define HEADER_LENGTH_OFFSET   sizeof(uint32_t)
 
#define HEADER_PACKET_TYPE_OFFSET   (sizeof(uint32_t) + sizeof(uint16_t))
 
#define HEADER_RESERVED_OFFSET
 
#define HEADER_SIGNATURE_OFFSET   0
 
#define HEADER_SIZE
 
#define STRINGIFY(x)   #x
 

Functions

struct __attribute__ ((packed))
 
static int cmsis_dap_tcp_alloc (struct cmsis_dap *dap, unsigned int pkt_sz)
 
static void cmsis_dap_tcp_cancel_all (struct cmsis_dap *dap)
 
static void cmsis_dap_tcp_close (struct cmsis_dap *dap)
 
static void cmsis_dap_tcp_free (struct cmsis_dap *dap)
 
static int cmsis_dap_tcp_open (struct cmsis_dap *dap, uint16_t vids[] __attribute__((unused)), uint16_t pids[] __attribute__((unused)), const char *serial __attribute__((unused)))
 
static int cmsis_dap_tcp_read (struct cmsis_dap *dap, int transfer_timeout_ms, enum cmsis_dap_blocking blocking)
 
static int cmsis_dap_tcp_write (struct cmsis_dap *dap, int txlen, int timeout_ms __attribute__((unused)))
 
 COMMAND_HANDLER (cmsis_dap_handle_tcp_host)
 
 COMMAND_HANDLER (cmsis_dap_handle_tcp_min_timeout)
 
 COMMAND_HANDLER (cmsis_dap_handle_tcp_port)
 
static int peekall_socket (int handle, void *buffer, unsigned int count)
 
static int readall_socket (int handle, void *buffer, unsigned int count)
 

Variables

const struct cmsis_dap_backend cmsis_dap_tcp_backend
 
static char * cmsis_dap_tcp_host
 
static int cmsis_dap_tcp_min_timeout_ms = DEFAULT_MIN_TIMEOUT_MS
 
static char * cmsis_dap_tcp_port = cmsis_dap_tcp_port_default
 
static char *const cmsis_dap_tcp_port_default = STRINGIFY(CMSIS_DAP_TCP_PORT)
 
const struct command_registration cmsis_dap_tcp_subcommand_handlers []
 

Macro Definition Documentation

◆ CMSIS_DAP_PACKET_SIZE

#define CMSIS_DAP_PACKET_SIZE   1024

Definition at line 51 of file cmsis_dap_tcp.c.

◆ CMSIS_DAP_TCP_PORT

#define CMSIS_DAP_TCP_PORT   4441

Definition at line 50 of file cmsis_dap_tcp.c.

◆ DAP_PKT_HDR_SIGNATURE

#define DAP_PKT_HDR_SIGNATURE   0x00504144

Definition at line 46 of file cmsis_dap_tcp.c.

◆ DAP_PKT_TYPE_REQUEST

#define DAP_PKT_TYPE_REQUEST   0x01

Definition at line 47 of file cmsis_dap_tcp.c.

◆ DAP_PKT_TYPE_RESPONSE

#define DAP_PKT_TYPE_RESPONSE   0x02

Definition at line 48 of file cmsis_dap_tcp.c.

◆ DEFAULT_MIN_TIMEOUT_MS

#define DEFAULT_MIN_TIMEOUT_MS   150

Definition at line 63 of file cmsis_dap_tcp.c.

◆ HEADER_LENGTH_OFFSET

#define HEADER_LENGTH_OFFSET   sizeof(uint32_t)

Definition at line 81 of file cmsis_dap_tcp.c.

◆ HEADER_PACKET_TYPE_OFFSET

#define HEADER_PACKET_TYPE_OFFSET   (sizeof(uint32_t) + sizeof(uint16_t))

Definition at line 82 of file cmsis_dap_tcp.c.

◆ HEADER_RESERVED_OFFSET

#define HEADER_RESERVED_OFFSET
Value:
(sizeof(uint32_t) + sizeof(uint16_t) + \
sizeof(uint8_t))

Definition at line 83 of file cmsis_dap_tcp.c.

◆ HEADER_SIGNATURE_OFFSET

#define HEADER_SIGNATURE_OFFSET   0

Definition at line 80 of file cmsis_dap_tcp.c.

◆ HEADER_SIZE

#define HEADER_SIZE
Value:
(sizeof(uint32_t) + sizeof(uint16_t) + \
2 * sizeof(uint8_t))

Definition at line 85 of file cmsis_dap_tcp.c.

◆ STRINGIFY

#define STRINGIFY (   x)    #x

Definition at line 43 of file cmsis_dap_tcp.c.

Function Documentation

◆ __attribute__()

struct __attribute__ ( (packed)  )

Definition at line 1 of file cmsis_dap_tcp.c.

◆ cmsis_dap_tcp_alloc()

static int cmsis_dap_tcp_alloc ( struct cmsis_dap *  dap,
unsigned int  pkt_sz 
)
static

Definition at line 333 of file cmsis_dap_tcp.c.

References cmsis_dap::command, ERROR_FAIL, ERROR_OK, HEADER_SIZE, LOG_ERROR, cmsis_dap::packet_buffer, cmsis_dap::packet_buffer_size, cmsis_dap::packet_size, cmsis_dap::packet_usable_size, and cmsis_dap::response.

Referenced by cmsis_dap_tcp_open().

◆ cmsis_dap_tcp_cancel_all()

static void cmsis_dap_tcp_cancel_all ( struct cmsis_dap *  dap)
static

Definition at line 359 of file cmsis_dap_tcp.c.

◆ cmsis_dap_tcp_close()

static void cmsis_dap_tcp_close ( struct cmsis_dap *  dap)
static

Definition at line 186 of file cmsis_dap_tcp.c.

References cmsis_dap::bdata, close_socket(), cmsis_dap_tcp_free(), log_socket_error(), NULL, and cmsis_dap_backend_data::sockfd.

Referenced by cmsis_dap_tcp_open().

◆ cmsis_dap_tcp_free()

static void cmsis_dap_tcp_free ( struct cmsis_dap *  dap)
static

Definition at line 353 of file cmsis_dap_tcp.c.

References NULL, and cmsis_dap::packet_buffer.

Referenced by cmsis_dap_tcp_close().

◆ cmsis_dap_tcp_open()

static int cmsis_dap_tcp_open ( struct cmsis_dap *  dap,
uint16_t vids[]  __attribute__(unused),
uint16_t pids[]  __attribute__(unused),
const char *serial   __attribute__(unused) 
)
static

Definition at line 101 of file cmsis_dap_tcp.c.

References cmsis_dap::bdata, CMSIS_DAP_PACKET_SIZE, cmsis_dap_tcp_alloc(), cmsis_dap_tcp_close(), cmsis_dap_tcp_host, cmsis_dap_tcp_port, ERROR_FAIL, ERROR_OK, LOG_DEBUG, LOG_ERROR, LOG_INFO, log_socket_error(), NULL, and cmsis_dap_backend_data::sockfd.

◆ cmsis_dap_tcp_read()

static int cmsis_dap_tcp_read ( struct cmsis_dap *  dap,
int  transfer_timeout_ms,
enum cmsis_dap_blocking  blocking 
)
static

Definition at line 212 of file cmsis_dap_tcp.c.

References cmsis_dap::bdata, CMSIS_DAP_NON_BLOCKING, cmsis_dap_tcp_min_timeout_ms, DAP_PKT_HDR_SIGNATURE, DAP_PKT_TYPE_RESPONSE, ERROR_FAIL, ERROR_TIMEOUT_REACHED, HEADER_LENGTH_OFFSET, HEADER_PACKET_TYPE_OFFSET, HEADER_RESERVED_OFFSET, HEADER_SIGNATURE_OFFSET, HEADER_SIZE, le_to_h_u16(), le_to_h_u32(), LOG_DEBUG_IO, LOG_ERROR, log_socket_error(), cmsis_dap::packet_buffer, cmsis_dap::packet_buffer_size, peekall_socket(), readall_socket(), socket_block(), socket_nonblock(), socket_recv_timeout(), and cmsis_dap_backend_data::sockfd.

◆ cmsis_dap_tcp_write()

static int cmsis_dap_tcp_write ( struct cmsis_dap *  dap,
int  txlen,
int timeout_ms   __attribute__(unused) 
)
static

Definition at line 303 of file cmsis_dap_tcp.c.

References cmsis_dap::bdata, DAP_PKT_HDR_SIGNATURE, DAP_PKT_TYPE_REQUEST, ERROR_FAIL, h_u16_to_le(), h_u32_to_le(), HEADER_LENGTH_OFFSET, HEADER_PACKET_TYPE_OFFSET, HEADER_RESERVED_OFFSET, HEADER_SIGNATURE_OFFSET, HEADER_SIZE, LOG_DEBUG_IO, LOG_ERROR, log_socket_error(), cmsis_dap::packet_buffer, cmsis_dap::packet_buffer_size, cmsis_dap_backend_data::sockfd, and write_socket().

◆ COMMAND_HANDLER() [1/3]

COMMAND_HANDLER ( cmsis_dap_handle_tcp_host  )

Definition at line 379 of file cmsis_dap_tcp.c.

References CMD_ARGC, CMD_ARGV, cmsis_dap_tcp_host, ERROR_COMMAND_SYNTAX_ERROR, ERROR_FAIL, ERROR_OK, and LOG_ERROR.

◆ COMMAND_HANDLER() [2/3]

COMMAND_HANDLER ( cmsis_dap_handle_tcp_min_timeout  )

Definition at line 393 of file cmsis_dap_tcp.c.

◆ COMMAND_HANDLER() [3/3]

COMMAND_HANDLER ( cmsis_dap_handle_tcp_port  )

Definition at line 363 of file cmsis_dap_tcp.c.

References CMD_ARGC, CMD_ARGV, cmsis_dap_tcp_port, cmsis_dap_tcp_port_default, ERROR_COMMAND_SYNTAX_ERROR, ERROR_FAIL, ERROR_OK, and LOG_ERROR.

◆ peekall_socket()

static int peekall_socket ( int  handle,
void *  buffer,
unsigned int  count 
)
inlinestatic

Definition at line 203 of file cmsis_dap_tcp.c.

References buffer, and count.

Referenced by cmsis_dap_tcp_read().

◆ readall_socket()

static int readall_socket ( int  handle,
void *  buffer,
unsigned int  count 
)
inlinestatic

Definition at line 197 of file cmsis_dap_tcp.c.

References buffer, and count.

Referenced by cmsis_dap_tcp_read().

Variable Documentation

◆ cmsis_dap_tcp_backend

const struct cmsis_dap_backend cmsis_dap_tcp_backend
Initial value:
= {
.name = "tcp",
.open = cmsis_dap_tcp_open,
.close = cmsis_dap_tcp_close,
.read = cmsis_dap_tcp_read,
.write = cmsis_dap_tcp_write,
.packet_buffer_alloc = cmsis_dap_tcp_alloc,
.packet_buffer_free = cmsis_dap_tcp_free,
.cancel_all = cmsis_dap_tcp_cancel_all,
}
cmsis_dap_tcp_write
static int cmsis_dap_tcp_write(struct cmsis_dap *dap, int txlen, int timeout_ms __attribute__((unused)))
Definition: cmsis_dap_tcp.c:303
cmsis_dap_tcp_free
static void cmsis_dap_tcp_free(struct cmsis_dap *dap)
Definition: cmsis_dap_tcp.c:353
cmsis_dap_tcp_open
static int cmsis_dap_tcp_open(struct cmsis_dap *dap, uint16_t vids[] __attribute__((unused)), uint16_t pids[] __attribute__((unused)), const char *serial __attribute__((unused)))
Definition: cmsis_dap_tcp.c:101
cmsis_dap_tcp_read
static int cmsis_dap_tcp_read(struct cmsis_dap *dap, int transfer_timeout_ms, enum cmsis_dap_blocking blocking)
Definition: cmsis_dap_tcp.c:212
cmsis_dap_tcp_alloc
static int cmsis_dap_tcp_alloc(struct cmsis_dap *dap, unsigned int pkt_sz)
Definition: cmsis_dap_tcp.c:333
cmsis_dap_tcp_close
static void cmsis_dap_tcp_close(struct cmsis_dap *dap)
Definition: cmsis_dap_tcp.c:186
cmsis_dap_tcp_cancel_all
static void cmsis_dap_tcp_cancel_all(struct cmsis_dap *dap)
Definition: cmsis_dap_tcp.c:359

Definition at line 393 of file cmsis_dap_tcp.c.

◆ cmsis_dap_tcp_host

char* cmsis_dap_tcp_host
static

Definition at line 92 of file cmsis_dap_tcp.c.

Referenced by cmsis_dap_tcp_open(), and COMMAND_HANDLER().

◆ cmsis_dap_tcp_min_timeout_ms

int cmsis_dap_tcp_min_timeout_ms = DEFAULT_MIN_TIMEOUT_MS
static

Definition at line 95 of file cmsis_dap_tcp.c.

Referenced by cmsis_dap_tcp_read().

◆ cmsis_dap_tcp_port

char* cmsis_dap_tcp_port = cmsis_dap_tcp_port_default
static

Definition at line 94 of file cmsis_dap_tcp.c.

Referenced by cmsis_dap_tcp_open(), and COMMAND_HANDLER().

◆ cmsis_dap_tcp_port_default

char* const cmsis_dap_tcp_port_default = STRINGIFY(CMSIS_DAP_TCP_PORT)
static

Definition at line 93 of file cmsis_dap_tcp.c.

Referenced by COMMAND_HANDLER().

◆ cmsis_dap_tcp_subcommand_handlers

const struct command_registration cmsis_dap_tcp_subcommand_handlers[]
Initial value:
= {
{
.name = "host",
.handler = &cmsis_dap_handle_tcp_host,
.mode = COMMAND_CONFIG,
.help = "set the host name to use (for TCP backend only)",
.usage = "<host_name>",
},
{
.name = "port",
.handler = &cmsis_dap_handle_tcp_port,
.mode = COMMAND_CONFIG,
.help = "set the port number to use for DAP (for TCP backend only)",
.usage = "<port_number>",
},
{
.name = "min_timeout",
.handler = &cmsis_dap_handle_tcp_min_timeout,
.mode = COMMAND_CONFIG,
.help = "set the minimum timeout in milliseconds to wait for response "
"packets (for TCP backend only)",
.usage = "<milliseconds>",
},
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:251
COMMAND_CONFIG
@ COMMAND_CONFIG
Definition: command.h:41

Definition at line 393 of file cmsis_dap_tcp.c.