From 033d1053ae42b913ff7100221628c0376e596d71 Mon Sep 17 00:00:00 2001 From: Mathias K Date: Sat, 17 Dec 2011 09:51:09 +0100 Subject: [PATCH] STM32 ST-LINK target initial release STM32 ST-LINK target added. Change-Id: Ibe2b7a3c0d5a8cf73d8680d6019adbdb62d68fa2 Signed-off-by: Mathias K Reviewed-on: http://openocd.zylin.com/279 Tested-by: jenkins Reviewed-by: Spencer Oliver --- src/target/Makefile.am | 3 +- src/target/stm32_stlink.c | 670 ++++++++++++++++++++++++++++++++++++++ src/target/target.c | 2 + 3 files changed, 674 insertions(+), 1 deletion(-) create mode 100644 src/target/stm32_stlink.c diff --git a/src/target/Makefile.am b/src/target/Makefile.am index 03d84ea0..ab7b3be2 100644 --- a/src/target/Makefile.am +++ b/src/target/Makefile.am @@ -34,7 +34,8 @@ libtarget_la_SOURCES = \ avrt.c \ dsp563xx.c \ dsp563xx_once.c \ - dsp5680xx.c + dsp5680xx.c \ + stm32_stlink.c TARGET_CORE_SRC = \ algorithm.c \ diff --git a/src/target/stm32_stlink.c b/src/target/stm32_stlink.c new file mode 100644 index 00000000..baa6b748 --- /dev/null +++ b/src/target/stm32_stlink.c @@ -0,0 +1,670 @@ +/*************************************************************************** + * Copyright (C) 2011 by Mathias Kuester * + * Mathias Kuester * + * * + * 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. * + ***************************************************************************/ +#ifdef HAVE_CONFIG_H +#include "config.h" +#endif + +#include "jtag/jtag.h" +#include "jtag/stlink/stlink_interface.h" +#include "jtag/stlink/stlink_layout.h" +#include "register.h" +#include "algorithm.h" +#include "target.h" +#include "breakpoints.h" +#include "target_type.h" +#include "armv7m.h" +#include "cortex_m.h" + +static inline struct stlink_interface_s *target_to_stlink(struct target *target) +{ + return target->tap->priv; +} + +static int stm32_stlink_load_core_reg_u32(struct target *target, + enum armv7m_regtype type, + uint32_t num, uint32_t *value) +{ + int retval; + struct stlink_interface_s *stlink_if = target_to_stlink(target); + + LOG_DEBUG("%s", __func__); + + /* NOTE: we "know" here that the register identifiers used + * in the v7m header match the Cortex-M3 Debug Core Register + * Selector values for R0..R15, xPSR, MSP, and PSP. + */ + switch (num) { + case 0 ... 18: + /* read a normal core register */ + retval = + stlink_if->layout->api->read_reg(stlink_if->fd, num, value); + + if (retval != ERROR_OK) { + LOG_ERROR("JTAG failure %i", retval); + return ERROR_JTAG_DEVICE_ERROR; + } + LOG_DEBUG("load from core reg %i value 0x%" PRIx32 "", + (int)num, *value); + break; + + case ARMV7M_PRIMASK: + case ARMV7M_BASEPRI: + case ARMV7M_FAULTMASK: + case ARMV7M_CONTROL: + /* Cortex-M3 packages these four registers as bitfields + * in one Debug Core register. So say r0 and r2 docs; + * it was removed from r1 docs, but still works. + */ + retval = + stlink_if->layout->api->read_reg(stlink_if->fd, 20, value); + + switch (num) { + case ARMV7M_PRIMASK: + *value = buf_get_u32((uint8_t *) value, 0, 1); + break; + + case ARMV7M_BASEPRI: + *value = buf_get_u32((uint8_t *) value, 8, 8); + break; + + case ARMV7M_FAULTMASK: + *value = buf_get_u32((uint8_t *) value, 16, 1); + break; + + case ARMV7M_CONTROL: + *value = buf_get_u32((uint8_t *) value, 24, 2); + break; + } + + LOG_DEBUG("load from special reg %i value 0x%" PRIx32 "", + (int)num, *value); + break; + + default: + return ERROR_INVALID_ARGUMENTS; + } + + return ERROR_OK; +} + +static int stm32_stlink_store_core_reg_u32(struct target *target, + enum armv7m_regtype type, + uint32_t num, uint32_t value) +{ + int retval; + uint32_t reg; + struct armv7m_common *armv7m = target_to_armv7m(target); + struct stlink_interface_s *stlink_if = target_to_stlink(target); + + LOG_DEBUG("%s", __func__); + +#ifdef ARMV7_GDB_HACKS + /* If the LR register is being modified, make sure it will put us + * in "thumb" mode, or an INVSTATE exception will occur. This is a + * hack to deal with the fact that gdb will sometimes "forge" + * return addresses, and doesn't set the LSB correctly (i.e., when + * printing expressions containing function calls, it sets LR = 0.) + * Valid exception return codes have bit 0 set too. + */ + if (num == ARMV7M_R14) + value |= 0x01; +#endif + + /* NOTE: we "know" here that the register identifiers used + * in the v7m header match the Cortex-M3 Debug Core Register + * Selector values for R0..R15, xPSR, MSP, and PSP. + */ + switch (num) { + case 0 ... 18: + retval = + stlink_if->layout->api->write_reg(stlink_if->fd, num, + value); + + if (retval != ERROR_OK) { + struct reg *r; + + LOG_ERROR("JTAG failure"); + r = armv7m->core_cache->reg_list + num; + r->dirty = r->valid; + return ERROR_JTAG_DEVICE_ERROR; + } + LOG_DEBUG("write core reg %i value 0x%" PRIx32 "", (int)num, + value); + break; + + case ARMV7M_PRIMASK: + case ARMV7M_BASEPRI: + case ARMV7M_FAULTMASK: + case ARMV7M_CONTROL: + /* Cortex-M3 packages these four registers as bitfields + * in one Debug Core register. So say r0 and r2 docs; + * it was removed from r1 docs, but still works. + */ + /* cortexm3_dap_read_coreregister_u32(swjdp, ®, 20); */ + + switch (num) { + case ARMV7M_PRIMASK: + buf_set_u32((uint8_t *) ®, 0, 1, value); + break; + + case ARMV7M_BASEPRI: + buf_set_u32((uint8_t *) ®, 8, 8, value); + break; + + case ARMV7M_FAULTMASK: + buf_set_u32((uint8_t *) ®, 16, 1, value); + break; + + case ARMV7M_CONTROL: + buf_set_u32((uint8_t *) ®, 24, 2, value); + break; + } + + /* cortexm3_dap_write_coreregister_u32(swjdp, reg, 20); */ + + LOG_DEBUG("write special reg %i value 0x%" PRIx32 " ", (int)num, + value); + break; + + default: + return ERROR_INVALID_ARGUMENTS; + } + + return ERROR_OK; +} + +static int stm32_stlink_init_arch_info(struct target *target, + struct cortex_m3_common *cortex_m3, + struct jtag_tap *tap) +{ + struct armv7m_common *armv7m; + + LOG_DEBUG("%s", __func__); + + armv7m = &cortex_m3->armv7m; + armv7m_init_arch_info(target, armv7m); + + armv7m->load_core_reg_u32 = stm32_stlink_load_core_reg_u32; + armv7m->store_core_reg_u32 = stm32_stlink_store_core_reg_u32; + + return ERROR_OK; +} + +static int stm32_stlink_init_target(struct command_context *cmd_ctx, + struct target *target) +{ + LOG_DEBUG("%s", __func__); + + armv7m_build_reg_cache(target); + + return ERROR_OK; +} + +static int stm32_stlink_target_create(struct target *target, + Jim_Interp *interp) +{ + LOG_DEBUG("%s", __func__); + + struct cortex_m3_common *cortex_m3 = calloc(1, sizeof(struct cortex_m3_common)); + + if (!cortex_m3) + return ERROR_INVALID_ARGUMENTS; + + stm32_stlink_init_arch_info(target, cortex_m3, target->tap); + + return ERROR_OK; +} + +static int stm32_stlink_poll(struct target *target); + +static int stm32_stlink_examine(struct target *target) +{ + int retval, i; + uint32_t cpuid, fpcr; + struct cortex_m3_common *cortex_m3 = target_to_cm3(target); + + LOG_DEBUG("%s", __func__); + + if (target->tap->hasidcode == false) { + LOG_ERROR("no IDCODE present on device"); + + return ERROR_INVALID_ARGUMENTS; + } + + if (!target_was_examined(target)) { + target_set_examined(target); + + stm32_stlink_poll(target); + + LOG_INFO("IDCODE %x", target->tap->idcode); + + /* Read from Device Identification Registers */ + retval = target_read_u32(target, CPUID, &cpuid); + if (retval != ERROR_OK) + return retval; + + if (((cpuid >> 4) & 0xc3f) == 0xc23) + LOG_DEBUG("Cortex-M3 r%" PRId8 "p%" PRId8 " processor detected", + (uint8_t)((cpuid >> 20) & 0xf), (uint8_t)((cpuid >> 0) & 0xf)); + LOG_DEBUG("cpuid: 0x%8.8" PRIx32 "", cpuid); + + /* Setup FPB */ + target_read_u32(target, FP_CTRL, &fpcr); + cortex_m3->auto_bp_type = 1; + cortex_m3->fp_num_code = ((fpcr >> 8) & 0x70) | + ((fpcr >> 4) & 0xF); /* bits [14:12] and [7:4] */ + cortex_m3->fp_num_lit = (fpcr >> 8) & 0xF; + cortex_m3->fp_code_available = cortex_m3->fp_num_code; + cortex_m3->fp_comparator_list = calloc(cortex_m3->fp_num_code + + cortex_m3->fp_num_lit, sizeof(struct cortex_m3_fp_comparator)); + cortex_m3->fpb_enabled = fpcr & 1; + for (i = 0; i < cortex_m3->fp_num_code + cortex_m3->fp_num_lit; i++) { + cortex_m3->fp_comparator_list[i].type = + (i < cortex_m3->fp_num_code) ? FPCR_CODE : FPCR_LITERAL; + cortex_m3->fp_comparator_list[i].fpcr_address = FP_COMP0 + 4 * i; + } + LOG_DEBUG("FPB fpcr 0x%" PRIx32 ", numcode %i, numlit %i", fpcr, + cortex_m3->fp_num_code, cortex_m3->fp_num_lit); + + /* Setup DWT */ + cortex_m3_dwt_setup(cortex_m3, target); + + /* These hardware breakpoints only work for code in flash! */ + LOG_INFO("%s: hardware has %d breakpoints, %d watchpoints", + target_name(target), + cortex_m3->fp_num_code, + cortex_m3->dwt_num_comp); + } + + return ERROR_OK; +} + +static int stm32_stlink_load_context(struct target *target) +{ + struct armv7m_common *armv7m = target_to_armv7m(target); + + for (unsigned i = 0; i < 23; i++) { + if (!armv7m->core_cache->reg_list[i].valid) + armv7m->read_core_reg(target, i); + } + + return ERROR_OK; +} + +static int stm32_stlink_poll(struct target *target) +{ + enum target_state state; + struct stlink_interface_s *stlink_if = target_to_stlink(target); + struct armv7m_common *armv7m = target_to_armv7m(target); + + state = stlink_if->layout->api->state(stlink_if->fd); + + if (state == TARGET_UNKNOWN) { + LOG_ERROR + ("jtag status contains invalid mode value - communication failure"); + return ERROR_TARGET_FAILURE; + } + + if (target->state == state) + return ERROR_OK; + + if (state == TARGET_HALTED) { + target_call_event_callbacks(target, TARGET_EVENT_DEBUG_HALTED); + target->state = state; + + stm32_stlink_load_context(target); + + LOG_INFO("halted: PC: 0x%x", buf_get_u32(armv7m->arm.pc->value, 0, 32)); + } + + return ERROR_OK; +} + +static int stm32_stlink_arch_state(struct target *target) +{ + LOG_DEBUG("%s", __func__); + return ERROR_OK; +} + +static int stm32_stlink_assert_reset(struct target *target) +{ + int res; + struct stlink_interface_s *stlink_if = target_to_stlink(target); + struct armv7m_common *armv7m = target_to_armv7m(target); + + LOG_DEBUG("%s", __func__); + + res = stlink_if->layout->api->reset(stlink_if->fd); + + if (res != ERROR_OK) + return res; + + /* virtual assert reset, we need it for the internal + * jtag state machine + */ + jtag_add_reset(1, 1); + + /* registers are now invalid */ + register_cache_invalidate(armv7m->core_cache); + + stm32_stlink_load_context(target); + + target->state = TARGET_HALTED; + + return ERROR_OK; +} + +static int stm32_stlink_deassert_reset(struct target *target) +{ + int res; + + LOG_DEBUG("%s", __func__); + + /* virtual deassert reset, we need it for the internal + * jtag state machine + */ + jtag_add_reset(0, 0); + + if (!target->reset_halt) { + res = target_resume(target, 1, 0, 0, 0); + + if (res != ERROR_OK) + return res; + } + + return ERROR_OK; +} + +static int stm32_stlink_soft_reset_halt(struct target *target) +{ + LOG_DEBUG("%s", __func__); + return ERROR_OK; +} + +static int stm32_stlink_halt(struct target *target) +{ + int res; + struct stlink_interface_s *stlink_if = target_to_stlink(target); + + LOG_DEBUG("%s", __func__); + + if (target->state == TARGET_HALTED) { + LOG_DEBUG("target was already halted"); + return ERROR_OK; + } + + if (target->state == TARGET_UNKNOWN) { + LOG_WARNING + ("target was in unknown state when halt was requested"); + } + + res = stlink_if->layout->api->halt(stlink_if->fd); + + if (res != ERROR_OK) + return res; + + target->debug_reason = DBG_REASON_DBGRQ; + + return ERROR_OK; +} + +static int stm32_stlink_resume(struct target *target, int current, + uint32_t address, int handle_breakpoints, + int debug_execution) +{ + int res; + struct stlink_interface_s *stlink_if = target_to_stlink(target); + struct armv7m_common *armv7m = target_to_armv7m(target); + uint32_t resume_pc; + struct breakpoint *breakpoint = NULL; + struct reg *pc; + + LOG_DEBUG("%s %d %x %d %d", __func__, current, address, + handle_breakpoints, debug_execution); + + if (target->state != TARGET_HALTED) { + LOG_WARNING("target not halted"); + return ERROR_TARGET_NOT_HALTED; + } + + pc = armv7m->arm.pc; + if (!current) { + buf_set_u32(pc->value, 0, 32, address); + pc->dirty = true; + pc->valid = true; + } + + if (!breakpoint_find(target, buf_get_u32(pc->value, 0, 32)) + && !debug_execution) { + armv7m_maybe_skip_bkpt_inst(target, NULL); + } + + resume_pc = buf_get_u32(pc->value, 0, 32); + + armv7m_restore_context(target); + + /* registers are now invalid */ + register_cache_invalidate(armv7m->core_cache); + + /* the front-end may request us not to handle breakpoints */ + if (handle_breakpoints) { + /* Single step past breakpoint at current address */ + breakpoint = breakpoint_find(target, resume_pc); + if (breakpoint) { + LOG_DEBUG("unset breakpoint at 0x%8.8" PRIx32 " (ID: %d)", + breakpoint->address, + breakpoint->unique_id); + cortex_m3_unset_breakpoint(target, breakpoint); + + res = stlink_if->layout->api->step(stlink_if->fd); + + if (res != ERROR_OK) + return res; + + cortex_m3_set_breakpoint(target, breakpoint); + } + } + + res = stlink_if->layout->api->run(stlink_if->fd); + + if (res != ERROR_OK) + return res; + + target->state = TARGET_RUNNING; + + target_call_event_callbacks(target, TARGET_EVENT_DEBUG_RESUMED); + + return ERROR_OK; +} + +static int stm32_stlink_step(struct target *target, int current, + uint32_t address, int handle_breakpoints) +{ + int res; + struct stlink_interface_s *stlink_if = target_to_stlink(target); + struct armv7m_common *armv7m = target_to_armv7m(target); + struct breakpoint *breakpoint = NULL; + struct reg *pc = armv7m->arm.pc; + bool bkpt_inst_found = false; + + LOG_DEBUG("%s", __func__); + + if (target->state != TARGET_HALTED) { + LOG_WARNING("target not halted"); + return ERROR_TARGET_NOT_HALTED; + } + + pc = armv7m->arm.pc; + if (!current) { + buf_set_u32(pc->value, 0, 32, address); + pc->dirty = true; + pc->valid = true; + } + + uint32_t pc_value = buf_get_u32(pc->value, 0, 32); + + /* the front-end may request us not to handle breakpoints */ + if (handle_breakpoints) { + breakpoint = breakpoint_find(target, pc_value); + if (breakpoint) + cortex_m3_unset_breakpoint(target, breakpoint); + } + + armv7m_maybe_skip_bkpt_inst(target, &bkpt_inst_found); + + target->debug_reason = DBG_REASON_SINGLESTEP; + + armv7m_restore_context(target); + + target_call_event_callbacks(target, TARGET_EVENT_RESUMED); + + res = stlink_if->layout->api->step(stlink_if->fd); + + if (res != ERROR_OK) + return res; + + /* registers are now invalid */ + register_cache_invalidate(armv7m->core_cache); + + if (breakpoint) + cortex_m3_set_breakpoint(target, breakpoint); + + target->debug_reason = DBG_REASON_SINGLESTEP; + target_call_event_callbacks(target, TARGET_EVENT_HALTED); + + stm32_stlink_load_context(target); + + LOG_INFO("halted: PC: 0x%x", buf_get_u32(armv7m->arm.pc->value, 0, 32)); + + return ERROR_OK; +} + +static int stm32_stlink_read_memory(struct target *target, uint32_t address, + uint32_t size, uint32_t count, + uint8_t *buffer) +{ + int res; + uint32_t *dst = (uint32_t *) buffer; + uint32_t c; + struct stlink_interface_s *stlink_if = target_to_stlink(target); + + if (!count || !buffer) + return ERROR_INVALID_ARGUMENTS; + if (size != 4) { + LOG_DEBUG("%s %x %d %d", __func__, address, size, count); + return ERROR_INVALID_ARGUMENTS; + } + + while (count) { + if (count > 128) + c = 128; + else + c = count; + + res = + stlink_if->layout->api->read_mem32(stlink_if->fd, address, + c, dst); + + if (res != ERROR_OK) + return res; + dst += c; + address += (c * 4); + count -= c; + } + + return ERROR_OK; +} + +static int stm32_stlink_write_memory(struct target *target, uint32_t address, + uint32_t size, uint32_t count, + const uint8_t *buffer) +{ + int res; + uint32_t *dst = (uint32_t *) buffer; + uint32_t c; + struct stlink_interface_s *stlink_if = target_to_stlink(target); + + if (!count || !buffer) + return ERROR_INVALID_ARGUMENTS; + if (size != 4) { + LOG_DEBUG("%s %x %d %d", __func__, address, size, count); + return ERROR_INVALID_ARGUMENTS; + } + + while (count) { + if (count > 128) + c = 128; + else + c = count; + + res = + stlink_if->layout->api->write_mem32(stlink_if->fd, address, + c, dst); + + if (res != ERROR_OK) + return res; + dst += c; + address += (c * 4); + count -= c; + } + + return ERROR_OK; +} + +static int stm32_stlink_bulk_write_memory(struct target *target, + uint32_t address, uint32_t count, + const uint8_t *buffer) +{ + return stm32_stlink_write_memory(target, address, 4, count, buffer); +} + +struct target_type stm32_stlink_target = { + .name = "stm32_stlink", + + .init_target = stm32_stlink_init_target, + .target_create = stm32_stlink_target_create, + .examine = stm32_stlink_examine, + + .poll = stm32_stlink_poll, + .arch_state = stm32_stlink_arch_state, + + .assert_reset = stm32_stlink_assert_reset, + .deassert_reset = stm32_stlink_deassert_reset, + .soft_reset_halt = stm32_stlink_soft_reset_halt, + + .halt = stm32_stlink_halt, + .resume = stm32_stlink_resume, + .step = stm32_stlink_step, + + .get_gdb_reg_list = armv7m_get_gdb_reg_list, + + .read_memory = stm32_stlink_read_memory, + .write_memory = stm32_stlink_write_memory, + .bulk_write_memory = stm32_stlink_bulk_write_memory, + + .run_algorithm = armv7m_run_algorithm, + .start_algorithm = armv7m_start_algorithm, + .wait_algorithm = armv7m_wait_algorithm, + + .add_breakpoint = cortex_m3_add_breakpoint, + .remove_breakpoint = cortex_m3_remove_breakpoint, + .add_watchpoint = cortex_m3_add_watchpoint, + .remove_watchpoint = cortex_m3_remove_watchpoint, +}; diff --git a/src/target/target.c b/src/target/target.c index a414a6a7..6b034665 100644 --- a/src/target/target.c +++ b/src/target/target.c @@ -84,6 +84,7 @@ extern struct target_type dsp563xx_target; extern struct target_type dsp5680xx_target; extern struct target_type testee_target; extern struct target_type avr32_ap7k_target; +extern struct target_type stm32_stlink_target; static struct target_type *target_types[] = { @@ -107,6 +108,7 @@ static struct target_type *target_types[] = &dsp5680xx_target, &testee_target, &avr32_ap7k_target, + &stm32_stlink_target, NULL, }; -- 2.39.5