summaryrefslogtreecommitdiff
path: root/ao-tools/lib/ccdbg.h
blob: b17f289d59894d0f72d532ed0b331373ceae21ff (plain) (blame)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
/*
 * Copyright © 2008 Keith Packard <keithp@keithp.com>
 *
 * This program is free software; you can redistribute it and/or modify
 * it under the terms of the GNU General Public License as published by
 * the Free Software Foundation; either version 2 of the License, or
 * (at your option) any later version.
 *
 * This program is distributed in the hope that it will be useful, but
 * WITHOUT ANY WARRANTY; without even the implied warranty of
 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
 * General Public License for more details.
 *
 * You should have received a copy of the GNU General Public License along
 * with this program; if not, write to the Free Software Foundation, Inc.,
 * 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA.
 */

#ifndef _CCDBG_H_
#define _CCDBG_H_

#include <stdint.h>
#include <stdlib.h>
#include <unistd.h>
#include <string.h>
#include <stdio.h>
#include <stdint.h>
#include <assert.h>
#include <fcntl.h>
#include <sys/types.h>
#include <sys/ioctl.h>
#include <sys/stat.h>
#include "ccdbg-debug.h"
#include "cc-bitbang.h"
#include "cc-usb.h"
#include "ao-hex.h"

/* 8051 instructions
 */
#define NOP			0x00
#define MOV_direct_data		0x75
#define LJMP			0x02
#define MOV_Rn_data(n)		(0x78 | (n))
#define DJNZ_Rn_rel(n)		(0xd8 | (n))
#define MOV_A_direct		0xe5
#define MOV_direct1_direct2	0x85
#define MOV_direct_A		0xf5
#define MOV_DPTR_data16		0x90
#define MOV_A_data		0x74
#define MOVX_atDPTR_A		0xf0
#define MOVX_A_atDPTR		0xe0
#define INC_DPTR		0xa3
#define TRAP			0xa5
#define SJMP			0x80
#define JB			0x20

/* 8051 special function registers
 */

#define SFR_P0			0x80
#define SFR_SP			0x81
#define SFR_DPL0		0x82
#define SFR_DPH0		0x83
#define SFR_DPL1		0x84
#define SFR_DPH1		0x85

/* flash controller */
#define FWT			0xAB
#define FADDRL			0xAC
#define FADDRH			0xAD
#define FCTL			0xAE
# define FCTL_BUSY		0x80
# define FCTL_BUSY_BIT		7
# define FCTL_SWBSY		0x40
# define FCTL_SWBSY_BIT		6
# define FCTL_CONTRD		0x10
# define FCTL_WRITE		0x02
# define FCTL_ERASE		0x01
#define FWDATA			0xAF

#define SLEEP			0xBE

/* clock controller */
#define CLKCON			0xC6
#define  CLKCON_OSC32K		0x80
#define  CLKCON_OSC		0x40
#define  CLKCON_TICKSPD		0x38
#define  CLKCON_CLKSPD		0x07

/* I/O pins */
#define P0			0x80
#define P1			0x90
#define P2			0xA0
#define P0DIR			0xFD
#define P1DIR			0xFE
#define P2DIR			0xFF

/* Bit-addressable accumulator */
#define ACC(bit)		(0xE0 | (bit))

/* Bit-addressable status word */
#define PSW(bit)		(0xD0 | (bit))

struct ccdbg {
	struct cc_bitbang	*bb;
	struct cc_usb		*usb;
	struct ao_hex_image	*rom;
};


#define CC_STATE_ACC	0x1
#define CC_STATE_PSW	0x2
#define CC_STATE_DP	0x4

#define CC_STATE_NSFR	5

struct ccstate {
	uint16_t	mask;
	uint8_t		acc;
	uint8_t		sfr[CC_STATE_NSFR];
};

/* CC1111 debug port commands
 */
#define CC_CHIP_ERASE		0x14

#define CC_WR_CONFIG		0x1d
#define CC_RD_CONFIG		0x24
# define CC_CONFIG_TIMERS_OFF		(1 << 3)
# define CC_CONFIG_DMA_PAUSE		(1 << 2)
# define CC_CONFIG_TIMER_SUSPEND	(1 << 1)
# define CC_SET_FLASH_INFO_PAGE		(1 << 0)

#define CC_GET_PC		0x28
#define CC_READ_STATUS		0x34
# define CC_STATUS_CHIP_ERASE_DONE	(1 << 7)
# define CC_STATUS_PCON_IDLE		(1 << 6)
# define CC_STATUS_CPU_HALTED		(1 << 5)
# define CC_STATUS_POWER_MODE_0		(1 << 4)
# define CC_STATUS_HALT_STATUS		(1 << 3)
# define CC_STATUS_DEBUG_LOCKED		(1 << 2)
# define CC_STATUS_OSCILLATOR_STABLE	(1 << 1)
# define CC_STATUS_STACK_OVERFLOW	(1 << 0)

#define CC_SET_HW_BRKPNT	0x3b
# define CC_HW_BRKPNT_N(n)	((n) << 3)
# define CC_HW_BRKPNT_N_MASK	(0x3 << 3)
# define CC_HW_BRKPNT_ENABLE	(1 << 2)

