CooCox CoIDE UserGuide Version: 1.2.2 2011-3-4 page 1. Free ARM Cortex M3 and Cortex M0 IDE: CooCox CoIDE UserGuide



Similar documents
Data Tool Platform SQL Development Tools

For Introduction to Java Programming, 5E By Y. Daniel Liang

Nios II IDE Help System

Debugging Java Applications

Using Example Projects, Code and Scripts to Jump-Start Customers With Code Composer Studio 2.0

TIPS & TRICKS JOHN STEVENSON

EPIC - User s Guide i. EPIC - User s Guide

POOSL IDE User Manual

Desktop, Web and Mobile Testing Tutorials

IBM Operational Decision Manager Version 8 Release 5. Getting Started with Business Rules

Legal Notes. Regarding Trademarks KYOCERA Document Solutions Inc.

Avaya Network Configuration Manager User Guide

SKP16C62P Tutorial 1 Software Development Process using HEW. Renesas Technology America Inc.

Database Studio is the new tool to administrate SAP MaxDB database instances as of version 7.5.

Before you can use the Duke Ambient environment to start working on your projects or

Department of Veterans Affairs. Open Source Electronic Health Record Services

How to test and debug an ASP.NET application

DataPA OpenAnalytics End User Training

Microsoft SharePoint 2010 End User Quick Reference Card

NETWORK PRINT MONITOR User Guide

Hypercosm. Studio.

Q N X S O F T W A R E D E V E L O P M E N T P L A T F O R M v Steps to Developing a QNX Program Quickstart Guide

Creating and Using Forms in SharePoint

Building an Embedded Processor System on a Xilinx Zync FPGA (Profiling): A Tutorial

3. Programming the STM32F4-Discovery

Getting Started with CodeXL

Colligo Manager 6.0. Offline Mode - User Guide

USER GUIDE. Unit 2: Synergy. Chapter 2: Using Schoolwires Synergy

ArchestrA Log Viewer User s Guide Invensys Systems, Inc.

Code::Blocks Student Manual

Dell SonicWALL SRA 7.5 Secure Virtual Meeting and Secure Virtual Assist

EMC Documentum Webtop

Microsoft Access 2010 Part 1: Introduction to Access

Xcode Project Management Guide. (Legacy)

Code Composer Studio Development Tools v3.3. Getting Started Guide

Altera Monitor Program

DiskPulse DISK CHANGE MONITOR

Microsoft Outlook Reference Guide for Lotus Notes Users

10 STEPS TO YOUR FIRST QNX PROGRAM. QUICKSTART GUIDE Second Edition

PTC Integrity Eclipse and IBM Rational Development Platform Guide

USING STUFFIT DELUXE THE STUFFIT START PAGE CREATING ARCHIVES (COMPRESSED FILES)

Module One: Getting Started Opening Outlook Setting Up Outlook for the First Time Understanding the Interface...

DS-5 ARM. Using the Debugger. Version 5.7. Copyright 2010, 2011 ARM. All rights reserved. ARM DUI 0446G (ID092311)

Quick Start Tutorial. Using the TASKING* Software Development Tools with the Intel 8x930 Family Evaluation Board

ArcGIS. Tips and Shortcuts. for Desktop

Using SSH Secure Shell Client for FTP

Infor ERP BaanIV / Baan 5.0 / LN 6.1. User's Guide for Worktop 2.4

PowerLogic ION Enterprise 6.0

vtcommander Installing and Starting vtcommander

EE8205: Embedded Computer System Electrical and Computer Engineering, Ryerson University. Multitasking ARM-Applications with uvision and RTX

IAR Embedded Workbench

Programming with the Dev C++ IDE

NovaBACKUP. User Manual. NovaStor / November 2011

Waspmote IDE. User Guide

DsPIC HOW-TO GUIDE Creating & Debugging a Project in MPLAB

BLUECIELO MERIDIAN ASSET MANAGEMENT MODULE 2014

Alfresco Online Collaboration Tool

Nuvoton Nu-Link Debug Adapter User Manual

Colligo Manager 6.2. Offline Mode - User Guide

Project Manager Editor & Debugger

UNDELETE 7.0 USER GUIDE

Xythos on Demand Quick Start Guide For Xythos Drive

Timeless Time and Expense Version 3.0. Copyright MAG Softwrx, Inc.

NDA ISSUE 1 STOCK # CallCenterWorX-Enterprise IMX MAT Quick Reference Guide MAY, NEC America, Inc.

DEPLOYING A VISUAL BASIC.NET APPLICATION

Event Record Monitoring and Analysis Software. Software Rev. 3.0 and Up. User s Guide

Tutorial 5: Developing Java applications

-lead Grabber Business 2010 User Guide

Device Installer User Guide

Installation and Operation Manual Portable Device Manager, Windows version

Configuration Manager

Backup Assistant. User Guide. NEC NEC Unified Solutions, Inc. March 2008 NDA-30282, Revision 6

Using Microsoft Visual Studio API Reference

SQL Server 2005: Report Builder

DS-5 ARM. Using the Debugger. Version Copyright ARM. All rights reserved. ARM DUI 0446M (ID120712)

Code Composer Studio Getting Started Guide

SHAREPOINT 2010 FOUNDATION FOR END USERS

for Sage 100 ERP Business Insights Overview Document

Lotus Notes Client Version 8.5 Reference Guide

Auditing manual. Archive Manager. Publication Date: November, 2015

Professional. SlickEdif. John Hurst IC..T...L. i 1 8 О 7» \ WILEY \ Wiley Publishing, Inc.

DRV8312-C2-KIT How to Run Guide

Outlook . User Guide IS TRAINING CENTER. 833 Chestnut St, Suite 600. Philadelphia, PA

Microsoft Access Basics

SourceAnywhere Service Configurator can be launched from Start -> All Programs -> Dynamsoft SourceAnywhere Server.

Microsoft Visual Studio Integration Guide

LESSON 4 - FILE MANAGEMENT

Topography of an Origin Project and Workspace

Internet Explorer 7. Getting Started The Internet Explorer Window. Tabs NEW! Working with the Tab Row. Microsoft QUICK Source

Enhanced Project Management for Embedded C/C++ Programming using Software Components

Avalanche Remote Control User Guide. Version 4.1.3

UNDELETE Users Guide

QIAsymphony Management Console User Manual

Chapter 15: Forms. User Guide. 1 P a g e

Generative Drafting. Page DASSAULT SYSTEMES. IBM Product Lifecycle Management Solutions / Dassault Systemes

ImageNow User. Getting Started Guide. ImageNow Version: 6.7. x

Ride7 for ARM. RAISONANCE Tools for the STRx and STM32 families. Overview and Getting Started

Getting Started with IntelleView POS Administrator Software

Capacitive Touch Lab. Renesas Capacitive Touch Lab R8C/36T-A Family

13 Managing Devices. Your computer is an assembly of many components from different manufacturers. LESSON OBJECTIVES

Transcription:

CooCox CoIDE UserGuide Version: 1.2.2 2011-3-4 page 1 Free ARM Cortex M3 and Cortex M0 IDE: CooCox CoIDE UserGuide

