/* * This file is part of the Black Magic Debug project. * * Copyright (C) 2011 Black Sphere Technologies Ltd. * Written by Gareth McMullin * Copyright (C) 2019 - 2020 Uwe Bonnes * (bon@elektron.ikp.physik.tu-darmstadt.de) * * 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 3 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, see . */ /* This file implements the SW-DP specific functions of the * ARM Debug Interface v5 Architecure Specification, ARM doc IHI0031A. */ #include "general.h" #include "exception.h" #include "target.h" #include "target_internal.h" #include "adiv5.h" #include "jlink.h" #include "cl_utils.h" #define SWDP_ACK_OK 0x01 #define SWDP_ACK_WAIT 0x02 #define SWDP_ACK_FAULT 0x04 static uint32_t jlink_adiv5_swdp_read(ADIv5_DP_t *dp, uint16_t addr); static uint32_t jlink_adiv5_swdp_error(ADIv5_DP_t *dp); static uint32_t jlink_adiv5_swdp_low_access(ADIv5_DP_t *dp, uint8_t RnW, uint16_t addr, uint32_t value); static void jlink_adiv5_swdp_abort(ADIv5_DP_t *dp, uint32_t abort); enum { SWDIO_WRITE = 0, SWDIO_READ }; /* Write at least 50 bits high, two bits low and read DP_IDR and put * idle cyccles at the end*/ static int line_reset(bmp_info_t *info) { uint8_t cmd[44]; cmd[0] = CMD_HW_JTAG3; cmd[1] = 0; /* write 19 Bytes.*/ cmd[2] = 19 * 8; cmd[3] = 0; uint8_t *direction = cmd + 4; direction[0] = 0; direction[1] = 0; direction[2] = 0; direction[3] = 0; direction[4] = 0; direction[5] = 0xff; direction[6] = 0xff; direction[7] = 0xff; direction[8] = 0xff; direction[9] = 0xff; direction[10] = 0xff; direction[11] = 0xff; direction[12] = 0xff; direction[13] = 0xff; direction[14] = 0x0; direction[15] = 0x0; direction[16] = 0x0; direction[17] = 0x0; direction[18] = 0xe0; uint8_t *data = direction + 19; data[5] = 0xff; data[6] = 0xff; data[7] = 0xff; data[8] = 0xff; data[9] = 0xff; data[10] = 0xff; data[11] = 0xff; data[12] = 0; data[13] = 0xa5; data[18] = 0; uint8_t res[18]; send_recv(info->usb_link, cmd, 42, res, 19); send_recv(info->usb_link, NULL, 0, res, 1); if (res[0] != 0) { DEBUG_WARN( "Line reset failed\n"); return -1; } return 0; } static int swdptap_init(bmp_info_t *info) { uint8_t cmd[2] = {CMD_GET_SELECT_IF, JLINK_IF_GET_AVAILABLE}; uint8_t res[4]; send_recv(info->usb_link, cmd, 2, res, sizeof(res)); if (!(res[0] & JLINK_IF_SWD)) return -1; cmd[1] = SELECT_IF_SWD; send_recv(info->usb_link, cmd, 2, res, sizeof(res)); platform_delay(10); /* Set speed 256 kHz*/ unsigned int speed = 2000; uint8_t jtag_speed[3] = {5, speed & 0xff, speed >> 8}; send_recv(info->usb_link, jtag_speed, 3, NULL, 0); return 0; } int jlink_swdp_scan(bmp_info_t *info) { swdptap_init(info); target_list_free(); ADIv5_DP_t *dp = (void*)calloc(1, sizeof(*dp)); if (!dp) /* calloc failed: heap exhaustion */ return 0; uint8_t cmd[44]; cmd[0] = CMD_HW_JTAG3; cmd[1] = 0; /* write 18 Bytes.*/ cmd[2] = 17 * 8; cmd[3] = 0; uint8_t *direction = cmd + 4; direction[0] = 0xff; direction[1] = 0xff; direction[2] = 0xff; direction[3] = 0xff; direction[4] = 0xff; direction[5] = 0xff; direction[6] = 0xff; direction[7] = 0xff; direction[8] = 0xff; direction[9] = 0xff; direction[10] = 0xff; direction[11] = 0xff; direction[12] = 0xff; direction[13] = 0xff; direction[14] = 0xff; direction[15] = 0xff; direction[16] = 0xff; uint8_t *data = direction + 17; data[0] = 0xff; data[1] = 0xff; data[2] = 0xff; data[3] = 0xff; data[4] = 0xff; data[5] = 0xff; data[6] = 0xff; data[7] = 0x9e; data[8] = 0xe7; data[9] = 0xff; data[10] = 0xff; data[11] = 0xff; data[12] = 0xff; data[13] = 0xff; data[14] = 0xff; data[15] = 0; data[16] = 0; uint8_t res[18]; send_recv(info->usb_link, cmd, 38, res, 17); send_recv(info->usb_link, NULL, 0, res, 1); if (res[0] != 0) { DEBUG_WARN( "Line reset failed\n"); return 0; } dp->idcode = jlink_adiv5_swdp_low_access(dp, 1, ADIV5_DP_IDCODE, 0); dp->dp_read = jlink_adiv5_swdp_read; dp->error = jlink_adiv5_swdp_error; dp->low_access = jlink_adiv5_swdp_low_access; dp->abort = jlink_adiv5_swdp_abort; jlink_adiv5_swdp_error(dp); adiv5_dp_init(dp); return target_list?1:0; } static uint32_t jlink_adiv5_swdp_read(ADIv5_DP_t *dp, uint16_t addr) { if (addr & ADIV5_APnDP) { adiv5_dp_low_access(dp, ADIV5_LOW_READ, addr, 0); return adiv5_dp_low_access(dp, ADIV5_LOW_READ, ADIV5_DP_RDBUFF, 0); } else { return jlink_adiv5_swdp_low_access(dp, ADIV5_LOW_READ, addr, 0); } } static uint32_t jlink_adiv5_swdp_error(ADIv5_DP_t *dp) { uint32_t err, clr = 0; err = jlink_adiv5_swdp_read(dp, ADIV5_DP_CTRLSTAT) & (ADIV5_DP_CTRLSTAT_STICKYORUN | ADIV5_DP_CTRLSTAT_STICKYCMP | ADIV5_DP_CTRLSTAT_STICKYERR | ADIV5_DP_CTRLSTAT_WDATAERR); if(err & ADIV5_DP_CTRLSTAT_STICKYORUN) clr |= ADIV5_DP_ABORT_ORUNERRCLR; if(err & ADIV5_DP_CTRLSTAT_STICKYCMP) clr |= ADIV5_DP_ABORT_STKCMPCLR; if(err & ADIV5_DP_CTRLSTAT_STICKYERR) clr |= ADIV5_DP_ABORT_STKERRCLR; if(err & ADIV5_DP_CTRLSTAT_WDATAERR) clr |= ADIV5_DP_ABORT_WDERRCLR; if (clr) adiv5_dp_write(dp, ADIV5_DP_ABORT, clr); if (dp->fault) err |= 0x8000; dp->fault = 0; return err; } static uint32_t jlink_adiv5_swdp_low_access(ADIv5_DP_t *dp, uint8_t RnW, uint16_t addr, uint32_t value) { bool APnDP = addr & ADIV5_APnDP; uint8_t addr8 = addr & 0xff; uint8_t request = 0x81; uint32_t response = 0; uint8_t ack; platform_timeout timeout; if(APnDP && dp->fault) return 0; if(APnDP) request ^= 0x22; if(RnW) request ^= 0x24; addr8 &= 0xC; request |= (addr8 << 1) & 0x18; if((addr8 == 4) || (addr8 == 8)) request ^= 0x20; uint8_t cmd[16]; uint8_t res[8]; cmd[0] = CMD_HW_JTAG3; cmd[1] = 0; cmd[2] = 13; cmd[3] = 0; cmd[4] = 0xff; cmd[5] = 0xe3; cmd[6] = request << 2; cmd[7] = request >> 6; platform_timeout_set(&timeout, 2000); do { send_recv(info.usb_link, cmd, 8, res, 2); send_recv(info.usb_link, NULL, 0, res, 1); if (res[0] != 0) raise_exception(EXCEPTION_ERROR, "Low access setup failed"); ack = res[1] >> 2; ack &= 7; } while (ack == SWDP_ACK_WAIT && !platform_timeout_is_expired(&timeout)); if (ack == SWDP_ACK_WAIT) raise_exception(EXCEPTION_TIMEOUT, "SWDP ACK timeout"); if(ack == SWDP_ACK_FAULT) { if (cl_debuglevel & BMP_DEBUG_TARGET) DEBUG_WARN( "Fault\n"); dp->fault = 1; return 0; } if(ack != SWDP_ACK_OK) { if (cl_debuglevel & BMP_DEBUG_TARGET) DEBUG_WARN( "Protocol\n"); line_reset(&info); return 0; } cmd[3] = 0; /* Always prepend an idle cycle (SWDIO = 0)!*/ if(RnW) { memset(cmd + 4, 0, 10); cmd[2] = 34; cmd[8] = 0xfe; cmd[13] = 0; send_recv(info.usb_link, cmd, 14, res, 5); send_recv(info.usb_link, NULL, 0, res + 5, 1); if (res[5] != 0) raise_exception(EXCEPTION_ERROR, "Low access read failed"); response = res[0] | res[1] << 8 | res[2] << 16 | res[3] << 24; int parity = res[4] & 1; int bit_count = __builtin_popcount (response) + parity; if (bit_count & 1) /* Give up on parity error */ raise_exception(EXCEPTION_ERROR, "SWDP Parity error"); } else { cmd[2] = 35; memset(cmd + 4, 0xff, 5); cmd[ 9] = ((value << 2) & 0xfc); cmd[10] = ((value >> 6) & 0xff); cmd[11] = ((value >> 14) & 0xff); cmd[12] = ((value >> 22) & 0xff); cmd[13] = ((value >> 30) & 0x03); int bit_count = __builtin_popcount(value); cmd[13] |= ((bit_count & 1) ? 4 : 0); send_recv(info.usb_link, cmd, 14, res, 5); send_recv(info.usb_link, NULL, 0, res, 1); if (res[0] != 0) raise_exception(EXCEPTION_ERROR, "Low access write failed"); } return response; } static void jlink_adiv5_swdp_abort(ADIv5_DP_t *dp, uint32_t abort) { adiv5_dp_write(dp, ADIV5_DP_ABORT, abort); }