2 * Copyright © 2008 Keith Packard <keithp@keithp.com>
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.
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.
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.
30 #include <sys/types.h>
31 #include <sys/ioctl.h>
36 #define CC_RESET_N 0x4
37 #define CC_CLOCK_US (40)
41 #define MOV_direct_data 0x75
43 #define MOV_Rn_data(n) (0x78 | (n))
44 #define DJNZ_Rn_rel(n) (0xd8 | (n))
45 #define MOV_A_direct 0xe5
46 #define MOV_direct_A 0xf5
47 #define MOV_DPTR_data16 0x90
48 #define MOV_A_data 0x74
49 #define MOVX_atDPTR_A 0xf0
50 #define MOVX_A_atDPTR 0xe0
56 /* 8051 special function registers
59 /* flash controller */
64 # define FCTL_BUSY 0x80
65 # define FCTL_BUSY_BIT 7
66 # define FCTL_SWBSY 0x40
67 # define FCTL_SWBSY_BIT 6
68 # define FCTL_CONTRD 0x10
69 # define FCTL_WRITE 0x02
70 # define FCTL_ERASE 0x01
75 /* clock controller */
77 #define CLKCON_OSC32K 0x80
78 #define CLKCON_OSC 0x40
79 #define CLKCON_TICKSPD 0x38
80 #define CLKCON_CLKSPD 0x07
90 /* Bit-addressable accumulator */
91 #define ACC(bit) (0xE0 | (bit))
97 /* Intel hex file format data
109 struct hex_record *records[0];
118 #define HEX_RECORD_NORMAL 0x00
119 #define HEX_RECORD_EOF 0x01
120 #define HEX_RECORD_EXTENDED_ADDRESS 0x02
122 /* CC1111 debug port commands
124 #define CC_CHIP_ERASE 0x14
126 #define CC_WR_CONFIG 0x1d
127 #define CC_RD_CONFIG 0x24
128 # define CC_CONFIG_TIMERS_OFF (1 << 3)
129 # define CC_CONFIG_DMA_PAUSE (1 << 2)
130 # define CC_CONFIG_TIMER_SUSPEND (1 << 1)
131 # define CC_SET_FLASH_INFO_PAGE (1 << 0)
133 #define CC_GET_PC 0x28
134 #define CC_READ_STATUS 0x34
135 # define CC_STATUS_CHIP_ERASE_DONE (1 << 7)
136 # define CC_STATUS_PCON_IDLE (1 << 6)
137 # define CC_STATUS_CPU_HALTED (1 << 5)
138 # define CC_STATUS_POWER_MODE_0 (1 << 4)
139 # define CC_STATUS_HALT_STATUS (1 << 3)
140 # define CC_STATUS_DEBUG_LOCKED (1 << 2)
141 # define CC_STATUS_OSCILLATOR_STABLE (1 << 1)
142 # define CC_STATUS_STACK_OVERFLOW (1 << 0)
144 #define CC_SET_HW_BRKPNT 0x3b
145 # define CC_HW_BRKPNT_N(n) ((n) << 3)
146 # define CC_HW_BRKPNT_N_MASK (0x3 << 3)
147 # define CC_HW_BRKPNT_ENABLE (1 << 2)
150 #define CC_RESUME 0x4c
151 #define CC_DEBUG_INSTR(n) (0x54|(n))
152 #define CC_STEP_INSTR 0x5c
153 #define CC_STEP_REPLACE(n) (0x64|(n))
154 #define CC_GET_CHIP_ID 0x68
158 #define CC_DEBUG_BITBANG 0x00000001
159 #define CC_DEBUG_COMMAND 0x00000002
160 #define CC_DEBUG_INSTRUCTIONS 0x00000004
161 #define CC_DEBUG_EXECUTE 0x00000008
162 #define CC_DEBUG_FLASH 0x00000010
164 /* ccdbg-command.c */
166 ccdbg_debug_mode(struct ccdbg *dbg);
169 ccdbg_reset(struct ccdbg *dbg);
172 ccdbg_chip_erase(struct ccdbg *dbg);
175 ccdbg_wr_config(struct ccdbg *dbg, uint8_t config);
178 ccdbg_rd_config(struct ccdbg *dbg);
181 ccdbg_get_pc(struct ccdbg *dbg);
184 ccdbg_read_status(struct ccdbg *dbg);
187 ccdbg_set_hw_brkpnt(struct ccdbg *dbg, uint8_t number, uint8_t enable, uint16_t addr);
190 ccdbg_halt(struct ccdbg *dbg);
193 ccdbg_resume(struct ccdbg *dbg);
196 ccdbg_debug_instr(struct ccdbg *dbg, uint8_t *instr, int nbytes);
199 ccdbg_step_instr(struct ccdbg *dbg);
202 ccdbg_step_replace(struct ccdbg *dbg, uint8_t *instr, int nbytes);
205 ccdbg_get_chip_id(struct ccdbg *dbg);
208 ccdbg_execute(struct ccdbg *dbg, uint8_t *inst);
211 ccdbg_set_pc(struct ccdbg *dbg, uint16_t pc);
214 ccdbg_execute_hex_image(struct ccdbg *dbg, struct hex_image *image);
218 ccdbg_debug(int level, char *format, ...);
221 ccdbg_add_debug(int level);
224 ccdbg_clear_debug(int level);
228 ccdbg_flash_hex_image(struct ccdbg *dbg, struct hex_image *image);
232 ccdbg_hex_file_read(FILE *file, char *name);
235 ccdbg_hex_file_free(struct hex_file *hex);
238 ccdbg_hex_image_create(struct hex_file *hex);
241 ccdbg_hex_image_free(struct hex_image *image);
244 ccdbg_hex_image_equal(struct hex_image *a, struct hex_image *b);
248 ccdbg_half_clock(struct ccdbg *dbg);
251 ccdbg_write(struct ccdbg *dbg, uint8_t mask, uint8_t value);
254 ccdbg_read(struct ccdbg *dbg);
260 ccdbg_close(struct ccdbg *dbg);
263 ccdbg_clock_1_0(struct ccdbg *dbg);
266 ccdbg_clock_0_1(struct ccdbg *dbg);
269 ccdbg_write_bit(struct ccdbg *dbg, uint8_t bit);
272 ccdbg_write_byte(struct ccdbg *dbg, uint8_t byte);
275 ccdbg_read_bit(struct ccdbg *dbg);
278 ccdbg_read_byte(struct ccdbg *dbg);
281 ccdbg_cmd_write(struct ccdbg *dbg, uint8_t cmd, uint8_t *data, int len);
284 ccdbg_cmd_write_read8(struct ccdbg *dbg, uint8_t cmd, uint8_t *data, int len);
287 ccdbg_cmd_write_read16(struct ccdbg *dbg, uint8_t cmd, uint8_t *data, int len);
290 ccdbg_send(struct ccdbg *dbg, uint8_t mask, uint8_t set);
293 ccdbg_send_bit(struct ccdbg *dbg, uint8_t bit);
296 ccdbg_send_byte(struct ccdbg *dbg, uint8_t byte);
299 ccdbg_send_bytes(struct ccdbg *dbg, uint8_t *bytes, int nbytes);
302 ccdbg_recv_bit(struct ccdbg *dbg, int first);
305 ccdbg_recv_byte(struct ccdbg *dbg, int first);
308 ccdbg_recv_bytes(struct ccdbg *dbg, uint8_t *bytes, int nbytes);
311 ccdbg_print(char *format, uint8_t mask, uint8_t set);
316 ccdbg_manual(struct ccdbg *dbg, FILE *input);
320 ccdbg_write_memory(struct ccdbg *dbg, uint16_t addr, uint8_t *bytes, int nbytes);
323 ccdbg_read_memory(struct ccdbg *dbg, uint16_t addr, uint8_t *bytes, int nbytes);
326 ccdbg_write_uint8(struct ccdbg *dbg, uint16_t addr, uint8_t byte);
329 ccdbg_write_hex_image(struct ccdbg *dbg, struct hex_image *image, uint16_t offset);
332 ccdbg_read_hex_image(struct ccdbg *dbg, uint16_t address, uint16_t length);
334 #endif /* _CCDBG_H_ */