tcl/target/stellaris.cfg

   1 # TI/Luminary Stellaris LM3S chip family
   2
   3 # Some devices have errata in returning their device class.
   4 # DEVICECLASS is provided as a manual override
   5 # Manual setting of a device class of 0xff is not allowed
   6
   7 global _DEVICECLASS
   8
   9 if { [info exists DEVICECLASS ] } {
  10    set _DEVICECLASS $DEVICECLASS
  11 } else {
  12    set _DEVICECLASS 0xff
  13 }
  14
  15 # Luminary chips support both JTAG and SWD transports.
  16 # Adapt based on what transport is active.
  17 source [find target/swj-dp.tcl]
  18
  19 # For now we ignore the SPI and UART options, which
  20 # are usable only for ISP style initial flash programming.
  21
  22 if { [info exists CHIPNAME] } {
  23    set  _CHIPNAME $CHIPNAME
  24 } else {
  25    set  _CHIPNAME lm3s
  26 }
  27
  28 # CPU TAP ID 0x1ba00477 for early Sandstorm parts
  29 # CPU TAP ID 0x2ba00477 for later SandStorm parts, e.g. lm3s811 Rev C2
  30 # CPU TAP ID 0x3ba00477 for Cortex-M3 r1p2 (on Fury, DustDevil)
  31 # CPU TAP ID 0x4ba00477 for Cortex-M3 r2p0 (on Tempest)
  32 # ... we'll ignore the JTAG version field, rather than list every
  33 # chip revision that turns up.
  34 if { [info exists CPUTAPID ] } {
  35    set _CPUTAPID $CPUTAPID
  36 } else {
  37    set _CPUTAPID 0x0ba00477
  38 }
  39
  40 # SWD DAP, and JTAG TAP, take same params for now;
  41 # ... even though SWD ignores all except TAPID, and
  42 # JTAG shouldn't need anything more then irlen. (and TAPID).
  43 swj_newdap $_CHIPNAME cpu -irlen 4 -irmask 0xf \
  44         -expected-id $_CPUTAPID -ignore-version
  45
  46 if { [info exists WORKAREASIZE ] } {
  47    set _WORKAREASIZE $WORKAREASIZE
  48 } else {
  49    # default to 8K working area
  50    set _WORKAREASIZE 0x2000
  51 }
  52
  53 set _TARGETNAME $_CHIPNAME.cpu
  54 target create $_TARGETNAME cortex_m3 -chain-position $_CHIPNAME.cpu
  55
  56 # 8K working area at base of ram, not backed up
  57 #
  58 # NOTE:  you may need or want to reconfigure the work area;
  59 # some parts have just 6K, and you may want to use other
  60 # addresses (at end of mem not beginning) or back it up.
  61 $_TARGETNAME configure -work-area-phys 0x20000000 -work-area-size $_WORKAREASIZE
  62
  63 # JTAG speed ... slow enough to work with a 12 MHz RC oscillator;
  64 # LM3S parts don't support RTCK
  65 #
  66 # NOTE:  this may be increased by a reset-init handler, after it
  67 # configures and enables the PLL.  Or you might need to decrease
  68 # this, if you're using a slower clock.
  69 adapter_khz 500
  70
  71 source [find mem_helper.tcl]
  72
  73 $_TARGETNAME configure -event reset-start {
  74         adapter_khz 500
  75
  76         #
  77         # When nRST is asserted on most Stellaris devices, it clears some of
  78         # the debug state.  The ARMv7M and Cortex-M3 TRMs say that's wrong;
  79         # and OpenOCD depends on those TRMs.  So we won't use SRST on those
  80         # chips.  (Only power-on reset should affect debug state, beyond a
  81         # few specified bits; not the chip's nRST input, wired to SRST.)
  82         #
  83         # REVISIT current errata specs don't seem to cover this issue.
  84         # Do we have more details than this email?
  85         #   https://lists.berlios.de/pipermail
  86         #       /openocd-development/2008-August/003065.html
  87         #
  88
  89         global _DEVICECLASS
  90
  91         if {$_DEVICECLASS != 0xff} {
  92            set device_class $_DEVICECLASS
  93         } else {
  94            set device_class [expr (([mrw 0x400fe000] >> 16) & 0xff)]
  95         }
  96
  97         if {$device_class == 0 || $device_class == 1 || $device_class == 3} {
  98                 # Sandstorm, Fury and DustDevil are able to use NVIC SYSRESETREQ
  99                 cortex_m3 reset_config sysresetreq
 100         } else {
 101                 # Tempest and newer default to using NVIC VECTRESET
 102                 # this does mean a reset-init event handler is required to reset
 103                 # any peripherals
 104                 cortex_m3 reset_config vectreset
 105         }
 106 }
 107
 108 # flash configuration ... autodetects sizes, autoprobed
 109 flash bank $_CHIPNAME.flash stellaris 0 0 0 0 $_TARGETNAME
 110