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 ***************************************************************************/
23 #ifndef CORTEX_SWJDP_H
24 #define CORTEX_SWJDP_H
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 AHBAP_CSW 0x00
51 #define AHBAP_TAR 0x04
52 #define AHBAP_DRW 0x0C
53 #define AHBAP_BD0 0x10
54 #define AHBAP_BD1 0x14
55 #define AHBAP_BD2 0x18
56 #define AHBAP_BD3 0x1C
57 #define AHBAP_DBGROMA 0xF8
58 #define AHBAP_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 /* Register select cache */
94 /* information about current pending SWjDP-AHBAP transaction */
100 /* Internal functions used in the module, partial transactions, use with caution */
101 extern int swjdp_write_dpacc(swjdp_common_t *swjdp, u32 value, u8 reg_addr);
102 /* extern int swjdp_write_apacc(swjdp_common_t *swjdp, u32 value, u8 reg_addr); */
103 extern int swjdp_read_dpacc(swjdp_common_t *swjdp, u32 *value, u8 reg_addr);
104 /* extern int swjdp_read_apacc(swjdp_common_t *swjdp, u32 *value, u8 reg_addr); */
105 extern int ahbap_write_reg(swjdp_common_t *swjdp, u32 reg_addr, u8* out_value_buf);
106 extern int ahbap_read_reg(swjdp_common_t *swjdp, u32 reg_addr, u8 *in_value_buf);
108 /* External interface, partial operations must be completed with swjdp_transaction_endcheck() */
109 extern int ahbap_read_system_u32(swjdp_common_t *swjdp, u32 address, u32 *value);
110 extern int ahbap_write_system_u32(swjdp_common_t *swjdp, u32 address, u32 value);
111 extern int swjdp_transaction_endcheck(swjdp_common_t *swjdp);
113 /* External interface, complete atomic operations */
114 /* Host endian word transfer of single memory and system registers */
115 extern int ahbap_read_system_atomic_u32(swjdp_common_t *swjdp, u32 address, u32 *value);
116 extern int ahbap_write_system_atomic_u32(swjdp_common_t *swjdp, u32 address, u32 value);
118 /* Host endian word transfers of processor core registers */
119 extern int ahbap_read_coreregister_u32(swjdp_common_t *swjdp, u32 *value, int regnum);
120 extern int ahbap_write_coreregister_u32(swjdp_common_t *swjdp, u32 value, int regnum);
122 extern int ahbap_read_buf_u8(swjdp_common_t *swjdp, u8 *buffer, int count, u32 address);
123 extern int ahbap_read_buf_u16(swjdp_common_t *swjdp, u8 *buffer, int count, u32 address);
124 extern int ahbap_read_buf_u32(swjdp_common_t *swjdp, u8 *buffer, int count, u32 address);
126 extern int ahbap_write_buf_u8(swjdp_common_t *swjdp, u8 *buffer, int count, u32 address);
127 extern int ahbap_write_buf_u16(swjdp_common_t *swjdp, u8 *buffer, int count, u32 address);
128 extern int ahbap_write_buf_u32(swjdp_common_t *swjdp, u8 *buffer, int count, u32 address);
130 /* Initialisation of the debug system, power domains and registers */
131 extern int ahbap_debugport_init(swjdp_common_t *swjdp);