8ccd477012ca6d7264a8f8810a4aa911e7825019
[fw/altos] / ccdbg.h
1 /*
2  * Copyright © 2008 Keith Packard <keithp@keithp.com>
3  *
4  * This program is free software; you can redistribute it and/or modify
5  * it under the terms of the GNU General Public License as published by
6  * the Free Software Foundation; either version 2 of the License, or
7  * (at your option) any later version.
8  *
9  * This program is distributed in the hope that it will be useful, but
10  * WITHOUT ANY WARRANTY; without even the implied warranty of
11  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
12  * General Public License for more details.
13  *
14  * You should have received a copy of the GNU General Public License along
15  * with this program; if not, write to the Free Software Foundation, Inc.,
16  * 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA.
17  */
18
19 #ifndef _CCDBG_H_
20 #define _CCDBG_H_
21
22 #include <stdint.h>
23 #include <stdlib.h>
24 #include <unistd.h>
25 #include <string.h>
26 #include <stdio.h>
27 #include <stdint.h>
28 #include <assert.h>
29 #include <fcntl.h>
30 #include <sys/types.h>
31 #include <sys/ioctl.h>
32 #include <sys/stat.h>
33 #undef USE_KERNEL
34 #ifdef USE_KERNEL
35 #include <cp2101.h>
36 #define CC_CLOCK        CP2101_GPIO_MASK(0)
37 #define CC_DATA         CP2101_GPIO_MASK(1)
38 #define CC_RESET_N      CP2101_GPIO_MASK(2)
39 #else
40 #define CC_CLOCK        0x1
41 #define CC_DATA         0x2
42 #define CC_RESET_N      0x4
43 #include <usb.h>
44 #endif
45
46
47 /* painfully slow for now */
48 #define CC_CLOCK_US     (100)
49
50 struct ccdbg {
51         usb_dev_handle  *usb_dev;
52         uint8_t gpio;
53 #ifdef USE_KERNEL
54         int     fd;
55 #endif
56         uint8_t debug_data;
57         int     clock;
58 };
59
60 #include "cccp.h"
61
62 #define CC_CHIP_ERASE           0x14
63
64 #define CC_WR_CONFIG            0x1d
65 #define CC_RD_CONFIG            0x24
66 # define CC_CONFIG_TIMERS_OFF           (1 << 3)
67 # define CC_CONFIG_DMA_PAUSE            (1 << 2)
68 # define CC_CONFIG_TIMER_SUSPEND        (1 << 1)
69 # define CC_SET_FLASH_INFO_PAGE         (1 << 0)
70
71 #define CC_GET_PC               0x28
72 #define CC_READ_STATUS          0x34
73 # define CC_STATUS_CHIP_ERASE_DONE      (1 << 7)
74 # define CC_STATUS_PCON_IDLE            (1 << 6)
75 # define CC_STATUS_CPU_HALTED           (1 << 5)
76 # define CC_STATUS_POWER_MODE_0         (1 << 4)
77 # define CC_STATUS_HALT_STATUS          (1 << 3)
78 # define CC_STATUS_DEBUG_LOCKED         (1 << 2)
79 # define CC_STATUS_OSCILLATOR_STABLE    (1 << 1)
80 # define CC_STATUS_STACK_OVERFLOW       (1 << 0)
81
82 #define CC_SET_HW_BRKPNT        0x3b
83 # define CC_HW_BRKPNT_N(n)      ((n) << 3)
84 # define CC_HW_BRKPNT_N_MASK    (0x3 << 3)
85 # define CC_HW_BRKPNT_ENABLE    (1 << 2)
86
87 #define CC_HALT                 0x44
88 #define CC_RESUME               0x4c
89 #define CC_DEBUG_INSTR(n)       (0x54|(n))
90 #define CC_STEP_INSTR           0x5c
91 #define CC_STEP_REPLACE         (0x64|(n))
92 #define CC_GET_CHIP_ID          0x68
93
94 /* ccdbg-command.c */
95 void
96 ccdbg_debug_mode(struct ccdbg *dbg);
97
98 void
99 ccdbg_reset(struct ccdbg *dbg);
100
101 uint8_t
102 ccdbg_read_status(struct ccdbg *dbg);
103
104 uint8_t
105 ccdbg_rd_config(struct ccdbg *dbg);
106
107 uint16_t
108 ccdbg_get_chip_id(struct ccdbg *dbg);
109
110 /* ccdbg-io.c */
111 void
112 ccdbg_quarter_clock(struct ccdbg *dbg);
113
114 void
115 ccdbg_half_clock(struct ccdbg *dbg);
116
117 int
118 ccdbg_write(struct ccdbg *dbg, uint8_t mask, uint8_t value);
119
120 uint8_t
121 ccdbg_read(struct ccdbg *dbg);
122
123 struct ccdbg *
124 ccdbg_open(char *file);
125
126 void
127 ccdbg_close(struct ccdbg *dbg);
128
129 void
130 ccdbg_clock_1_0(struct ccdbg *dbg);
131
132 void
133 ccdbg_clock_0_1(struct ccdbg *dbg);
134
135 void
136 ccdbg_write_bit(struct ccdbg *dbg, uint8_t bit);
137
138 void
139 ccdbg_write_byte(struct ccdbg *dbg, uint8_t byte);
140
141 uint8_t
142 ccdbg_read_bit(struct ccdbg *dbg);
143
144 uint8_t
145 ccdbg_read_byte(struct ccdbg *dbg);
146
147 void
148 ccdbg_cmd_write(struct ccdbg *dbg, uint8_t cmd, uint8_t *data, int len);
149
150 uint8_t
151 ccdbg_cmd_write_read8(struct ccdbg *dbg, uint8_t cmd, uint8_t *data, int len);
152
153 uint16_t
154 ccdbg_cmd_write_read16(struct ccdbg *dbg, uint8_t cmd, uint8_t *data, int len);
155
156 /* cp-usb.c */
157 void
158 cp_usb_init(struct ccdbg *dbg);
159
160 void
161 cp_usb_fini(struct ccdbg *dbg);
162
163 void
164 cp_usb_write(struct ccdbg *dbg, uint8_t mask, uint8_t value);
165
166 uint8_t
167 cp_usb_read(struct ccdbg *dbg);
168
169 #endif /* _CCDBG_H_ */