1 /* 2 * QEMU RISC-V Native Debug Support 3 * 4 * Copyright (c) 2022 Wind River Systems, Inc. 5 * 6 * Author: 7 * Bin Meng <bin.meng@windriver.com> 8 * 9 * This program is free software; you can redistribute it and/or modify it 10 * under the terms and conditions of the GNU General Public License, 11 * version 2 or later, as published by the Free Software Foundation. 12 * 13 * This program is distributed in the hope it will be useful, but WITHOUT 14 * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or 15 * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for 16 * more details. 17 * 18 * You should have received a copy of the GNU General Public License along with 19 * this program. If not, see <http://www.gnu.org/licenses/>. 20 */ 21 22 #ifndef RISCV_DEBUG_H 23 #define RISCV_DEBUG_H 24 25 #define RV_MAX_TRIGGERS 2 26 27 /* register index of tdata CSRs */ 28 enum { 29 TDATA1 = 0, 30 TDATA2, 31 TDATA3, 32 TDATA_NUM 33 }; 34 35 typedef enum { 36 TRIGGER_TYPE_NO_EXIST = 0, /* trigger does not exist */ 37 TRIGGER_TYPE_AD_MATCH = 2, /* address/data match trigger */ 38 TRIGGER_TYPE_INST_CNT = 3, /* instruction count trigger */ 39 TRIGGER_TYPE_INT = 4, /* interrupt trigger */ 40 TRIGGER_TYPE_EXCP = 5, /* exception trigger */ 41 TRIGGER_TYPE_AD_MATCH6 = 6, /* new address/data match trigger */ 42 TRIGGER_TYPE_EXT_SRC = 7, /* external source trigger */ 43 TRIGGER_TYPE_UNAVAIL = 15, /* trigger exists, but unavailable */ 44 TRIGGER_TYPE_NUM 45 } trigger_type_t; 46 47 /* actions */ 48 typedef enum { 49 DBG_ACTION_NONE = -1, /* sentinel value */ 50 DBG_ACTION_BP = 0, 51 DBG_ACTION_DBG_MODE, 52 DBG_ACTION_TRACE0, 53 DBG_ACTION_TRACE1, 54 DBG_ACTION_TRACE2, 55 DBG_ACTION_TRACE3, 56 DBG_ACTION_EXT_DBG0 = 8, 57 DBG_ACTION_EXT_DBG1 58 } trigger_action_t; 59 60 /* tdata1 field masks */ 61 62 #define RV32_TYPE(t) ((uint32_t)(t) << 28) 63 #define RV32_TYPE_MASK (0xf << 28) 64 #define RV32_DMODE BIT(27) 65 #define RV32_DATA_MASK 0x7ffffff 66 #define RV64_TYPE(t) ((uint64_t)(t) << 60) 67 #define RV64_TYPE_MASK (0xfULL << 60) 68 #define RV64_DMODE BIT_ULL(59) 69 #define RV64_DATA_MASK 0x7ffffffffffffff 70 71 /* mcontrol field masks */ 72 73 #define TYPE2_LOAD BIT(0) 74 #define TYPE2_STORE BIT(1) 75 #define TYPE2_EXEC BIT(2) 76 #define TYPE2_U BIT(3) 77 #define TYPE2_S BIT(4) 78 #define TYPE2_M BIT(6) 79 #define TYPE2_MATCH (0xf << 7) 80 #define TYPE2_CHAIN BIT(11) 81 #define TYPE2_ACTION (0xf << 12) 82 #define TYPE2_SIZELO (0x3 << 16) 83 #define TYPE2_TIMING BIT(18) 84 #define TYPE2_SELECT BIT(19) 85 #define TYPE2_HIT BIT(20) 86 #define TYPE2_SIZEHI (0x3 << 21) /* RV64 only */ 87 88 /* mcontrol6 field masks */ 89 90 #define TYPE6_LOAD BIT(0) 91 #define TYPE6_STORE BIT(1) 92 #define TYPE6_EXEC BIT(2) 93 #define TYPE6_U BIT(3) 94 #define TYPE6_S BIT(4) 95 #define TYPE6_M BIT(6) 96 #define TYPE6_MATCH (0xf << 7) 97 #define TYPE6_CHAIN BIT(11) 98 #define TYPE6_ACTION (0xf << 12) 99 #define TYPE6_SIZE (0xf << 16) 100 #define TYPE6_TIMING BIT(20) 101 #define TYPE6_SELECT BIT(21) 102 #define TYPE6_HIT BIT(22) 103 #define TYPE6_VU BIT(23) 104 #define TYPE6_VS BIT(24) 105 106 /* access size */ 107 enum { 108 SIZE_ANY = 0, 109 SIZE_1B, 110 SIZE_2B, 111 SIZE_4B, 112 SIZE_6B, 113 SIZE_8B, 114 SIZE_10B, 115 SIZE_12B, 116 SIZE_14B, 117 SIZE_16B, 118 SIZE_NUM = 16 119 }; 120 121 /* itrigger filed masks */ 122 #define ITRIGGER_ACTION 0x3f 123 #define ITRIGGER_U BIT(6) 124 #define ITRIGGER_S BIT(7) 125 #define ITRIGGER_PENDING BIT(8) 126 #define ITRIGGER_M BIT(9) 127 #define ITRIGGER_COUNT (0x3fff << 10) 128 #define ITRIGGER_HIT BIT(24) 129 #define ITRIGGER_VU BIT(25) 130 #define ITRIGGER_VS BIT(26) 131 132 bool tdata_available(CPURISCVState *env, int tdata_index); 133 134 target_ulong tselect_csr_read(CPURISCVState *env); 135 void tselect_csr_write(CPURISCVState *env, target_ulong val); 136 137 target_ulong tdata_csr_read(CPURISCVState *env, int tdata_index); 138 void tdata_csr_write(CPURISCVState *env, int tdata_index, target_ulong val); 139 140 target_ulong tinfo_csr_read(CPURISCVState *env); 141 142 void riscv_cpu_debug_excp_handler(CPUState *cs); 143 bool riscv_cpu_debug_check_breakpoint(CPUState *cs); 144 bool riscv_cpu_debug_check_watchpoint(CPUState *cs, CPUWatchpoint *wp); 145 146 void riscv_trigger_realize(CPURISCVState *env); 147 void riscv_trigger_reset_hold(CPURISCVState *env); 148 149 bool riscv_itrigger_enabled(CPURISCVState *env); 150 void riscv_itrigger_update_priv(CPURISCVState *env); 151 #endif /* RISCV_DEBUG_H */ 152