CooCox CoIDE UserGuide Version: 1.2.2 2011-3-4 page 2 Index: 1. CoIDE Quick Start... 4 2. Builder Guide... 21 2.1 New Concepts... 21 2.1.1 Terminology Note... 21 2.1.2 CoIDE Features... 22 2.2 User Interface... 23 2.2.1 Menus and Actions... 23 2.2.2 Views... 26 2.2.3 Toolbar... 30 2.3 Project Management... 31 2.3.1 Creating project... 31 2.3.2 Editing code... 37 2.3.3 Project Configuration... 43 2.3.4 Building project... 47 2.3.5 Saving project to another location... 49 2.3.6 Opening an existing project... 51 2.4 Component Examples... 56 2.4.1 Viewing example... 56 2.4.2 Adding example to project... 63 2.4.3 Sharing example... 66 2.4.4 Managing example... 72 2.5 Component Management... 81 2.5.1 Upload a Component... 81 2.5.2 Modify your Component... 91 2.5.3 Delete a component... 97 3. Debug Guide... 102 3.1 Debug Configurations... 102 3.1.1 Debugger... 104 3.1.2 Download... 105 3.2 Controlling debug execution... 106 3.3 Breakpoints &Watchpoints... 108 3.3.1 Adding Breakpoints & Watchpoint... 108 3.3.2 Removing Breakpoints & Watchpoints... 110 3.3.3 Enabling and Disabling Breakpoints & Watchpoints... 112 3.4 Debug View... 114 3.4.1 Disassembly view... 114 3.4.2 Breakpoints View... 115 3.4.3 Registers view... 117 3.4.4 Memory View... 119 3.4.5 Variables View... 121 3.4.6 Expressions view... 123 3.4.7 Debug View... 124

CooCox CoIDE UserGuide Version: 1.2.2 2011-3-4 page 3 3.4.8 Peripherals View (CoAssistant)... 126 4. C/C++ Views... 134 4.1 Project Explorer View... 134 4.2 Outline View... 137 4.3 Console View... 139 4.4 Search View... 141 4.5 Editor View... 143 4.6 Help Contents... 144

CooCox CoIDE UserGuide Version: 1.2.2 2011-3-4 page 4 1. CoIDE Quick Start To create a simple embedded application using CooCox CoIDE, you will perform the following steps: 1. After launching CooCox CoIDE, select manufacturer, for example: Nuvoton.

CooCox CoIDE UserGuide Version: 1.2.2 2011-3-4 page 5 2. Select chip, for example: NUC100LE3AN, the right side of CoIDE will display the corresponding information of the chip.

CooCox CoIDE UserGuide Version: 1.2.2 2011-3-4 page 6 3. Check the components which you want to use, for example, check GPIO component. CoIDE will promote you to create a new project.

CooCox CoIDE UserGuide Version: 1.2.2 2011-3-4 page 7 4. Input the project's name, CoIDE will create a project contained startup code and main.c file for you. The components you selected in third step will be added to your project, too.

CooCox CoIDE UserGuide Version: 1.2.2 2011-3-4 page 8 5. Click GPIO in repository view, the detailed descriptions of GPIO component will show in help view.

CooCox CoIDE UserGuide Version: 1.2.2 2011-3-4 page 9 6. Click GPIO in component view, you can find there are some examples for this component.

CooCox CoIDE UserGuide Version: 1.2.2 2011-3-4 page 10 7. Click add to copy the existing example to your project. For example, add BlinkExp.

CooCox CoIDE UserGuide Version: 1.2.2 2011-3-4 page 11 8. CoIDE will automatically add the BlinkExp.c example to the project.

CooCox CoIDE UserGuide Version: 1.2.2 2011-3-4 page 12 9. Click Build button to compile and link the program.

CooCox CoIDE UserGuide Version: 1.2.2 2011-3-4 page 13 10. Click Debug Configuration button to open the configuration dialog.

CooCox CoIDE UserGuide Version: 1.2.2 2011-3-4 page 14 11. Select Nulink or CoLinkEx as the adapter according to that you use.

CooCox CoIDE UserGuide Version: 1.2.2 2011-3-4 page 15 12. Click Download button to download code to flash.

CooCox CoIDE UserGuide Version: 1.2.2 2011-3-4 page 16 13. Click Debug button to start debug.

CooCox CoIDE UserGuide Version: 1.2.2 2011-3-4 page 17 14. After launching debug successfully, CoIDE will come into debug mode.

CooCox CoIDE UserGuide Version: 1.2.2 2011-3-4 page 18 15. The initial debug UI only shows a few debug windows, you can open the other debug windows through view menu.

CooCox CoIDE UserGuide Version: 1.2.2 2011-3-4 page 19 16. Setting breakpoints in c window or in the disassembly window.

CooCox CoIDE UserGuide Version: 1.2.2 2011-3-4 page 20 17. Using the debug functions.

CooCox CoIDE UserGuide Version: 1.2.2 2011-3-4 page 21 2. Builder Guide 2.1 New Concepts CooCox CoIDE consists of a component-based network platform and an Eclipse-based development environment. The component-based network platform can quickly obtain resources to build applications, share your resources and exchange ideas. The Eclipse-based development environment provides many features for code editing, code browsing, compiling, linking, debugging, project management, etc. 2.1.1 Terminology Note Component In CooCox CoIDE, reusable code is called component. A component can be a library, a collection of source files and so on. It must provide useful functions, be easy to understand and use, and most importantly, can work correctly. Each component has its corresponding code snippets, usage, documentation and comments. Dependence If component A calls the content of component B (known as Compilation Dependence), or component A can not correctly execute without component B (known as Application Dependence), We call component A depends on component B. When you check component A, CoIDE will automatically check the dependence components of component A. One component can depend on several components, and also can be depended by multiple components. Code Snippet Code Snippet is also known as example code, it is an extension of component. If the component is object-oriented, the code snippet will be application-oriented. Example, a PIO driver can be known as a component, a function using PIO driver to achieve LED flashing can be known as a code snippet. The code snippet is generally very short, but the features are not restricted. It can be automatically inserted into the code.

CooCox CoIDE UserGuide Version: 1.2.2 2011-3-4 page 22 2.1.2 CoIDE Features CoIDE can be used for code editing, code browsing, compiling, linking, debugging, project management, it also can be used to obtain components, to share components and to exchange ideas. Component Network Component Network contains a large amount of free components, the components are provided by CooCox and CooCox users. CooCox has provided RTOS, flash manager, embedded database, protocol stack and other components which are all free and open. Everyone can use these components and upload their own components. Component Oriented Programming In embedded application development, if there is no suitable libraries, development work will become very complicated. Once you have the suitable libraries, anything will be manipulated in your hands. CooCox CoIDE Component Network contains a large amount of free components, users can choose suitable components according to your own needs, and use the component code snippets to build application more quickly. With a large number of components and detailed component documentation, programming will be as simple as building block. Component Documentation Each component has a detailed documentation (displayed in the Help View), including component description, component dependency relationship, component source files, usage of the component, comments and so on. CoIDE automatically generates documentation for source files. If the code comment style is consistent with doxygen, the documentation will be very detailed. And the detailed documentation allows you to use the component more quickly. Interaction In order to help users to solve the problems encountered in development process, CoIDE provides a powerful interaction function. In CooCox CoIDE, every thing can interact, such as chip, component, peripheral, register, code snippet and so on, users can even ask questions directly to solve their problems. Development Environment CoIDE is based on the Eclipse development platform, it has the following features: Integrated CDT editor: You can edit and browse the code; it is a full-featured editor. Integrated Sourcery G++ Lite tool chain: Using gcc tool chain, which is efficient and stable. A clear interface: Menus and toolbar are simple, clear and easy to use. GUI Setting: Dialogs for all settings.

