1 /***************************************************************************
2 * Copyright (C) 2011 by Broadcom Corporation *
3 * Evan Hunter - ehunter@broadcom.com *
5 * This program is free software; you can redistribute it and/or modify *
6 * it under the terms of the GNU General Public License as published by *
7 * the Free Software Foundation; either version 2 of the License, or *
8 * (at your option) any later version. *
10 * This program is distributed in the hope that it will be useful, *
11 * but WITHOUT ANY WARRANTY; without even the implied warranty of *
12 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the *
13 * GNU General Public License for more details. *
15 * You should have received a copy of the GNU General Public License *
16 * along with this program. If not, see <http://www.gnu.org/licenses/>. *
17 ***************************************************************************/
19 #ifndef OPENOCD_RTOS_RTOS_H
20 #define OPENOCD_RTOS_RTOS_H
22 #include "server/server.h"
23 #include "target/target.h"
26 typedef int64_t threadid_t
;
27 typedef int64_t symbol_address_t
;
32 * Table should be terminated by an element with NULL in symbol_name
34 struct symbol_table_elem
{
35 const char *symbol_name
;
36 symbol_address_t address
;
40 struct thread_detail
{
43 char *thread_name_str
;
48 const struct rtos_type
*type
;
50 struct symbol_table_elem
*symbols
;
51 struct target
*target
;
52 /* add a context variable instead of global variable */
53 /* The thread currently selected by gdb. */
54 int64_t current_threadid
;
55 /* The currently selected thread according to the target. */
56 threadid_t current_thread
;
57 struct thread_detail
*thread_details
;
59 int (*gdb_thread_packet
)(struct connection
*connection
, char const *packet
, int packet_size
);
60 int (*gdb_target_for_threadid
)(struct connection
*connection
, int64_t thread_id
, struct target
**p_target
);
61 void *rtos_specific_params
;
72 bool (*detect_rtos
)(struct target
*target
);
73 int (*create
)(struct target
*target
);
74 int (*smp_init
)(struct target
*target
);
75 int (*update_threads
)(struct rtos
*rtos
);
76 /** Return a list of general registers, with their values filled out. */
77 int (*get_thread_reg_list
)(struct rtos
*rtos
, int64_t thread_id
,
78 struct rtos_reg
**reg_list
, int *num_regs
);
79 int (*get_thread_reg
)(struct rtos
*rtos
, int64_t thread_id
,
80 uint32_t reg_num
, struct rtos_reg
*reg
);
81 int (*get_symbol_list_to_lookup
)(struct symbol_table_elem
*symbol_list
[]);
82 int (*clean
)(struct target
*target
);
83 char * (*ps_command
)(struct target
*target
);
84 int (*set_reg
)(struct rtos
*rtos
, uint32_t reg_num
, uint8_t *reg_value
);
85 /* Implement these if different threads in the RTOS can see memory
86 * differently (for instance because address translation might be different
87 * for each thread). */
88 int (*read_buffer
)(struct rtos
*rtos
, target_addr_t address
, uint32_t size
,
90 int (*write_buffer
)(struct rtos
*rtos
, target_addr_t address
, uint32_t size
,
91 const uint8_t *buffer
);
94 struct stack_register_offset
{
95 unsigned short number
; /* register number */
96 signed short offset
; /* offset in bytes from stack head, or -1 to indicate
97 * register is not stacked, or -2 to indicate this is the
98 * stack pointer register */
99 unsigned short width_bits
;
102 struct rtos_register_stacking
{
103 unsigned char stack_registers_size
;
104 signed char stack_growth_direction
;
105 unsigned char num_output_registers
;
106 /* Some targets require evaluating the stack to determine the
107 * actual stack pointer for a process. If this field is NULL,
108 * just use stacking->stack_registers_size * stack_growth_direction
109 * to calculate adjustment.
111 int64_t (*calculate_process_stack
)(struct target
*target
,
112 const uint8_t *stack_data
,
113 const struct rtos_register_stacking
*stacking
,
115 const struct stack_register_offset
*register_offsets
;
118 #define GDB_THREAD_PACKET_NOT_CONSUMED (-40)
120 int rtos_create(struct jim_getopt_info
*goi
, struct target
*target
);
121 void rtos_destroy(struct target
*target
);
122 int rtos_set_reg(struct connection
*connection
, int reg_num
,
124 int rtos_generic_stack_read(struct target
*target
,
125 const struct rtos_register_stacking
*stacking
,
127 struct rtos_reg
**reg_list
,
129 int gdb_thread_packet(struct connection
*connection
, char const *packet
, int packet_size
);
130 int rtos_get_gdb_reg(struct connection
*connection
, int reg_num
);
131 int rtos_get_gdb_reg_list(struct connection
*connection
);
132 int rtos_update_threads(struct target
*target
);
133 void rtos_free_threadlist(struct rtos
*rtos
);
134 int rtos_smp_init(struct target
*target
);
135 /* function for handling symbol access */
136 int rtos_qsymbol(struct connection
*connection
, char const *packet
, int packet_size
);
137 int rtos_read_buffer(struct target
*target
, target_addr_t address
,
138 uint32_t size
, uint8_t *buffer
);
139 int rtos_write_buffer(struct target
*target
, target_addr_t address
,
140 uint32_t size
, const uint8_t *buffer
);
142 #endif /* OPENOCD_RTOS_RTOS_H */