1 /***************************************************************************
2 * Copyright (C) 2006 by Magnus Lundin *
5 * This program is free software; you can redistribute it and/or modify *
6 * it under the terms of the GNU General Public License as published by *
7 * the Free Software Foundation; either version 2 of the License, or *
8 * (at your option) any later version. *
10 * This program is distributed in the hope that it will be useful, *
11 * but WITHOUT ANY WARRANTY; without even the implied warranty of *
12 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the *
13 * GNU General Public License for more details. *
15 * You should have received a copy of the GNU General Public License *
16 * along with this program; if not, write to the *
17 * Free Software Foundation, Inc., *
18 * 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA. *
19 ***************************************************************************/
20 #ifndef CORTEX_SWJDP_H
21 #define CORTEX_SWJDP_H
27 #define SWJDP_IR_DPACC 0xA
28 #define SWJDP_IR_APACC 0xB
33 #define DP_CTRL_STAT 0x4
37 #define CORUNDETECT (1<<0)
38 #define SSTICKYORUN (1<<1)
39 #define SSTICKYERR (1<<5)
40 #define CDBGRSTREQ (1<<26)
41 #define CDBGRSTACK (1<<27)
42 #define CDBGPWRUPREQ (1<<28)
43 #define CDBGPWRUPACK (1<<29)
44 #define CSYSPWRUPREQ (1<<30)
45 #define CSYSPWRUPACK (1<<31)
47 #define AHBAP_CSW 0x00
48 #define AHBAP_TAR 0x04
49 #define AHBAP_DRW 0x0C
50 #define AHBAP_BD0 0x10
51 #define AHBAP_BD1 0x14
52 #define AHBAP_BD2 0x18
53 #define AHBAP_BD3 0x1C
54 #define AHBAP_DBGROMA 0xF8
55 #define AHBAP_IDR 0xFC
61 #define CSW_ADDRINC_MASK (3<<4)
62 #define CSW_ADDRINC_OFF 0
63 #define CSW_ADDRINC_SINGLE (1<<4)
64 #define CSW_ADDRINC_PACKED (2<<4)
65 #define CSW_HPROT (1<<25)
66 #define CSW_MASTER_DEBUG (1<<29)
67 #define CSW_DBGSWENABLE (1<<31)
69 /* transaction mode */
70 #define TRANS_MODE_NONE 0
71 /* Transaction waits for previous to complete */
72 #define TRANS_MODE_ATOMIC 1
73 /* Freerunning transactions with delays and overrun checking */
74 #define TRANS_MODE_COMPOSITE 2
76 typedef struct swjdp_reg_s
79 arm_jtag_t *jtag_info;
82 typedef struct swjdp_common_s
84 arm_jtag_t *jtag_info;
87 /* Register select cache */
92 /* information about current pending SWjDP-AHBAP transaction */
99 /* Internal functions used in the module, partial transactions, use with caution */
100 extern int swjdp_write_dpacc(swjdp_common_t *swjdp, u32 value, u8 reg_addr);
101 //extern int swjdp_write_apacc(swjdp_common_t *swjdp, u32 value, u8 reg_addr);
102 extern int swjdp_read_dpacc(swjdp_common_t *swjdp, u32 *value, u8 reg_addr);
103 //extern int swjdp_read_apacc(swjdp_common_t *swjdp, u32 *value, u8 reg_addr);
104 extern int ahbap_write_reg(swjdp_common_t *swjdp, u32 reg_addr, u8* out_value_buf);
105 extern int ahbap_read_reg(swjdp_common_t *swjdp, u32 reg_addr, u8 *in_value_buf);
107 /* External interface, partial operations must be completed with swjdp_transaction_endcheck() */
108 extern int ahbap_read_system_u32(swjdp_common_t *swjdp, u32 address, u32 *value);
109 extern int ahbap_write_system_u32(swjdp_common_t *swjdp, u32 address, u32 value);
110 extern int swjdp_transaction_endcheck(swjdp_common_t *swjdp);
112 /* External interface, complete atomic operations */
113 /* Host endian word transfer of single memory and system registers */
114 extern int ahbap_read_system_atomic_u32(swjdp_common_t *swjdp, u32 address, u32 *value);
115 extern int ahbap_write_system_atomic_u32(swjdp_common_t *swjdp, u32 address, u32 value);
116 /* Target endian (u8*) buffer transfers of blocks of memory and system registers */
117 extern int ahbap_read_block(swjdp_common_t *swjdp, u8 *buffer, int bytecount, u32 address);
118 extern int ahbap_write_block(swjdp_common_t *swjdp, u8 *buffer, int bytecount, u32 address);
119 /* Host endian word transfers of processor core registers */
120 extern int ahbap_read_coreregister_u32(swjdp_common_t *swjdp, u32 *value, int regnum);
121 extern int ahbap_write_coreregister_u32(swjdp_common_t *swjdp, u32 value, int regnum);
123 extern int ahbap_read_buf(swjdp_common_t *swjdp, u8 *buffer, int count, u32 address);
124 extern int ahbap_read_buf_u16(swjdp_common_t *swjdp, u8 *buffer, int count, u32 address);
125 extern int ahbap_write_buf(swjdp_common_t *swjdp, u8 *buffer, int count, u32 address);
126 extern int ahbap_write_buf_u16(swjdp_common_t *swjdp, u8 *buffer, int count, u32 address);
128 /* Initialisation of the debug system, power domains and registers */
129 extern int ahbap_debugport_init(swjdp_common_t *swjdp);