MSP Debug Stack

From Texas Instruments Wiki
Jump to: navigation, search

Overview

The MSP debug stack (MSPDS) for all MSP430 devices is called MSP430.DLL. It consists of a dynamic link library as well as embedded firmware that runs on the MSP-FET430UIF or the eZ430 emulators. It is the bridging element between all PC software and all MSP430 microcontroller derivatives and handles tasks such as code download, stepping through code, break point handling and so forth. Examples that use the DLLv3 are IDEs such as Code Composer Studio (CCS), IAR's Embedded Workbench or others. Also other TI tools like Smart RF Studio or Elprotronic's FlashPro430 are using the MSP430.DLL.

The MSP debug stack is officially supporting the following Operating Systems:

  • Windows XP SP3, 32- and 64-bit
  • Windows Vista, 32- and 64-bit
  • Windows 7, 32- and 64-bit
  • Windows 8, 32- and 64-bit
  • Linux Ubuntu 10.04
  • Linux Suse 10.3


What's new in the MSP430.DLLv3

We're glad to announce that we've released MSP430.DLLv3 end of 2011! It is an all new version of the previous MSP430.DLLv2, which has been used in all tools until October 2011. The DLLv3 was created from scratch and was written in an object oriented way, which allows for simpler modifications.

Furthermore, we're introducing a new USB protocol (CDC) for the MSP-FET430UIF debuggers, which will improve stability significantly and doesn't require any drivers except for an .inf file.

One of the most important aspects of the MSP430.DLLv3 is that it is available as open source software. See the MSPDS Open Source DLL package.

The DLLv3 supports all features of the previous DLLv2 (see release notes for limitations). In addition it features:

  • Open source package
  • Host OS independent design
  • Linux support (Open Source Release available - see below and in CCSv5.2 and newer)
  • Faster operation, especially when stepping through code
  • Improved stability - CDC driver for the MSP-FET430UIF debugger
  • Improved usability
  • Extended LPMx.5 support

Backward compatibility: The new MSP430.DLLv3 provides full backward compatibility once the MSP-FET430UIF debugger has been updated and the CDC driver has been installed on the target system. The automated update from MSP430.DLLv2 to MSP430.DLLv3 for the MSP-FET430UIF debuggers is a new feature however, and not compatible with previous IDE releases.


IMPORTANT NOTE
The DLLv3 requires a significant firmware-update of the MSP-FET430UIF debugger. This update is different from the usual DLLv2 update, as the USB protocol stack will be updated as well. Once an update was done, the updated MSP-FET430UIF debugger won't work with older IDE or other MSP430.DLL based software anymore, unless a downgrade will be performed. For details see MSPDS Debugger Up- and Downgrade.
IMPORTANT NOTE
Do not unplug the JTAG cable during an active debug session! This might cause unknown device behavior!


Downloads

There are numerous ways of obtaining the MSP430.DLL.

  • If you intend to program your MSP430 device out of an IDE, simply download the latest CCS or IAR Embedded Workbench release. The latest MSP430.dll will be included.
  • Download the MSP430 Flasher to be able to access the basic functionality of the MSP430.DLL on the command line.
  • Download the DLL Developers Package if you plan to create your own project based on the MSP430.DLL.
  • Download the MSP430.DLL open source package to take a look at the low-level functionality (includes the MSP-FET430UIF firmware!)

IDEs

Each new IDE release with support for new MSP430 derivatives will include the latest version of the MSP430.DLL.

The first IDE versions that contain the new MSP430.DLLv3 are:

  • Code Composer Studio (CCS) v5.1 and newer - are available for download CCSv6 Wiki, legacy versions are available here.
  • IAR EW430 5.40.2 and newer - Available from IAR and the TI IAR EW430 Wiki.


Default MSP430/HIL.dll locations:
  • CCSv5: C:\ti\ccsv5\ccs_base\DebugServer\drivers
  • CCSv4: C:\Program Files\Texas Instruments\ccsv4\DebugServer\drivers
  • CCE: C:\Program Files\Texas Instruments\CC Essentials v3\DebugServer\drivers
  • IAR: C:\Program Files\IAR Systems\Embedded Workbench 5.0\430\bin
NOTE
The DLL version is aligned with the IDE release it's part of. Since different versions might include API changes it is not recommended to exchange these files. If a DLL exchange is absolutely necessary, make sure the IDE is shut down while doing this. Also it is strongly recommended to make a backup copy of the original files.


MSP430 Flasher

The MSP430 Flasher is a command line tool which provides easy access to the most common functions of the MSP430.dll

(programming & reading device memory, setting hardware breakpoints or blowing the security fuse).

Get the MSP430 Flasher here.


DLL Developers Package