CooCox CoIDE UserGuide Version: 1.2.2 2011-3-4 page 23 2.2 User Interface 2.2.1 Menus and Actions File Menu Actions Name Description Shortcut New File New Folder Open File... Save Save As... Save All Exit Create a new file. Create a new folder. Open a file. Save the content of the current editor. Disabled if the editor does not contain unsaved changes. Save the content of the current editor under a new name. Save the content of all editors with unsaved changes. Disabled if no editor contains unsaved changes. Exit CoIDE. Ctrl + S Ctrl + Shift + S View Menu Actions Name Description Shortcut Repository Help Outline Peripherals Breakpoints Open Repository View. Open Help View. Open Outline View. Open Peripherals View. Open Breakpoints View. Project Menu Actions Name Description Shortcut New Project Open Project... Create a new Project and close the current project. Show a dialog that can be used to select an existing project.

CooCox CoIDE UserGuide Version: 1.2.2 2011-3-4 page 24 Save Project As Close Project Configuration Build Save the current project under a new location. Close the current project. Open the current project configuration page (Open builder.xml of the current project in Editor). Build the currently selected project. This is an incremental build, meaning that the builder analyzes the changes since the last time of build and minimizes the number of changed files. F7 Rebuild Rebuild all files of the current project. Ctrl + R Clean Upload Component Clean the intermediate files that generated by building. Open the Login dialog box, you can upload Component after login with coocox account. Flash Menu Actions Name Description Shortcut Program Download Flash Erase Download program to flash. Erase flash. Debug Menu Actions Name Description Shortcut Debug To debug the current project. Ctrl+F5; Debug Configuration To do configuration for debugging. Toggle Breakpoint To set a breakpoint at the current line. Ctrl+Shift+B; Toggle Method Breakpoint Toggle Watch Breakpoint Skip All Breakpoints Remove All Breakpoints To set a breakpoint at the entry of current function. To set a Watch Breakpoint. Skip all the Breakpoints when dubugging. Delete all the BreakPoints. Search Menu Actions Name Description Shortcut Search... Execute a C/C++ or file search. Ctrl + H File... Execute a file search.

CooCox CoIDE UserGuide Version: 1.2.2 2011-3-4 page 25 Help Menu Actions Name Description Shortcut Help Contents About CoIDE CoIDE Users' Guide. Display CoIDE version number and license information.

CooCox CoIDE UserGuide Version: 1.2.2 2011-3-4 page 26 2.2.2 Views Component View This view displays all the components of the current project selection. If you click a component in this view: The Help view will display the properties of the clicked component, such as the component source files, source files documents, dependent components, usage and comments. The Code Snippet View will display all code snippets of the component. The Project View will highlight the component source files. Project View This view displays all files of the file system under your project directory, including C source files (*.c, *.h), assembly source files (*.s), project configuration files (build.xml), linker script files (*.ld), library files (*.a), etc. In this view you could do the following operations: Open files in the editor view Open project configuration interface Close the current project Create new projects, files, or folders Manage existing files (copy, paste, delete, move or rename)

CooCox CoIDE UserGuide Version: 1.2.2 2011-3-4 page 27 Repository View This view consists of Manufacturers page, Chip page and Component page. In this view, you can view chip components and manage your local or network components. When you check a component, the component and other components depended by the checked component will be automatically checked, and the source files will be automatically added to the project. This view can be opened by menu command View->Repository. In this view you could do the following operations: View component information. Add components to the current project. Uncheck components. View/Manage local components. Search components. Manage your components. Release components. Help View This view displays all information about the selected component, including:

CooCox CoIDE UserGuide Version: 1.2.2 2011-3-4 page 28 Overview: The component description. Usage: Component usage (can be edited). Source files: Source files of the component. Source files documents: Generated after building (It can generate detailed documentation if the code comment style is consistent with DOXYGEN specification.). Dependency: Other components depended by the component. Code Snippet View In the Components View, click the component to open this view, this view will display all code snippets of the clicked component. In this view you can do the following things: Click view to view code snippet and the comments. Click add to insert the code snippet into the project. View more example for the chip you selected. Upload a code snippet. Manage your own code snippets. Add comments.

CooCox CoIDE UserGuide Version: 1.2.2 2011-3-4 page 29 Other Eclipse View The following views are commonly used in CoIDE perspective: Project Explorer: Shows all of the file system's files under your project directory. Editor: The C/C++ editor view provides specialized features for editing C/C++ related files. Outline: Displays the structure of the file currently open in an editor. Search: Shows the results of searches for files or text. Console: Displays your program's output, as well as the output from your build tools. More about Eclipse Views, please refer to Eclipse documentation.

CooCox CoIDE UserGuide Version: 1.2.2 2011-3-4 page 30 2.2.3 Toolbar Toolbar Actions Icon Name Description Shortcut New Project Create New File Save Build Create a new Project and close the current project. Create a new file. Save the content of the current editor. Disabled if the there is no changed. Build the currently selected project. This is an incremental build, meaning that the builder analyzes the changes since the last time of build and minimizes the number of changed files. Ctrl + S F7 Rebuild Rebuild all files of the current project. Ctrl + R Start Debug. To debug the current project. Ctrl + F5 Debug Configuration Download Code to Flash Flash Erase Repository To do configuration for debugging. Download program to flash. Erase the full chip. Open Repository View. Search Open the Search dialog box. Ctrl + H Next Annotation Go to the next annotation. Ctrl +. Previous Annotation Go to the previous annotation. Ctrl +, Last Edit Location Go to the location where you have modified last time. Ctrl + Q Back to... Go back to the previous position. Alt + Left Forward to... Forward to next position. Alt + Right

CooCox CoIDE UserGuide Version: 1.2.2 2011-3-4 page 31 2.3 Project Management 2.3.1 Creating project 1. Select Project > New Project.

CooCox CoIDE UserGuide Version: 1.2.2 2011-3-4 page 32 2. Type a name for your project. For example, in the Project name field, type MyFirstProject.

CooCox CoIDE UserGuide Version: 1.2.2 2011-3-4 page 33 3. Select a manufacturer. For example, choose Atmel.

CooCox CoIDE UserGuide Version: 1.2.2 2011-3-4 page 34 4. Select a chip. For example choose AT91SAM3U4C.

CooCox CoIDE UserGuide Version: 1.2.2 2011-3-4 page 35 5. Check a component. For example, select pio. CoIDE will automatically check the components which the checked component depends on.

CooCox CoIDE UserGuide Version: 1.2.2 2011-3-4 page 36 6. Finish creating project and you can review the result.

CooCox CoIDE UserGuide Version: 1.2.2 2011-3-4 page 37 2.3.2 Editing code CoIDE integrates CDT Editor which is a part of CDT project of Eclipse. This section describes how to edit code in CoIDE, if you want to get more help, you can visit eclipse cdt project home. To edit code using CoIDE, you could perform as follows: 1. Select File > New File.

CooCox CoIDE UserGuide Version: 1.2.2 2011-3-4 page 38 2. Type file name for the new file and then click Finish button.

CooCox CoIDE UserGuide Version: 1.2.2 2011-3-4 page 39 3. Edit your own application code.

CooCox CoIDE UserGuide Version: 1.2.2 2011-3-4 page 40 4. If necessary, right click at the left edge of editor, select Show Line Numbers to enable the function or disable.

CooCox CoIDE UserGuide Version: 1.2.2 2011-3-4 page 41 5. If necessary, right click at the left edge of editor, select Folding > Enable Folding to enable the function or disable.

