0% found this document useful (0 votes)
283 views150 pages

CooCox - User Guide

This document is a user guide for CooCox CoIDE, a free IDE for ARM Cortex M3 and M0 development. It provides instructions on how to quickly get started using CoIDE to create an embedded application by selecting a manufacturer, chip, and components to build a new project. The guide then covers key aspects of using CoIDE like the user interface, project management, debugging tools, and C/C++ views.

Uploaded by

07et842
Copyright
© © All Rights Reserved
We take content rights seriously. If you suspect this is your content, claim it here.
Available Formats
Download as PDF, TXT or read online on Scribd
0% found this document useful (0 votes)
283 views150 pages

CooCox - User Guide

This document is a user guide for CooCox CoIDE, a free IDE for ARM Cortex M3 and M0 development. It provides instructions on how to quickly get started using CoIDE to create an embedded application by selecting a manufacturer, chip, and components to build a new project. The guide then covers key aspects of using CoIDE like the user interface, project management, debugging tools, and C/C++ views.

Uploaded by

07et842
Copyright
© © All Rights Reserved
We take content rights seriously. If you suspect this is your content, claim it here.
Available Formats
Download as PDF, TXT or read online on Scribd
You are on page 1/ 150

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 Create a new file.

New Folder Create a new folder.

Open File... Open a file.

Save the content of the current editor. Disabled if the editor does not
Save Ctrl + S
contain unsaved changes.

Save As... Save the content of the current editor under a new name.

Save the content of all editors with unsaved changes. Disabled if no


Save All Ctrl + Shift + S
editor contains unsaved changes.

Exit Exit CoIDE.

View Menu Actions

Name Description Shortcut

Repository Open Repository View.

Help Open Help View.

Outline Open Outline View.

Peripherals Open Peripherals View.

Breakpoints Open Breakpoints View.

Project Menu Actions

Name Description Shortcut

New Project Create a new Project and close the current project.

Open 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 Save the current project under a new location.

Close Project Close the current project.

Open the current project configuration page (Open builder.xml


Configuration
of the current project in Editor).
Build the currently selected project. This is an incremental build,
Build meaning that the builder analyzes the changes since the last F7
time of build and minimizes the number of changed files.

Rebuild Rebuild all files of the current project. Ctrl + R

Clean Clean the intermediate files that generated by building.

Upload Open the Login dialog box, you can upload Component after
Component login with coocox account.

Flash Menu Actions

Name Description Shortcut

Program Download Download program to flash.

Flash Erase 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 To set a breakpoint at the entry of current function.

Toggle Watch Breakpoint To set a Watch Breakpoint.

Skip All Breakpoints Skip all the Breakpoints when dubugging.

Remove All Breakpoints 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 CoIDE Users' Guide.

About CoIDE 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 a new Project and close the current project.

Create New File Create a new file.

Save the content of the current editor. Disabled if the


Save Ctrl + S
there is no changed.
Build the currently selected project. This is an
incremental build, meaning that the builder analyzes
Build F7
the changes since the last time of build and minimizes
the number of changed files.

Rebuild Rebuild all files of the current project. Ctrl + R

Start Debug. To debug the current project. Ctrl + F5

Debug Configuration To do configuration for debugging.

Download Code to Flash Download program to flash.

Flash Erase Erase the full chip.

Repository 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:

Keyboard
Icons Action Description
shortcut

Reset Select the Reset command to reset the debugging.


Select the Run command to resume execution of the currently
Run F5
suspended debug target.
Select the Suspend command to halt execution of the currently
Suspend F9
selected thread in a debug target.
Ends the selected debug session and/or process. The impact of this
Terminate Ctrl + F5
action depends on the type of the item selected in the Debug view.
Select to execute the current line, including any routines, and
Step Into F11
proceed to the next statement.
Select to execute the current line, following execution inside a
Step Over F12
routine.
Select to continue execution to the end of the current routine, then
Step Out F7
follow execution to the routine's caller.

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 will display in the marker bar and
in the Breakpoints View, along with the name of the associated file.

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

Resumes program execution until the specific line is


Run To Line reached. This is a convenient way to suspend execution Context menu
at a line without setting a breakpoint.

