forked from auracaster/openocd
Palmer Dabbelt
8dea2908b7
This is a major rewrite of the RISC-V v0.13 OpenOCD port. This shouldn't have any meaningful effect on the v0.11 support, but it does add generic versions of many functions that will allow me to later refactor the v0.11 support so it's easier to maintain both ports. This started as an emergency feature branch and went on for a long time, so it's all been squashed down into one commit so there isn't a big set of broken commits lying around. The changes are: * You can pass "-rtos riscv" to the target in OpenOCD's configuration file, which enables multi-hart mode. This uses OpenOCD's RTOS support to control all the harts from the debug module using commands like "info threads" in GDB. This support is still expermental. * There is support for RV64I, but due to OpenOCD limitations we only support 32-bit physical addresses. I hope to remedy this by rebasing onto the latest OpenOCD release, which I've heard should fix this. * This matches the latest draft version of the RISC-V debug spec, as of April 26th. This version fixes a number of spec bugs and should be close to the final debug spec.
113 lines
4.2 KiB
C
113 lines
4.2 KiB
C
/***************************************************************************
|
|
* Copyright (C) 2011 by Broadcom Corporation *
|
|
* Evan Hunter - ehunter@broadcom.com *
|
|
* *
|
|
* This program is free software; you can redistribute it and/or modify *
|
|
* it under the terms of the GNU General Public License as published by *
|
|
* the Free Software Foundation; either version 2 of the License, or *
|
|
* (at your option) any later version. *
|
|
* *
|
|
* This program is distributed in the hope that it will be useful, *
|
|
* but WITHOUT ANY WARRANTY; without even the implied warranty of *
|
|
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the *
|
|
* GNU General Public License for more details. *
|
|
* *
|
|
* You should have received a copy of the GNU General Public License *
|
|
* along with this program. If not, see <http://www.gnu.org/licenses/>. *
|
|
***************************************************************************/
|
|
|
|
#ifndef OPENOCD_RTOS_RTOS_H
|
|
#define OPENOCD_RTOS_RTOS_H
|
|
|
|
#include "server/server.h"
|
|
#include <jim-nvp.h>
|
|
|
|
typedef int64_t threadid_t;
|
|
typedef int64_t symbol_address_t;
|
|
|
|
struct reg;
|
|
|
|
/**
|
|
* Table should be terminated by an element with NULL in symbol_name
|
|
*/
|
|
typedef struct symbol_table_elem_struct {
|
|
const char *symbol_name;
|
|
symbol_address_t address;
|
|
bool optional;
|
|
} symbol_table_elem_t;
|
|
|
|
struct thread_detail {
|
|
threadid_t threadid;
|
|
bool exists;
|
|
char *thread_name_str;
|
|
char *extra_info_str;
|
|
};
|
|
|
|
struct rtos {
|
|
const struct rtos_type *type;
|
|
|
|
symbol_table_elem_t *symbols;
|
|
struct target *target;
|
|
/* add a context variable instead of global variable */
|
|
int64_t current_threadid;
|
|
threadid_t current_thread;
|
|
struct thread_detail *thread_details;
|
|
int thread_count;
|
|
int (*gdb_thread_packet)(struct connection *connection, char const *packet, int packet_size);
|
|
int (*gdb_v_packet)(struct connection *connection, char const *packet, int packet_size);
|
|
void *rtos_specific_params;
|
|
};
|
|
|
|
struct rtos_type {
|
|
const char *name;
|
|
int (*detect_rtos)(struct target *target);
|
|
int (*create)(struct target *target);
|
|
int (*smp_init)(struct target *target);
|
|
int (*update_threads)(struct rtos *rtos);
|
|
int (*get_thread_reg_list)(struct rtos *rtos, int64_t thread_id, char **hex_reg_list);
|
|
int (*get_symbol_list_to_lookup)(symbol_table_elem_t *symbol_list[]);
|
|
int (*clean)(struct target *target);
|
|
char * (*ps_command)(struct target *target);
|
|
};
|
|
|
|
struct stack_register_offset {
|
|
signed short offset; /* offset in bytes from stack head, or -1 to indicate
|
|
* register is not stacked, or -2 to indicate this is the
|
|
* stack pointer register */
|
|
unsigned short width_bits;
|
|
};
|
|
|
|
struct rtos_register_stacking {
|
|
unsigned char stack_registers_size;
|
|
signed char stack_growth_direction;
|
|
unsigned char num_output_registers;
|
|
/* Some targets require evaluating the stack to determine the
|
|
* actual stack pointer for a process. If this field is NULL,
|
|
* just use stacking->stack_registers_size * stack_growth_direction
|
|
* to calculate adjustment.
|
|
*/
|
|
int64_t (*calculate_process_stack)(struct target *target,
|
|
const uint8_t *stack_data,
|
|
const struct rtos_register_stacking *stacking,
|
|
int64_t stack_ptr);
|
|
const struct stack_register_offset *register_offsets;
|
|
};
|
|
|
|
#define GDB_THREAD_PACKET_NOT_CONSUMED (-40)
|
|
|
|
int rtos_create(Jim_GetOptInfo *goi, struct target *target);
|
|
int rtos_generic_stack_read(struct target *target,
|
|
const struct rtos_register_stacking *stacking,
|
|
int64_t stack_ptr,
|
|
char **hex_reg_list);
|
|
int rtos_try_next(struct target *target);
|
|
int gdb_thread_packet(struct connection *connection, char const *packet, int packet_size);
|
|
int rtos_get_gdb_reg_list(struct connection *connection);
|
|
int rtos_update_threads(struct target *target);
|
|
void rtos_free_threadlist(struct rtos *rtos);
|
|
int rtos_smp_init(struct target *target);
|
|
/* function for handling symbol access */
|
|
int rtos_qsymbol(struct connection *connection, char const *packet, int packet_size);
|
|
|
|
#endif /* OPENOCD_RTOS_RTOS_H */
|