The DLL Developers Package contains everything to give your DLL-based MSP430 project a head start:
  • DLL binaries
  • DLL developers guide
  • Documentation material
  • Low-Level USB drivers
  • Application examples


Download DLL Developers Package v3.4.2.7 Released 09/02/2014
Download MSPDS DLL Developers Package
Older versions:


Open Source Release

The MSP430.DLLv3 is available as open source software.

It has been tested on Windows and Linux [see distributions above]

Get the Open Source package here.


Documentation

Download the MSP430.DLL documentation directly without any additional software.


Low-Level USB CDC or VCP Drivers

These drivers provide an interface between the high-level debugger drivers (MSP430.DLL & HIL.DLL) and the MSP-FET430UIF's USB interface. This is accomplished by using a Communication Device Class (CDC) or Virtual COM Port (VCP) protocol. Please note that all necessary low-level drivers are included in each IDE release (Code Composer Studio & IAR Embedded Workbench) and get installed automatically. Download these drivers only if you are solely using the Open Source DLL or the MSP430 Flasher.

Windows

Please use our new and easy-to-use stand-alone driver package. It does not only include the CDC drivers for the latest MSP Debug Stack releases but also legacy VCP drivers for DLLv2 support.

Supported operating systems: WinXP-32/64, WinVista-32/64, Win7-32/64, Win8-32/64

Download driver package - these drivers are Microsoft WHQL certified.

The USB CDC drivers to use the back-channel UART on the LaunchPad or on the eZ430 Emulator can be downloaded and installed from this link: Download

Linux: Native CDC support - no driver installation required - Download installation script to set the required udev rules

Linux

Native CDC support - no driver installation required - Download installation script to set the required udev rules

VCP (for legacy DLLv2 support only):

Download from Brimson Labs Kernel 2.4: Release notes Kernel 2.6: Release notes

NOTE
When attempting to use the new MSP-FET debugger on Linux, please check the label on the bottom side of the casing. If the batch number on the label starts with 1401, a firmware update has to be performed on a Windows system before the tool can be used on Linux. In order to do so, download and execute the MSP-FET Linux Patcher.

MAC OS X (experimental)

Download from e2e


Releases

Release Date CCS version IAR version USB Driver Notes
DLLv3
3.4.2.7 September 3, 2014 CCSv6.0.1 + p2 package v6.0.1.2 6.10.7 CDC 1.04

New device support:

  • MSP430FR2033 Family
  • MSP430FG6626 Family

New features:

  • MSP-FET BSL support - I2C and UART BSL
    • Can be activated via invalid baud rate commands
      • 9620 Tristate of all UART/ BSL pins – no current flow into target device
      • 9621 Configure UART communication without handshake (default start behaviour)
      • 9622 Configure UART communication with handshake
      • 9623 Voltage configuration command. Set target VCC hard to 3.3V
      • 9601 BSL-Entry sequence + Power up 3.3V (UART BSL)
      • 100000(1) BSL-Entry sequence + Power up 3.3V (I2C BSL)
      • 400000(1) BSL-Entry sequence + Power up 3.3V (I2C BSL)
      • 8001 Enable MSP-FET debugger mode - disable of MSP-FET BSL mode
  • During MSP-FET BSL mode the debugger mode is disabled
  • Over-current protection of JTAG/I2C/UART and VCC supply lines is switched of in MSP-FET BSL mode
  • In MSP-FET UART BSL mode only fixed baud rates are supported - 9600, 14400, 19200, 28800, 38400, 56000, 57600 and 115200

Changes:

  • Early MSP430FR6989 family silicon (older than revision C) is no longer supported
  • Early MSP430FR5969 family silicon (older than revision F) is no longer supported
  • Improved EnergyTrace stability on longer runs
  • Improved stability during UIF firmware update from v2 to v3
  • Fuse blow option no longer available for MSP430i2040 series
  • SMCLK no longer listed for clock control on MSP430i2040 series
  • Changed voltage of 3000mV to 3300mV during UIF start-up
  • Changed MSP-FET UART lines power up state - UART lines are configured to High-Z during MSP-FET start-up
  • Changed MSP-FET UART to only support fixed baud rates - 9600, 14400, 19200, 28800, 38400, 56000, 57600 and 115200

Bug Fixes:

  • Fixed clock control module definitions For MSP430FR5969/MSP430FR6989
  • Fixed potential race condition in communication with Fet (could get out of sync)
  • Fixed potential race condition between events (eg. LPMx.5) and API calls
  • Fixed memory leak when receiving asynchronous events (breakpoints, trace, ...)
  • Fixed case of hex digits when writing Intel Hex (now upper case)
  • Fixed debug access affect LPM current consumption on FR5969
  • Fixed Race conditions during LPM5/breakpoint events