CooCox CoIDE UserGuide Version: 1.2.2 2011-3-4 page 42 6. If necessary, move cursor to a code field then right click, select Open Declaration to open a declaration file.

CooCox CoIDE UserGuide Version: 1.2.2 2011-3-4 page 43 2.3.3 Project Configuration Opening Project Configuration After creating a project, CoIDE will automatically generate a builder.xml file for the project. It contains the project configuration. By editing the file you could configure the project. There is an interface in CoIDE to help us to edit builder.xml file. There are several ways to open the project configuration interface: double-click build.xml in the project view or click Project->Configuration in CoIDE menubar. Adding Preprocessor Symbols For CoIDE projects, you can define preprocessor symbols for the parser. This makes the parser understand the contents of the C/C++ source code so that you can more effectively use the search and code completion

CooCox CoIDE UserGuide Version: 1.2.2 2011-3-4 page 44 features. Add symbols in "Defined symbols" section: Click Add to define new symbol. Click Remove to remove selected element. Adding Include Paths For CoIDE projects, you can add include paths for the parser. This makes the parser find the header included in the C source code so that you can more effectively use the search and code completion features. Add symbols in "Include paths" section: Click Add to add new path. Click Remove to remove selected element. Selecting a Project Type When you create a new project, you can specify the output file type. This output file type will determine the toolchain and data, and tabs that CoIDE uses. In CooCox CoIDE, you can choose from the following output file types: Executable -The target file is a binary file (*.bin) that can be downloaded into the chip and run, it is selected by default. Library - The target file is a library file (libxx.a). It is a collection of object files which you can link into another application. CoIDE combines object files (i.e. *.o) into an archive (*.a) that is directly linked into an executable. Select output file type in "Custom Options" section. Select Executable to generate binary file. Select Library to generate library file. Setting Optimization Options Setting optimization options makes the compiler attempt to improve the performance and/or code size at the expense of compilation time and possibly the ability to debug the program. Optimization - Set optimization levels, about more optimization levels, please refer to gcc documentation. Discard unused sections - Enable garbage collection of unused input sections. The section containing the entry symbol and all sections containing symbols undefined on the command-line will be kept, as will sections containing symbols referenced by dynamic objects. Check this option will reduce code size.

CooCox CoIDE UserGuide Version: 1.2.2 2011-3-4 page 45 Set optimization options in "Custom Options" section. Select Optimization to set optimization level. Check Discard unused sections to discard unused input sections. Adding Library Library is a set of routines, external functions and variables which are resolved in a caller at compile-time and copied into a target application by a compiler, linker, or binder, producing an object file and a stand-alone executable. CoIDE library is a gcc library. Add libraries file in "Linked Libraries" section. Click Add to add new library. Click Remove to remove selected library. Customizing Memory Areas You can modify the IROM and IRAM options. Customize the start address and size for IROM and IRAM in "Memory Areas" section. Customize the start address of IROM and IRAM in Start line. Customize the size of IROM and IRAM in Size line. Customizing Linker Script Customize the linker script file for current project in "Locate Link File" section. Click Locate to locate an existing linker script file. Click Edit to edit current linker script file in CoIDE editor.

CooCox CoIDE UserGuide Version: 1.2.2 2011-3-4 page 46 Customizing Compiler and Linker Options You can add, delete and modify the Compiler and Linker options. Customize compiler and linker options in "Command" section. Customize compile options in Compiler line. Customize link options in Linker line.

CooCox CoIDE UserGuide Version: 1.2.2 2011-3-4 page 47 2.3.4 Building project 1. Select Project > Build. If necessary, you can select Rebuild to recompile your project or select Clean to clean-up the project have compiled.

CooCox CoIDE UserGuide Version: 1.2.2 2011-3-4 page 48 2. Viewing compile information in the Console window.

CooCox CoIDE UserGuide Version: 1.2.2 2011-3-4 page 49 2.3.5 Saving project to another location 1. Select Project > Save Project As

CooCox CoIDE UserGuide Version: 1.2.2 2011-3-4 page 50 2. Choose the location you want to save.

CooCox CoIDE UserGuide Version: 1.2.2 2011-3-4 page 51 2.3.6 Opening an existing project 1. If necessary, you can select Project > Close Project to close the current project.

CooCox CoIDE UserGuide Version: 1.2.2 2011-3-4 page 52 2. After closing the project, all the windows are clean.

CooCox CoIDE UserGuide Version: 1.2.2 2011-3-4 page 53 3. Select Project > Open Project...

CooCox CoIDE UserGuide Version: 1.2.2 2011-3-4 page 54 4. Locating the directory of the project file with suffix of '.cob'.

CooCox CoIDE UserGuide Version: 1.2.2 2011-3-4 page 55 5. Check your project.

CooCox CoIDE UserGuide Version: 1.2.2 2011-3-4 page 56 2.4 Component Examples CoIDE integrates a lot of infrastructure components, in order to allow users to use these components more easily, each component can be corresponded to multiple sample code fragment, you can view them and add them to your project, you also could upload your own examples to the internet. 2.4.1 Viewing example 1. Click the component which shows "with x example(s)" in the Component View of CoIDE.

CooCox CoIDE UserGuide Version: 1.2.2 2011-3-4 page 57 2. The example view will appear and display all the code snippets of the selected component.

CooCox CoIDE UserGuide Version: 1.2.2 2011-3-4 page 58 3. Click view link of the example you are interested.

CooCox CoIDE UserGuide Version: 1.2.2 2011-3-4 page 59 4. The code snippet will display in the code editor viewer.

CooCox CoIDE UserGuide Version: 1.2.2 2011-3-4 page 60 5. You can click "More Example for xxx" to view more example for the selected chip.

CooCox CoIDE UserGuide Version: 1.2.2 2011-3-4 page 61 6. Other example will show in more example view based on the component classification.

CooCox CoIDE UserGuide Version: 1.2.2 2011-3-4 page 62 7. Click the example name can open the example in the edit view.

CooCox CoIDE UserGuide Version: 1.2.2 2011-3-4 page 63 2.4.2 Adding example to project 1. Click add link of the example you are interested.

CooCox CoIDE UserGuide Version: 1.2.2 2011-3-4 page 64 2. It will popup a dialog to tell you where the example will be located in, click "yes", please.

CooCox CoIDE UserGuide Version: 1.2.2 2011-3-4 page 65 3. The code snippet is automatically added to the project.

CooCox CoIDE UserGuide Version: 1.2.2 2011-3-4 page 66 2.4.3 Sharing example 1. Click Have a better example snippet? Share with others?

CooCox CoIDE UserGuide Version: 1.2.2 2011-3-4 page 67 2. If you have not login, you must login first.if you don not have an account, click the link named "Get new CooCox account?" at the bottom of Login Dialog.

CooCox CoIDE UserGuide Version: 1.2.2 2011-3-4 page 68 3. Type the Title of your code snippet.

CooCox CoIDE UserGuide Version: 1.2.2 2011-3-4 page 69 4. Click Edit in the editor.

CooCox CoIDE UserGuide Version: 1.2.2 2011-3-4 page 70 5. Edit you example code and click the submit button.

CooCox CoIDE UserGuide Version: 1.2.2 2011-3-4 page 71 6. View your example code snippet.

CooCox CoIDE UserGuide Version: 1.2.2 2011-3-4 page 72 2.4.4 Managing example 1. Login with your CooCox account.

