src/target/embeddedice.h

   1 /***************************************************************************
   2  *   Copyright (C) 2005, 2006 by Dominic Rath                              *
   3  *   Dominic.Rath@gmx.de                                                   *
   4  *                                                                         *
   5  *   Copyright (C) 2007,2008 Øyvind Harboe                                 *
   6  *   oyvind.harboe@zylin.com                                               *
   7  *                                                                         *
   8  *   Copyright (C) 2008 by Spencer Oliver                                  *
   9  *   spen@spen-soft.co.uk                                                  *
  10  *                                                                         *
  11  *   This program is free software; you can redistribute it and/or modify  *
  12  *   it under the terms of the GNU General Public License as published by  *
  13  *   the Free Software Foundation; either version 2 of the License, or     *
  14  *   (at your option) any later version.                                   *
  15  *                                                                         *
  16  *   This program is distributed in the hope that it will be useful,       *
  17  *   but WITHOUT ANY WARRANTY; without even the implied warranty of        *
  18  *   MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the         *
  19  *   GNU General Public License for more details.                          *
  20  *                                                                         *
  21  *   You should have received a copy of the GNU General Public License     *
  22  *   along with this program; if not, write to the                         *
  23  *   Free Software Foundation, Inc.,                                       *
  24  *   51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA.           *
  25  ***************************************************************************/
  26
  27 #ifndef EMBEDDED_ICE_H
  28 #define EMBEDDED_ICE_H
  29
  30 #include "arm7_9_common.h"
  31
  32 enum {
  33         EICE_DBG_CTRL = 0,
  34         EICE_DBG_STAT = 1,
  35         EICE_COMMS_CTRL = 2,
  36         EICE_COMMS_DATA = 3,
  37         EICE_W0_ADDR_VALUE = 4,
  38         EICE_W0_ADDR_MASK = 5,
  39         EICE_W0_DATA_VALUE  = 6,
  40         EICE_W0_DATA_MASK = 7,
  41         EICE_W0_CONTROL_VALUE = 8,
  42         EICE_W0_CONTROL_MASK = 9,
  43         EICE_W1_ADDR_VALUE = 10,
  44         EICE_W1_ADDR_MASK = 11,
  45         EICE_W1_DATA_VALUE = 12,
  46         EICE_W1_DATA_MASK = 13,
  47         EICE_W1_CONTROL_VALUE = 14,
  48         EICE_W1_CONTROL_MASK = 15,
  49         EICE_VEC_CATCH = 16
  50 };
  51
  52 enum {
  53         EICE_DBG_CONTROL_ICEDIS = 5,
  54         EICE_DBG_CONTROL_MONEN = 4,
  55         EICE_DBG_CONTROL_INTDIS = 2,
  56         EICE_DBG_CONTROL_DBGRQ = 1,
  57         EICE_DBG_CONTROL_DBGACK = 0,
  58 };
  59
  60 enum {
  61         EICE_DBG_STATUS_IJBIT = 5,
  62         EICE_DBG_STATUS_ITBIT = 4,
  63         EICE_DBG_STATUS_SYSCOMP = 3,
  64         EICE_DBG_STATUS_IFEN = 2,
  65         EICE_DBG_STATUS_DBGRQ = 1,
  66         EICE_DBG_STATUS_DBGACK = 0
  67 };
  68
  69 enum {
  70         EICE_W_CTRL_ENABLE = 0x100,
  71         EICE_W_CTRL_RANGE = 0x80,
  72         EICE_W_CTRL_CHAIN = 0x40,
  73         EICE_W_CTRL_EXTERN = 0x20,
  74         EICE_W_CTRL_nTRANS = 0x10,
  75         EICE_W_CTRL_nOPC = 0x8,
  76         EICE_W_CTRL_MAS = 0x6,
  77         EICE_W_CTRL_ITBIT = 0x2,
  78         EICE_W_CTRL_nRW = 0x1
  79 };
  80
  81 enum {
  82         EICE_COMM_CTRL_WBIT = 1,
  83         EICE_COMM_CTRL_RBIT = 0
  84 };
  85
  86 struct embeddedice_reg {
  87         int addr;
  88         struct arm_jtag *jtag_info;
  89 };
  90
  91 struct reg_cache *embeddedice_build_reg_cache(struct target *target,
  92                 struct arm7_9_common *arm7_9);
  93
  94 int embeddedice_setup(struct target *target);
  95
  96 int embeddedice_read_reg(struct reg *reg);
  97 int embeddedice_read_reg_w_check(struct reg *reg,
  98                 uint8_t *check_value, uint8_t *check_mask);
  99
 100 void embeddedice_write_reg(struct reg *reg, uint32_t value);
 101 void embeddedice_store_reg(struct reg *reg);
 102
 103 void embeddedice_set_reg(struct reg *reg, uint32_t value);
 104
 105 int embeddedice_receive(struct arm_jtag *jtag_info, uint32_t *data, uint32_t size);
 106 int embeddedice_send(struct arm_jtag *jtag_info, uint32_t *data, uint32_t size);
 107
 108 int embeddedice_handshake(struct arm_jtag *jtag_info, int hsbit, uint32_t timeout);
 109
 110 /* If many embeddedice_write_reg() follow eachother, then the >1 invocations can be
 111  * this faster version of embeddedice_write_reg
 112  */
 113 static inline void embeddedice_write_reg_inner(struct jtag_tap *tap, int reg_addr, uint32_t value)
 114 {
 115         uint8_t out_reg_addr = (1 << 5) | reg_addr;
 116         uint8_t out_value[4];
 117         buf_set_u32(out_value, 0, 32, value);
 118
 119         struct scan_field fields[2] = {
 120                         { .num_bits = 32, .out_value = out_value },
 121                         { .num_bits = 6, .out_value = &out_reg_addr },
 122         };
 123
 124         jtag_add_dr_scan(tap, 2, fields, TAP_IDLE);
 125 }
 126
 127 void embeddedice_write_dcc(struct jtag_tap *tap, int reg_addr, const uint8_t *buffer,
 128                 int little, int count);
 129
 130 #endif /* EMBEDDED_ICE_H */