Known Limitations:

  • On devices with FLL, clock control does not allow to keep clocks running, while the device is halted and the clock is sourced by the FLL
  • V1.3 of UIF does not work in SBW2 mode with 2.2nf cap on reset line
  • eZ-FET UART might lose bytes with 115k baud (no handshake enabled) and DMA as data loopback on target device
  • MSP-FET EEM access to F149 and L092 devices is only possible with JTAG speed slow
3.4.1.0 April 24, 2014 CCSv6.0.1.00040/39 + CCSv6.0.0.00190 with MSP430 emulation p2 package (6.0.0.11) 6.10.5 + 6.10.2 CDC 1.04

New device support:

  • MSP430FG6626
  • MSP430FR4133 Family
  • MSP430FR6989 Family

New features:

  • User code erase via JTAG mailbox on MSP430FR4133 family
  • MSP-FET backchannel UART support

Changes:

  • MSP430FR5969 revE and previous revisions are not supported any longer
  • Reduced calibration time when setting VCC

Bug Fixes:

  • eZ-FET update fails in Ubuntu 64bit due to modemmanager blocking the port. When installing CCS, debugger ports will be blacklisted for modemmanager
  • Selecting invalid JTAG protocol on eZ-FET returns error instead of silently using SBW
  • Prevent MSP-FET from detecting over current when connecting to a target driving the JTAG lines active low
  • Added fix to prevent unintended execution of memory content as code during debug
  • Restoring software breakpoints after external code download on MSP430L092
  • Fixed typo in device name for MSP430FR5857
  • Removed non-existent timers from clock control settings
  • Saving to Intel format did not pad CRC values lower than 0x10 with leading 0

Known Limitations:

  • On devices with FLL, clock control does not allow to keep clocks running, while the device is halted and the clock is sourced by the FLL
  • V1.3 of UIF does not work in SBW2 mode with 2.2nf cap on reset line
  • eZ-FET UART might lose bytes with 115k baud (no handshake enabled) and DMA as data loopback on target device
  • MSP-FET EEM access to F149 and L092 devices is only possible with JTAG speed slow
  • MSP430FR4133 might not work reliably under debug control when XT1 is used as clock source, because of overwritten XT1 drive strength register
  • MSP430FR4133 might not work reliably under debug control when BSL unlock is executed via DLL/IDE, because of overwritten DCO CSCTL1 register
3.4.0.20 January 29, 2014 CCSv6.0.0.00190 + CCSv5.5.0.00077 with MSP430 emulation p2 update package (5.5.0.21) 6.10.1 + 5.60.7 CDC 1.04

New device support:

  • F67621, F67641
  • MSP430F6779A Family
  • MSP430FR5969 revF Family (full EnergyTrace and ULP feature support)

New features:

  • Added support for new MSP-FET debugger
  • Added EnergyTrace

Changes:

  • Removed MSP430_GetJTAGID() from MSP Debug Stack API completely
  • Enhanced debug flow for FR5969 family
  • Enhanced power up mechanism to handle all MSP430 device requirements
  • MSP430FR5969 revD and previous revisions are not supported any longer

Bug Fixes:

  • Fixed: Debugger-started in "FreeRun" mode has higher current than real free run without debugger
  • Fixed: RAM corruption when using emulated breakpoints option in IAR
  • Fixes JTAG password unlock in SBW mode
  • Fixed: eZ-FET DCDC PWM width is too long for first PWM after no load phase
  • Fixed: DLL crashes if memory function is called with read/write length equals zero
  • Fixed: Code placed on the first location of the Info Memory cannot be executed (FRAM devices only)
  • Fixed F14x/F14x1 identification
  • Fixed: MSP430_Error_String returns INT instead of string w/o MSP430_Initialize up front
  • Fixed: SFR register mask off by one on odd address
  • Fixed memory verification issue on devices without BSL
  • Fixed connect to running target
  • Fixed: Download/verify error if code size > 250 bytes on FR5969 devices
  • Fixed L092 startup bug

Known Limitations:

  • On devices with FLL, clock control does not allow to keep clocks running, while the device is halted and the clock is sourced by the FLL
    Workaround: None
  • This MSP Debug Stack version might not be compatible with revision 1.3 of the MSP-FET430UIF if a capacitor is connected to the RST pin.
    Workaround: None
  • eZ-FET UART might lose bytes with 115kbaut (no handshake enabled) and DMA as data loopback on target device
  • MSP-FET EEM access to F149 and L092 devices is only possible with JTAG speed slow
  • Fuseblow on 1/2/4xx devices using the MSP-FET is provided as "experimental"!
  • MSP-FET UART not implemented
  • EnergyTrace is not supported on MSP430FR5969 revE and previous revisions
3.3.1.4 September 20, 2013 CCSv5.5.0.00077 + MSP430 emulation p2 update package (5.5.0.18) 5.60.6 + 5.60.5 + 5.60.2 CDC 1.04