CooCox CoIDE UserGuide Version: 1.2.2 2011-3-4 page 73 2. Find your example in the example view.

CooCox CoIDE UserGuide Version: 1.2.2 2011-3-4 page 74 3. Click modify link of the example you want to modify.

CooCox CoIDE UserGuide Version: 1.2.2 2011-3-4 page 75 4. You can modify the name, description, code of the example.

CooCox CoIDE UserGuide Version: 1.2.2 2011-3-4 page 76 5. Click Save to save your modification.

CooCox CoIDE UserGuide Version: 1.2.2 2011-3-4 page 77 6. View the modified content.

CooCox CoIDE UserGuide Version: 1.2.2 2011-3-4 page 78 7. You can click delete to delete the example.

CooCox CoIDE UserGuide Version: 1.2.2 2011-3-4 page 79 8. Click "Yes" to delete the example.

CooCox CoIDE UserGuide Version: 1.2.2 2011-3-4 page 80 9. The example was deleted.

CooCox CoIDE UserGuide Version: 1.2.2 2011-3-4 page 81 2.5 Component Management 2.5.1 Upload a Component To upload a component, you only need to perform the following steps: 1. You can click "Upload Component" under the "Project" menu or the button in the Repository view.

CooCox CoIDE UserGuide Version: 1.2.2 2011-3-4 page 82 2. Login with your account, it could be the account of yours in CooCox Forum.

CooCox CoIDE UserGuide Version: 1.2.2 2011-3-4 page 83 3. Type the name and descriptions of the new Component.

CooCox CoIDE UserGuide Version: 1.2.2 2011-3-4 page 84 4. Add files or folder of the Component.

CooCox CoIDE UserGuide Version: 1.2.2 2011-3-4 page 85 5. Click next to save the settings of "Files" and then enter the "Tags" page.

CooCox CoIDE UserGuide Version: 1.2.2 2011-3-4 page 86 6. Edit the information about the component; you need to select the manufacture, chip, category for the component.

CooCox CoIDE UserGuide Version: 1.2.2 2011-3-4 page 87 7. Edit the Component Dependency.

CooCox CoIDE UserGuide Version: 1.2.2 2011-3-4 page 88 8. Edit the help content for this Component.

CooCox CoIDE UserGuide Version: 1.2.2 2011-3-4 page 89 9. Click "Commit" to upload the Component to the internet.

CooCox CoIDE UserGuide Version: 1.2.2 2011-3-4 page 90 10. The Congratulation will come out if your upload is successful.

CooCox CoIDE UserGuide Version: 1.2.2 2011-3-4 page 91 2.5.2 Modify your Component 1. Login with your CooCox account.

CooCox CoIDE UserGuide Version: 1.2.2 2011-3-4 page 92 2. Right Click the component you uploaded in the Repository View

CooCox CoIDE UserGuide Version: 1.2.2 2011-3-4 page 93 3. Modify the content of "Files" page.

CooCox CoIDE UserGuide Version: 1.2.2 2011-3-4 page 94 4. Modify the content of "Tags" page.

CooCox CoIDE UserGuide Version: 1.2.2 2011-3-4 page 95 5. Modify the help content and click "save" in the "Saving" page.

CooCox CoIDE UserGuide Version: 1.2.2 2011-3-4 page 96 6. Congratulation shows when your change is successfully saved.

CooCox CoIDE UserGuide Version: 1.2.2 2011-3-4 page 97 2.5.3 Delete a component 1.Login with your CooCox account.

CooCox CoIDE UserGuide Version: 1.2.2 2011-3-4 page 98 2. Right Click the component you uploaded in the Repository View, and select "Delete".

CooCox CoIDE UserGuide Version: 1.2.2 2011-3-4 page 99 3. Click "Yes" to delete the component.

CooCox CoIDE UserGuide Version: 1.2.2 2011-3-4 page 100 4. In the lower right corner of the CoIDE interface, you will find deleting is executing.

CooCox CoIDE UserGuide Version: 1.2.2 2011-3-4 page 101 5. Delete successfully.

CooCox CoIDE UserGuide Version: 1.2.2 2011-3-4 page 102 3. Debug Guide 3.1 Debug Configurations Before debugging your project, you could configurate it first. Like the steps below: Enter the configuration interface: 1. Click the Debug Configuration button.

CooCox CoIDE UserGuide Version: 1.2.2 2011-3-4 page 103 2. Enter the configuration interface. Click the configuration of your project.

CooCox CoIDE UserGuide Version: 1.2.2 2011-3-4 page 104 3.1.1 Debugger To specify the Debugger tab: 1. Hardware Tab: Adapter: CoIDE supports Colink, CoLinkEx, NuLink, Olimex Open-OCD and Stellaris-ICDI these five adapters. Port: CoIDE supports both SWD and JTAG debugging modes. Max Clock(Hz): You could select 2M, 1M, 500K, 300K and 100K clock here. 2. Startup Tab: You could check Run to main or not according to your needs. 3. Advance Tab: Reset Mode: There are there reset modes for you to choose: HW RESET, VECTRESET and SYSRESETREQ. CacheRomEnable: Checked indicates enable ROM cache. TargetInfo: It will show your Host Name and Port Number.

CooCox CoIDE UserGuide Version: 1.2.2 2011-3-4 page 105 3.1.2 Download To specify the Download tab: 1. You could select Download Functions: Auto Download before Debugging: Download the program to the chip automatically before start debug. Verify After Download: Verify the program after download it to the chip. Erase Full Chip: Erase the full chip before downloading your program. Erase Effected: Erase the effected sectors before downloading your program. Do not Erase: It will not erase the chip before downloading your program. 2. Programming Algorithm will show the programming algorithm file. 3. Add..., Remove and default are used to configurate program downloading algorithm.

CooCox CoIDE UserGuide Version: 1.2.2 2011-3-4 page 106 3.2 Controlling debug execution The debug execution controls are superceded by breakpoints. For example, if you attempt to step over a function and the program hits a breakpoint, it pauses, regardless of whether the function is completed. You can control your debug execution in various ways, but they all rely on a core set of debug controls. 1. In the Debug view, select a thread 2. To control the debug session, click menu items Debug > Reset Debug > Run Debug > Suspend Debug > Terminate Debug > Step Into Debug > Step Over Debug > Step Out Debug > Run to line

CooCox CoIDE UserGuide Version: 1.2.2 2011-3-4 page 107 Or directly click the toolbar buttons: Or use the keyboard shortcuts: Icons Action Description Keyboard shortcut Reset Run Suspend Terminate Step Into Step Over Step Out Select the Reset command to reset the debugging. Select the Run command to resume execution of the currently suspended debug target. Select the Suspend command to halt execution of the currently selected thread in a debug target. Ends the selected debug session and/or process. The impact of this action depends on the type of the item selected in the Debug view. Select to execute the current line, including any routines, and proceed to the next statement. Select to execute the current line, following execution inside a routine. Select to continue execution to the end of the current routine, then follow execution to the routine's caller. F5 F9 Ctrl + F5 F11 F12 F7 Run to Line Select to continue execution to current line. Ctrl + R

