{"id":4114,"date":"2011-12-12T18:20:21","date_gmt":"2011-12-12T23:20:21","guid":{"rendered":"http:\/\/embedded-lab.com\/blog\/?p=4114"},"modified":"2012-07-30T09:29:14","modified_gmt":"2012-07-30T13:29:14","slug":"setting-up-the-ccs-v4-build-and-debug-environment-for-ti-msp430-launchpad","status":"publish","type":"post","link":"https:\/\/embedded-lab.com\/blog\/setting-up-the-ccs-v4-build-and-debug-environment-for-ti-msp430-launchpad\/","title":{"rendered":"Setting up the CCS v4 build and debug environment for TI MSP430 Launchpad"},"content":{"rendered":"

Last year, Texas Instruments (TI) released industry’s lowest cost (only $4.30) microcontroller development kit named Launchpad<\/strong><\/a>. It is a complete development tool for rapid prototyping with TI’s ultra-low power MSP430 Value Line MCUs. I also bought a Launchpad kit several months ago but haven’t really looked into it. Last weekend, I spent a couple of hours reading about the MSP-EXP430G2\u00a0experimenter\u00a0board (that comes with the Launchpad kit) and the Code Composer Studio<\/a> (CCS) software tool. CCS is an integrated development environment (IDE) to develop and debug applications for TI’s embedded processor families.\u00a0As always, a “Hello World” program is the best thing to start with any new development platform. If you ran it successfully, it means you have setup the compiler and the programmer\/debugger correctly and you are all set to go. Here’s a step-by-step guide to set up the CCS v4 build and debug environment for the MSP-EXP430G2 experimenter\u00a0board.<\/p>\n

\"\"<\/a>

TI's MSP430 Launchpad board<\/p><\/div>\n

A brief introduction to MSP430 Launchpad<\/strong><\/p>\n

Launchpad is a low cost development solution to get started with TI’s MSP430 Value Line devices. The Launchpad kit includes a MSP430G2 experimenter board, two MSP430G2xx flash microcontrollers (MSP430G2231 and\u00a0MSP430G2211), a mini USB cable, four 10-pin headers (two male and two female), and a 32.768 KHz external crystal. The total cost of the kit is only $4.30<\/strong>. The experimenter board has an integrated DIP target socket that supports up to 20 pin devices. All of the pins are broken out to the header ports on either side of the board for easy access. The on-board flash emulation tool allows direct interface to a PC through an USB port for easy programming and debugging. The same interface can also be used by the MSP430G2xx device on the board to communicate with the host PC through a 9600 baud UART serial connection (virtual COM port).<\/p>\n

There are two LEDs (red and green) on the board that are connected to P1.0 and P1.6 I\/O pins. Similarly, two push buttons for user input and device reset are also available on the board.<\/p>\n

There are different development tools available to write, download, and debug applications for the MSP-EXP430G2 development\u00a0board. Code Composer Studio (CCS) is one of them and is also available in a free limited version that allows 16 KB of C-code compilation. This is just enough for experimenting with MSP-EXP430G2 board.<\/p>\n

\"\"<\/a>

MSP430 Launchpad<\/p><\/div>\n

Installation of Code Composer Studio v4<\/strong><\/p>\n

Code Composer Studio\u2122 (CCS) is an integrated development environment (IDE) for developing and debugging embedded applications for TI’s various processor families. \u00a0It includes compilers for each of TI’s device families, source code editor, project build environment, debugger, profiler, simulators and many other features. There are many versions of CCS IDE, but I will be talking about CCS v4, which is a recommended version for MSP430 users. So first you need to go to the CCS download wiki by clicking the following link.<\/p>\n

http:\/\/processors.wiki.ti.com\/index.php\/Download_CCS<\/a><\/p>\n

Then scroll down a little bit and click on the download button, “Download latest production CCSv4 MSP430\/C28x code size limited image<\/strong>“, as shown below.<\/p>\n

\"\"<\/a>

Download the FREE Code Size Limited Tools for MSP430 and C28x<\/p><\/div>\n

You will be directed to my.TI Account page where you need to log in. If you don’t have a TI account you can create one for free. The link to the installation zip file will be then sent to your email. Click on the link and download the zip file. Unzip it and double click on the file named setup_CCS_MC_Core_x.x.x.x.exe<\/em><\/strong>. Follow the installation instructions and select MSP430-only Core Tools<\/em><\/strong> option in the Product Configuration<\/em><\/strong> dialogue window and click Next<\/em><\/strong>. Use the default settings in the \u00a0Select Components<\/em><\/strong> dialog and click Next<\/em><\/strong>. Then click Next<\/em><\/strong> again in the Start Copying Files<\/em><\/strong> dialogue and wait till the installation completes.<\/p>\n

Note:<\/strong><\/span><\/em>\u00a0By default, Microsoft Windows Vista and Windows 7 do not allow user level accounts to write files in the\u00a0Program Files<\/strong> directory. This can prevent CCS from starting when installed in the Program Files<\/strong> or Program Files (x86)<\/strong> directory, because CCS stores configuration data by default in its install directory. So it is recommended to install CCS outside the Program Files or Program Files (x86)<\/strong> directory.<\/em><\/p>\n

Writing a “Hello World” program<\/strong><\/p>\n

The Launchpad experimenter board includes a pre-programmed MSP430G2231 device which is already placed in the target DIP socket. When the board is powered through a USB cable, the preloaded demo program starts and the on-board red and green LEDs toggle in sequence. This is the\u00a0quickest way of verifying that the Launchpad board is working. But this is not our “Hello World”<\/strong> program. We will first explore the basic features of CCS and see how to create a new project, build the code, and eventually load the program into the flash memory of the MSP430 device on board. Our test program will make the MSP430G2231 device to continuously flash the on-board red LED connected to P1.0 pin.<\/p>\n

Step 1:<\/em><\/strong>\u00a0Start CCS by double clicking the icon on the desktop or selecting it from the Windows Start menu. When CCS loads, the first thing it asks is to define a workspace – a directory that holds all elements (projects, links to projects, possibly source code) used in the development. Browse the directory path where you want it to be and do NOT check the\u00a0Use this as the default and do not ask again<\/strong><\/em> checkbox. Click OK<\/em><\/strong>.<\/p>\n

\"\"<\/a>

Select Workspace folder<\/p><\/div>\n

Step 2:<\/strong><\/em> If this is the\u00a0first time you have opened CCS then a\u00a0Welcome to Code Composer Studio v4<\/strong><\/em> page appears.<\/p>\n

\"\"<\/a>

CCS Welcome screen<\/p><\/div>\n

Close the page by clicking the X<\/strong><\/em> on the Welcome<\/strong> tab. You should now see an empty CCS workbench with a C\/C++ icon in the upper right hand corner. This is called\u00a0the C\/C++ Perspective<\/strong> and is used to create or build C\/C++ projects. When you will be the debugging mode, it will automatically switch to the Debug Perspective<\/strong><\/em>. The layout views of the workbench windows,\u00a0tool-bars, and menus are different for code development and debugging. Therefore, the use of separate perspectives minimizes clutter to the user interface.<\/p>\n

\"\"<\/a>

Empty CCS workbench in C\/C++ Perspective<\/p><\/div>\n

Step 3:<\/em><\/strong> Next step is to create a new project.\u00a0A project contains all the files you will need to develop an executable output file (.out) which can be run on the MSP430 hardware. To create a new project click:\u00a0File -> New -> CCS Project<\/em><\/strong><\/p>\n

In the Project name field type FlashLED<\/em><\/strong>. It will create a new directory called FlashLED<\/em><\/strong> inside the Workspace<\/em><\/strong> folder (if Use default location is checked), where all the project files will be stored. Click Next<\/em><\/strong>.<\/p>\n

\"\"<\/a>

Creating a new CCS project<\/p><\/div>\n

Step 4:<\/em><\/strong>\u00a0The next window that appears selects the platform and configurations. The Project Type<\/em><\/strong> should be set to MSP430<\/strong><\/em> and the\u00a0Debug<\/strong><\/em> and\u00a0Release<\/strong><\/em> boxes should be checked in the Configurations<\/em><\/strong> box. Click Next.<\/strong><\/em><\/p>\n

\"\"<\/a>

Project type is MSP430<\/p><\/div>\n

Step 5:<\/em><\/strong>\u00a0The next window is to define inter-project dependencies (if any). There are none now. So select Next<\/em><\/strong>.<\/p>\n

\"\"<\/a>

No inter-project dependencies for now<\/p><\/div>\n

Step 6:<\/em><\/strong> The next step is to select the CCS project settings. Select the Device Variant<\/strong><\/em> using the pull-down list and choose MSP430G2231<\/em><\/strong> (target device on the Launchpad experimenter board). This will select the appropriate linker command file, runtime support library, set the basic build options for the linker and compiler, and set up the target configuration.<\/p>\n

\"\"<\/a>

Select MSP430G2231 for Device Variant<\/p><\/div>\n

Click Finish<\/em><\/strong> and a new project is created. You will now see\u00a0the C\/C++ Projects<\/em><\/strong> window contains FlashLED<\/strong><\/em> project which is set active.<\/p>\n

\"\"<\/a>

New project FlashLED added to the C\/C++ Projects window<\/p><\/div>\n

Step 7:<\/em><\/strong> At this point, the project does not include any source files. The next step is to add the source files to the project.\u00a0To add a source file to the project, right-click on FlashLED<\/strong><\/em> in the C\/C++ Projects<\/strong><\/em> window and select:\u00a0New -> Source File<\/em><\/strong>.\u00a0Name the source file main.c<\/em><\/strong> and click Finish<\/em><\/strong>.<\/p>\n

\"\"<\/a>

Add a new source file main.c<\/p><\/div>\n

Then\u00a0an empty window will open for the main.c<\/em><\/strong> code.<\/p>\n

\"\"<\/a>

Empty window for main.c<\/p><\/div>\n

Step 8:<\/em><\/strong>\u00a0Next, we will add code to main.c<\/em><\/strong>. Type in or copy and paste the following code into the main.c<\/em><\/strong> window. This code is for flashing the red LED connected to P1.0.<\/p>\n

#include <msp430g2231.h>\r\nvolatile unsigned int i;\r\nvoid main(void)\r\n{\r\n\tWDTCTL = WDTPW + WDTHOLD; \t\/\/ Stop watchdog timer\r\n\tP1DIR = 0x01; \t\t\t\/\/ P1.0 is output\r\n\tP1OUT = 0x00; \t\t\t\/\/ LED off\r\n\twhile(1)\r\n\t{\r\n\t\tP1OUT = ~P1OUT; \t\/\/ Complement output\r\n\t\t_delay_cycles(500000);  \/\/ Delay 50K clock cycles\r\n\t}\r\n}<\/pre>\n
The comments in the code pretty much explains each line of the code. The delay statement is a built-in intrinsic function for generating delays. The only parameter needed is the number of clock cycles for the delay. The while(1)<\/em><\/strong> loop repeats the next two lines for ever. After you finish typing the above code into main.c<\/em><\/strong> window, save your work.<\/p>\n
\"\"<\/a>
Save the main.c file after typing up the code<\/p><\/div>\n
Step 9:<\/em><\/strong> Next click the Build<\/strong><\/em> button or select Project-> Build Active Project<\/em><\/strong> and watch the tools run in the Console<\/em><\/strong> window. Check for any errors in the Problems<\/em><\/strong> window.<\/p>\n
\"\"<\/a>
Build and Debug buttons in the toolbar<\/p><\/div>\n
\"\"<\/a>
Console and Problems windows<\/p><\/div>\n
Step 10:<\/em><\/strong> If the build is successful, you are ready to load the program into the target MSP430 device. Make sure that the Launchpad board is connected to the PC. Then\u00a0click the Debug<\/em><\/strong> button (green bug). The Debug Perspective<\/strong><\/em> view should open, the program is loaded into the MSP430 device automatically, and you should now be at the start of main()<\/em><\/strong>.<\/p>\n
\"\"<\/a>
Debug Perspective<\/p><\/div>\n
In debug mode, you can run the application in either a single step mode using Step Into<\/em><\/strong> and Step Over<\/em><\/strong> function buttons or a free run mode by clicking on the Run<\/em><\/strong> button (see the picture below).<\/p>\n
\"\"<\/a>
Debugging menu<\/p><\/div>\n
If you click on the Run<\/strong> button, the MSP430G2231 processor starts executing the program and the LED on board should blink continuously.<\/p>\n
Step 11:<\/em><\/strong> At last, terminate the active debug session using the Terminate All<\/em><\/strong> button. This will close the debugger and return CCS to the C\/C++ Perspective<\/strong><\/em> view. CCS will remove the breakpoints and release the MSP430G2231 processor in the board so that it could execute freely the program without the need of the debugger.<\/p>\n
\"\"<\/a>
Blinking LED at P1.2<\/p><\/div>\n
Note:<\/span> <\/strong>The\u00a0_delay_cycles(500000);\u00a0<\/em><\/strong>statement in the code creates a delay interval of 500000 clock cycles. If you want to convert it into time, you need to know the time period or frequency of the clock. MSP430 devices have multiple sources of clock including internally generated clocks (known as internal digitally controlled oscillator, DCO) and external source (using crystal). On power on reset, the default clock source comes from the internal DCO module. The default value of this clock is around 1.0 MHz (the internal oscillator is not very accurate). So, the \u00a0_delay_cycles(500000);<\/em><\/strong>\u00a0statement should create a delay of approximately 0.5 sec interval.<\/p>\n
References<\/strong><\/p>\n
Various documents and links available at “Getting Started with the MSP430 LaunchPad Workshop”<\/a><\/strong>.<\/p>\n","protected":false},"excerpt":{"rendered":"
Last year, Texas Instruments (TI) released industry’s lowest cost (only $4.30) microcontroller development kit named Launchpad. It is a complete development tool for rapid prototyping with TI’s ultra-low power MSP430 Value Line MCUs. I also bought a Launchpad kit several months ago but haven’t really looked into it. Last weekend, I spent a couple of hours reading about the MSP-EXP430G2\u00a0experimenter\u00a0board (that comes with the Launchpad kit) and the Code Composer Studio (CCS) software tool. CCS is an integrated development environment (IDE) to develop and debug applications for TI’s embedded processor families.\u00a0As always, a “Hello World” program is the best thing<\/p>\n","protected":false},"author":1,"featured_media":4119,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"footnotes":""},"categories":[379,348,183],"tags":[386,384,385,383],"class_list":["post-4114","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-msp430-launchpad","category-product-review","category-tips-and-tricks","tag-ccs-v4","tag-launchpad-kit","tag-msp430g2231","tag-ti-msp430"],"_links":{"self":[{"href":"https:\/\/embedded-lab.com\/blog\/wp-json\/wp\/v2\/posts\/4114","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/embedded-lab.com\/blog\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/embedded-lab.com\/blog\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/embedded-lab.com\/blog\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/embedded-lab.com\/blog\/wp-json\/wp\/v2\/comments?post=4114"}],"version-history":[{"count":29,"href":"https:\/\/embedded-lab.com\/blog\/wp-json\/wp\/v2\/posts\/4114\/revisions"}],"predecessor-version":[{"id":4205,"href":"https:\/\/embedded-lab.com\/blog\/wp-json\/wp\/v2\/posts\/4114\/revisions\/4205"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/embedded-lab.com\/blog\/wp-json\/wp\/v2\/media\/4119"}],"wp:attachment":[{"href":"https:\/\/embedded-lab.com\/blog\/wp-json\/wp\/v2\/media?parent=4114"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/embedded-lab.com\/blog\/wp-json\/wp\/v2\/categories?post=4114"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/embedded-lab.com\/blog\/wp-json\/wp\/v2\/tags?post=4114"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}