New device support:

  • MSP430F5259 Full device series

New features:

  • N/A

Bug Fixes:

  • Added support for remaining MSP430F5259 spins

Known Limitations:

  • On devices with FLL, clock control does not allow to keep clocks running, while the device is halted and the clock is sourced by the FLL
    Workaround: None
  • This MSP430.dll version might not be compatible with revision 1.3 of the MSP-FET430UIF if a capacitor is connected to the RST pin.
    Workaround: None


3.3.1.3 June 28, 2013 CCSv5.5.0.00077 5.60.1 CDC 1.04

New device support:

  • MSP430FR5969 Rev. E - ULP debug feature support
  • MSP430FR5969 Rev. D - Basic debug support only
  • MSP430G2xx4 - eZ430 emulator series support update (e.g. for onboard LaunchPad emulation)
  • MSP430F5259 (single device only)
  • MSP430F5249 Family
  • MSP430i2040 Family

New features:

  • Enhanced support for new eZ-FET debuggers
  • 64 bit Jstate readout for MSP430FR5969
  • Added eZ-FET & eZ-FET lite BSL firmware project
  • Added new easy to use software breakpoint API
  • Added DCDC MCU firmware project to eZ-FET firmware project

Bug Fixes:

  • Fixed: Magic pattern is not fully functional
  • Fixed: 0x3FFF when reading upper 16 byte from RAM on MSP430FR5969
  • After calling the status = MSP430_Reset(..); TST line high
  • Fixed some preprocessor defines
  • Improved UART communication stability in no-handshake mode on eZ-FET
  • Fixed: Could not set device Vcc – COM port blocked by OS
  • Fixed Cycle Counter reset
  • Clarified error message for communication error (previously “Could not set VCC”)
  • Fixed potential timeout of data verification (MSP430F6659 in SBW2)
  • DLL now returns correct architecture for MSP430F5969 in DEVICE_T
  • Added main flash segment size to DEVICE_T

Known Limitations:

  • Only support for MSP430F5259, but not the full series
  • On devices with FLL, clock control does not allow to keep clocks running, while the device is halted and the clock is sourced by the FLL
    Workaround: None
  • This MSP430.dll version might not be compatible with revision 1.3 of the MSP-FET430UIF if a capacitor is connected to the RST pin.
    Workaround: None
3.3.0.6 January 31, 2013 5.4.0.00091 5.52.1 + 5.51.6 CDC 1.04

New device support:
MSP430G2xx5, MSP430G2xx4, MSP430TCH5E

New features:

  • Added support for new eZ-FET & eZ-FET light debuggers
  • Added new firmware project for eZ-FET & eZ-FET light debuggers
  • Implementéd HID recovery mechanism for eZ-FET & eZ-FET light debuggers
  • Linked HID-BSL library into DLLv3 to handle HID communication
  • Added unique Tool ID for eZ-FET and MSP-FET430UIF
  • Createed function to scan for multiple debuggers with different PID & VID
  • Added Hil_Configure API function to configure protocol on low level

Changes:

  • Changed update mechanism to handle different debuggers by adding different update managers
  • Removed polling handling from DebugManager by creating new PollingManager
  • Changed overcurrent detecion on MSP-FET430UIF to shut down power after 60ms in overcurrent case not after 10ms
  • Separated all FW projects into hardware specific parts
  • Deprecated old Reset function commands/states
  • Fixed thread race conditions in CDC IO channel class
  • Removed CDC & FLOW Control for new eZ-FET & eZ-FET Lite debuggers

Bug Fixes:

  • Improved error message if MSP-FET430UIF FW doesn't match
  • Removed C++ headers from include directory
  • Clear LPMx.5 debug settings when calling MSP430_Close
  • Fixed funclet offset addresses, which could cause RAM corruption

Known Problems:

  • On devices with FLL, clock control does not allow to keep clocks running, while the device is halted and the clock is sourced by the FLL
    Workaround: None
  • This MSP430.dll version might not be compatible with revision 1.3 of the MSP-FET430UIF if a capacitor is connected to the RST pin.
    Workaround: None
3.2.5.4 September 27, 2012 5.3.0.000090 5.51.5 + 5.51.4 + 5.51.3 + 5.51.2 CDC 1.04

New device support:
MSP430F535x, MSP430F565x, MSP430F635x, MSP430F665x

Changes:
Removed deprecated functions

  • MSP430_Identify
  • MSP430_Breakpoint
  • MSP430_EEM_Open
  • MSP430_EEM_Read_Register
  • MSP430_EEM_Read_Register_Test
  • MSP430_EEM_Write_Register
  • MSP430_EEM_Close