CooCox CoIDE UserGuide Version: 1.2.2 2011-3-4 page 108 3.3 Breakpoints &Watchpoints 3.3.1 Adding Breakpoints & Watchpoint Adding Breakpoints A breakpoint can be set on an executable line of the program. If the breakpoint is enabled when you debug, the execution will suspend before the code of that line is executed. To add a breakpoint point, you could double-click the marker bar located in the left margin of the C/C++ Editor beside the line of code where you want to add a breakpoint. A dot in the Breakpoints View, along with the name of the associated file. will display in the marker bar and Adding Watchpoints A watchpoint is a special breakpoint that stops the execution of the program whenever the value of a given expression changes, without specifying where it might occur. Unlike breakpoints (which are line-specific), watchpoints are associated with files. They take effect whenever a specified condition is true, regardless of when or where it occurred. You can set a watchpoint on a global variable by highlighting the variable in the editor. To set a watchpoint on a global variable, you could do as follows: 1. Highlight the variable in the editor. 2. Click Debug > Toggle Watchpoint.

CooCox CoIDE UserGuide Version: 1.2.2 2011-3-4 page 109 3. Do one of the follows: To stop execution when the watch expression is read, select the Read check box; To stop execution when the watch expression is written to, select the Write check box; 4. The watchpoint will appear in the Breakpoints View list.

CooCox CoIDE UserGuide Version: 1.2.2 2011-3-4 page 110 3.3.2 Removing Breakpoints & Watchpoints To remove breakpoints or watchpoints, you can do anyone of the following three methods: 1. In the edit view, right click the breakpoint symbol, select Toggle Breakpoint or just double click the breakpoint symbol. 2. In the Breakpoints view, select the breakpoints you want to remove and click Remove the selected breakpoints button or Remove all breakpoints button. 3. In the Breakpoints view, do one of the follows: 1) Select the breakpoints and watchpoints that you want to remove;

CooCox CoIDE UserGuide Version: 1.2.2 2011-3-4 page 111 2) Right-click and select Select All Then right-click the highlighted breakpoints and watchpoints and click Remove or Remove all.

CooCox CoIDE UserGuide Version: 1.2.2 2011-3-4 page 112 3.3.3 Enabling and Disabling Breakpoints & Watchpoints You can temporarily disable a breakpoint or watchpoint without losing the information it contains. To enable or disable breakpoints or watchpoints, you can do anyone of the following three methods: 1. In the edit view, right click the breakpoint symbol, select Enable Breakpoint or Disable Breakpoint 2. In the Breakpoints view, check the breakpoints and watchpoints that you want to enable or disable. 3. In the Breakpoints view, do one of the follows: 1) Select the breakpoints and watchpoints that you want to enable or disable;

CooCox CoIDE UserGuide Version: 1.2.2 2011-3-4 page 113 2) Right-click and select Select All; Then right-click the highlighted breakpoints and watchpoints and click Disable or Enable.

CooCox CoIDE UserGuide Version: 1.2.2 2011-3-4 page 114 3.4 Debug View 3.4.1 Disassembly view The Disassembly View shows the loaded program as assembler instructions mixed with source code for comparison. The currently executing line is indicated by an arrow marker and highlighted in the view. You can do the following tasks in the Disassembly view. Set breakpoints at the start of any assembler instruction. Enable and disable breakpoints and their set their properties. Step through the disassembly instructions of your program. Jump to specific instructions in the program. Disassembly view context menu commands The Disassembly view context menu commands include: Command Name Description Availability Run To Line Move to Line Resume At Line Resumes program execution until the specific line is reached. This is a convenient way to suspend execution at a line without setting a breakpoint. Jump to the line selected in the Disassembly view. Resume program execution from the line selected in the Disassembly view. Context menu Context menu Context menu

CooCox CoIDE UserGuide Version: 1.2.2 2011-3-4 page 115 3.4.2 Breakpoints View The Breakpoints View lists all the breakpoints you have set in your workspace. Only up to six breakpoints can be toggled if you are debugging in flash with Cortex-M3 series' chips, for Cortex-M0, the number is four. Otherwise, warnings will be presented at runtime. You can double-click a breakpoint to find its location in the editor (if applicable). You can also enable or disable breakpoints, delete them, add new ones. The commands available in the Breakpoints View Command Name Description Availability Remove Selected Breakpoints Remove All BreakPpoints Go to File Only removes the selected breakpoint(s). Removes all breakpoints. Goes to the corresponding location of the breakpoint in the java editor. Context menu and view action Context menu and view action Context menu and view action Skip All Sets all breakpoints to be skipped. View action Expand All Expands all of the items in the view. View action Collapse All Collapses all of the items in the view. View action Link with View Add Watchpoint (C/C++)... Changes if the breakpoints should be linked to the Debug View. Add watchpoints (Not supported by the current version. It will be supported in the future versions.) View action View action Show full paths Show the full paths of the breakpoints. View action Group By... Select default Working Sets... Deselect Default Working Set Allows you to select an alternate grouping for your breakpoints or create your own. Select the default working set so that the new breakpoints will be added into this working set. Deselect the default working set so that the new breakpoints will not be added into any working set. View action View action View action

CooCox CoIDE UserGuide Version: 1.2.2 2011-3-4 page 116 Working Sets... Opens the working sets dialog. View action Enable Change the selected breakpoint(s) to be enabled. Context menu Disable Change the selected breakpoint(s) to be disabled. Context menu Select All Selects all of the breakpoints in the view. Context menu Copy Copies the selected breakpoints to the system clipboard. Context menu Paste Pastes copied breakpoints into the view. Context menu Import Breakpoints... Export Breakpoints... Breakpoint Properties... Opens the import breakpoints wizard. Opens the export breakpoints wizard. Opens the breakpoints properties dialog. Context menu Context menu Context menu

CooCox CoIDE UserGuide Version: 1.2.2 2011-3-4 page 117 3.4.3 Registers view The Registers view of the Debug perspective lists information about the registers in a selected stack frame. You can view information about the registers in a selected stack frame. Values that have changed are highlighted in the Registers view when your program stops. Registers view toolbar icons: The table below lists the icons displayed in the Registers view toolbar: Command Name Description Show Type Name Show logic structure Configure columns to show type names (unavailable when columns are displayed). Show logic structure of the registers. Collapse All Layout Collapse all the registers. Provides multiple layout options for the Registers view. Registers view context menu commands: The Registers view context menu commands include:

CooCox CoIDE UserGuide Version: 1.2.2 2011-3-4 page 118 Command Name Description Select All Copy Registers Enable Select all the editor content. Copies the register names and contents to the clipboard. Enables the selected register. Disable Format Find... Change Value... Add Register Group Restore Default Register Groups Edit Register Group Remove Register Group Add Watchpoint (C/C++)... Watch Disables the selected register. Select a format type. Choices include: BInary, Decimal, Natural, and hexadecimal. Open the Find dialog which allows you to find specific elements within the view. Open the Set Value dialog to change the selected registers value. Open the Register Group dialog which allows you to define a register group that is shown in the Registers view. Restores the original register groups. Open the Register Group dialog to edit the selected register group. Removes the currently selected register group. Add watchpoints(not supported by the current version. It will be supported in the future versions.). Converts the selected register into a watch expression.

CooCox CoIDE UserGuide Version: 1.2.2 2011-3-4 page 119 3.4.4 Memory View The Memory view of the Debug perspective lets you monitor and modify your process memory. Memory can be displayed in different predefined data formats -- memory renderings. The CoIDE supports five rendering types -- hexadecimal (default), ascii, signed integer and unsigned integer. The Memory view can display and modify the value of selected memory address. The Rendering pane can be configured to display more than two renderings simultaneously. Memory view toolbar icons: The table below lists the icons displayed in the Memory view toolbar. Command Name Description New Tab Click to create a new memory view. Go Shows the Memory value of the slectected address. Import Import memory view from different kinds of files. Export Export memory to different kinds of files. Default Rendering Select default rendering Find/Replace Find or replace value from the Rendering pane. Find next Find next one after the command:find/replace. Memory view context menu: The context menu inside the Memory view includes: Command Name Description