#define CC_HALT			0x44
#define CC_RESUME		0x4c
#define CC_DEBUG_INSTR(n)	(0x54|(n))
#define CC_STEP_INSTR		0x5c
#define CC_STEP_REPLACE(n)	(0x64|(n))
#define CC_GET_CHIP_ID		0x68

/* ccdbg-command.c */
void
ccdbg_debug_mode(struct ccdbg *dbg);

void
ccdbg_reset(struct ccdbg *dbg);

uint8_t
ccdbg_chip_erase(struct ccdbg *dbg);

uint8_t
ccdbg_wr_config(struct ccdbg *dbg, uint8_t config);

uint8_t
ccdbg_rd_config(struct ccdbg *dbg);

uint16_t
ccdbg_get_pc(struct ccdbg *dbg);

uint8_t
ccdbg_read_status(struct ccdbg *dbg);

uint8_t
ccdbg_set_hw_brkpnt(struct ccdbg *dbg, uint8_t number, uint8_t enable, uint16_t addr);

uint8_t
ccdbg_halt(struct ccdbg *dbg);

uint8_t
ccdbg_resume(struct ccdbg *dbg);

uint8_t
ccdbg_debug_instr(struct ccdbg *dbg, uint8_t *instr, int nbytes);

void
ccdbg_debug_instr_discard(struct ccdbg *dbg, uint8_t *instr, int nbytes);

void
ccdbg_debug_instr_queue(struct ccdbg *dbg, uint8_t *instr, int nbytes,
			uint8_t *reply);

uint8_t
ccdbg_step_instr(struct ccdbg *dbg);

uint8_t
ccdbg_step_replace(struct ccdbg *dbg, uint8_t *instr, int nbytes);

uint16_t
ccdbg_get_chip_id(struct ccdbg *dbg);

uint8_t
ccdbg_execute(struct ccdbg *dbg, uint8_t *inst);

uint8_t
ccdbg_set_pc(struct ccdbg *dbg, uint16_t pc);

uint8_t
ccdbg_execute_hex_image(struct ccdbg *dbg, struct ao_hex_image *image);

/* ccdbg-flash.c */
uint8_t
ccdbg_flash_hex_image(struct ccdbg *dbg, struct ao_hex_image *image);

/* ccdbg-io.c */
struct ccdbg *
ccdbg_open(char *tty);

void
ccdbg_close(struct ccdbg *dbg);

void
ccdbg_cmd_write(struct ccdbg *dbg, uint8_t cmd, uint8_t *data, int len);

uint8_t
ccdbg_cmd_write_read8(struct ccdbg *dbg, uint8_t cmd, uint8_t *data, int len);

void
ccdbg_cmd_write_queue8(struct ccdbg *dbg, uint8_t cmd,
		       uint8_t *data, int len, uint8_t *reply);

uint16_t
ccdbg_cmd_write_read16(struct ccdbg *dbg, uint8_t cmd, uint8_t *data, int len);

void
ccdbg_send_bytes(struct ccdbg *dbg, uint8_t *bytes, int nbytes);

void
ccdbg_recv_bytes(struct ccdbg *dbg, uint8_t *bytes, int nbytes);

void
ccdbg_sync(struct ccdbg *dbg);

/* ccdbg-manual.c */

void
ccdbg_manual(struct ccdbg *dbg, FILE *input);

/* ccdbg-memory.c */
uint8_t
ccdbg_write_memory(struct ccdbg *dbg, uint16_t addr, uint8_t *bytes, int nbytes);

uint8_t
ccdbg_read_memory(struct ccdbg *dbg, uint16_t addr, uint8_t *bytes, int nbytes);

uint8_t
ccdbg_write_uint8(struct ccdbg *dbg, uint16_t addr, uint8_t byte);

uint8_t
ccdbg_write_hex_image(struct ccdbg *dbg, struct ao_hex_image *image, uint16_t offset);

struct ao_hex_image *
ccdbg_read_hex_image(struct ccdbg *dbg, uint16_t address, uint16_t length);

uint8_t
ccdbg_read_sfr(struct ccdbg *dbg, uint8_t addr, uint8_t *bytes, int nbytes);

uint8_t
ccdbg_write_sfr(struct ccdbg *dbg, uint8_t addr, uint8_t *bytes, int nbytes);

/* ccdbg-rom.c */
uint8_t
ccdbg_set_rom(struct ccdbg *dbg, struct ao_hex_image *rom);

uint8_t
ccdbg_rom_contains(struct ccdbg *dbg, uint16_t addr, int nbytes);

uint8_t
ccdbg_rom_replace_xmem(struct ccdbg *dbg,
		       uint16_t addrp, uint8_t *bytesp, int nbytes);

/* ccdbg-state.c */
uint8_t
ccdbg_state_save(struct ccdbg *dbg, struct ccstate *state, unsigned int mask);

uint8_t
ccdbg_state_restore(struct ccdbg *dbg, struct ccstate *state);

void
ccdbg_state_replace_xmem(struct ccdbg *dbg, struct ccstate *state,
			 uint16_t addr, uint8_t *bytes, int nbytes);

void
ccdbg_state_replace_sfr(struct ccdbg *dbg, struct ccstate *state,
			uint8_t addr, uint8_t *bytes, int nbytes);

#endif /* _CCDBG_H_ */