Bug Fixes:

  • Improved update stability and behavior in case of a failed update
  • Fixed occasional errors after firmware update without power cycle
  • Fixed wrong RAM sizes for MSP430FR57xx devices
  • Fixed bug where 0x00 was written behind a FRAM write
  • Fixed issue where EDI parity could be invalidated on writing

Known Problems:

  • This MSP430.dll version might not be compatible with revision 1.3 of the MSP-FET430UIF if a capacitor is connected to the RST pin.
3.2.4.5 June 26, 2012 5.2.1.00018 5.50.1 - FET613 CDC 1.04

New device support:
MSP430SL5438A, MSP430F6779(1), CC430F5123, CC430F5125, CC430F5143, CC430F5145, CC430F5147, CC430F6143, CC430F6145, CC430F6147, MSP430FR5969, MSP430FR5949 (Wolverine)
New features:

  • MPU and IP protection are handled by the DLL on all MSP430FRxx devices -> Access violations will be suppressed by the debugger
  • Implemented WriteMemoryQuick() function to write directly into the FRAM memory using JTAG
  • Removed write and erase funclets for MSP430FR59xx devices - erase is now handled using the JTAG mailbox, write is done using WriteMemoryQuick()
  • Implemented erase mechanism to erase IP protected memory areas without accessing it
  • Enhanced USB-FET VCC startup behavior to match the V2 DLL (VCC will be activated when the USB connector of the USB-FET is plugged in)
  • Enhanced EEM support (state storage implementation fully functional; implemented cycle counter for counting cycles during a single run)

Bug Fixes:

  • Corrected DLL database entry for min. flash voltage on 471x devices
  • Fixed single stepping issues on L092
  • Fixed DCO calibration bug, where the original DCO setting was not restored after debug break (device running slower after read)
  • Fixed DLL database entry for the EEM level of the MSP430F5228
  • Fixed disassembly window issues on MSP430FR59xx devices
  • Fixed issues with fast port close/open

Known Problems:

  • This MSP430.dll version might not be compatible with revision 1.3 of the MSP-FET430UIF if a capacitor is connected to the RST pin.
3.2.3.15 March 16, 2012 5.2.0.00069 5.40.7 - FET612 + 5.40.6 - FET611 CDC 1.04

New Features:

  • Added calibration of clock frequency to ensure exact flash timings, before Flash erasing or writing
  • The UIF now starts up supplying 3V to target

Bug Fixes:

  • Writing to BSL is now working when an erase or erase check, followed by a reset, was performed before
  • Writing to memory with enabled MPU on FRAM devices not possible anymore
  • Fixed a bug causing flash erase and write errors on MSP430F413
  • Size of DEVICE_T struct has been increased to match embedded v2 DLL
  • Port handling has been changed to prevent a port can't be reopened after closing
  • Added fix to prevent possible RAM corruption when reading CPU registers on 5xx/6xx devices

Known Problems:

  • This MSP430.dll version might not be compatible with revision 1.3 of the MSP-FET430UIF if a capacitor is connected to the RST pin.
3.2.3.2 December 30, 2011 5.1.1.00031 5.40.3 - FET610 CDC 1.04

Bug Fixes:

  • All 2xx Special Function Registers are not longer read as 0x3FFF
  • Step over certain instructions is now working
  • Flash programming at VCC < 2.7V for F1xx/F4xx now works
  • FLL Debug Error, RST after GO is fixed
  • C092: Connection to ROM device generates no errors anymore
  • Write File API call no longer fails with ERROR_OPERATION_ABORTED
  • Fixed FE427A / T103 Problems with FLL clock frequency while debugging
  • Debugger operation sets VMAIFG on MSP430F5438A
  • DLL now returns when USB FET is disconnected during FW update

Known Problems:

  • This MSP430.dll version might not be compatible with revision 1.3 of the MSP-FET430UIF if a capacitor is connected to the RST pin.
3.2.2.0 December 23, 2011 - 5.40.2 - FET609 + 5.40.1 - FET608 CDC 1.04

New device support:
CC430F5123, CC430F5125, CC430F5143, CC430F5145, CC430F5147, CC430F6143, CC430F6145, MSP430G2210, MSP430G2230 Known Problems:

  • This MSP430.dll version might not be compatible with revision 1.3 of the MSP-FET430UIF if a capacitor is connected to the RST pin.
3.2.1.9 November 8, 2011 5.1.0.09000 - CDC 1.04

The DLL version 3.2.1.9 is an all new DLL design compared to the last DLL version 2.4.9.1. This new DLL includes also a new UIF-Firmware. Furthermore the USB driver has been changed to a certified CDC driver. The DLL is implemented in C++ and follows an object based design, which is host operating system independent. The API of the new DLL is the same as for the old one. DLL functionality keeps the same as in the old V2 DLL. The new DLL V3 also includes a compiled version of the DLL v2. Known Problems:

  • This MSP430.dll version might not be compatible with revision 1.3 of the MSP-FET430UIF if a capacitor is connected to the RST pin.
