git.gag.com Git - fw/altos/blob - 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     (50)
  49
  50 #define MOV_direct_data         0x75
  51 #define LJMP                    0x02
  52 #define MOV_Rn_data(n)          (0x78 | (n))
  53 #define DJNZ_Rn_rel(n)          (0xd8 | (n))
  54 #define MOV_A_direct            0xe5
  55 #define MOV_direct_A            0xf5
  56 #define MOV_DPTR_data16         0x90
  57 #define MOV_A_data      0x74
  58 #define MOVX_atDPTR_A   0xf0
  59 #define MOVX_A_atDPTR   0xe0
  60 #define INC_DPTR        0xa3
  61 #define TRAP            0xa5
  62
  63 #define SJMP            0x80
  64
  65 #define FWT             0xAB
  66 #define FADDRL          0xAC
  67 #define FADDRH          0xAD
  68 #define FCTL            0xAE
  69 # define FCTL_BUSY      0x80
  70 # define FCTL_BUSY_BIT  7
  71 # define FCTL_SWBSY     0x40
  72 # define FCTL_SWBSY_BIT 6
  73 # define FCTL_CONTRD    0x10
  74 # define FCTL_WRITE     0x02
  75 # define FCTL_ERASE     0x01
  76 #define FWDATA          0xAF
  77
  78 #define CLKCON          0xC6
  79 #define  CLKCON_OSC32K  0x80
  80 #define  CLKCON_OSC     0x40
  81 #define  CLKCON_TICKSPD 0x38
  82 #define  CLKCON_CLKSPD  0x07
  83
  84 #define P0              0x80
  85 #define P1              0x90
  86 #define P2              0xA0
  87 #define P0DIR           0xFD
  88 #define P1DIR           0xFE
  89 #define P2DIR           0xFF
  90
  91 #define SLEEP           0xBE
  92
  93 #define JB              0x20
  94
  95 #define ACC(bit)        (0xE0 | (bit))
  96
  97 struct ccdbg {
  98         usb_dev_handle  *usb_dev;
  99         uint8_t gpio;
 100 #ifdef USE_KERNEL
 101         int     fd;
 102 #endif
 103         uint8_t debug_data;
 104         int     clock;
 105 };
 106
 107 struct hex_record {
 108         uint8_t length;
 109         uint16_t address;
 110         uint8_t type;
 111         uint8_t checksum;
 112         uint8_t data[0];
 113 };
 114
 115 struct hex_file {
 116         int                     nrecord;
 117         struct hex_record       *records[0];
 118 };
 119
 120 struct hex_image {
 121         uint16_t        address;
 122         uint16_t        length;
 123         uint8_t         data[0];
 124 };
 125
 126 #define HEX_RECORD_NORMAL               0x00
 127 #define HEX_RECORD_EOF                  0x01
 128 #define HEX_RECORD_EXTENDED_ADDRESS     0x02
 129
 130 #include "cccp.h"
 131
 132 #define CC_CHIP_ERASE           0x14
 133
 134 #define CC_WR_CONFIG            0x1d
 135 #define CC_RD_CONFIG            0x24
 136 # define CC_CONFIG_TIMERS_OFF           (1 << 3)
 137 # define CC_CONFIG_DMA_PAUSE            (1 << 2)
 138 # define CC_CONFIG_TIMER_SUSPEND        (1 << 1)
 139 # define CC_SET_FLASH_INFO_PAGE         (1 << 0)
 140
 141 #define CC_GET_PC               0x28
 142 #define CC_READ_STATUS          0x34
 143 # define CC_STATUS_CHIP_ERASE_DONE      (1 << 7)
 144 # define CC_STATUS_PCON_IDLE            (1 << 6)
 145 # define CC_STATUS_CPU_HALTED           (1 << 5)
 146 # define CC_STATUS_POWER_MODE_0         (1 << 4)
 147 # define CC_STATUS_HALT_STATUS          (1 << 3)
 148 # define CC_STATUS_DEBUG_LOCKED         (1 << 2)
 149 # define CC_STATUS_OSCILLATOR_STABLE    (1 << 1)
 150 # define CC_STATUS_STACK_OVERFLOW       (1 << 0)
 151
 152 #define CC_SET_HW_BRKPNT        0x3b
 153 # define CC_HW_BRKPNT_N(n)      ((n) << 3)
 154 # define CC_HW_BRKPNT_N_MASK    (0x3 << 3)
 155 # define CC_HW_BRKPNT_ENABLE    (1 << 2)
 156
 157 #define CC_HALT                 0x44
 158 #define CC_RESUME               0x4c
 159 #define CC_DEBUG_INSTR(n)       (0x54|(n))
 160 #define CC_STEP_INSTR           0x5c
 161 #define CC_STEP_REPLACE(n)      (0x64|(n))
 162 #define CC_GET_CHIP_ID          0x68
 163
 164 #define CC_DEBUG_BITBANG        0x00000001
 165 #define CC_DEBUG_COMMAND        0x00000002
 166 #define CC_DEBUG_INSTRUCTIONS   0x00000004
 167
 168 /* ccdbg-command.c */
 169 void
 170 ccdbg_debug_mode(struct ccdbg *dbg);
 171
 172 void
 173 ccdbg_reset(struct ccdbg *dbg);
 174
 175 uint8_t
 176 ccdbg_chip_erase(struct ccdbg *dbg);
 177
 178 uint8_t
 179 ccdbg_wr_config(struct ccdbg *dbg, uint8_t config);
 180
 181 uint8_t
 182 ccdbg_rd_config(struct ccdbg *dbg);
 183
 184 uint16_t
 185 ccdbg_get_pc(struct ccdbg *dbg);
 186
 187 uint8_t
 188 ccdbg_read_status(struct ccdbg *dbg);
 189
 190 uint8_t
 191 ccdbg_set_hw_brkpnt(struct ccdbg *dbg, uint8_t number, uint8_t enable, uint16_t addr);
 192
 193 uint8_t
 194 ccdbg_halt(struct ccdbg *dbg);
 195
 196 uint8_t
 197 ccdbg_resume(struct ccdbg *dbg);
 198
 199 uint8_t
 200 ccdbg_debug_instr(struct ccdbg *dbg, uint8_t *instr, int nbytes);
 201
 202 uint8_t
 203 ccdbg_step_instr(struct ccdbg *dbg);
 204
 205 uint8_t
 206 ccdbg_step_replace(struct ccdbg *dbg, uint8_t *instr, int nbytes);
 207
 208 uint16_t
 209 ccdbg_get_chip_id(struct ccdbg *dbg);
 210
 211 uint8_t
 212 ccdbg_execute(struct ccdbg *dbg, uint8_t *inst);
 213
 214 uint8_t
 215 ccdbg_set_pc(struct ccdbg *dbg, uint16_t pc);
 216
 217 uint8_t
 218 ccdbg_execute_hex_image(struct ccdbg *dbg, struct hex_image *image);
 219
 220 /* ccdbg-debug.c */
 221 void
 222 ccdbg_debug(int level, char *format, ...);
 223
 224 void
 225 ccdbg_add_debug(int level);
 226
 227 void
 228 ccdbg_clear_debug(int level);
 229
 230 /* ccdbg-flash.c */
 231 uint8_t
 232 ccdbg_flash_hex_image(struct ccdbg *dbg, struct hex_image *image);
 233
 234 /* ccdbg-hex.c */
 235 struct hex_file *
 236 ccdbg_hex_file_read(FILE *file, char *name);
 237
 238 void
 239 ccdbg_hex_file_free(struct hex_file *hex);
 240
 241 struct hex_image *
 242 ccdbg_hex_image_create(struct hex_file *hex);
 243
 244 void
 245 ccdbg_hex_image_free(struct hex_image *image);
 246
 247 int
 248 ccdbg_hex_image_equal(struct hex_image *a, struct hex_image *b);
 249
 250 /* ccdbg-io.c */
 251 void
 252 ccdbg_half_clock(struct ccdbg *dbg);
 253
 254 int
 255 ccdbg_write(struct ccdbg *dbg, uint8_t mask, uint8_t value);
 256
 257 uint8_t
 258 ccdbg_read(struct ccdbg *dbg);
 259
 260 struct ccdbg *
 261 ccdbg_open(char *file);
 262
 263 void
 264 ccdbg_close(struct ccdbg *dbg);
 265
 266 void
 267 ccdbg_clock_1_0(struct ccdbg *dbg);
 268
 269 void
 270 ccdbg_clock_0_1(struct ccdbg *dbg);
 271
 272 void
 273 ccdbg_write_bit(struct ccdbg *dbg, uint8_t bit);
 274
 275 void
 276 ccdbg_write_byte(struct ccdbg *dbg, uint8_t byte);
 277
 278 uint8_t
 279 ccdbg_read_bit(struct ccdbg *dbg);
 280
 281 uint8_t
 282 ccdbg_read_byte(struct ccdbg *dbg);
 283
 284 void
 285 ccdbg_cmd_write(struct ccdbg *dbg, uint8_t cmd, uint8_t *data, int len);
 286
 287 uint8_t
 288 ccdbg_cmd_write_read8(struct ccdbg *dbg, uint8_t cmd, uint8_t *data, int len);
 289
 290 uint16_t
 291 ccdbg_cmd_write_read16(struct ccdbg *dbg, uint8_t cmd, uint8_t *data, int len);
 292
 293 void
 294 ccdbg_send(struct ccdbg *dbg, uint8_t mask, uint8_t set);
 295
 296 void
 297 ccdbg_send_bit(struct ccdbg *dbg, uint8_t bit);
 298
 299 void
 300 ccdbg_send_byte(struct ccdbg *dbg, uint8_t byte);
 301
 302 void
 303 ccdbg_send_bytes(struct ccdbg *dbg, uint8_t *bytes, int nbytes);
 304
 305 uint8_t
 306 ccdbg_recv_bit(struct ccdbg *dbg, int first);
 307
 308 uint8_t
 309 ccdbg_recv_byte(struct ccdbg *dbg, int first);
 310
 311 void
 312 ccdbg_recv_bytes(struct ccdbg *dbg, uint8_t *bytes, int nbytes);
 313
 314 void
 315 ccdbg_print(char *format, uint8_t mask, uint8_t set);
 316
 317 /* ccdbg-manual.c */
 318
 319 void
 320 ccdbg_manual(struct ccdbg *dbg, FILE *input);
 321
 322 /* ccdbg-memory.c */
 323 uint8_t
 324 ccdbg_write_memory(struct ccdbg *dbg, uint16_t addr, uint8_t *bytes, int nbytes);
 325
 326 uint8_t
 327 ccdbg_read_memory(struct ccdbg *dbg, uint16_t addr, uint8_t *bytes, int nbytes);
 328
 329 uint8_t
 330 ccdbg_write_uint8(struct ccdbg *dbg, uint16_t addr, uint8_t byte);
 331
 332 uint8_t
 333 ccdbg_write_hex_image(struct ccdbg *dbg, struct hex_image *image, uint16_t offset);
 334
 335 struct hex_image *
 336 ccdbg_read_hex_image(struct ccdbg *dbg, uint16_t address, uint16_t length);
 337
 338 /* cp-usb.c */
 339 void
 340 cp_usb_init(struct ccdbg *dbg);
 341
 342 void
 343 cp_usb_fini(struct ccdbg *dbg);
 344
 345 void
 346 cp_usb_write(struct ccdbg *dbg, uint8_t mask, uint8_t value);
 347
 348 uint8_t
 349 cp_usb_read(struct ccdbg *dbg);
 350
 351 #endif /* _CCDBG_H_ */