1 /***************************************************************************
2 * Copyright (C) 2006 by Magnus Lundin *
5 * Copyright (C) 2008 by Spencer Oliver *
6 * spen@spen-soft.co.uk *
8 * This program is free software; you can redistribute it and/or modify *
9 * it under the terms of the GNU General Public License as published by *
10 * the Free Software Foundation; either version 2 of the License, or *
11 * (at your option) any later version. *
13 * This program is distributed in the hope that it will be useful, *
14 * but WITHOUT ANY WARRANTY; without even the implied warranty of *
15 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the *
16 * GNU General Public License for more details. *
18 * You should have received a copy of the GNU General Public License *
19 * along with this program; if not, write to the *
20 * Free Software Foundation, Inc., *
21 * 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA. *
22 ***************************************************************************/
30 #define SWJDP_IR_DPACC 0xA
31 #define SWJDP_IR_APACC 0xB
36 #define DP_CTRL_STAT 0x4
40 #define CORUNDETECT (1<<0)
41 #define SSTICKYORUN (1<<1)
42 #define SSTICKYERR (1<<5)
43 #define CDBGRSTREQ (1<<26)
44 #define CDBGRSTACK (1<<27)
45 #define CDBGPWRUPREQ (1<<28)
46 #define CDBGPWRUPACK (1<<29)
47 #define CSYSPWRUPREQ (1<<30)
48 #define CSYSPWRUPACK (1<<31)
50 #define AP_REG_CSW 0x00
51 #define AP_REG_TAR 0x04
52 #define AP_REG_DRW 0x0C
53 #define AP_REG_BD0 0x10
54 #define AP_REG_BD1 0x14
55 #define AP_REG_BD2 0x18
56 #define AP_REG_BD3 0x1C
57 #define AP_REG_DBGROMA 0xF8
58 #define AP_REG_IDR 0xFC
64 #define CSW_ADDRINC_MASK (3<<4)
65 #define CSW_ADDRINC_OFF 0
66 #define CSW_ADDRINC_SINGLE (1<<4)
67 #define CSW_ADDRINC_PACKED (2<<4)
68 #define CSW_HPROT (1<<25)
69 #define CSW_MASTER_DEBUG (1<<29)
70 #define CSW_DBGSWENABLE (1<<31)
72 /* transaction mode */
73 #define TRANS_MODE_NONE 0
74 /* Transaction waits for previous to complete */
75 #define TRANS_MODE_ATOMIC 1
76 /* Freerunning transactions with delays and overrun checking */
77 #define TRANS_MODE_COMPOSITE 2
79 typedef struct swjdp_reg_s
82 arm_jtag_t *jtag_info;
85 typedef struct swjdp_common_s
87 arm_jtag_t *jtag_info;
90 /* Support for several AP's in one DAP */
92 /* Register select cache */
96 /* information about current pending SWjDP-AHBAP transaction */
102 /* Internal functions used in the module, partial transactions, use with caution */
103 extern int dap_dp_write_reg(swjdp_common_t *swjdp, u32 value, u8 reg_addr);
104 /* extern int swjdp_write_apacc(swjdp_common_t *swjdp, u32 value, u8 reg_addr); */
105 extern int dap_dp_read_reg(swjdp_common_t *swjdp, u32 *value, u8 reg_addr);
106 /* extern int swjdp_read_apacc(swjdp_common_t *swjdp, u32 *value, u8 reg_addr); */
107 extern int dap_setup_accessport(swjdp_common_t *swjdp, u32 csw, u32 tar);
108 extern int dap_ap_select(swjdp_common_t *swjdp,u8 apsel);
110 extern int dap_ap_write_reg(swjdp_common_t *swjdp, u32 reg_addr, u8* out_value_buf);
111 extern int dap_ap_write_reg_u32(swjdp_common_t *swjdp, u32 reg_addr, u32 value);
112 extern int dap_ap_read_reg(swjdp_common_t *swjdp, u32 reg_addr, u8 *in_value_buf);
113 extern int dap_ap_read_reg_u32(swjdp_common_t *swjdp, u32 reg_addr, u32 *value);
115 /* External interface, partial operations must be completed with swjdp_transaction_endcheck() */
116 extern int swjdp_transaction_endcheck(swjdp_common_t *swjdp);
118 /* MEM-AP memory mapped bus single u32 register transfers, without endcheck */
119 extern int mem_ap_read_u32(swjdp_common_t *swjdp, u32 address, u32 *value);
120 extern int mem_ap_write_u32(swjdp_common_t *swjdp, u32 address, u32 value);
122 /* MEM-AP memory mapped bus transfers, single registers, complete transactions */
123 extern int mem_ap_read_atomic_u32(swjdp_common_t *swjdp, u32 address, u32 *value);
124 extern int mem_ap_write_atomic_u32(swjdp_common_t *swjdp, u32 address, u32 value);
126 /* MEM-AP memory mapped bus block transfers */
127 extern int mem_ap_read_buf_u8(swjdp_common_t *swjdp, u8 *buffer, int count, u32 address);
128 extern int mem_ap_read_buf_u16(swjdp_common_t *swjdp, u8 *buffer, int count, u32 address);
129 extern int mem_ap_read_buf_u32(swjdp_common_t *swjdp, u8 *buffer, int count, u32 address);
130 extern int mem_ap_write_buf_u8(swjdp_common_t *swjdp, u8 *buffer, int count, u32 address);
131 extern int mem_ap_write_buf_u16(swjdp_common_t *swjdp, u8 *buffer, int count, u32 address);
132 extern int mem_ap_write_buf_u32(swjdp_common_t *swjdp, u8 *buffer, int count, u32 address);
134 /* Initialisation of the debug system, power domains and registers */
135 extern int ahbap_debugport_init(swjdp_common_t *swjdp);
137 extern int dap_info_command(struct command_context_s *cmd_ctx, swjdp_common_t *swjdp, int apsel);
138 /* Commands for user dap access */
139 /* Currently implemented in armv7m, needs armv7m target structure to find jtag and swjdp structures */
140 extern int handle_dap_info_command(struct command_context_s *cmd_ctx, char *cmd, char **args, int argc);
141 extern int handle_dap_apsel_command(struct command_context_s *cmd_ctx, char *cmd, char **args, int argc);
142 extern int handle_dap_apid_command(struct command_context_s *cmd_ctx, char *cmd, char **args, int argc);
143 extern int handle_dap_baseaddr_command(struct command_context_s *cmd_ctx, char *cmd, char **args, int argc);