DLLv2
2.4.9.1 May 8, 2011 CCSv4.2.4 5.30.1 - FET607 VCP 6.5.9017.0

New device support:
L092 Rev. E, F5229, F5224, F5219, F5214, F5228, F5223, F5218, F5213, F5227, F5222, F5217, F5212, F6730, F6720, F6700, F6731, F6721, F6701, F6732, F6722, F6702, F6733, F6723, F6703,F6438, F6436, F6435, F6433, F5338, F5336, F5335, F5333, FR5737, FR5736, FR5727, FR5726, FR5734, FR5733, FR5732, FR5724, FR5723, FR5722, FR5731, FR5721, CC430F6147
Bug Fixes:

  • Fixed magic pattern mechanism
  • Corrected RAM definition of CC430F6137
  • Fixed wrong SR content (0xE1) after wakeup from LPM3.5
  • Improved reliability of connect if device is in LPMx.5
  • Software handshake needs to be configured for UIF only, not for eZ430
  • Fixed download with USB tool and REV D

Known Problems:

  • To prevent problems when multiple USB FET’s are connected to your system: Please use different USB HUB’s in your computer. If you unplug an USB FET during an active debug session, the session could be interrupted and the IDE could stop working.
  • MSP430_EEM_SetBreakpoint() does not set range breakpoints correctly on all 5xx devices with small emulation logic. Workaround: None.
2.4.8.2 March 10, 2011 CCSv4.2.3 5.20.4 - FET604 VCP 6.5.9017.0

New device support:
MSP430FR57xx, MSP430AFE253, MSP430AFE233, MSP430AFE223,MSP430AFE252, MSP430AFE232, MSP430AFE222, MSP430AFE251,MSP430AFE231, MSP430AFE221, MSP430AFE250, MSP430AFE250,MSP430AFE220, MSP430G2552

New Features:

  • Enhanced MSP430.DLL to support LPMx.5 debugging for the MSP430FR5739. The MSP430F5739 can enter LPMx.5. The DLL will detect this device state change and send a notification to the IDE via a callback. LPMx.5 debug is just available on the USB-FET and on the FRAM ez430.

Bug Fixes:

  • i_ReadMemQuick fixed: MOVA is now correctly calculated when resetting the PC after read out is done.
  • The thread handling and synchronization of the MSP430.DLL threads has been improved. The Critical Section mechanism has been replaced by a MUTEX which handles the USB communication with the USB-FET.
  • The erase problem, which was found on the new G2xx devices, has been fixed too. The DLL did not provide enough TCLK strobes when erasing the main memory. This fix is a DLL only fix; no new ez430-Launchpad firmware is required.
  • Fixed an FR5739 bug where the Disassembly window and memory window content is read wrong after code download
  • Fixed the password flow for FR5739 where the IDE would crash whenever a password was provided for a device that wasn't password protected
  • Fixed FRAM Memory corruption on memory write
  • Fixed a bug where the INFO memory wasn't 100% erased while download

Known Problems:

  • To prevent problems when multiple USB FET’s are connected to your system: Please use different USB HUB’s in your computer. If you unplug an USB FET during an active debug session, the session could be interrupted and the IDE could stop working.
  • MSP430_EEM_SetBreakpoint() does not set range breakpoints correctly on all 5xx devices with small emulation logic. Workaround: None.
2.4.7.1 November 30, 2010 CCSv4.2.1 5.20.1 - FET603 VCP 6.5.9017.0

New device support:
MSP430AFE253, MSP430F5329, MSP430F5328 MSP430F5327 MSP430F5326, MSP430F5325, MSP430F5324, MSP430G2452, MSP430F5342, MSP430F5341, MSP430F5340, FW428, FW429

New Features:

Enhanced MSP430.DLL to support LPMx.5 debugging for the MSP430FR5739. The MSP430F5739 can enter LPMx.5 when Release JTAG on Go is selected.

Bug Fixes:

  • MSP430_EEM_SetBreakpoint() fixed: Breakpoints are working correctly above the 64k boundary.
  • Fixed L092 SingleStepping Problems
  • Fixed “FLL Debug Error, RST after GO”
  • Fixed “handshake is switched on automatically after Fast Flasher”
  • Fixed “Step over certain instructions do not work”

Known Problems:

  • To prevent problems when multiple USB FET’s are connected to your system: Please use different USB HUB’s in your computer. If you unplug an USB FET during an active debug session, the session could be interrupted and the IDE could stop working.
  • MSP430_EEM_SetBreakpoint() does not set range breakpoints correctly on all 5xx devices with small emulation logic. Workaround: None.
