git.gag.com Git - fw/stlink/blob - src/gdb-server.c

   1 /* -*- tab-width:8 -*- */
   2
   3 /*
   4  Copyright (C)  2011 Peter Zotov <whitequark@whitequark.org>
   5  Use of this source code is governed by a BSD-style
   6  license that can be found in the LICENSE file.
   7 */
   8
   9 #include <stdio.h>
  10 #include <string.h>
  11 #include <stdlib.h>
  12 #include <unistd.h>
  13 #include <sys/types.h>
  14 #include <sys/socket.h>
  15 #include <netinet/in.h>
  16 #include <arpa/inet.h>
  17 #include "gdb-remote.h"
  18 #include "stlink-hw.h"
  19
  20 static const char hex[] = "0123456789abcdef";
  21
  22 // configured for STM32F100RB
  23 static const char* const c_memory_map =
  24   "<?xml version=\"1.0\"?>"
  25   "<!DOCTYPE memory-map PUBLIC \"+//IDN gnu.org//DTD GDB Memory Map V1.0//EN\""
  26   "     \"http://sourceware.org/gdb/gdb-memory-map.dtd\">"
  27   "<memory-map>"
  28   "  <memory type=\"rom\" start=\"0x00000000\" length=\"0x20000\"/>"    // code = sram or flash
  29   "  <memory type=\"ram\" start=\"0x20000000\" length=\"0x2000\"/>"     // sram 8k
  30   "  <memory type=\"flash\" start=\"0x08000000\" length=\"0x20000\">"   // flash 128k
  31   "    <property name=\"blocksize\">0x400</property>"                   // 1k pages
  32   "  </memory>"
  33   "  <memory type=\"ram\" start=\"0x40000000\" length=\"0x1fffffff\"/>" // peripheral regs
  34   "  <memory type=\"ram\" start=\"0xe0000000\" length=\"0x1fffffff\"/>" // cortex regs
  35   "</memory-map>";
  36
  37 int serve(struct stlink* sl, int port);
  38
  39 int main(int argc, char** argv) {
  40         if(argc != 3) {
  41                 fprintf(stderr, "Usage: %s <port> /dev/sgX\n", argv[0]);
  42                 return 1;
  43         }
  44
  45         struct stlink *sl = stlink_quirk_open(argv[2], 0);
  46         if (sl == NULL)
  47                 return 1;
  48
  49         if(stlink_current_mode(sl) != STLINK_DEV_DEBUG_MODE)
  50                 stlink_enter_swd_mode(sl);
  51
  52         stlink_core_id(sl);
  53         printf("Debugging ARM core %08x.\n", sl->core_id);
  54
  55         int port = atoi(argv[1]);
  56
  57         while(serve(sl, port) == 0);
  58
  59         stlink_close(sl);
  60
  61         return 0;
  62 }
  63
  64 #define CODE_BREAK_NUM  6
  65
  66 #define CODE_BREAK_LOW  0x01
  67 #define CODE_BREAK_HIGH 0x02
  68
  69 struct code_hw_breakpoint {
  70         stm32_addr_t addr;
  71         int          type;
  72 };
  73
  74 struct code_hw_breakpoint code_breaks[CODE_BREAK_NUM];
  75
  76 static void init_code_breakpoints(struct stlink* sl) {
  77         memset(sl->q_buf, 0, 4);
  78         sl->q_buf[0] = 0x03; // KEY | ENABLE
  79         stlink_write_mem32(sl, 0xe0002000, 4);
  80
  81         memset(sl->q_buf, 0, 4);
  82         for(int i = 0; i < CODE_BREAK_NUM; i++) {
  83                 code_breaks[i].type = 0;
  84                 stlink_write_mem32(sl, 0xe0002008 + i * 4, 4);
  85         }
  86 }
  87
  88 static int update_code_breakpoint(struct stlink* sl, stm32_addr_t addr, int set) {
  89         stm32_addr_t fpb_addr = addr & ~0x3;
  90         int type = addr & 0x2 ? CODE_BREAK_HIGH : CODE_BREAK_LOW;
  91
  92         if(addr & 1) {
  93                 fprintf(stderr, "update_code_breakpoint: unaligned address %08x\n", addr);
  94                 return -1;
  95         }
  96
  97         int id = -1;
  98         for(int i = 0; i < CODE_BREAK_NUM; i++) {
  99                 if(fpb_addr == code_breaks[i].addr ||
 100                         (set && code_breaks[i].type == 0)) {
 101                         id = i;
 102                         break;
 103                 }
 104         }
 105
 106         if(id == -1) {
 107                 if(set) return -1; // Free slot not found
 108                 else    return 0;  // Breakpoint is already removed
 109         }
 110
 111         struct code_hw_breakpoint* brk = &code_breaks[id];
 112
 113         brk->addr = fpb_addr;
 114
 115         if(set) brk->type |= type;
 116         else    brk->type &= ~type;
 117
 118         memset(sl->q_buf, 0, 4);
 119
 120         if(brk->type == 0) {
 121                 #ifdef DEBUG
 122                 printf("clearing hw break %d\n", id);
 123                 #endif
 124
 125                 stlink_write_mem32(sl, 0xe0002008 + id * 4, 4);
 126         } else {
 127                 sl->q_buf[0] = ( brk->addr        & 0xff) | 1;
 128                 sl->q_buf[1] = ((brk->addr >> 8)  & 0xff);
 129                 sl->q_buf[2] = ((brk->addr >> 16) & 0xff);
 130                 sl->q_buf[3] = ((brk->addr >> 24) & 0xff) | (brk->type << 6);
 131
 132                 #ifdef DEBUG
 133                 printf("setting hw break %d at %08x (%d)\n",
 134                         id, brk->addr, brk->type);
 135                 printf("reg %02x %02x %02x %02x\n",
 136                         sl->q_buf[3], sl->q_buf[2], sl->q_buf[1], sl->q_buf[0]);
 137                 #endif
 138
 139                 stlink_write_mem32(sl, 0xe0002008 + id * 4, 4);
 140         }
 141
 142         return 0;
 143 }
 144
 145 #define FLASH_BASE 0x08000000
 146 #define FLASH_PAGE 0x400
 147 #define FLASH_PAGE_MASK (~((1 << 10) - 1))
 148 #define FLASH_SIZE (FLASH_PAGE * 128)
 149
 150 struct flash_block {
 151         stm32_addr_t addr;
 152         unsigned     length;
 153         uint8_t*     data;
 154
 155         struct flash_block* next;
 156 };
 157
 158 static struct flash_block* flash_root;
 159
 160 static int flash_add_block(stm32_addr_t addr, unsigned length) {
 161         if(addr < FLASH_BASE || addr + length > FLASH_BASE + FLASH_SIZE) {
 162                 fprintf(stderr, "flash_add_block: incorrect bounds\n");
 163                 return -1;
 164         }
 165
 166         if(addr % FLASH_PAGE != 0 || length % FLASH_PAGE != 0) {
 167                 fprintf(stderr, "flash_add_block: unaligned block\n");
 168                 return -1;
 169         }
 170
 171         struct flash_block* new = malloc(sizeof(struct flash_block));
 172         new->next = flash_root;
 173
 174         new->addr   = addr;
 175         new->length = length;
 176         new->data   = calloc(length, 1);
 177
 178         flash_root = new;
 179
 180         return 0;
 181 }
 182
 183 static int flash_populate(stm32_addr_t addr, uint8_t* data, unsigned length) {
 184         int fit_blocks = 0, fit_length = 0;
 185
 186         for(struct flash_block* fb = flash_root; fb; fb = fb->next) {
 187                 /* Block: ------X------Y--------
 188                  * Data:            a-----b
 189                  *                a--b
 190                  *            a-----------b
 191                  * Block intersects with data, if:
 192                  *  a < Y && b > x
 193                  */
 194
 195                 unsigned X = fb->addr, Y = fb->addr + fb->length;
 196                 unsigned a = addr, b = addr + length;
 197                 if(a < Y && b > X) {
 198                         // from start of the block
 199                         unsigned start = (a > X ? a : X) - X;
 200                         unsigned end   = (b > Y ? Y : b) - X;
 201
 202                         memcpy(fb->data + start, data, end - start);
 203
 204                         fit_blocks++;
 205                         fit_length += end - start;
 206                 }
 207         }
 208
 209         if(fit_blocks == 0) {
 210                 fprintf(stderr, "Unfit data block %08x -> %04x\n", addr, length);
 211                 return -1;
 212         }
 213
 214         if(fit_length != length) {
 215                 fprintf(stderr, "warning: data block %08x -> %04x truncated to %04x\n",
 216                         addr, length, fit_length);
 217                 fprintf(stderr, "(this is not an error, just a GDB glitch)\n");
 218         }
 219
 220         return 0;
 221 }
 222
 223 static int flash_go(struct stlink* sl) {
 224         int error = -1;
 225
 226         // Some kinds of clock settings do not allow writing to flash.
 227         stlink_reset(sl);
 228
 229         for(struct flash_block* fb = flash_root; fb; fb = fb->next) {
 230                 #ifdef DEBUG
 231                 printf("flash_do: block %08x -> %04x\n", fb->addr, fb->length);
 232                 #endif
 233
 234                 stlink_erase_flash_page(sl, fb->addr);
 235
 236                 if(!stlink_write_flash(sl, fb->addr, fb->data, fb->length) < 0) {
 237                         fprintf(stderr, "Flash writing failed.\n");
 238                         goto error;
 239                 }
 240         }
 241
 242         stlink_reset(sl);
 243
 244         error = 0;
 245
 246 error:
 247         for(struct flash_block* fb = flash_root, *next; fb; fb = next) {
 248                 next = fb->next;
 249                 free(fb->data);
 250                 free(fb);
 251         }
 252
 253         flash_root = NULL;
 254
 255         return error;
 256 }
 257
 258 int serve(struct stlink* sl, int port) {
 259         int sock = socket(AF_INET, SOCK_STREAM, 0);
 260         if(sock < 0) {
 261                 perror("socket");
 262                 return 1;
 263         }
 264
 265         unsigned int val = 1;
 266         setsockopt(sock, SOL_SOCKET, SO_REUSEADDR, &val, sizeof(val));
 267
 268         struct sockaddr_in serv_addr = {0};
 269         serv_addr.sin_family = AF_INET;
 270         serv_addr.sin_addr.s_addr = inet_addr("127.0.0.1");
 271         serv_addr.sin_port = htons(port);
 272
 273         if(bind(sock, (struct sockaddr *) &serv_addr, sizeof(serv_addr)) < 0) {
 274                 perror("bind");
 275                 return 1;
 276         }
 277
 278         if(listen(sock, 5) < 0) {
 279                 perror("listen");
 280                 return 1;
 281         }
 282
 283         stlink_force_debug(sl);
 284         stlink_reset(sl);
 285         init_code_breakpoints(sl);
 286
 287         printf("Listening at *:%d...\n", port);
 288
 289         int client = accept(sock, NULL, NULL);
 290         if(client < 0) {
 291                 perror("accept");
 292                 return 1;
 293         }
 294
 295         close(sock);
 296
 297         printf("GDB connected.\n");
 298
 299         while(1) {
 300                 char* packet;
 301
 302                 int status = gdb_recv_packet(client, &packet);
 303                 if(status < 0) {
 304                         fprintf(stderr, "cannot recv: %d\n", status);
 305                         return 1;
 306                 }
 307
 308                 #ifdef DEBUG
 309                 printf("recv: %s\n", packet);
 310                 #endif
 311
 312                 char* reply = NULL;
 313
 314                 switch(packet[0]) {
 315                 case 'q': {
 316                         if(packet[1] == 'P' || packet[1] == 'C' || packet[1] == 'L') {
 317                                 reply = strdup("");
 318                                 break;
 319                         }
 320
 321                         char *separator = strstr(packet, ":"), *params = "";
 322                         if(separator == NULL) {
 323                                 separator = packet + strlen(packet);
 324                         } else {
 325                                 params = separator + 1;
 326                         }
 327
 328                         unsigned queryNameLength = (separator - &packet[1]);
 329                         char* queryName = calloc(queryNameLength + 1, 1);
 330                         strncpy(queryName, &packet[1], queryNameLength);
 331
 332                         #ifdef DEBUG
 333                         printf("query: %s;%s\n", queryName, params);
 334                         #endif
 335
 336                         if(!strcmp(queryName, "Supported")) {
 337                                 reply = strdup("PacketSize=3fff;qXfer:memory-map:read+");
 338                         } else if(!strcmp(queryName, "Xfer")) {
 339                                 char *type, *op, *annex, *s_addr, *s_length;
 340                                 char *tok = params;
 341
 342                                 type     = strsep(&tok, ":");
 343                                 op       = strsep(&tok, ":");
 344                                 annex    = strsep(&tok, ":");
 345                                 s_addr   = strsep(&tok, ",");
 346                                 s_length = tok;
 347
 348                                 unsigned addr = strtoul(s_addr, NULL, 16),
 349                                        length = strtoul(s_length, NULL, 16);
 350
 351                                 #ifdef DEBUG
 352                                 printf("Xfer: type:%s;op:%s;annex:%s;addr:%d;length:%d\n",
 353                                         type, op, annex, addr, length);
 354                                 #endif
 355
 356                                 const char* data = NULL;
 357
 358                                 if(!strcmp(type, "memory-map") && !strcmp(op, "read"))
 359                                         data = c_memory_map;
 360
 361                                 if(data) {
 362                                         unsigned data_length = strlen(data);
 363                                         if(addr + length > data_length)
 364                                                 length = data_length - addr;
 365
 366                                         if(length == 0) {
 367                                                 reply = strdup("l");
 368                                         } else {
 369                                                 reply = calloc(length + 2, 1);
 370                                                 reply[0] = 'm';
 371                                                 strncpy(&reply[1], data, length);
 372                                         }
 373                                 }
 374                         }
 375
 376                         if(reply == NULL)
 377                                 reply = strdup("");
 378
 379                         free(queryName);
 380
 381                         break;
 382                 }
 383
 384                 case 'v': {
 385                         char *separator = strstr(packet, ":"), *params = "";
 386                         if(separator == NULL) {
 387                                 separator = packet + strlen(packet);
 388                         } else {
 389                                 params = separator + 1;
 390                         }
 391
 392                         unsigned cmdNameLength = (separator - &packet[1]);
 393                         char* cmdName = calloc(cmdNameLength + 1, 1);
 394                         strncpy(cmdName, &packet[1], cmdNameLength);
 395
 396                         if(!strcmp(cmdName, "FlashErase")) {
 397                                 char *s_addr, *s_length;
 398                                 char *tok = params;
 399
 400                                 s_addr   = strsep(&tok, ",");
 401                                 s_length = tok;
 402
 403                                 unsigned addr = strtoul(s_addr, NULL, 16),
 404                                        length = strtoul(s_length, NULL, 16);
 405
 406                                 #ifdef DEBUG
 407                                 printf("FlashErase: addr:%08x,len:%04x\n",
 408                                         addr, length);
 409                                 #endif
 410
 411                                 if(flash_add_block(addr, length) < 0) {
 412                                         reply = strdup("E00");
 413                                 } else {
 414                                         reply = strdup("OK");
 415                                 }
 416                         } else if(!strcmp(cmdName, "FlashWrite")) {
 417                                 char *s_addr, *data;
 418                                 char *tok = params;
 419
 420                                 s_addr = strsep(&tok, ":");
 421                                 data   = tok;
 422
 423                                 unsigned addr = strtoul(s_addr, NULL, 16);
 424                                 unsigned data_length = status - (data - packet);
 425
 426                                 // Length of decoded data cannot be more than
 427                                 // encoded, as escapes are removed.
 428                                 // Additional byte is reserved for alignment fix.
 429                                 uint8_t *decoded = calloc(data_length + 1, 1);
 430                                 unsigned dec_index = 0;
 431                                 for(int i = 0; i < data_length; i++) {
 432                                         if(data[i] == 0x7d) {
 433                                                 i++;
 434                                                 decoded[dec_index++] = data[i] ^ 0x20;
 435                                         } else {
 436                                                 decoded[dec_index++] = data[i];
 437                                         }
 438                                 }
 439
 440                                 // Fix alignment
 441                                 if(dec_index % 2 != 0)
 442                                         dec_index++;
 443
 444                                 #ifdef DEBUG
 445                                 printf("binary packet %d -> %d\n", data_length, dec_index);
 446                                 #endif
 447
 448                                 if(flash_populate(addr, decoded, dec_index) < 0) {
 449                                         reply = strdup("E00");
 450                                 } else {
 451                                         reply = strdup("OK");
 452                                 }
 453                         } else if(!strcmp(cmdName, "FlashDone")) {
 454                                 if(flash_go(sl) < 0) {
 455                                         reply = strdup("E00");
 456                                 } else {
 457                                         reply = strdup("OK");
 458                                 }
 459                         }
 460
 461                         if(reply == NULL)
 462                                 reply = strdup("");
 463
 464                         free(cmdName);
 465
 466                         break;
 467                 }
 468
 469                 case 'c':
 470                         stlink_run(sl);
 471
 472                         printf("Core running, waiting for interrupt (either in chip or GDB).\n");
 473
 474                         while(1) {
 475                                 int status = gdb_check_for_interrupt(client);
 476                                 if(status < 0) {
 477                                         fprintf(stderr, "cannot check for int: %d\n", status);
 478                                         return 1;
 479                                 }
 480
 481                                 if(status == 1) {
 482                                         stlink_force_debug(sl);
 483                                         break;
 484                                 }
 485
 486                                 stlink_status(sl);
 487                                 if(sl->core_stat == STLINK_CORE_HALTED) {
 488                                         break;
 489                                 }
 490
 491                                 usleep(100000);
 492                         }
 493
 494                         reply = strdup("S05"); // TRAP
 495                         break;
 496
 497                 case 's':
 498                         stlink_step(sl);
 499
 500                         reply = strdup("S05"); // TRAP
 501                         break;
 502
 503                 case '?':
 504                         reply = strdup("S05"); // TRAP
 505                         break;
 506
 507                 case 'g':
 508                         stlink_read_all_regs(sl);
 509
 510                         reply = calloc(8 * 16 + 1, 1);
 511                         for(int i = 0; i < 16; i++)
 512                                 sprintf(&reply[i * 8], "%08x", htonl(sl->reg.r[i]));
 513
 514                         break;
 515
 516                 case 'p': {
 517                         unsigned id = strtoul(&packet[1], NULL, 16), reg = 0xDEADDEAD;
 518
 519                         if(id < 16) {
 520                                 stlink_read_reg(sl, id);
 521                                 reg = htonl(sl->reg.r[id]);
 522                         } else if(id == 0x19) {
 523                                 stlink_read_reg(sl, 16);
 524                                 reg = htonl(sl->reg.xpsr);
 525                         } else {
 526                                 reply = strdup("E00");
 527                         }
 528
 529                         reply = calloc(8 + 1, 1);
 530                         sprintf(reply, "%08x", reg);
 531
 532                         break;
 533                 }
 534
 535                 case 'P': {
 536                         char* s_reg = &packet[1];
 537                         char* s_value = strstr(&packet[1], "=") + 1;
 538
 539                         unsigned reg   = strtoul(s_reg,   NULL, 16);
 540                         unsigned value = strtoul(s_value, NULL, 16);
 541
 542                         if(reg < 16) {
 543                                 stlink_write_reg(sl, ntohl(value), reg);
 544                         } else if(reg == 0x19) {
 545                                 stlink_write_reg(sl, ntohl(value), 16);
 546                         } else {
 547                                 reply = strdup("E00");
 548                         }
 549
 550                         if(!reply) {
 551                                 reply = strdup("OK");
 552                         }
 553
 554                         break;
 555                 }
 556
 557                 case 'G':
 558                         for(int i = 0; i < 16; i++) {
 559                                 char str[9] = {0};
 560                                 strncpy(str, &packet[1 + i * 8], 8);
 561                                 uint32_t reg = strtoul(str, NULL, 16);
 562                                 stlink_write_reg(sl, ntohl(reg), i);
 563                         }
 564
 565                         reply = strdup("OK");
 566                         break;
 567
 568                 case 'm': {
 569                         char* s_start = &packet[1];
 570                         char* s_count = strstr(&packet[1], ",") + 1;
 571
 572                         stm32_addr_t start = strtoul(s_start, NULL, 16);
 573                         unsigned     count = strtoul(s_count, NULL, 16);
 574
 575                         unsigned adj_start = start % 4;
 576
 577                         stlink_read_mem32(sl, start - adj_start, (count % 4 == 0) ?
 578                                                 count : count + 4 - (count % 4));
 579
 580                         reply = calloc(count * 2 + 1, 1);
 581                         for(int i = 0; i < count; i++) {
 582                                 reply[i * 2 + 0] = hex[sl->q_buf[i + adj_start] >> 4];
 583                                 reply[i * 2 + 1] = hex[sl->q_buf[i + adj_start] & 0xf];
 584                         }
 585
 586                         break;
 587                 }
 588
 589                 case 'M': {
 590                         char* s_start = &packet[1];
 591                         char* s_count = strstr(&packet[1], ",") + 1;
 592                         char* hexdata = strstr(packet, ":") + 1;
 593
 594                         stm32_addr_t start = strtoul(s_start, NULL, 16);
 595                         unsigned     count = strtoul(s_count, NULL, 16);
 596
 597                         for(int i = 0; i < count; i ++) {
 598                                 char hex[3] = { hexdata[i*2], hexdata[i*2+1], 0 };
 599                                 uint8_t byte = strtoul(hex, NULL, 16);
 600                                 sl->q_buf[i] = byte;
 601                         }
 602
 603                         if((count % 4) == 0 && (start % 4) == 0) {
 604                                 stlink_write_mem32(sl, start, count);
 605                         } else {
 606                                 stlink_write_mem8(sl, start, count);
 607                         }
 608
 609                         reply = strdup("OK");
 610
 611                         break;
 612                 }
 613
 614                 case 'Z': {
 615                         if(packet[1] == '1') {
 616                                 stm32_addr_t addr = strtoul(&packet[3], NULL, 16);
 617                                 if(update_code_breakpoint(sl, addr, 1) < 0) {
 618                                         reply = strdup("E00");
 619                                 } else {
 620                                         reply = strdup("OK");
 621                                 }
 622                         } else {
 623                                 reply = strdup("");
 624                         }
 625
 626                         break;
 627                 }
 628
 629                 case 'z': {
 630                         if(packet[1] == '1') {
 631                                 stm32_addr_t addr = strtoul(&packet[3], NULL, 16);
 632                                 update_code_breakpoint(sl, addr, 0);
 633
 634                                 reply = strdup("OK");
 635                         } else {
 636                                 reply = strdup("");
 637                         }
 638
 639                         break;
 640                 }
 641
 642                 case 'k': {
 643                         // After this function will be entered afterwards, the
 644                         // chip will be reset anyway. So this is a no-op.
 645
 646                         close(client);
 647                         return 0;
 648                 }
 649
 650                 default:
 651                         reply = strdup("");
 652                 }
 653
 654                 if(reply) {
 655                         #ifdef DEBUG
 656                         printf("send: %s\n", reply);
 657                         #endif
 658
 659                         int result = gdb_send_packet(client, reply);
 660                         if(result != 0) {
 661                                 fprintf(stderr, "cannot send: %d\n", result);
 662                                 return 1;
 663                         }
 664
 665                         free(reply);
 666                 }
 667
 668                 free(packet);
 669         }
 670
 671         return 0;
 672 }