src/target/arm_dpm.h

   1 /*
   2  * Copyright (C) 2009 by David Brownell
   3  *
   4  * This program is free software; you can redistribute it and/or modify
   5  * it under the terms of the GNU General Public License as published by
   6  * the Free Software Foundation; either version 2 of the License, or
   7  * (at your option) any later version.
   8  *
   9  * This program is distributed in the hope that it will be useful
  10  * but WITHOUT ANY WARRANTY; without even the implied warranty of
  11  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  12  * GNU General Public License for more details.
  13  *
  14  * You should have received a copy of the GNU General Public License
  15  * along with this program.  If not, see <http://www.gnu.org/licenses/>.
  16  */
  17
  18 #ifndef OPENOCD_TARGET_ARM_DPM_H
  19 #define OPENOCD_TARGET_ARM_DPM_H
  20
  21 /**
  22  * @file
  23  * This is the interface to the Debug Programmers Model for ARMv6 and
  24  * ARMv7 processors.  ARMv6 processors (such as ARM11xx implementations)
  25  * introduced a model which became part of the ARMv7-AR architecture
  26  * which is most familiar through the Cortex-A series parts.  While
  27  * specific details differ (like how to write the instruction register),
  28  * the high level models easily support shared code because those
  29  * registers are compatible.
  30  */
  31
  32 struct dpm_bpwp {
  33         unsigned number;
  34         uint32_t address;
  35         uint32_t control;
  36         /* true if hardware state needs flushing */
  37         bool dirty;
  38 };
  39
  40 struct dpm_bp {
  41         struct breakpoint *bp;
  42         struct dpm_bpwp bpwp;
  43 };
  44
  45 struct dpm_wp {
  46         struct watchpoint *wp;
  47         struct dpm_bpwp bpwp;
  48 };
  49
  50 /**
  51  * This wraps an implementation of DPM primitives.  Each interface
  52  * provider supplies a structure like this, which is the glue between
  53  * upper level code and the lower level hardware access.
  54  *
  55  * It is a PRELIMINARY AND INCOMPLETE set of primitives, starting with
  56  * support for CPU register access.
  57  */
  58 struct arm_dpm {
  59         struct arm *arm;
  60
  61         /** Cache of DIDR */
  62         uint32_t didr;
  63
  64         /** Invoke before a series of instruction operations */
  65         int (*prepare)(struct arm_dpm *);
  66
  67         /** Invoke after a series of instruction operations */
  68         int (*finish)(struct arm_dpm *);
  69
  70         /* WRITE TO CPU */
  71
  72         /** Runs one instruction, writing data to DCC before execution. */
  73         int (*instr_write_data_dcc)(struct arm_dpm *,
  74                         uint32_t opcode, uint32_t data);
  75
  76         int (*instr_write_data_dcc_64)(struct arm_dpm *,
  77                         uint32_t opcode, uint64_t data);
  78
  79         /** Runs one instruction, writing data to R0 before execution. */
  80         int (*instr_write_data_r0)(struct arm_dpm *,
  81                         uint32_t opcode, uint32_t data);
  82
  83         /** Runs one instruction, writing data to R0 before execution. */
  84         int (*instr_write_data_r0_64)(struct arm_dpm *,
  85                         uint32_t opcode, uint64_t data);
  86
  87         /** Optional core-specific operation invoked after CPSR writes. */
  88         int (*instr_cpsr_sync)(struct arm_dpm *dpm);
  89
  90         /* READ FROM CPU */
  91
  92         /** Runs one instruction, reading data from dcc after execution. */
  93         int (*instr_read_data_dcc)(struct arm_dpm *,
  94                         uint32_t opcode, uint32_t *data);
  95
  96         int (*instr_read_data_dcc_64)(struct arm_dpm *,
  97                         uint32_t opcode, uint64_t *data);
  98
  99         /** Runs one instruction, reading data from r0 after execution. */
 100         int (*instr_read_data_r0)(struct arm_dpm *,
 101                         uint32_t opcode, uint32_t *data);
 102
 103         int (*instr_read_data_r0_64)(struct arm_dpm *,
 104                         uint32_t opcode, uint64_t *data);
 105
 106         struct reg *(*arm_reg_current)(struct arm *arm,
 107                         unsigned regnum);
 108
 109         /* BREAKPOINT/WATCHPOINT SUPPORT */
 110
 111         /**
 112          * Enables one breakpoint or watchpoint by writing to the
 113          * hardware registers.  The specified breakpoint/watchpoint
 114          * must currently be disabled.  Indices 0..15 are used for
 115          * breakpoints; indices 16..31 are for watchpoints.
 116          */
 117         int (*bpwp_enable)(struct arm_dpm *, unsigned index_value,
 118                         uint32_t addr, uint32_t control);
 119
 120         /**
 121          * Disables one breakpoint or watchpoint by clearing its
 122          * hardware control registers.  Indices are the same ones
 123          * accepted by bpwp_enable().
 124          */
 125         int (*bpwp_disable)(struct arm_dpm *, unsigned index_value);
 126
 127         /* The breakpoint and watchpoint arrays are private to the
 128          * DPM infrastructure.  There are nbp indices in the dbp
 129          * array.  There are nwp indices in the dwp array.
 130          */
 131
 132         unsigned nbp;
 133         unsigned nwp;
 134         struct dpm_bp *dbp;
 135         struct dpm_wp *dwp;
 136
 137         /** Address of the instruction which triggered a watchpoint. */
 138         uint32_t wp_pc;
 139
 140         /** Recent value of DSCR. */
 141         uint32_t dscr;
 142
 143         /* FIXME -- read/write DCSR methods and symbols */
 144 };
 145
 146 int arm_dpm_setup(struct arm_dpm *dpm);
 147 int arm_dpm_initialize(struct arm_dpm *dpm);
 148
 149 int arm_dpm_read_current_registers(struct arm_dpm *);
 150 int arm_dpm_read_current_registers_64(struct arm_dpm *);
 151 int dpm_modeswitch(struct arm_dpm *dpm, enum arm_mode mode);
 152
 153
 154 int arm_dpm_write_dirty_registers(struct arm_dpm *, bool bpwp);
 155
 156 void arm_dpm_report_wfar(struct arm_dpm *, uint32_t wfar);
 157
 158 /* DSCR bits; see ARMv7a arch spec section C10.3.1.
 159  * Not all v7 bits are valid in v6.
 160  */
 161 #define DSCR_CORE_HALTED            (0x1 <<  0)
 162 #define DSCR_CORE_RESTARTED         (0x1 <<  1)
 163 #define DSCR_ENTRY_MASK             (0xF <<  2)
 164 #define DSCR_STICKY_ABORT_PRECISE   (0x1 <<  6)
 165 #define DSCR_STICKY_ABORT_IMPRECISE (0x1 <<  7)
 166 #define DSCR_STICKY_UNDEFINED       (0x1 <<  8)
 167 #define DSCR_DBG_NOPWRDWN           (0x1 <<  9) /* v6 only */
 168 #define DSCR_DBG_ACK                (0x1 << 10)
 169 #define DSCR_INT_DIS                (0x1 << 11)
 170 #define DSCR_CP14_USR_COMMS         (0x1 << 12)
 171 #define DSCR_ITR_EN                 (0x1 << 13)
 172 #define DSCR_HALT_DBG_MODE          (0x1 << 14)
 173 #define DSCR_MON_DBG_MODE           (0x1 << 15)
 174 #define DSCR_SEC_PRIV_INVASV_DIS    (0x1 << 16)
 175 #define DSCR_SEC_PRIV_NINVASV_DIS   (0x1 << 17)
 176 #define DSCR_NON_SECURE             (0x1 << 18)
 177 #define DSCR_DSCRD_IMPRECISE_ABORT  (0x1 << 19)
 178 #define DSCR_EXT_DCC_MASK           (0x3 << 20) /* DTR mode */  /* bits 22, 23 are reserved */
 179 #define DSCR_INSTR_COMP             (0x1 << 24)
 180 #define DSCR_PIPE_ADVANCE           (0x1 << 25)
 181 #define DSCR_DTRTX_FULL_LATCHED     (0x1 << 26)
 182 #define DSCR_DTRRX_FULL_LATCHED     (0x1 << 27) /* bit 28 is reserved */
 183 #define DSCR_DTR_TX_FULL            (0x1 << 29)
 184 #define DSCR_DTR_RX_FULL            (0x1 << 30) /* bit 31 is reserved */
 185
 186 #define DSCR_ENTRY(dscr)            (((dscr) >> 2) & 0xf)
 187 #define DSCR_RUN_MODE(dscr)         ((dscr) & (DSCR_CORE_HALTED | DSCR_CORE_RESTARTED))
 188
 189
 190 /* Methods of entry into debug mode */
 191 #define DSCR_ENTRY_HALT_REQ           (0x0 << 2)
 192 #define DSCR_ENTRY_BREAKPOINT         (0x1 << 2)
 193 #define DSCR_ENTRY_IMPRECISE_WATCHPT  (0x2 << 2)
 194 #define DSCR_ENTRY_BKPT_INSTR         (0x3 << 2)
 195 #define DSCR_ENTRY_EXT_DBG_REQ        (0x4 << 2)
 196 #define DSCR_ENTRY_VECT_CATCH         (0x5 << 2)
 197 #define DSCR_ENTRY_D_SIDE_ABORT       (0x6 << 2)  /* v6 only */
 198 #define DSCR_ENTRY_I_SIDE_ABORT       (0x7 << 2)  /* v6 only */
 199 #define DSCR_ENTRY_OS_UNLOCK          (0x8 << 2)
 200 #define DSCR_ENTRY_PRECISE_WATCHPT    (0xA << 2)
 201
 202 /* DTR modes */
 203 #define DSCR_EXT_DCC_NON_BLOCKING     (0x0 << 20)
 204 #define DSCR_EXT_DCC_STALL_MODE       (0x1 << 20)
 205 #define DSCR_EXT_DCC_FAST_MODE        (0x2 << 20)  /* bits 22, 23 are reserved */
 206
 207
 208
 209
 210
 211 /* DRCR (debug run control register) bits */
 212 #define DRCR_HALT                               (1 << 0)
 213 #define DRCR_RESTART                    (1 << 1)
 214 #define DRCR_CLEAR_EXCEPTIONS   (1 << 2)
 215
 216 void arm_dpm_report_dscr(struct arm_dpm *dpm, uint32_t dcsr);
 217
 218 /* PRCR (Device Power-down and Reset Control Register) bits */
 219 #define PRCR_DEBUG_NO_POWER_DOWN         (1 << 0)
 220 #define PRCR_WARM_RESET                  (1 << 1)
 221 #define PRCR_HOLD_NON_DEBUG_RESET        (1 << 2)
 222
 223 /* PRSR (Device Power-down and Reset Status Register) bits */
 224 #define PRSR_POWERUP_STATUS              (1 << 0)
 225 #define PRSR_STICKY_POWERDOWN_STATUS     (1 << 1)
 226 #define PRSR_RESET_STATUS                (1 << 2)
 227 #define PRSR_STICKY_RESET_STATUS         (1 << 3)
 228 #define PRSR_HALTED                      (1 << 4)  /* v7.1 Debug only */
 229 #define PRSR_OSLK                        (1 << 5)  /* v7.1 Debug only */
 230 #define PRSR_DLK                         (1 << 6)  /* v7.1 Debug only */
 231
 232 /* OSLSR (OS Lock Status Register) bits */
 233 #define OSLSR_OSLM0                      (1 << 0)
 234 #define OSLSR_OSLK                       (1 << 1)
 235 #define OSLSR_nTT                        (1 << 2)
 236 #define OSLSR_OSLM1                      (1 << 3)
 237 #define OSLSR_OSLM                       (OSLSR_OSLM0|OSLSR_OSLM1)
 238
 239 #endif /* OPENOCD_TARGET_ARM_DPM_H */