2.4.6.1 November 5, 2010 CCSv4.2.0 5.10.6 - FET602 VCP 6.5.9017.0 New device support:

MSP430F6733, MSP430F11x2 & MSP430F12x2 new revisions, MSP430F5510, MSP430F5509, MSP430F5508, MSP430F5507, MSP430F5506, MSP430F5505, MSP430F5505, MSP430F5504, MSP430F5503, MSP430F5502, MSP430F5501, MSP430F5500, MSP430F5310, MSP430F5309, MSP430F5308, MSP430F5304

New Features:

  • Enhanced MSP430.DLL to support LPMx.5 debugging for the MSP430FR5739. The MSP430F5739 can enter LPMx.5 when Release JTAG on Go is selected.
  • Implemented a special handling for the Fast-eZ in the MSP430.DLL. MSP430.DLL can now handle the Fast-eZ430(3kb/s download speed) and all old version of the eZ430.
  • A software and hardware handshake has been implemented in the MSP430.DLL and USB-UIF firmware to increase stability of the USB communication.

Bug Fixes:

  • Fixed MSP430_EEM_SetBreakpoint(): Register breakpoints are now working correctly on all 5xx devices with small emulation logic.
  • Fixed “UIF gets stuck, both LEDs stay on”
  • Fixed “Retry upon debugger launch doesn’t work”
  • Fixed “CCS hang upon debugger launch occasionally”
  • Fixed “Device gets Reset when BootData is displayed in memory window”
  • Fixed “Device generates POR during Single Stepping”
  • Fixed “Set PC to Cursor" function from CCS deletes SP”
  • Fixed “EDI: single stepping over EDI PUC event returns wrong program counter”

Known Problems:

  • To prevent problems when multiple USB FETs are connected to your system, please use different USB HUBs in your computer. If you unplug a USB FET during an active debug session, the session could be interrupted and the IDE could stop working.
  • MSP430_EEM_SetBreakpoint() does not set range breakpoints correctly, on all 5xx devices with small emulation logic Workaround: None.
2.4.5.3 July 1, 2010 CCSv4.1.3 5.10.4 - FET601 VCP 6.5.9017.0 New device support:

MSP430F438, F439, full support for L092 and C092 devices.

New Features:

  • Implemented function to download application code to an external SPI memory, which is connected to the L092.
  • Added password support for the C092. Configured it to start in the correct mode.
  • Added automatic interface scan to DLL: Now it’s possible that the DLL scans automatically for connected interfaces. The DLL detects the first unused FET on an interface and initialize it. First HID devices are initialized. If the first interface is in use, the next unused interface will be initialized.

Bug Fixes:

  • Corrected issues in the struct sDebugInfo[]. Now the number of Register Triggers is valid.
  • Corrected RAM size definition for MSP430F5132.
  • Fixed read DATA QUICK MEMORY function.
  • Implemented different DATA QUICK MEMORY function for the L092.
2.4.4.0 April 1, 2010 CCSv4.1.2 5.10.1 - FET600 VCP 6.5.9017.0 New Device Support:
  • MSP430F5510
  • MSP430F5630, F5631, F5632, F5633, F5634, F5635, F5636, F5637, F5638
  • MSP430F6630, F6631, F6632, F6633, F6634, F6635, F6636, F6637, F6638
  • MSP430F5131, F5132, F5151, F5152, F5171, F5172
  • MSP430G2211, G2201, G2111, G2101, G2011, G2001, G2231, G2221, G2131, G2121, G2031, G2021

New Features:

  • Added automatic protocol detection to DLL: Now it’s possible that the DLL scans automatically, if the connected device operates in JTAG or Spy-bi-wire mode. If the function MSP430_Configure(INTERFACE_MODE, AUTOMATIC_IF) is called, the automatic protocol scanning will be started. Also the automatic mode is selected by default.
  • New behavior for reading dual port memories (derivatives with USB) has been implemented in the DLL. That means, just the dual port memory is read in a word by word mode. The rest of the memory is read in DATA QUICK mode. This fix increases debugging performance on 5xx device with dual port memory.
  • New API call: MSP430_OpenDevice() (see DLL documentation for details)
  • New API call: MSP430_GetFoundDevice() (see DLL documentation for details)
  • New API call: MSP430_SET_SYSTEM_NOTIFY_CALLBACK() (see DLL documentation for details)
  • The DEVICE_T struct was enhanced with device-specific EMM information (see DLL documentation for details)

Bug Fixes:

  • Implemented fix for HP machines and the eZ430-430: This fix enables the DLL to recognize the eZ430-430 on HP computers.|
  • The read DATA QUICK MEMORY function has been fixed. Now, no invalid memory access is preformed under debugger control.
  • A fix for DMA debugging is implemented in the DLL release. However, the debugger may show invalid DMA transfer data.