Move to
Jump to the line selected in the Disassembly view. Context menu
Line

Resume At Resume program execution from the line selected in the


Context menu
Line Disassembly view.
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 Context menu


Only removes the selected breakpoint(s).
Breakpoints and view action
Remove All Context menu
Removes all breakpoints.
BreakPpoints and view action
Goes to the corresponding location of the Context menu
Go to File
breakpoint in the java editor. 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

Changes if the breakpoints should be linked to


Link with View View action
the Debug View.
Add watchpoints (Not supported by the current
Add Watchpoint
version. It will be supported in the future View action
(C/C++)...
versions.)

Show full paths Show the full paths of the breakpoints. View action

Allows you to select an alternate grouping for


Group By... View action
your breakpoints or create your own.
Select default Select the default working set so that the new
View action
Working Sets... breakpoints will be added into this working set.
Deselect the default working set so that the new
Deselect Default
breakpoints will not be added into any working View action
Working Set
set.
CooCox CoIDE UserGuide Version: 1.2.2 2011-3-4 page 116

Working Sets... Opens the working sets dialog. View action

Change the selected breakpoint(s) to be


Enable Context menu
enabled.
Change the selected breakpoint(s) to be
Disable Context menu
disabled.
Select All Selects all of the breakpoints in the view. Context menu
Copies the selected breakpoints to the system
Copy Context menu
clipboard.

Paste Pastes copied breakpoints into the view. Context menu

Import
Opens the import breakpoints wizard. Context menu
Breakpoints...
Export
Opens the export breakpoints wizard. Context menu
Breakpoints...
Breakpoint
Opens the breakpoints properties dialog. Context menu
Properties...
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

Configure columns to show type names (unavailable


Show Type Name
when columns are displayed).

Show logic structure Show logic structure of the registers.

Collapse All Collapse all the registers.

Provides multiple layout options for the Registers


Layout
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 Select all the editor content.

Copies the register names and contents to the


Copy Registers
clipboard.

Enable Enables the selected register.

Disable Disables the selected register.

Select a format type. Choices include: BInary,


Format
Decimal, Natural, and hexadecimal.
Open the Find dialog which allows you to find specific
Find...
elements within the view.
Open the Set Value dialog to change the selected
Change Value...
registers value.
Open the Register Group dialog which allows you to
Add Register Group define a register group that is shown in the Registers
view.
Restore Default Register
Restores the original register groups.
Groups
Open the Register Group dialog to edit the selected
Edit Register Group
register group.

Remove Register Group Removes the currently selected register group.

Add watchpoints(Not supported by the current


Add Watchpoint (C/C++)...
version. It will be supported in the future versions.).
Converts the selected register into a watch
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

Enable or disable the showing of the Address, Binary,


Panes
and Text portions of the rendering view.
Toggle between the Little (default) and Big Endian
Endian
display of memory.
Choose the character encoding used to convert memory
Text 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
Cell Size
column. Choices include: 1, 2, 4 (default), and 8 bytes.
Specify the radix used to display the values in the Binary
Radix column. Choices include: Hex, Decimal Signed, Decimal
Unsigned (default), Octal, and Binary.

Columns Specify the number of columns in the Binary column.

Select the update mode of the Rendering


Update Mode
pane:Always,On Breakpoints,or Manual
Copies the selected portion of the Rendering pane to the
Copy To Clipboard
clipboard.
Copies the address of the selected portion in the
Copy Address
Rendering pane to the clipboard.

Reset To Base Address 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

Context menu and


Add Globle Variables Add Globle Variables.
view action
Remove Globle Context menu and
Remove Globle Variables.
Variables view action
Remove All Globle Context menu and
Remove All Globle Variables.
Variables view action

Select All Selects all of the variables in the view. Context menu

Copies the selected variables to the


Copy Variables Context menu
system clipboard.

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

Allows you to create a memory monitor for


