SPMU356 - Texas Instruments
Contents
1. Lee ek tm4cl23gxl udma_demo ek tm4cl 3gxl usb_dev_bulk ks ek tm4cl23qxl usb_dev_serial inc z gt My_proypect third_party E usblib utils File name main c Use template Default C source template Figure 11 The project should look similar to Figure 12 gt W inc 4 E my _project 4 Includes gt Program Files odeSourcery Sourcery_CodeBench_for_Stellaris_ arm stellaris eabi include C Program Files x86 CodeS ry S ry_CodeBench_for_Stellaris_EABI llaris eabi includ A C Program Files x86 CodeSourcery Sourcery_CodeBench_for_Stellaris_EABI lib gcc arm stellaris eabi 4 5 2 include p 8 C Program Files x86 CodeSourcery Sourcery_CodeBench_for_Stellaris_EABI lib gcc arm stellaris eabi 4 5 2 include fixed c main c Figure 12 14 Tiva C Series Development and Evaluation Kits for Sourcery CodeBench SPMU356 July 2013 Development Tools Submit Documentation Feedback Copyright 2013 Texas Instruments Incorporated la TEXAS INSTRUMENTS www ti com Add Include Paths Libraries and Output In the main c file add a simple main function 5 Add Include Paths Libraries and Output The tool has many options but the basic set up must include the hooks to TivaWare primarily the Driver Library driverlib To get to the project options dialog right click the project and select Properties Expand the C C Build menu and select the Settings item see Figure 13 First2. C C General g5 Preprocessor 4 cuonlbsnace locia Project References Symbols Uworkspace loc S ProiName Run Debug Settings 53 Includes Task Repository ce Optimization WikiText 2 Debugging 2 Warnings g Miscellaneous a 3 Sourcery CodeBench Assembler ce General ce Miscellaneous a 3 Sourcery CodeBench Linker Ge General Libraries Miscellaneous Shared Library Settings a 3 Sourcery CodeBench Objcopy ee General Include files inchide Restore Defaults Apply Figure 15 Next add a pointer to the TivaWare Driver Library Select the Libraries item under Sourcery CodeBench C Linker Add a new item by clicking the little icon with the green In the Libraries field type the name of the Driver Library to match the project that was included in the previous step For this example the Driver Library project was named driverlib so type driver in the Libraries field see Figure 16 SPMU356 July 2013 Tiva C Series Development and Evaluation Kits for Sourcery CodeBench 17 Submit Documentation Feedback Development Tools Copyright 2013 Texas Instruments Incorporated I TEXAS INSTRUMENTS Add Include Paths Libraries and Output www ti com Enter Value 2s Libraries I driver Figure 16 In the Library search path point the tool to the driverlib Release directory as done for the C include paths see Figure 17 G Properties for my_project type filter text Settings
3. Resource ij Builders C C Build Configuration Build Variables Discovery Options Environment E Tool Settings Build Steps Build Artifact Binary Parsers C3 Error Parsers Legging l Settings Target Libraries t TEELEN Tool Chain Editor B3 Sourcery CodeBench C Compiler C C General amp Preprocessor Project References Symbols Run Debug Settings Includes Task Repository 22 Optimization WikiT ext 22 Debugging 2 Warnings Miscellaneous 3 Sourcery CodeBench Assembler ce General amp Miscellaneous Ha Sourcery CodeBench C Linker ce General 23 Libraries Miscellaneous Shared Library Settings eit i E amp 3 Sourcery CodeBench Objcopy Siworkspace loc driverlib Release es General Library search path L spe Figure 17 18 Tiva C Series Development and Evaluation Kits for Sourcery CodeBench SPMU356 July 2013 Development Tools Submit Documentation Feedback Copyright 2013 Texas Instruments Incorporated ld TEXAS INSTRUMENTS www ti com Add a Debug Configuration Tell the tool how to format the output executable The default configuration generates an output file in ELF format without an extension To change it to an AXF file go to the Build Artifact tab and type axf in the Artifact extension box see Figure 18 type filter text Settings a pees Resource Builders C C Build Configuration Debug Active Build Variables D
4. Sourcery CodeBench www ti com 2 2 2 3 Flash and Debug an Example Application After the IDE builds the imported examples download the examples to the target board for debugging 1 Point to the example application you wish to download and right click to show a context menu see Figure 5 From this menu select Debug As then select C C Application from the menu that appears The application is downloaded to the board and is ready for debugging C C Sourcery CodeBench ID Bla File Edit Source Refactor Navigate Search Project Run Window Help r OS ty a a Sr A Br v OrQvr orr g yl v oi v v v FS o gt ta j lo LC Project Explorer i ajo x Om ET O BS e Y p 7 gt E driverlib An outline is not available gt tS ek tm4c123gxl bitband gt tS ek tm4c123gxl blinky gt CES ek tm4c123gxl freertos_demo gt LES ek tm4c123gxl gpio_jtag gt ke ek tm4c123gxl he z gt E ek tm4c123gxl ir New p gt tS ek tm4c123gxl m Go Into gt ES ek tm4c123gxl p Open in New Window gt LES ek tm4c123gxl q gt LS ek tm4c123gkxl ti E Copy ace gt LS ek tm4c123gxl u so rg gt tS ek tm4c123gxl u s gt ES ek tm4c123gxl u Delete Delete gt ES ek tm4c123gxl u Remove from Context Ctrl Alt Shift Down b I inc Move gt EZ third_party panne S gt 5 usblib gt TS utils ey Import e Export Build Project Clean Project amp Ref
5. a gdbinit file and placing it in your HOME directory To find the location of the HOME directory type echo HOME in a shell window For Windows users the directory is at C Documents and Settings lt user name gt by default An example of a command to include in your gdbinit file is connect This command replaces the complex command string described in Section 2 2 1 2 item 3 For example after starting GDB typing connect has the same effect as typing target extended remote arm stellaris eabi sprite s 2 f Imi dll stdio Build Using the Integrated Development Environment Perform the steps in the following subsections to use the IDE To use the command line interface see Building using the command line 2 2 2 1 Start the Sourcery CodeBench IDE To start the IDE use the shortcut found under Start All Programs CodeSourcery Sourcery CodeBench for Stellaris EABI Sourcery CodeBench IDE to open a dialog box see Figure 2 Enter the path where Sourcery CodeBench will store the source files of the project Tiva C Series Development and Evaluation Kits for Sourcery CodeBench SPMU356 July 2013 Development Tools Submit Documentation Feedback Copyright 2013 Texas Instruments Incorporated la TEXAS INSTRUMENTS www ti com Sourcery CodeBench Select a workspace Sourcery CodeBench IDE stores your projects in a folder called a workspace Choose a workspace folder to use for this session Workspace C Users lt user
6. gt sgxw file and click Open see Figure 4 The following example assumes that you are importing the ek tm4c123gxl examples but the same procedure applies to all TivaWare releases 6 Tiva C Series Development and Evaluation Kits for Sourcery CodeBench SPMU356 July 2013 Development Tools Submit Documentation Feedback Copyright 2013 Texas Instruments Incorporated la TEXAS INSTRUMENTS www ti com Sourcery CodeBench v v 0j0 x m Et oO Sele act File zx examples boards ek tm4c123gxl gt v Search ek tm4c123gxl p Organize v New folder HEJ v slale Select Pr Ft Favorites i bitband blinky E Desktop d drivers freertos_demo Downloads bs gpio_jtag hello S Recent Places Ji interrupts J mpu_fault J project0 d qs rgb v Libraries J settings timers C Documents J uart_echo Ji udma_demo a Music _ usb_dev_bulk E usb_dev_serial Pictures lie ek tm4c123gxl sgxw S Subversion F Videos j Computer amp OSDisk C ti Network File name Figure 4 Press the Finish button to start importing the project files into the workspace When the files are imported the IDE builds each library and example application SPMU356 July 2013 Tiva C Series Development and Evaluation Kits for Sourcery CodeBench 7 Submit Documentation Feedback Development Tools Copyright 2013 Texas Instruments Incorporated I TEXAS INSTRUMENTS
7. ti com Add Source Files sourcery G Configuration Specify the desired Sourcery G project properties below Board Stellaris ERC LM4F2s2 Profile RAM Hosting Hosted a Pracescot Stellaris LM4F232H50D 4 Figure 10 The created project will be empty so you must complete some additional steps including the following 1 Add source files 2 Set up include paths 3 Set up the debug interface 4 Add Source Files For a basic project you ll need to create a main function In this example create a main file using the Sourcery CodeBench templates To create the main file right click on the project and select New File From Template In the dialog box that appears type main c in the File Name field and then click the Finish button see Figure 11 Ensure the correct project is selected in the project browser otherwise the file will not be added to your project Notice that the file is added to my_project SPMU356 July 2013 Tiva C Series Development and Evaluation Kits for Sourcery CodeBench 13 Submit Documentation Feedback Development Tools Copyright 2013 Texas Instruments Incorporated I TEXAS INSTRUMENTS Add Source Files www ti com Create a new file resource from a template Enter or select the parent folder my_project BP ith Lo ek tr4cl 23gxl propecti ek tm4cl2sgxl qs rgb ES ek tm4cl23qxl timers ek tm4c123gxl uart_echo
8. with the Tiva device on the board For this example lt target gt is replaced with ek tm4c123gxl Find the full list of supported target strings in the Sourcery CodeBench installation directory at CodeSourcery share doc sourceryg arm stellaris eabi htmi getting started sec sprite supported boards html Press Enter and you should see the following gdb target extended remote arm stellaris eabi sprite armisb specd 2 tm4cl23qx1 Remote debugging using arm stellaris eabi sprite armusb speed 2 tm4cl123gxl 4 Type load to download hello axf to the flash and press Enter The following should appear gdb load Loading section text size Oxxxx lma 0x0 Loading section data size Oxxxx lma Oxxxxx Start address Oxxxx load size xXxXxx Transfer rate xxxx KB sec xxx bytes write 5 Type continue to restart the application The words Hello World should appear on the PC via the UART or to the display once execution of the application starts gdb continue Continuing If you encounter difficulties when working with the Sourcery CodeBench command line debugger find further documentation in the Sourcery CodeBench installation directory at CodeSourcery share doc sourceryg arm stellaris eabi Section 5 3 and Chapter 7 of Sourcery CodeBench s Getting Started Guide contains more information on running applications through GDB 2 2 1 3 Simplify GDB Commands 2 2 2 Simplify commands sent to the GDB by defining custom commands in
9. ID OMAP Applications Processors Wireless Connectivity www ti com audio amplifier ti com dataconverter ti com www dip com www ti com clocks interface ti com logic ti com power ti com microcontroller ti com www ti rfid com www ti com omap Applications Automotive and Transportation Communications and Telecom Computers and Peripherals Consumer Electronics Energy and Lighting Industrial Medical Security Space Avionics and Defense Video and Imaging TI E2E Community www ti com wirelessconnectivity www ti com automotive www ti com communications www ti com computers www ti com consumer apps www ti com energy www ti com industrial www ti com medical www ti com security www ti com space avionics defense www ti com video Mailing Address Texas Instruments Post Office Box 655303 Dallas Texas 75265 Copyright 2013 Texas Instruments Incorporated
10. a lists the commands available for doing data operations Tiva C Series Development and Evaluation Kits for Sourcery CodeBench Development Tools SPMU356 July 2013 Submit Documentation Feedback Copyright 2013 Texas Instruments Incorporated ld TEXAS INSTRUMENTS www ti com References 8 References The following references are included on the Tiva C Series Development Kit Software USB flash drive and are also available for download at htip www ti com tiva c e Tiva C Series Evaluation kit User s Manual e TivaWare for C Series Software Order Number SW TMA4C http Awww ti com tool sw tm4c e TivaWare Peripheral Driver Library User s Guide Document Number SW DRL UG literature SPMU298 In addition the following website may be useful e Mentor Graphics Sourcery Code Bench website at http www mentor com embedded software sourcery tools SPMU356 July 2013 Tiva C Series Development and Evaluation Kits for Sourcery CodeBench 21 Submit Documentation Feedback Development Tools Copyright 2013 Texas Instruments Incorporated IMPORTANT NOTICE Texas Instruments Incorporated and its subsidiaries TI reserve the right to make corrections enhancements improvements and other changes to its semiconductor products and services per JESD46 latest issue and to discontinue any product or service per JESD48 latest issue Buyers should obtain the latest relevant information before placing orders and should
11. add the appropriate include paths In the Tool Settings tab click on the Includes item located inside the Sourcery CodeBench C Compiler section To the right there is a box that says Include paths To add a new path click the small icon with the green Properties for my project type filter text Settings b Resource qa Builders a C C Build Configuration Debug Active Build Variables Discovery Options Manage Configurations Environment Tool Settings 8 Build Steps Build Artifact lu Binary Parsers Error Parsers Logging Settings Target Include paths I Tool Chain Editor E3 Sourcery CodeBench C Compiler t C C General g2 Preprocessor Project References Symbols Run Debug Settings 82 Includes Task Repository 22 Optimization WikiT ext G2 Debugging g Warnings 8 Miscellaneous E Sourcery CodeBench Assembler 2 General Miscellaneous H Sourcery CodeBench C Linker fe General g Libraries 2 Miscellaneous 88 Shared Library Settings 3 Sourcery CodeBench Objcopy ce General Include files include Restore Defaults Apply Cancel Figure 13 A window appears allowing you to browse for the new path see Figure 14 Click the Workspace button to browse through your existing workspace When the workspace browser appears expand the driverlib project and select the Release folder SPMU356 July 2013 Tiva C Series Development
12. ainst any damages arising out of the use of any Tl components in safety critical applications In some cases Tl components may be promoted specifically to facilitate safety related applications With such components Tl s goal is to help enable customers to design and create their own end product solutions that meet applicable functional safety standards and requirements Nonetheless such components are subject to these terms No Tl components are authorized for use in FDA Class III or similar life critical medical equipment unless authorized officers of the parties have executed a special agreement specifically governing such use Only those Tl components which TI has specifically designated as military grade or enhanced plastic are designed and intended for use in military aerospace applications or environments Buyer acknowledges and agrees that any military or aerospace use of Tl components which have not been so designated is solely at the Buyer s risk and that Buyer is solely responsible for compliance with all legal and regulatory requirements in connection with such use Tl has specifically designated certain components as meeting ISO TS16949 requirements mainly for automotive use In any case of use of non designated products TI will not be responsible for any failure to meet ISO TS16949 Products Audio Amplifiers Data Converters DLP Products DSP Clocks and Timers Interface Logic Power Mgmt Microcontrollers RF
13. and Evaluation Kits for Sourcery CodeBench 15 Submit Documentation Feedback Development Tools Copyright 2013 Texas Instruments Incorporated Add Include Paths Libraries and Output Select one or more Workspace Folders 4 ic gt g gt 6 fy E gt EE driverlib ek tr4cl23gxl Blinky ek tr4cl 3gxl freertos_demo ek tm4cl23gxl gpio_jtag ek tm4cl23gxl hello ek tm4cl23qgxl interrupts ek tr4 cl23gxl mpu_fault ek tr4cl23gxl project ek tr4cl 3gxl qs rgb ek tm4cl23qxl timers ek tr4cl23gxl uartecho ek tm4cl23gxl udma_demeo ek tm4cl 3qxl usb_dev_bulk Figure 14 Cancel l TEXAS INSTRUMENTS www ti com Repeat this process three more times adding the inc project the utils project and your working project in this case my_project to the include paths see Figure 15 16 Tiva C Series Development and Evaluation Kits for Sourcery CodeBench Development Tools SPMU356 July 2013 Submit Documentation Feedback Copyright 2013 Texas Instruments Incorporated la TEXAS INSTRUMENTS www ti com Add Include Paths Libraries and Output G Pr perties docs yt ore jec E type filter text Settings Resource Builders C C Build Configuration Build Variables Discovery Options Environment 2 Tool Settings lar Binary Parsers Error Parsers Legging Rp Settings 3 Target Include paths I Ponana lg B oe COREE SS EERE Sfworkspace_loc driverlib Release
14. atents or other intellectual property of the third party or a license from TI under the patents or other intellectual property of TI Reproduction of significant portions of TI information in TI data books or data sheets is permissible only if reproduction is without alteration and is accompanied by all associated warranties conditions limitations and notices TI is not responsible or liable for such altered documentation Information of third parties may be subject to additional restrictions Resale of TI components or services with statements different from or beyond the parameters stated by TI for that component or service voids all express and any implied warranties for the associated Tl component or service and is an unfair and deceptive business practice Tl is not responsible or liable for any such statements Buyer acknowledges and agrees that it is solely responsible for compliance with all legal regulatory and safety related requirements concerning its products and any use of Tl components in its applications notwithstanding any applications related information or support that may be provided by TI Buyer represents and agrees that it has all the necessary expertise to create and implement safeguards which anticipate dangerous consequences of failures monitor failures and their consequences lessen the likelinood of failures that might cause harm and take appropriate remedial actions Buyer will fully indemnify Tl and its representatives ag
15. ed 2 Tiva C Series Development and Evaluation Kits for Sourcery CodeBench SPMU356 July 2013 Development Tools Submit Documentation Feedback Copyright 2013 Texas Instruments Incorporated la TEXAS INSTRUMENTS www ti com Sourcery CodeBench If you encounter any difficulties during the Sourcery CodeBench installation procedure or would like to learn more about the Sourcery CodeBench IDE further documentation on the subject can be found in the CodeSourcery installation directory at CodeSourcery Sourcery_CodeBench_for_Stellaris EABI share doc sourceryg arm stellaris eabi Chapter two of CodeSourcery s getting started guide goes into further detail concerning the installation and configuration process 2 1 2 Install the TivaWare Package A full set of C based peripheral drivers is provided covering all peripherals and functions of the Tiva devices The TivaWare package includes various example applications with project files for all major tool vendors that support Tiva C Series including CodeSourcery To install TivaWare follow these steps 1 On the html index of the Development Kit Software USB flash drive click on the Firmware Development Package Depending on your web browser you have the option to run the TivaWare installer or save it to your drive NOTE If navigating the USB flash drive with Windows Explorer or a similar application navigate to the TivaWare directory 2 Run the TivaWare installer To manua
16. ended Breakpoint main at c users a0272201 workspace ek tm4c123gxl hello examp pi gdb p hello axf Name Type Value p co 5 Outline 3 is 1 RW o AERARII IT ARN EN aN OTITIS z T Gs Rae seine void stdbool h J inc hw_memmap h 2 inc hw_types h SJ driverlib debug h i ZJ driverlib fpu h Enable lazy I i This allows fi in in h instructions to be used within interrupt R but at the expense of QI driverlib pin_map h extra stack usage uJ driverlib rom h Ri driverlib sysctl h ROM FPULazyStackingEnable driverlib uart h utils uartstdio h fvolatile uint32 t ui32Loop driverlib gpio h fi _error_ char uint32_t void Set the clocking to run directly from the crystal ConfigureUART void void id main void int 1A aac fai Problems Cr Executables 6 Memory am Se Ek x b AE oe ki tm4c123gxl hello Sourcery CodeBench Debug hello axf Figure 6 3 Use the icons on the top edge of the debug pane the top left of the window in this example to start and stop program execution When execution completes or you terminate the debug session using the stop icon the red square you can switch back to the editor perspective by selecting Window Open Perspective C C__ from the IDE menu 3 Create a New Project When you have completed the TivaWare example applications you may want to create your own projec
17. id gt workspace Use this as the default and do not ask again Figure 2 If you check the Use this as the default and do not ask again checkbox this workspace opens each time you start the IDE Click OK to proceed If the License Installation screen appears obtain a license for the toolchain by following the instructions given in Section 2 1 1 2 2 2 2 Import the TivaWare or TivaWare Release for Your Board 1 Select File Import from the Sourcery CodeBench IDE menu 2 Highlight StellarisWare or TivaWare Project in the Import dialog See Figure 3 SPMU356 July 2013 Tiva C Series Development and Evaluation Kits for Sourcery CodeBench Development Tools Submit Documentation Feedback Copyright 2013 Texas Instruments Incorporated I TEXAS INSTRUMENTS Sourcery CodeBench www ti com select Import Stellaris Ware Project Select an import source type filter text gt amp General b E C C b amp CVS gt amp Remote Systems gt amp Run Debug 4 amp Sourcery CodeBench C C Executable Kinetis Project Sourcery CodeBench Example Project G StellarisWare Project b E Tasks gt gt Team Finish Figure 3 3 Click Next and browse to the directory containing the TivaWare release for the board If TivaWare is installed in the default directory this directory appears under C ti TivaWare_C_Series n n examples boards lt board name gt 4 Select the lt board
18. iscovery Options Manage Configurations Environment B Tool Settings amp Build Steps Build Artifact ii Binary Parsers Error Parsers Logging Settings Artifact Type Executable Tool Chain Editor CCF General Artifact name 5 ProjNarme a Project References Artifact extension Eoi Run Debug Settings Task Repository Output prefix WikiText Figure 18 Now you can build your project 6 Add a Debug Configuration Before debugging the application create a debug configuration 1 Right click the project and select Debug As Debug Configurations see Figure 19 Show in Remote Systems view Convert To Run s Debug As H ic I Local C C Application eich Debug Configurations Team H Figure 19 2 In the dialog box that appears double click on the Sourcery CodeBench Debug item and the tool creates a new debug configuration called my_project Debug see Figure 20 SPMU356 July 2013 Tiva C Series Development and Evaluation Kits for Sourcery CodeBench 19 Submit Documentation Feedback Development Tools Copyright 2013 Texas Instruments Incorporated Conclusion l Create manage and run configurations TEXAS INSTRUMENTS www ti com type filter text Application Attach to Application Postmortem Debugger inch Group ircery CodeBench Debug ek tm4cl23gxl birtband ek tr4cl23gul blinky ek tm4cl23g
19. isting Code Figure 8 3 The tool prompts you with a dialog box that asks for the desired project type see Figure 9 For this example focus on the executable project types In the Executable menu select Empty Project and name it SPMU356 July 2013 Tiva C Series Development and Evaluation Kits for Sourcery CodeBench 11 Submit Documentation Feedback Development Tools Copyright 2013 Texas Instruments Incorporated I TEXAS INSTRUMENTS Create a New Project www ti com C Project Create C project of selected type Project name my project m Use default location Location C Users ah2 72701 workspace my_proyect Browse Choose tle astern detautt Project type Toolchains Executable Sourcery CodeBench for Stellaris EABI Empty Project Factorial C Project Shared Library Static Library gt Makefile project Show propect types and toolchains only if they are supported on the platform Finish Figure 9 4 Click the Next button 5 The Sourcery G Configuration dialog box appears From this dialog box choose the device used for the project See Figure 10 Choose the device from the Board menu or keep the default Tiva option 12 Tiva C Series Development and Evaluation Kits for Sourcery CodeBench SPMU356 July 2013 Development Tools Submit Documentation Feedback Copyright 2013 Texas Instruments Incorporated ld TEXAS INSTRUMENTS www
20. iva TivaWare are trademarks of Texas Instruments Stellaris is a registered trademark of Texas Instruments Sourcery CodeBench is a trademark of Mentor Graphics Microsoft is a registered trademark of Microsoft All other trademarks are the property of their respective owners SPMU356 July 2013 Tiva C Series Development and Evaluation Kits for Sourcery CodeBench 1 Submit Documentation Feedback Development Tools Copyright 2013 Texas Instruments Incorporated I TEXAS INSTRUMENTS Sourcery CodeBench www ti com 2 1 Installation 2 1 1 Install Sourcery CodeBench 1 Insert the Tlva C Series Development Kit Software USB flash drive and click on the index html For kits that don t include a USB flash drive go to the evaluation board software webpage www ti com tools sw lt kit_name gt 2 With the Development Kit USB flash drive click the CodeSourcery logo to start the setup program Depending on your web browser either run the installer directly from the USB flash drive or first download it to your PC and then run the installer NOTE If installing CodeBench manually open the sourceryg x x xx arm stellaris eabi exe file in the Tools CodeSourcery directory of the USB flash drive 3 Follow the instructions detailed in the installer until the installation is complete 4 Register with CodeSourcery to obtain an evaluation license once installation is complete To obtain a license start the Sourcery CodeBench integrated de
21. lly install TivaWare use a zip file extraction utility such as WinZip to manually extract the contents of the zip file in the TivaWare directory 3 Navigate to the Tools TivaWare docs directory and click the TivaWare Peripheral Driver Library User s Guide PDF file to view the TivaWare documentation 2 2 Build and Debug the Software There are two methods of building and debugging software in the Sourcery CodeBench environment a command line interface and an Eclipse based Integrated Development Environment IDE To use the command line interface follow these steps after installing Sourcery CodeBench and TivaWare To use the IDE interface see Building using the Integrated Development Environment 2 2 1 Build Using the Command Line After installing Sourcery CodeBench and TivaWare build and debug the software from a command line using the following steps 2 2 1 1 Build the Driver Library With GCC 1 Use your command line utility shell to navigate to the TivaWare directory Assume the TivaWare directory was extracted to C ti TivaWare_C_Series n n MYPC cd C TivaWare 2 Type make to build the TivaWare and software examples MYPC make 3 The compiler completes the build process for each file and then builds the output files axf and bin 2 2 1 2 Run GDB The GDB stub is in the CodeSourcery Sourcery G bin directory which is installed to C Program Files by default In this example the Hello example from ti TivaWa
22. re_C_Series n n examples boards ek tm4c123gx is loaded into flash although there is a Hello example for all Tiva boards 1 Open a command line utility shell window and navigate to the ek tm4c123gx hello gcc directory of TivaWare to run GDB Assume TivaWare is at C lt TivaWare_C_Series 1 0 MYPC cd C ti TivaWare_C_Series 1 0 examples boards ek tm4c123gxl hello gcc 2 Type arm stellaris eabi gdb hello axf and press Enter Assuming you have already built the example SPMU356 July 2013 Tiva C Series Development and Evaluation Kits for Sourcery CodeBench 3 Submit Documentation Feedback Development Tools Copyright 2013 Texas Instruments Incorporated I TEXAS INSTRUMENTS Sourcery CodeBench www ti com as described in Section 2 2 1 you should see the following MYPC arm stellaris eabi gdb hello axf GNU gdb Sourcery G x Xx XX X X XX XXXXXXXXX CVS Copyright C 2007 Free Software Foundation Inc GDB is free software covered by the GNU General Public License and you are welcome to change it and or distribute copies of it under certain conditions Type show copying to see the conditions There is absolutely no warranty for GDB Type show warranty for details This GDB was configured as host i686 mingw32 target arm stellaris eabi GDB is now running 3 Type target extended remote arm stellaris eabi sprite armusb speed 2 lt target gt to connect to the board where lt target gt should be replaced
23. resh F5 Close Project Close Unrelated Projects Build Configurations b Make Targets gt Index b Show in Remote Systems view Convert To Run As b el z See Debug As gt fe 1 Local C C Application i gt Profile As Debug Configurations Location Type Team b Compare With gt Restore from Local History Properties Alt Enter ai AY cs ek tm4c123gxl hello Building workspace 52 _ Figure 5 2 If a dialog box asks whether you want to switch to the debug perspective or view select Yes and optionally check the box indicating you wish to switch automatically in the future When the image download is complete the screen similar to the one shown in Figure 6 should appear Tiva C Series Development and Evaluation Kits for Sourcery CodeBench SPMU356 July 2013 Development Tools Submit Documentation Feedback Copyright 2013 Texas Instruments Incorporated J TEXAS INSTRUMENTS www ti com Create a New Project y miles oards ek trn 2s 00aras tm 4c1 File Edit Source Refactor Search Project Window Help gix B 707 Q7 Boer E 555 Debug ebog pepeng C C ET Debug 2 Se oT Oe ia gt D a i gt PA 69 Variables 52 5 Breakpoints 33 t Registers Modules amp ek TAa hello Sourcery CodeBench Debug t st E Ge Fe C Users a0272201 workspace ek tm4c123gxl hello Release hello axf i1 rea uspended Breakpoint Thread 1 Susp
24. t to start development Create a new project by following these steps 1 To add a new project to your workspace assuming you re still using the example described above go to File New Project see Figure 7 SPMU356 July 2013 Tiva C Series Development and Evaluation Kits for Sourcery CodeBench 9 Submit Documentation Feedback Development Tools Copyright 2013 Texas Instruments Incorporated Create a New Project 10 Edit Source Refactor eee eS SE Re IALL PAAL Pt ee a 2 T MRC Navigate Search Project Run Window I TEXAS INSTRUMENTS www ti com Ctrl N PT J Variables New Alt Shift N F Project Open File 4 Other Close Ctrl W nags Close All Ctrl Shift W fh Debug Save Ctri S Save As Save All Ctrl Shitt Revert Move Rename F2 Refresh F5 Convert Line Delimiters To Print Ctril P Switch Workspace b Figure 7 Tiva C Series Development and Evaluation Kits for Sourcery CodeBench Development Tools Copyright 2013 Texas Instruments Incorporated Name 2 The tool prompts you to select a wizard for creating the new project Select C Project SPMU356 July 2013 Submit Documentation Feedback la TEXAS INSTRUMENTS www ti com Create a New Project Select a wizard Create a new C project Wizards type filter t G gt General Ea CA fe C Project C Project Makefile Project with Ex
25. velopment environment IDE The Sourcery G for Tiva EABI License Installation window appears see Figure 1 Sourcery G for Stellaris EAB Licensing Sourcery G for Stellaris EABI License Installation S No valid license for Sourcery G For Stellaris EABI was found The error was Can t Find License File 1 4042 C Program Files CodeSourcery Sourcery G 4 3 186 license arm stellaris eabi Your Host IDs s are DISK_SERIAL_NUM lt SERIAL OF YOUR DISK gt lt MAC ADDRESS ES OF YOUR NETWORK ADAPTER S gt You must install a license to use Sourcery G Please select a license installation method Install a license file you already have If you cancel this wizard you will be prompted again to install a license the next time you start the Sourcery G IDE Figure 1 5 If you already have a license for the Sourcery CodeBench tools select Install a license file you already have click Next and follow the instructions If you do not have a license file you must visit the Sourcery CodeBench web site to register and request an evaluation license key You can reach this web site by making sure that Obtain a license automatically is selected before click Next twice then clicking the Sourcer G Portal link on the Obtain License screen 6 Once you have obtained a license key use the Back button to return to the screen shown above then select Install a license file you already have and proceed as direct
26. verify that such information is current and complete All semiconductor products also referred to herein as components are sold subject to Tl s terms and conditions of sale supplied at the time of order acknowledgment Tl warrants performance of its components to the specifications applicable at the time of sale in accordance with the warranty in Tl s terms and conditions of sale of semiconductor products Testing and other quality control techniques are used to the extent TI deems necessary to support this warranty Except where mandated by applicable law testing of all parameters of each component is not necessarily performed Tl assumes no liability for applications assistance or the design of Buyers products Buyers are responsible for their products and applications using TI components To minimize the risks associated with Buyers products and applications Buyers should provide adequate design and operating safeguards TI does not warrant or represent that any license either express or implied is granted under any patent right copyright mask work right or other intellectual property right relating to any combination machine or process in which Tl components or services are used Information published by TI regarding third party products or services does not constitute a license to use such products or services or a warranty or endorsement thereof Use of such information may require a license from a third party under the p
27. xl freertos_dema ek tr4cl23qxl gpio_jtag ek tm4cl23gul hello ek tm4cl23guxl interrupts ek tm4cl23gxl mpu_fault ek tr4cl23gxl project ek tm4cl25qxl qs rgb ek tm4cl23gul timers ek tm4cl23gaxl uart_echo ek tm4cl23gxl udima_demo ek tm4cl23gxl usb_dev_bulk ek tm4cl23gxl usb_dev_serial ircery CodeBench Debug Attacl 4 Li j Filter matched 20 of 20 items 7 Name my_project Debug E Main 6 Arguments BG Environment Debugger Source eens C C Application Debug my_proyect axt Project my_project Build if required before launching Build configuration Use Active C Enable auto build C Disable auto build Use workspace settings Configure Workspace Settings Connect process input amp output to a terminal Search Project Figure 20 3 Click Debug after applying the changes See Section 2 2 2 3 for more information on using the debugger Conclusion You have now installed GCC built the TivaWare package and flashed the device using either GDB or the Sourcery CodeBench IDE To learn more about using GDB commands type help You will find a list of expandable help topics For example typing help dat
28. z Quick Start Guide I TEXAS SPMU356 July 2013 INSTRUMENTS Tiva C Series Development and Evaluation Kits for Sourcery CodeBench Development Tools This Quickstart provides instructions to install the Sourcery CodeBench flash and debug an application using the Sourcery CodeBench IDE and GDB and compile TivaWare for C Series The Tiva C Series development and evaluation boards can function as either a complete evaluation target with minor modifications or as a debugger interface to any external Tiva C Series device 1 Requirements e PC with a USB interface and Microsoft Windows 2000 XP Vista or 7 Operating System e Tiva C Series Development Kit Software USB flash drive or the downloaded and extracted kit software found on www ti com tool sw lt kit_name gt e ICDI drivers installed following the instructions in Stellaris In Circuit Debug Interface ICDI and Virtual COM Port SPMU287 e Installed command line environment if using a command line interface The environment should include make and the other associated utilities described in the TivaWare User s Guide 2 Sourcery CodeBench This quickstart provides instructions to install the Sourcery CodeBench tools and how to build and run an example application on a Tiva Development or Evaluation board NOTE The GDB stub included with Sourcery CodeBench is a 30 day time limited evaluation version For long term use you must purchase a license from CodeSourcery T
Download Pdf Manuals
Related Search