1 // SPDX-License-Identifier: GPL-2.0-or-later
7 #include <helper/time_support.h>
9 #include "target/target.h"
10 #include "target/target_type.h"
11 #include "target/register.h"
12 #include <target/smp.h>
14 #include "helper/log.h"
15 #include "helper/types.h"
16 #include "server/gdb_server.h"
18 static bool hwthread_detect_rtos(struct target
*target
);
19 static int hwthread_create(struct target
*target
);
20 static int hwthread_update_threads(struct rtos
*rtos
);
21 static int hwthread_get_thread_reg(struct rtos
*rtos
, int64_t thread_id
,
22 uint32_t reg_num
, struct rtos_reg
*rtos_reg
);
23 static int hwthread_get_thread_reg_list(struct rtos
*rtos
, int64_t thread_id
,
24 struct rtos_reg
**reg_list
, int *num_regs
);
25 static int hwthread_get_symbol_list_to_lookup(struct symbol_table_elem
*symbol_list
[]);
26 static int hwthread_smp_init(struct target
*target
);
27 static int hwthread_set_reg(struct rtos
*rtos
, uint32_t reg_num
, uint8_t *reg_value
);
28 static int hwthread_read_buffer(struct rtos
*rtos
, target_addr_t address
,
29 uint32_t size
, uint8_t *buffer
);
30 static int hwthread_write_buffer(struct rtos
*rtos
, target_addr_t address
,
31 uint32_t size
, const uint8_t *buffer
);
33 #define HW_THREAD_NAME_STR_SIZE (32)
35 extern int rtos_thread_packet(struct connection
*connection
, const char *packet
, int packet_size
);
37 static inline threadid_t
threadid_from_target(const struct target
*target
)
39 return target
->coreid
+ 1;
42 const struct rtos_type hwthread_rtos
= {
44 .detect_rtos
= hwthread_detect_rtos
,
45 .create
= hwthread_create
,
46 .update_threads
= hwthread_update_threads
,
47 .get_thread_reg_list
= hwthread_get_thread_reg_list
,
48 .get_thread_reg
= hwthread_get_thread_reg
,
49 .get_symbol_list_to_lookup
= hwthread_get_symbol_list_to_lookup
,
50 .smp_init
= hwthread_smp_init
,
51 .set_reg
= hwthread_set_reg
,
52 .read_buffer
= hwthread_read_buffer
,
53 .write_buffer
= hwthread_write_buffer
,
56 struct hwthread_params
{
60 static int hwthread_fill_thread(struct rtos
*rtos
, struct target
*curr
, int thread_num
)
62 char tmp_str
[HW_THREAD_NAME_STR_SIZE
];
63 threadid_t tid
= threadid_from_target(curr
);
65 memset(tmp_str
, 0, HW_THREAD_NAME_STR_SIZE
);
67 /* thread-id is the core-id of this core inside the SMP group plus 1 */
68 rtos
->thread_details
[thread_num
].threadid
= tid
;
69 /* create the thread name */
70 rtos
->thread_details
[thread_num
].exists
= true;
71 rtos
->thread_details
[thread_num
].thread_name_str
= strdup(target_name(curr
));
72 snprintf(tmp_str
, HW_THREAD_NAME_STR_SIZE
-1, "state: %s", debug_reason_name(curr
));
73 rtos
->thread_details
[thread_num
].extra_info_str
= strdup(tmp_str
);
78 static int hwthread_update_threads(struct rtos
*rtos
)
80 int threads_found
= 0;
81 struct target_list
*head
;
82 struct target
*target
;
83 int64_t current_thread
= 0;
84 enum target_debug_reason current_reason
= DBG_REASON_UNDEFINED
;
89 target
= rtos
->target
;
91 /* wipe out previous thread details if any */
92 rtos_free_threadlist(rtos
);
94 /* determine the number of "threads" */
96 foreach_smp_target(head
, target
->smp_targets
) {
97 struct target
*curr
= head
->target
;
99 if (!target_was_examined(curr
))
107 /* create space for new thread details */
108 rtos
->thread_details
= malloc(sizeof(struct thread_detail
) * threads_found
);
111 /* loop over all threads */
112 foreach_smp_target(head
, target
->smp_targets
) {
113 struct target
*curr
= head
->target
;
115 if (!target_was_examined(curr
))
118 threadid_t tid
= threadid_from_target(curr
);
120 hwthread_fill_thread(rtos
, curr
, threads_found
);
122 /* find an interesting thread to set as current */
123 switch (current_reason
) {
124 case DBG_REASON_UNDEFINED
:
125 current_reason
= curr
->debug_reason
;
126 current_thread
= tid
;
128 case DBG_REASON_SINGLESTEP
:
129 /* single-step can only be overridden by itself */
130 if (curr
->debug_reason
== DBG_REASON_SINGLESTEP
) {
131 if (tid
== rtos
->current_threadid
)
132 current_thread
= tid
;
135 case DBG_REASON_BREAKPOINT
:
136 /* single-step overrides breakpoint */
137 if (curr
->debug_reason
== DBG_REASON_SINGLESTEP
) {
138 current_reason
= curr
->debug_reason
;
139 current_thread
= tid
;
141 /* multiple breakpoints, prefer gdbs' threadid */
142 if (curr
->debug_reason
== DBG_REASON_BREAKPOINT
) {
143 if (tid
== rtos
->current_threadid
)
144 current_thread
= tid
;
147 case DBG_REASON_WATCHPOINT
:
148 /* breakpoint and single-step override watchpoint */
149 if (curr
->debug_reason
== DBG_REASON_SINGLESTEP
||
150 curr
->debug_reason
== DBG_REASON_BREAKPOINT
) {
151 current_reason
= curr
->debug_reason
;
152 current_thread
= tid
;
155 case DBG_REASON_DBGRQ
:
156 /* all other reasons override debug-request */
157 if (curr
->debug_reason
== DBG_REASON_SINGLESTEP
||
158 curr
->debug_reason
== DBG_REASON_WATCHPOINT
||
159 curr
->debug_reason
== DBG_REASON_BREAKPOINT
) {
160 current_reason
= curr
->debug_reason
;
161 current_thread
= tid
;
163 if (curr
->debug_reason
== DBG_REASON_DBGRQ
) {
164 if (tid
== rtos
->current_threadid
)
165 current_thread
= tid
;
175 hwthread_fill_thread(rtos
, target
, threads_found
);
176 current_thread
= threadid_from_target(target
);
179 rtos
->thread_count
= threads_found
;
181 /* we found an interesting thread, set it as current */
182 if (current_thread
!= 0)
183 rtos
->current_thread
= current_thread
;
184 else if (rtos
->current_threadid
!= 0)
185 rtos
->current_thread
= rtos
->current_threadid
;
187 rtos
->current_thread
= threadid_from_target(target
);
189 LOG_DEBUG("%s current_thread=%i", __func__
, (int)rtos
->current_thread
);
193 static int hwthread_smp_init(struct target
*target
)
195 return hwthread_update_threads(target
->rtos
);
198 static struct target
*hwthread_find_thread(struct target
*target
, int64_t thread_id
)
200 /* Find the thread with that thread_id */
204 struct target_list
*head
;
205 foreach_smp_target(head
, target
->smp_targets
) {
206 if (thread_id
== threadid_from_target(head
->target
))
209 } else if (thread_id
== threadid_from_target(target
)) {
215 static int hwthread_get_thread_reg_list(struct rtos
*rtos
, int64_t thread_id
,
216 struct rtos_reg
**rtos_reg_list
, int *rtos_reg_list_size
)
221 struct target
*target
= rtos
->target
;
223 struct target
*curr
= hwthread_find_thread(target
, thread_id
);
227 if (!target_was_examined(curr
))
231 struct reg
**reg_list
;
232 int retval
= target_get_gdb_reg_list(curr
, ®_list
, ®_list_size
,
234 if (retval
!= ERROR_OK
)
238 for (int i
= 0; i
< reg_list_size
; i
++) {
239 if (!reg_list
[i
] || reg_list
[i
]->exist
== false || reg_list
[i
]->hidden
)
243 *rtos_reg_list_size
= j
;
244 *rtos_reg_list
= calloc(*rtos_reg_list_size
, sizeof(struct rtos_reg
));
245 if (!*rtos_reg_list
) {
251 for (int i
= 0; i
< reg_list_size
; i
++) {
252 if (!reg_list
[i
] || reg_list
[i
]->exist
== false || reg_list
[i
]->hidden
)
254 (*rtos_reg_list
)[j
].number
= (*reg_list
)[i
].number
;
255 (*rtos_reg_list
)[j
].size
= (*reg_list
)[i
].size
;
256 memcpy((*rtos_reg_list
)[j
].value
, (*reg_list
)[i
].value
,
257 ((*reg_list
)[i
].size
+ 7) / 8);
265 static int hwthread_get_thread_reg(struct rtos
*rtos
, int64_t thread_id
,
266 uint32_t reg_num
, struct rtos_reg
*rtos_reg
)
271 struct target
*target
= rtos
->target
;
273 struct target
*curr
= hwthread_find_thread(target
, thread_id
);
275 LOG_ERROR("Couldn't find RTOS thread for id %" PRId64
".", thread_id
);
279 if (!target_was_examined(curr
)) {
280 LOG_ERROR("Target %d hasn't been examined yet.", curr
->coreid
);
284 struct reg
*reg
= register_get_by_number(curr
->reg_cache
, reg_num
, true);
286 LOG_ERROR("Couldn't find register %" PRIu32
" in thread %" PRId64
".", reg_num
,
291 if (reg
->type
->get(reg
) != ERROR_OK
)
294 rtos_reg
->number
= reg
->number
;
295 rtos_reg
->size
= reg
->size
;
296 unsigned bytes
= (reg
->size
+ 7) / 8;
297 assert(bytes
<= sizeof(rtos_reg
->value
));
298 memcpy(rtos_reg
->value
, reg
->value
, bytes
);
303 static int hwthread_set_reg(struct rtos
*rtos
, uint32_t reg_num
, uint8_t *reg_value
)
308 struct target
*target
= rtos
->target
;
310 struct target
*curr
= hwthread_find_thread(target
, rtos
->current_thread
);
314 struct reg
*reg
= register_get_by_number(curr
->reg_cache
, reg_num
, true);
318 return reg
->type
->set(reg
, reg_value
);
321 static int hwthread_get_symbol_list_to_lookup(struct symbol_table_elem
*symbol_list
[])
323 /* return an empty list, we don't have any symbols to look up */
324 *symbol_list
= calloc(1, sizeof(struct symbol_table_elem
));
325 (*symbol_list
)[0].symbol_name
= NULL
;
329 static int hwthread_target_for_threadid(struct connection
*connection
, int64_t thread_id
, struct target
**p_target
)
331 struct target
*target
= get_target_from_connection(connection
);
333 struct target
*curr
= hwthread_find_thread(target
, thread_id
);
342 static bool hwthread_detect_rtos(struct target
*target
)
344 /* always return 0, avoid auto-detection */
348 static int hwthread_thread_packet(struct connection
*connection
, const char *packet
, int packet_size
)
350 struct target
*target
= get_target_from_connection(connection
);
352 struct target
*curr
= NULL
;
353 int64_t current_threadid
;
355 if (packet
[0] == 'H' && packet
[1] == 'g') {
356 sscanf(packet
, "Hg%16" SCNx64
, ¤t_threadid
);
358 if (current_threadid
> 0) {
359 if (hwthread_target_for_threadid(connection
, current_threadid
, &curr
) != ERROR_OK
) {
360 LOG_ERROR("hwthread: cannot find thread id %"PRId64
, current_threadid
);
361 gdb_put_packet(connection
, "E01", 3);
364 target
->rtos
->current_thread
= current_threadid
;
366 if (current_threadid
== 0 || current_threadid
== -1)
367 target
->rtos
->current_thread
= threadid_from_target(target
);
369 target
->rtos
->current_threadid
= current_threadid
;
371 gdb_put_packet(connection
, "OK", 2);
375 return rtos_thread_packet(connection
, packet
, packet_size
);
378 static int hwthread_create(struct target
*target
)
380 LOG_INFO("Hardware thread awareness created");
382 target
->rtos
->rtos_specific_params
= NULL
;
383 target
->rtos
->current_thread
= 0;
384 target
->rtos
->thread_details
= NULL
;
385 target
->rtos
->gdb_target_for_threadid
= hwthread_target_for_threadid
;
386 target
->rtos
->gdb_thread_packet
= hwthread_thread_packet
;
390 static int hwthread_read_buffer(struct rtos
*rtos
, target_addr_t address
,
391 uint32_t size
, uint8_t *buffer
)
396 struct target
*target
= rtos
->target
;
398 struct target
*curr
= hwthread_find_thread(target
, rtos
->current_thread
);
402 return target_read_buffer(curr
, address
, size
, buffer
);
405 static int hwthread_write_buffer(struct rtos
*rtos
, target_addr_t address
,
406 uint32_t size
, const uint8_t *buffer
)
411 struct target
*target
= rtos
->target
;
413 struct target
*curr
= hwthread_find_thread(target
, rtos
->current_thread
);
417 return target_write_buffer(curr
, address
, size
, buffer
);
Linking to existing account procedure
If you already have an account and want to add another login method
you
MUST first sign in with your existing account and
then change URL to read
https://review.openocd.org/login/?link
to get to this page again but this time it'll work for linking. Thank you.
SSH host keys fingerprints
1024 SHA256:YKx8b7u5ZWdcbp7/4AeXNaqElP49m6QrwfXaqQGJAOk gerrit-code-review@openocd.zylin.com (DSA)
384 SHA256:jHIbSQa4REvwCFG4cq5LBlBLxmxSqelQPem/EXIrxjk gerrit-code-review@openocd.org (ECDSA)
521 SHA256:UAOPYkU9Fjtcao0Ul/Rrlnj/OsQvt+pgdYSZ4jOYdgs gerrit-code-review@openocd.org (ECDSA)
256 SHA256:A13M5QlnozFOvTllybRZH6vm7iSt0XLxbA48yfc2yfY gerrit-code-review@openocd.org (ECDSA)
256 SHA256:spYMBqEYoAOtK7yZBrcwE8ZpYt6b68Cfh9yEVetvbXg gerrit-code-review@openocd.org (ED25519)
+--[ED25519 256]--+
|=.. |
|+o.. . |
|*.o . . |
|+B . . . |
|Bo. = o S |
|Oo.+ + = |
|oB=.* = . o |
| =+=.+ + E |
|. .=o . o |
+----[SHA256]-----+
2048 SHA256:0Onrb7/PHjpo6iVZ7xQX2riKN83FJ3KGU0TvI0TaFG4 gerrit-code-review@openocd.zylin.com (RSA)