811c08698e79916b63c90ef0a9b99167bd0c6355
[fw/openocd] / src / target / dsp563xx_once.h
1 /***************************************************************************
2  *   Copyright (C) 2009 by Mathias Kuester                                 *
3  *   mkdorg@users.sourceforge.net                                          *
4  *                                                                         *
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.                                   *
9  *                                                                         *
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.                          *
14  *                                                                         *
15  *   You should have received a copy of the GNU General Public License     *
16  *   along with this program.  If not, see <http://www.gnu.org/licenses/>. *
17  ***************************************************************************/
18
19 #ifndef OPENOCD_TARGET_DSP563XX_ONCE_H
20 #define OPENOCD_TARGET_DSP563XX_ONCE_H
21
22 #include <jtag/jtag.h>
23
24 #ifdef HAVE_CONFIG_H
25 #include "config.h"
26 #endif
27
28 #define DSP563XX_ONCE_OCR_EX    (1<<5)
29 #define DSP563XX_ONCE_OCR_GO    (1<<6)
30 #define DSP563XX_ONCE_OCR_RW    (1<<7)
31
32 #define DSP563XX_ONCE_OSCR_OS1  (1<<7)
33 #define DSP563XX_ONCE_OSCR_OS0  (1<<6)
34 #define DSP563XX_ONCE_OSCR_HIT  (1<<5)
35 #define DSP563XX_ONCE_OSCR_TO   (1<<4)
36 #define DSP563XX_ONCE_OSCR_MBO  (1<<3)
37 #define DSP563XX_ONCE_OSCR_SWO  (1<<2)
38 #define DSP563XX_ONCE_OSCR_IME  (1<<1)
39 #define DSP563XX_ONCE_OSCR_TME  (1<<0)
40
41 #define DSP563XX_ONCE_OSCR_NORMAL_M     (0)
42 #define DSP563XX_ONCE_OSCR_STOPWAIT_M   (DSP563XX_ONCE_OSCR_OS0)
43 #define DSP563XX_ONCE_OSCR_BUSY_M       (DSP563XX_ONCE_OSCR_OS1)
44 #define DSP563XX_ONCE_OSCR_DEBUG_M      (DSP563XX_ONCE_OSCR_OS0|DSP563XX_ONCE_OSCR_OS1)
45
46 #define DSP563XX_ONCE_OSCR      0x000   /* status/ctrl reg. */
47 #define DSP563XX_ONCE_OMBC      0x001   /* memory breakp. reg. */
48 #define DSP563XX_ONCE_OBCR      0x002   /* breakp. ctrl reg */
49 #define DSP563XX_ONCE_OMLR0     0x005   /* memory limit reg */
50 #define DSP563XX_ONCE_OMLR1     0x006   /* memory limit reg */
51 #define DSP563XX_ONCE_OGDBR     0x009   /* gdb reg */
52 #define DSP563XX_ONCE_OPDBR     0x00A   /* pdb reg */
53 #define DSP563XX_ONCE_OPILR     0x00B   /* pil reg */
54 #define DSP563XX_ONCE_PDBGOTO   0x00C   /* pdb to go reg */
55 #define DSP563XX_ONCE_OTC       0x00D   /* trace cnt */
56 #define DSP563XX_ONCE_TAGB      0x00E   /* tags buffer */
57 #define DSP563XX_ONCE_OPABFR    0x00F   /* pab fetch reg */
58 #define DSP563XX_ONCE_OPABDR    0x010   /* pab decode reg */
59 #define DSP563XX_ONCE_OPABEX    0x011   /* pab exec reg */
60 #define DSP563XX_ONCE_OPABF11   0x012   /* trace buffer/inc ptr */
61 #define DSP563XX_ONCE_NOREG     0x01F   /* no register selected */
62
63 struct once_reg {
64         const uint8_t num;
65         const uint8_t addr;
66         const uint8_t len;
67         const char *name;
68         uint32_t reg;
69 };
70
71 /** */
72 int dsp563xx_once_request_debug(struct jtag_tap *tap, int reset_state);
73 /** */
74 int dsp563xx_once_target_status(struct jtag_tap *tap);
75
76 /** once read registers */
77 int dsp563xx_once_read_register(struct jtag_tap *tap, int flush, struct once_reg *regs, int len);
78 /** once read register */
79 int dsp563xx_once_reg_read_ex(struct jtag_tap *tap, int flush, uint8_t reg, uint8_t len, uint32_t *data);
80 /** once read register */
81 int dsp563xx_once_reg_read(struct jtag_tap *tap, int flush, uint8_t reg, uint32_t *data);
82 /** once write register */
83 int dsp563xx_once_reg_write(struct jtag_tap *tap, int flush, uint8_t reg, uint32_t data);
84 /** single word instruction */
85 int dsp563xx_once_execute_sw_ir(struct jtag_tap *tap, int flush, uint32_t opcode);
86 /** double word instruction */
87 int dsp563xx_once_execute_dw_ir(struct jtag_tap *tap, int flush, uint32_t opcode, uint32_t operand);
88
89 #endif /* OPENOCD_TARGET_DSP563XX_ONCE_H */