CooCox CoIDE UserGuide Version: 1.2.2 2011-3-4 page 120 Panes Endian Text Cell Size Radix Columns Update Mode Copy To Clipboard Copy Address Reset To Base Address Enable or disable the showing of the Address, Binary, and Text portions of the rendering view. Toggle between the Little (default) and Big Endian display of memory. Choose the character encoding used to convert memory values into text for display. Choices include: ISO-8859-1 (default), US-ASCII, or UTF-8. Specify the cell size used to display values in the Binary column. Choices include: 1, 2, 4 (default), and 8 bytes. Specify the radix used to display the values in the Binary column. Choices include: Hex, Decimal Signed, Decimal Unsigned (default), Octal, and Binary. Specify the number of columns in the Binary column. Select the update mode of the Rendering pane:always,on Breakpoints,or Manual Copies the selected portion of the Rendering pane to the clipboard. Copies the address of the selected portion in the Rendering pane to the clipboard. Resets the Rendering pane to the original base address. Refresh Refreshes the Rendering pane.

CooCox CoIDE UserGuide Version: 1.2.2 2011-3-4 page 121 3.4.5 Variables View The Variables View displays information about the variables associated with the stack frame selected in the Debug View. When debugging a C/C++ program, data that contains variables can be expanded to show the variables and the fields the variables contain. You can view information about the variables in a selected stack frame in the Variables view. When execution stops, the changed values are by default highlighted. Like the other debug-related views, the Variables view does not refresh as you run your executable. A refresh occurs when execution stops. The Variables View, shown with columns: The commands available in the Variables View: Command Name Description Availability Show Type Name Configure columns to show type names. view action Show logic structure Show logic structure of the Variables. view action Collapse All Collapse all the Variables. view action Add Globle Variables Remove Globle Variables Remove All Globle Variables Add Globle Variables. Remove Globle Variables. Remove All Globle Variables. Context menu and view action Context menu and view action Context menu and view action Select All Selects all of the variables in the view. Context menu Copy Variables Copies the selected variables to the system clipboard. Context menu Enable Enables a currently disabled variable. Context menu Disable Disables a currently enabled variable. Context menu

CooCox CoIDE UserGuide Version: 1.2.2 2011-3-4 page 122 Cast To Type Cast To Type Context menu Display As Array Display As Array. Context menu View Memory Format Find... Change Value... Add Watchpoint(C/C++) Watch Allows you to create a memory monitor for the selected variable. Select a format type. Choices include: BInary, Decimal, Natural, and hexadecimal. Opens the search dialog to find elements in the variables view. Allows you to change the value for the underlying selected variable. Add Watchpoint(C/C++). Allows you to create a watch expression for the selected variable. Context menu Context menu Context menu Context menu Context menu Context menu

CooCox CoIDE UserGuide Version: 1.2.2 2011-3-4 page 123 3.4.6 Expressions view An expression is a snippet of code which can be evaluated to produce a result. The context for an expression depends on the particular debug model. Some expressions may need to be evaluated at a specific location in the program so that the variables can be referenced. You can view information about expressions in the Expressions view. You can inspect expressions from a scrapbook page, a stack frame of a suspended thread, and other places. The Expressions View opens automatically when an item is added to the view. When debugging a C/C++ program, data that contains variables can be expanded to show the variables and the fields of the variables. The commands available in the Expressions View: Command Name Description Availability Show Type Name Configure columns to dispaly type names. view action Show logic structure Show logic structure of the Expressions. view action Collapse All Collapse all the Expressions. view action Add Watch Expression Remove Remove All Allows you to add a watch expression. Removes the currently selected expression(s) from the view. Removes all of the expressions from the view. Context menu and view action Context menu and view action Context menu and view action Select All Selects all of the variables in the view. Context menu Copy Expressions Find... Copies the selected expressions and variables to the system clipboard. Opens the search dialog to find elements in the variables view. Context menu Context menu Disable Disables a currently enabled expression. Context menu Enable Enables a currently disabled expression. Context menu Edit Watch Expression Allows you to edit exsiting watch expression. Context menu Reevaluate Expression Format Reevaluates the currently selected expression. Select a format type. Choices include: Binary, Decimal, Natural, and Hexadecimal. Context menu Context menu

CooCox CoIDE UserGuide Version: 1.2.2 2011-3-4 page 124 3.4.7 Debug View 1. The Debug view shows the target debugging information in a tree hierarchy. 2. The number beside the thread label is a reference counter, not a thread identification number. 3. The CDT displays stack frames as child elements. It displays the reason for the suspension beside the thread, (such as end of stepping range, breakpoint hit, and signal received). When a program exits, the exit code is displayed. Debug view context menu commands: Icons Name Description Remove All Terminated Drop To Frame Use Step Filters Copy Stack Find... Step Into Step Over Step Out Instruction Stepping Mode Resume Suspend Terminate Clears all terminated processes in Debug view Select the Drop to Frame command to re-enter the selected stack frame in the Debug view. Toggles step filters on/off. When on, all step functions apply step filters. Copies the selected stack of suspended threads as well as the state of the running threads to the clipboard. Opens the debug view element searching dialog. Select to execute the current line, including any routines, and proceed to the next statement. Select to execute the current line, following execution inside a routine. Select to continue execution to the end of the current routine, then follow execution to the routine s caller. Activate to enable instruction stepping mode to examine a program as it steps into disassembled code. Select the Resume command to resume execution of the currently suspended debug target. Select the Suspend command to halt execution of the currently selected thread in a debug target. Ends the selected debug session and/or process. The impact of this action depends on the type of the item

CooCox CoIDE UserGuide Version: 1.2.2 2011-3-4 page 125 selected in the Debug view. Terminate and Relaunch Relaunch Edit... Edit Source Lookup... Lookup Source Terminate and Remove Terminate/Disconnect All Properties Select the Terminate and Relaunch command to terminate the selected debug target and then relaunch it. This command relaunches the selected debug target. Opens the launch configuration dialog, allowing you to make changes. Opens the source lookup dialog, allowing you to make changes. Select to force a source lookup to take place. Terminates the selected debug target and removes it from the view. Terminates all active launches in the view. Opens the Properties for window showing the process properties.

CooCox CoIDE UserGuide Version: 1.2.2 2011-3-4 page 126 3.4.8 Peripherals View (CoAssistant) The Peripherals View can be used to view and Modify the vaule of Peripherals' registers.values that have changed are highlighted in the Peripherals view when your program stops. To use CoAssitant in CoIDE, you only need to perform the following steps: 1. Click Peripherals under the View menu.

CooCox CoIDE UserGuide Version: 1.2.2 2011-3-4 page 127 2. CoIDE will open the Peipherals View.

CooCox CoIDE UserGuide Version: 1.2.2 2011-3-4 page 128 3. Click the name of Peripheral to view the base address and description for this peripheral.

CooCox CoIDE UserGuide Version: 1.2.2 2011-3-4 page 129 4. Click "+" to show the register list and view the value of these registers.

CooCox CoIDE UserGuide Version: 1.2.2 2011-3-4 page 130 5. The Register that have changed are highlighted in in the Peripherals view.

