ARM chips like the STM32 and the LPC8xx series as used in the PicosARM and jeelabs.org projects provide hardware debug facilities. For instance, the LPC810 has some pins providing On-Chip Debugging (OCD). Two of those pins provide the Serial Wire Debug interface, the SWD. There is a slight drawback. To use this it requires an additional hardware adapter to interface between a USB-port of your computer and the ARM-chip.\u00a0Several JTAG debuggers are around. ARM-chip makers usually provide demo-boards and some of them implement a variant of a JTAG\/SWD debugger.<\/p>\n
LPC-Link<\/h5>\n
NXP provides LPCXpresso boards. Around EUR 16 for a LPC812 board. From reading the LPC forum and further searching the internet I get the impression that Eclipse\/OpenOCD support is substandard. and that it might only properly work with NXP’s own version of the Eclipse IDE: LPCXPresso.<\/p>\n
STLink \/ ST Discovery \/ ST Nucleo boards<\/h5>\n
ST provides very inexpensive demo boards. Just above EUR 10. Currently the Nucleo STM32 boards. Those boards have the STLink-V2-1 SWD interface that can be used for external SWD programmable devices as well. Linux and OpenOCD support is good. Despite being designed by the supplier of the STM32 chips, it also works with NCP LPC chips! The STLink-V2-1 part of the Nucleo board is what I use in the following text.<\/p>\n
Basic steps for setup<\/h5>\n\n- Install OpenOCD<\/li>\n
- Configure OpenOCD for the Nucleo\/LPC8xx combination<\/li>\n
- Install STLink-V2-1 USB drivers<\/li>\n
- Create OpenOCD External Tool in Eclipse CDT<\/li>\n
- Create Debug configuration with GNU debugger in Eclipse CDT<\/li>\n
- Connect the target to the STLink device<\/li>\n
- Build a project and start stepping through the code.<\/li>\n<\/ul>\n
\u00a0Install OpenOCD<\/h3>\n
OpenOCD is a server that connects to the target (the LPC8xx to be debugged or programmed) and that handles debugger commands. The current release is version 0.8.0. Download a executable (binary) version from Freddie Chopin’s site<\/a>.<\/p>\n![\"OpenOCDDownload\"](\"\/\/www.sevenwatt.com\/main\/wp-content\/uploads\/2015\/03\/OpenOCDDownload.png\")
<\/a><\/p>\nIn File explorer, create or go to the PicosARM root folder. When you followed this PicosARM guide, it is located in C:\\PicosARM<\/code>. Unzip the openOCD download in the tools folder. A folder containing OpenOCD will be created in tools: C:\\PicosARM\\openOCD0.8.0<\/code>.<\/p>\n![\"OpenOCDInstall1\"](\"\/\/www.sevenwatt.com\/main\/wp-content\/uploads\/2015\/03\/OpenOCDInstall1.png\")
<\/a>To avoid some future maintenance, rename this folder to openOCD<\/code>, without the version number in it.<\/p>\n![\"OpenOCDInstall2\"](\"\/\/www.sevenwatt.com\/main\/wp-content\/uploads\/2015\/03\/OpenOCDInstall2.png\")
<\/a><\/p>\nNote: Winzip may refuse to unpack. In this case download and use 7-zip to unzip<\/p><\/blockquote>\n
Configure OpenOCD<\/h3>\n
OpenOCD requires some additional configuration for the specific hardware we are using as HW debugger (Nucleo STM32)\u00a0and Micrcontroller target (LPC8xx). OpenOCD 0.9.0 is providing more extensive support for the LPC8xx series. It requires a slightly different configuration then OpenOCD 0.8.0. Here we proceed with the OpenOCD 0.8.0 configuration, but 0.9.0 cfg files are also available for download.<\/p>\n
Download the Nucleo\/LPC8xx\u00a0cfg files from the PicosARM github repository. For OpenOCD-0.8.0, this is the LPC8xx-Nucleo link<\/a>.<\/p>\nIn the just installed OpenOCD, browse to the openocd\/scripts folder and unzip\u00a0the .cfg files to\u00a0this location.<\/p>\n
![\"OpenOCDConfig2\"](\"\/\/www.sevenwatt.com\/main\/wp-content\/uploads\/2015\/03\/OpenOCDConfig2.png\")
<\/a><\/p>\nMake sure that within the script folder an picosARM folder is created:<\/p>\n
![\"OpenOCDConfig3\"](\"\/\/www.sevenwatt.com\/main\/wp-content\/uploads\/2015\/03\/OpenOCDConfig3.png\")
<\/a><\/p>\nInstall STLink-V2-1 USB drivers<\/h3>\n
This step is specific for the exact JTAG\/SWD debugger that will be used. In this guide it is the STLink-V2-1 interface of a Nucleo STM32 board. It does not matter which of the Nucleo boards is used. All are equipped with the same STLink device. If you already have connected a Nucleo to your PC before, then you probably already performed this step.<\/p>\n
Download the drivers form the ST-website<\/a>.<\/p>\n![\"STLinkDriver\"](\"\/\/www.sevenwatt.com\/main\/wp-content\/uploads\/2015\/03\/STLinkDriver.png\")
<\/a><\/p>\nUnzip the downloaded file and run stlink_winusb_install.bat<\/code> to install the USB drivers<\/p>\n![\"STLinkDriver2\"](\"\/\/www.sevenwatt.com\/main\/wp-content\/uploads\/2015\/03\/STLinkDriver2.png\")
<\/a><\/p>\nNow connect the Nucleo to your computer and see whether windows properly recognizes the Nucleo board.<\/p>\n
Create Eclipse CDT External Tool<\/h3>\n
Start Eclipse and go to the HelloLPC or Blink project. This guide uses a Blink project as example.\u00a0The second row of the screen is the toolbar. Just below the main menu. On this menu is the External Programs tool, which we can use to launch OpenOCD. To setup OpenOCD as External Program open the External Tool Configuration screen:<\/p>\n
![\"EclipseOpenOCDConfig0\"](\"\/\/www.sevenwatt.com\/main\/wp-content\/uploads\/2015\/03\/EclipseOpenOCDConfig0.png\")
<\/a><\/p>\nThe editor is opened. Press the Create new button and fill the fileds in the main tab.<\/p>\n
![\"EclipseOpenOCDConfig1\"](\"\/\/www.sevenwatt.com\/main\/wp-content\/uploads\/2015\/03\/EclipseOpenOCDConfig1.png\")
<\/a><\/p>\nSet field Name to LPC810 - Nucleo<\/code>
\nSet field Location to C:\\PicosARM\\openocd\\bin\\openocd.exe<\/code>
\nSet filed Argumets to\u00a0-c \"telnet_port 4444\" -f \"picosARM\\lpc810-nucleo.cfg\"<\/code>
\nAll other settings can remain unchanged.<\/p>\nOn the “Common” Tab, check the “Exteral Tools” as display favorite:<\/p>\n
![\"EclipseOpenOCDConfig2\"](\"\/\/www.sevenwatt.com\/main\/wp-content\/uploads\/2015\/03\/EclipseOpenOCDConfig2.png\")
<\/a><\/p>\nThe External tool is configured now.<\/p>\n
This example uses a LPC810. For other LPC8xx boards, just replace all LPC810 by the proper LPC number on the “Main” Tab, for example to \u00a0LPC824.<\/p><\/blockquote>\n
Create Debug configuration in Eclipse<\/h3>\n
Make sure the project is already build. The following step requires a firmware image to be available. Open the Debug Configuration Editor through the toolbar:<\/p>\n
![\"EclipseDebugConfig0\"](\"\/\/www.sevenwatt.com\/main\/wp-content\/uploads\/2015\/03\/EclipseDebugConfig0.png\")
<\/a><\/p>\nSelect “Debug Configurations…”<\/p>\n
![\"EclipseDebugConfig1\"](\"\/\/www.sevenwatt.com\/main\/wp-content\/uploads\/2015\/03\/EclipseDebugConfig1.png\")
<\/a><\/p>\nOn this screen Select “GDB Hardware Debugging” and press the “New” button:<\/p>\n
![\"EclipseDebugConfig2\"](\"\/\/www.sevenwatt.com\/main\/wp-content\/uploads\/2015\/03\/EclipseDebugConfig2.png\")
<\/a><\/p>\nOn \u00a0the “Main” Tab enter:
\nC\/C++ Application:\u00a0C:\\workspace\\Blink\\build\\firmware.elf
\n<\/code>Select “Enable auto build”
\nLeave all other fields unchanged.<\/p>\nGo to the Tab “Debugger”:<\/p>\n
![\"EclipseDebugConfig3\"](\"\/\/www.sevenwatt.com\/main\/wp-content\/uploads\/2015\/03\/EclipseDebugConfig3.png\")
<\/a><\/p>\nEnter the following, and leave other fields unchanged:
\nGDB Command: arm-none-eabi-gdb<\/code>
\nPort Number: 3333<\/code><\/p>\nGo to the “Startup” Tab:<\/p>\n
![\"EclipseDebugConfig4\"](\"\/\/www.sevenwatt.com\/main\/wp-content\/uploads\/2015\/03\/EclipseDebugConfig4.png\")
<\/a><\/p>\nMake sure to scroll to the bottom of the entry form: Enter:
\nRun Commands: mon reset init<\/code><\/p>\nGo to the “Common” Tab<\/p>\n
![\"EclipseDebugConfig5\"](\"\/\/www.sevenwatt.com\/main\/wp-content\/uploads\/2015\/03\/EclipseDebugConfig5.png\")
<\/a><\/p>\nCheck “Debug” as display favorite, and press “Apply”, press “Close” to exit the editor. Eclipse is now prepared for debugging!<\/p>\n
Connect the target LPC8xx<\/h3>\n
Plugin the USB cable of the Nucleo STLinkV2-1 interface into the computer. How to connect the LPC8xx to the Nucleo boards SWD interface is described in\u00a0article\u00a0LPC810 SWD \/ JTAG with Nucleo STM32<\/em><\/a><\/p>\nDownload firmware and start flashing.<\/h3>\n
The following describes typical steps in a build\/download\/debug session. Build the project by pressing the hammer-tool (Build).<\/p>\n
Start the External Program “LPC810 – Nucleo”:<\/p>\n
![\"EclipseDebugRun1\"](\"\/\/www.sevenwatt.com\/main\/wp-content\/uploads\/2015\/03\/EclipseDebugRun1.png\")
<\/a>
\nWhen the HW (both Nucleo and LPC810) is connected correctly, the concole panel will report the STLink interface and the LPC810 target. When the last line reads Info: lpc810.cpu: hardware has 4 breakpoints, 2 watchpoints<\/code>, everything is OK.<\/p>\nWhen activating the External Program, two things may happen. Eclipse may suggest to switch to a debug perspective, and the Windows Firewall may ask for permision for OpenOCD using a port. Confirm (Yes\/Allow Access) these situations:<\/p>\n
![\"EclipseDebugRun2\"](\"\/\/www.sevenwatt.com\/main\/wp-content\/uploads\/2015\/03\/EclipseDebugRun21.png\")
<\/a><\/p>\n![\"EclipseOpenOCDFirewall\"](\"\/\/www.sevenwatt.com\/main\/wp-content\/uploads\/2015\/03\/EclipseOpenOCDFirewall.png\")
<\/a><\/p>\nThen download\/flash and run the application in Debug mode, through the toolbar:<\/p>\n
![\"EclipseDebugRun3\"](\"\/\/www.sevenwatt.com\/main\/wp-content\/uploads\/2015\/03\/EclipseDebugRun3.png\")
<\/a><\/p>\nSelect “Blink Default”. This rebuilds the project if needed, downloads it to the target LPC, and automatically breaks at the first instruction of the program:<\/p>\n
![\"EclipseDebugRun4\"](\"\/\/www.sevenwatt.com\/main\/wp-content\/uploads\/2015\/03\/EclipseDebugRun4.png\")
<\/a><\/p>\nBefore pressing the the run\/play button, for demonstration purposes set a breakpoint in the main program source code Blink.c, at the instruction that toggles the LED, line 46. To set the breakpoint double click the line number. Now press “Play”. After a moment, the program stops at the breakpoint:<\/p>\n
![\"EclipseDebugRun5\"](\"\/\/www.sevenwatt.com\/main\/wp-content\/uploads\/2015\/03\/EclipseDebugRun5.png\")
<\/a><\/p>\nIt can now be seen that the program is suspended, and that the loop counter is set to “1” in the Variables panel. Press “Play” again. The program breaks again, and the loop counter is now updated to “2”:<\/p>\n
\u00a0Install OpenOCD<\/h3>\n
OpenOCD is a server that connects to the target (the LPC8xx to be debugged or programmed) and that handles debugger commands. The current release is version 0.8.0. Download a executable (binary) version from Freddie Chopin’s site<\/a>.<\/p>\n In File explorer, create or go to the PicosARM root folder. When you followed this PicosARM guide, it is located in Note: Winzip may refuse to unpack. In this case download and use 7-zip to unzip<\/p><\/blockquote>\n OpenOCD requires some additional configuration for the specific hardware we are using as HW debugger (Nucleo STM32)\u00a0and Micrcontroller target (LPC8xx). OpenOCD 0.9.0 is providing more extensive support for the LPC8xx series. It requires a slightly different configuration then OpenOCD 0.8.0. Here we proceed with the OpenOCD 0.8.0 configuration, but 0.9.0 cfg files are also available for download.<\/p>\n Download the Nucleo\/LPC8xx\u00a0cfg files from the PicosARM github repository. For OpenOCD-0.8.0, this is the LPC8xx-Nucleo link<\/a>.<\/p>\n In the just installed OpenOCD, browse to the openocd\/scripts folder and unzip\u00a0the .cfg files to\u00a0this location.<\/p>\n Make sure that within the script folder an picosARM folder is created:<\/p>\n This step is specific for the exact JTAG\/SWD debugger that will be used. In this guide it is the STLink-V2-1 interface of a Nucleo STM32 board. It does not matter which of the Nucleo boards is used. All are equipped with the same STLink device. If you already have connected a Nucleo to your PC before, then you probably already performed this step.<\/p>\n Download the drivers form the ST-website<\/a>.<\/p>\n Unzip the downloaded file and run Now connect the Nucleo to your computer and see whether windows properly recognizes the Nucleo board.<\/p>\n Start Eclipse and go to the HelloLPC or Blink project. This guide uses a Blink project as example.\u00a0The second row of the screen is the toolbar. Just below the main menu. On this menu is the External Programs tool, which we can use to launch OpenOCD. To setup OpenOCD as External Program open the External Tool Configuration screen:<\/p>\n The editor is opened. Press the Create new button and fill the fileds in the main tab.<\/p>\n Set field Name to On the “Common” Tab, check the “Exteral Tools” as display favorite:<\/p>\n The External tool is configured now.<\/p>\n This example uses a LPC810. For other LPC8xx boards, just replace all LPC810 by the proper LPC number on the “Main” Tab, for example to \u00a0LPC824.<\/p><\/blockquote>\n Make sure the project is already build. The following step requires a firmware image to be available. Open the Debug Configuration Editor through the toolbar:<\/p>\n Select “Debug Configurations…”<\/p>\n On this screen Select “GDB Hardware Debugging” and press the “New” button:<\/p>\n On \u00a0the “Main” Tab enter: Go to the Tab “Debugger”:<\/p>\n Enter the following, and leave other fields unchanged: Go to the “Startup” Tab:<\/p>\n Make sure to scroll to the bottom of the entry form: Enter: Go to the “Common” Tab<\/p>\n Check “Debug” as display favorite, and press “Apply”, press “Close” to exit the editor. Eclipse is now prepared for debugging!<\/p>\n Plugin the USB cable of the Nucleo STLinkV2-1 interface into the computer. How to connect the LPC8xx to the Nucleo boards SWD interface is described in\u00a0article\u00a0LPC810 SWD \/ JTAG with Nucleo STM32<\/em><\/a><\/p>\n The following describes typical steps in a build\/download\/debug session. Build the project by pressing the hammer-tool (Build).<\/p>\n Start the External Program “LPC810 – Nucleo”:<\/p>\n When activating the External Program, two things may happen. Eclipse may suggest to switch to a debug perspective, and the Windows Firewall may ask for permision for OpenOCD using a port. Confirm (Yes\/Allow Access) these situations:<\/p>\n Then download\/flash and run the application in Debug mode, through the toolbar:<\/p>\n Select “Blink Default”. This rebuilds the project if needed, downloads it to the target LPC, and automatically breaks at the first instruction of the program:<\/p>\n Before pressing the the run\/play button, for demonstration purposes set a breakpoint in the main program source code Blink.c, at the instruction that toggles the LED, line 46. To set the breakpoint double click the line number. Now press “Play”. After a moment, the program stops at the breakpoint:<\/p>\n It can now be seen that the program is suspended, and that the loop counter is set to “1” in the Variables panel. Press “Play” again. The program breaks again, and the loop counter is now updated to “2”:<\/p>\n<\/a><\/p>\nC:\\PicosARM<\/code>. Unzip the openOCD download in the tools folder. A folder containing OpenOCD will be created in tools: C:\\PicosARM\\openOCD0.8.0<\/code>.<\/p>\n<\/a>To avoid some future maintenance, rename this folder to openOCD<\/code>, without the version number in it.<\/p>\n<\/a><\/p>\nConfigure OpenOCD<\/h3>\n
<\/a><\/p>\n<\/a><\/p>\nInstall STLink-V2-1 USB drivers<\/h3>\n
<\/a><\/p>\nstlink_winusb_install.bat<\/code> to install the USB drivers<\/p>\n<\/a><\/p>\nCreate Eclipse CDT External Tool<\/h3>\n
<\/a><\/p>\n<\/a><\/p>\nLPC810 - Nucleo<\/code>
\nSet field Location to C:\\PicosARM\\openocd\\bin\\openocd.exe<\/code>
\nSet filed Argumets to\u00a0-c \"telnet_port 4444\" -f \"picosARM\\lpc810-nucleo.cfg\"<\/code>
\nAll other settings can remain unchanged.<\/p>\n<\/a><\/p>\nCreate Debug configuration in Eclipse<\/h3>\n
<\/a><\/p>\n<\/a><\/p>\n<\/a><\/p>\n
\nC\/C++ Application:\u00a0C:\\workspace\\Blink\\build\\firmware.elf
\n<\/code>Select “Enable auto build”
\nLeave all other fields unchanged.<\/p>\n<\/a><\/p>\n
\nGDB Command: arm-none-eabi-gdb<\/code>
\nPort Number: 3333<\/code><\/p>\n<\/a><\/p>\n
\nRun Commands: mon reset init<\/code><\/p>\n<\/a><\/p>\nConnect the target LPC8xx<\/h3>\n
Download firmware and start flashing.<\/h3>\n
<\/a>
\nWhen the HW (both Nucleo and LPC810) is connected correctly, the concole panel will report the STLink interface and the LPC810 target. When the last line reads Info: lpc810.cpu: hardware has 4 breakpoints, 2 watchpoints<\/code>, everything is OK.<\/p>\n<\/a><\/p>\n<\/a><\/p>\n<\/a><\/p>\n<\/a><\/p>\n<\/a><\/p>\n
![\"EclipseDebugRun6\"](\"\/\/www.sevenwatt.com\/main\/wp-content\/uploads\/2015\/03\/EclipseDebugRun6.png\")
<\/a><\/p>\n![\"EclipseDebugRun7\"](\"\/\/www.sevenwatt.com\/main\/wp-content\/uploads\/2015\/03\/EclipseDebugRun7.png\")
<\/a><\/p>\n