View Memory Context menu
the selected variable.
Select a format type. Choices include:
Format BInary, Decimal, Natural, and Context menu
hexadecimal.
Opens the search dialog to find elements
Find... Context menu
in the variables view.
Allows you to change the value for the
Change Value... Context menu
underlying selected variable.
Add
Add Watchpoint(C/C++). Context menu
Watchpoint(C/C++)
Allows you to create a watch expression
Watch Context menu
for the selected variable.
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

Context menu
Add Watch Expression Allows you to add a watch expression.
and view action
Removes the currently selected expression(s) Context menu
Remove
from the view. and view action
Context menu
Remove All Removes all of the expressions from the view.
and view action

Select All Selects all of the variables in the view. Context menu

Copies the selected expressions and variables


Copy Expressions Context menu
to the system clipboard.
Opens the search dialog to find elements in the
Find... Context menu
variables view.

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
Reevaluates the currently selected expression. Context menu
Expression
Select a format type. Choices include: Binary,
Format Context menu
Decimal, Natural, and Hexadecimal.
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 Clears all terminated processes in Debug view

Select the Drop to Frame command to re-enter the


Drop To Frame
selected stack frame in the Debug view.
Toggles step filters on/off. When on, all step functions
Use Step Filters
apply step filters.
Copies the selected stack of suspended threads as well as
Copy Stack
the state of the running threads to the clipboard.

Find... Opens the debug view element searching dialog.

Select to execute the current line, including any routines,


Step Into
and proceed to the next statement.
Select to execute the current line, following execution
Step Over
inside a routine.
Select to continue execution to the end of the current
Step Out
routine, then follow execution to the routine’s caller.
Activate to enable instruction stepping mode to examine
Instruction Stepping Mode
a program as it steps into disassembled code.
Select the Resume command to resume execution of the
Resume
currently suspended debug target.
Select the Suspend command to halt execution of the
Suspend
currently selected thread in a debug target.
Ends the selected debug session and/or process. The
Terminate
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.

Select the Terminate and Relaunch command to


Terminate and Relaunch
terminate the selected debug target and then relaunch it.

Relaunch This command relaunches the selected debug target.

Opens the launch configuration dialog, allowing you to


Edit...
make changes.
Opens the source lookup dialog, allowing you to make
Edit Source Lookup...
changes.

Lookup Source Select to force a source lookup to take place.

Terminates the selected debug target and removes it


Terminate and Remove
from the view.
Terminate/Disconnect All Terminates all active launches in the view.
Opens the Properties for window showing the process
Properties
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

Choose whether to show working sets or projects as top level


Top Level Elements elements. Choosing working sets allows easy grouping of
projects in large workspaces.
Opens the Select Working Set dialog to allow selecting a
Select Working Set
working set for the view.

Deselect Working Set Deselects the current working set.


CooCox CoIDE UserGuide Version: 1.2.2 2011-3-4 page 135

Opens the Edit Working Set dialog to allow changing the


Edit Active Working Set
current working set.
This command allows customization of view filters and content
modules. The previous will allow you to supress the display of
Customize View
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
Link with Editor
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

Forces the Console view to remain on top of other


Pin Console
views in the window area.
CooCox CoIDE UserGuide Version: 1.2.2 2011-3-4 page 140

If multiple consoles are open, you can select the one


Display Selected Console
to display from a list.

Open Console Open new console view.

Clear Console Clears the console.

Scroll Lock Toggles the Scroll Lock.

Show Console When


Show console when standard out changes.
Standard Out Changes
Show Console When
Show console when standard error changes.
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 Navigates to the previous search result.

Removes user selected matches from the search


Remove the Selected Matches
console.

Remove All Matches 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

Shows the list of previously run searches which can


Show Previous Searches
be reselected.
Forces the search view to remain on top of other
Pin the Search View
views in the window area.
Lists two selectable view layouts for search results:
Menu
Flat and Heirarchical.

Minimize Console 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

Go to the home page of the Help


Home Toolbar
content.
Show the page position in the table of
Show in table of content Toolbar
content view.

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 the categories of the search Search Results


Show Rerult Categories
rerults. View
Show the description of the search Search Results
Show Rerult Description
rerults. View

Delete Selected Bookmark Delete the selected bookmark. Bookmark View

Delete All Bookmark Delete all the bookmark. Bookmark View

You might also like