CooCox CoIDE UserGuide Version: 1.2.2 2011-3-4 page 131 6. Click the name of Register to open the detail information view.

CooCox CoIDE UserGuide Version: 1.2.2 2011-3-4 page 132 7. In this view, you can get the description, RW access, address offset and the reset value of the register.

CooCox CoIDE UserGuide Version: 1.2.2 2011-3-4 page 133 8. You can modify the value of register when you debug a project.

CooCox CoIDE UserGuide Version: 1.2.2 2011-3-4 page 134 4. C/C++ Views 4.1 Project Explorer View The Project Explorer view displays in a tree structure similar to the C/C++ Projects view, but it is not limited to C and C++ projects. In this view you can do the following things: Browse the elements of C/C++ source files Open files in the editor view Manage existing files (copy, paste, delete, refresh) Restore deleted files from local history Files that you selected in the Project Explorer view affect the information which display in other views. Toolbar: Icon Name Description Top Level Elements Select Working Set Deselect Working Set Choose whether to show working sets or projects as top level elements. Choosing working sets allows easy grouping of projects in large workspaces. Opens the Select Working Set dialog to allow selecting a working set for the view. Deselects the current working set.

CooCox CoIDE UserGuide Version: 1.2.2 2011-3-4 page 135 Edit Active Working Set Customize View Link with Editor Opens the Edit Working Set dialog to allow changing the current working set. This command allows customization of view filters and content modules. The previous will allow you to supress the display of certain types of files while the later will allow entirely new types of content to be shown in the view. This command toggles whether the view selection is linked to the active editor. When this option is selected, changing the active editor will automatically update the selection to the resource being edited. Project Explorer view icons: Icon Description C or C++ file Class Macro Definition Enum Enumerator Variable Field private Field protected Field public Include Makefile Method private Method protected Method public Namespace Struct

CooCox CoIDE UserGuide Version: 1.2.2 2011-3-4 page 136 Type definition Union Function

CooCox CoIDE UserGuide Version: 1.2.2 2011-3-4 page 137 4.2 Outline View The Outline view displays an outline of a structured C/C++ file that is currently open in the editor area, by listing the structural elements. Outline view toolbar icons: The table below lists the icons displayed in the Outline view toolbar Icon Description Sort items alphabetically Hide Fields Hide Static Members Hide Non-Public Members Hide Inactive Elements Outline view menu Outline view icons: The table below lists the icons displayed in the Outline view.

CooCox CoIDE UserGuide Version: 1.2.2 2011-3-4 page 138 Icon Description Class Namespace Macro Definition Enum Enumerator Variable Field private Field protected Field public Include Method private Method protected Method public Struct Type definition Union Function

CooCox CoIDE UserGuide Version: 1.2.2 2011-3-4 page 139 4.3 Console View This view shows the output of the execution of your program and enables you to enter input for the program. The console shows three different kinds of text, each is in a different color, default as follows: Black: Standard output Red: Standard error Green: Standard input You can choose the different colors for these kinds of text in the preferences pages (Window > Preferences > Debug > Console). Console View Context Menu: When you right-click in the Console view (or when you press Shift+F10 when the focus is on the Console view), you could see the following options: Edit options: Cut, Copy, Paste, and Select All These options perform the standard edit operations. Which options are available depends on where the focus is in the Console view. For example, you cannot paste text into the program output, but you can paste text to the bottom of the file. Find/Replace Open a Find/Replace dialog, which operate only on the text in the Console view. Console View Toolbar: Icon Command Description Pin Console Forces the Console view to remain on top of other views in the window area.

CooCox CoIDE UserGuide Version: 1.2.2 2011-3-4 page 140 Display Selected Console Open Console If multiple consoles are open, you can select the one to display from a list. Open new console view. Clear Console Clears the console. Scroll Lock Show Console When Standard Out Changes Show Console When Standard Error Changes Toggles the Scroll Lock. Show console when standard out changes. Show console when standard error changes.

CooCox CoIDE UserGuide Version: 1.2.2 2011-3-4 page 141 4.4 Search View Any matches are reported in the Search view: When you have completed a search and have results in the Search view, you can put the focus on that view and get more options on the Search menu. A C/C++ search can also be conducted via the context menu of selected resources and elements in the following views: Outline view Search result view The search context menu is also available in the C/C++ editor. The search is only performed if the currently selected text can be resolved to a C/C++ element. The type of the selected C/C++ element defines which search context menus are available. The C/C++ editor does not constrain the list of available C/C++ searches based on the selection. Search view Toolbar: Icon Command Description Next Navigates to the next search result. Previous Remove the Selected Matches Remove All Matches Navigates to the previous search result. Removes user selected matches from the search console. Clears the search console. Run the Current Search Again Run the current search again. Terminate Terminates the current search.

CooCox CoIDE UserGuide Version: 1.2.2 2011-3-4 page 142 Show Previous Searches Pin the Search View Menu Minimize Console Shows the list of previously run searches which can be reselected. Forces the search view to remain on top of other views in the window area. Lists two selectable view layouts for search results: Flat and Heirarchical. Minimizes the Console view. Maximize Console Maximizes the Console view.

CooCox CoIDE UserGuide Version: 1.2.2 2011-3-4 page 143 4.5 Editor View The C/C++ editor provides specialized features for editing C/C++ related files. Associated with the editor is a C/C++-specific Outline view, which shows the structure of the active C, C++. It will update when you edit these files. The editor includes the following features: 1. Syntax highlighting 2. Content/code assist 3. Integrated debugging features The most common way to invoke the C/C++ editor is to open a file from the Project Explorer by clicking the file (single or double-click depending on the user preferences). The C/C++ editor does not contain a toolbar itself, but relies on the use of the context menu (right click your mouse in the editor view, the context menu will be presented) and key binding actions.

CooCox CoIDE UserGuide Version: 1.2.2 2011-3-4 page 144 4.6 Help Contents You can get CoIDE's version information from the Help menu, also you can get its User guide from this menu. 1. You can open the help contents by clicking Help Contents under the Help menu.

CooCox CoIDE UserGuide Version: 1.2.2 2011-3-4 page 145 2. You fill find help contents shown in a new window.

CooCox CoIDE UserGuide Version: 1.2.2 2011-3-4 page 146 3. The Content view shows the topic of the Help Content.

CooCox CoIDE UserGuide Version: 1.2.2 2011-3-4 page 147 4. Open the Index view to search the topic.

CooCox CoIDE UserGuide Version: 1.2.2 2011-3-4 page 148 5. Open the Search Results view to search a string in the content.

CooCox CoIDE UserGuide Version: 1.2.2 2011-3-4 page 149 6. Open the Bookmarks view to manage your bookmark.

CooCox CoIDE UserGuide Version: 1.2.2 2011-3-4 page 150 Toolbar Actions Icon Name Description position Go Back Go back to the previous position. Toolbar Go Forward to Forward to the next position. Toolbar Home Show in table of content Go to the home page of the Help content. Show the page position in the table of content view. Toolbar Toolbar Bookmark Document Add a bookmark. Toolbar Print Page Print the current page. Toolbar Print Topics Print the topics. Contents View Search Topics Search the topics. Contents View Collapse All Collapse all the topics. Contents View Link with contents Link with the contents. Contents View Show Rerult Categories Show Rerult Description Show the categories of the search rerults. Show the description of the search rerults. Search Results View Search Results View Delete Selected Bookmark Delete the selected bookmark. Bookmark View Delete All Bookmark Delete all the bookmark. Bookmark View