Known Problems:

  • MSP430_EEM_SetBreakpoint() does not set register breakpoints correctly on all 5xx devices with small emulation logic. Workaround: None.
2.4.2.0 November 1, 2009 CCSv4.1.0 4.21.7 - FET522 VCP 6.5.9017.0 New Device Support:
  • MSP430F5527, MSP430F5418A
  • MSP430F47163IPZ(R), F47173IPZ(R), F47183IPZ(R), F47193IPZ(R)
  • MSP430F47126IPZ/R, F47127IPZ/R
  • MSP430F46161IPZ(R), F46171IPZ(R), F46181IPZ(R), F46191IPZ(R), F4481IPZ(R), F4491IPZ(R)
  • MSP430F4616IPZ(R), F4617IPZ(R), F4618IPZ(R), F4619IPZ(R)

Bug Fixes:

  • MSP430_VerifyMem() and MSP430_EraseCheck() don't return STATUS_ERROR anymore when used for Flash memory verification with small F54xx(A) & F54xx devices
  • Fixed "Debugger stops on the ISR-Handler, instead of BreakPoint."
  • Fixed "Wrong Stack value stored if CPU stops on breakpoint with incoming interrupt."
  • Fixed "CPU accepts interrupt requests although CPUSUSP is set."
  • Fixed "Singlestep over NMI request by Software stores wrong return address on stack."
  • Fixed "Stop and Go of Debugger in LPMx increments the PC by 2."

Known Problems:

  • MSP430_VerifyMem() and MSP430_EraseCheck() return STATUS_ERROR when used for Flash memory verification of F5521 , F5521 & F5513 devices although the memory contains the correct content. Workaround: Use MSP430_Memory() instead for verification.
  • The Word-by-word mode is much slower than DATA_QUICK mode. This decreases the performance during the memory read on the MSP430F55xx devices.
2.4.1.4 October 9, 2009 CCSv4.0.1 4.21.4 - FET521 VCP 6.5.9003.0 New Features:

The memory read routine was updated because of memory design changes on the F55xx family. If the device memory is spitted over two physical flash memory blocks it’s important that both physical memory blocks are erased when a mass erase occurs.

Known Problems:

  • MSP430_VerifyMem() and MSP430_EraseCheck() return STATUS_ERROR when used for Flash memory verification with small F54xx(A) AND F55xx devices (MSP430F5436(A),MSP430F5419(A),MSP430F5437(A), MSP430F5435(A), MSP430F5418(A)) although the memory contains the correct content. Workaround: Use MSP430_Memory() instead for verification.
  • The Word-by-word mode is much slower than DATA_QUICK mode. This decreases the performance during the memory read on the MSP430F55xx devices.


New Findings

This section describes new findings that have been identified after the release happend (i.e. not covered in release notes). They are planned to be addressed in the upcoming release.


# Symptoms Treatment
1 A FET firmware update from older DLL versions (up to v3.2.3.15) to v3.2.4.5 and newer versions might not be completed correctly. In this case, the IDE/programmer software won't respond anymore. The IDE/programmer software will have to be closed and restarted. Additionally, the FET has to be unplugged and reconnected again.
2 Can't launch debug session for MSP430F67xx devices when using 4-wire JTAG mode. Make sure that device is not in LPMx.5 when launching a debug session or use 2-wire SBW mode.
3 Error message "Can't set Vcc" occurs upon debug session launch with DLLv3.3.0.6. Workaround: Unplug/reconnect debug interface and launch debug session again. This issue has been fixed in DLLv3.3.1.3 and newer versions.
4 Can't set breakpoints while device is running (FR59xx series) with DLLv3.3.0.6. This issue has been fixed in DLLv3.3.1.3 and newer versions.
5 Can only access F2xx master devices (e.g. MSP430F2274 works, but not the F2272) with eZ-FET based emulators. This issue has been fixed in DLLv3.3.1.3 and newer versions.
6 Configuring SMCLK to keep running during debug halt causes device resets on MSP430i2040. The clock control option for SMCLK on MSP430i2040 will be removed in the next release.
7 MSP-FET430UIF us delay is doubled inside firmware which might cause issues when trying to waking up i2040 from LPMx.5. This issue has been fixed in DLLv3.4.2.7 and newer versions.
8 MSP-FET backchannel support in 3.4.1.0 forces UART pins high, even if the backchannel wasn't opened yet. This may lead to the overcurrent protection switching off any UART/JTAG communications (green LED off, red LED on). Workaround: Disconnect UART lines or change default pin level of connected target. This issue has been fixed in DLLv3.4.2.7 and newer versions.


Feedback

Your feedback to the MSP40.DLLv3 binary as well as the open source release is highly appreciated! Please visit the E2E forums!