JumpStart C++ for Cortex
<!-- If the browser does not support frames put the first topic content here --> <div class="WordSection1"> <p class="MsoTitle" align="center" style='text-align:center'> JumpStart Embedded Tools for Cortex User Guide</p> <p class="MsoNormal" align="center" style='text-align:center'> <a name="_Hlk535514367">Version 1.22 2019/07/08</a></p> <p class="MsoNormal" align="center" style='text-align:center'> Copyright © 2018-2019</p> <p class="MsoNormal" align="center" style='text-align:center'> <a href="mailto:info@imagecraft.com"><span style= 'color:#1155CC'>info@imagecraft.com</span></a></p> <p class="MsoNormal" align="center" style='text-align:center'> <a href="https://imagecraft.com/"><span style= 'color:#1155CC'>https://imagecraft.com</span></a></p> <p class="MsoNormal" align="center" style='text-align:center'> </p> <p class="MyBody">This is the user guide for ImageCraft’s JumpStart Embedded Tools for Cortex product.</p> <p class="MsoNormal" align="center" style='text-align:center'> </p> <span style= 'font-size:11.0pt;line-height:115%;font-family:"Arial",sans-serif'><br clear="all" style='page-break-before:always' /></span> <p class="MsoNormal"> </p> <p class="MsoNormal" align="center" style='text-align:center'> </p> </div>
Contents
Topics
Search
JumpStart C++ for Cortex
EULA AND ADMINISTRATIVA
End User License Agreement
LIMITED WARRANTY
Licensing the Software
Re-Licensing
Using the Software on Multiple Computers
Transferring a License to Another Computer
Maintenance Purchase and Version Upgrades
Using the Hardware Dongle
Installing Dongle Driver
Win8 / Win10 Unsigned Driver Hack
Upgrading a Dongle License
Transferring a Software License to a Dongle
Support
INTRODUCTION
What is JumpStart Embedded Tools for Cortex
Why ImageCraft’s JumpStart Embedded Tools?
Overview of JumpStart Embedded Tools for Cortex
Features at A Glance
Operating System Requirements
Downloading and Installing
Demo, Non-Commercial, and Standard Compiler Editions
Choosing C, or C++?
Using C and C++ Together
In a C++ file:
In a C file
Where is the C/C++ Language Manual?
What Does a Compiler Do Anyway?
GCC Version
IDE OVERVIEW AND REFERENCES
Overview
Features of the CodeBlocks IDE
“Views” and Perspectives
Visual Components of the IDE
Toolbar Management
Debugging, Downloading, and Semihosting
Projects, Targets, and Workspace
Project
Menu and Popup Shortcuts
Project Files
Source Files
Project File Directories
Targets
Active Target
Workspace
Project Build Options
Default Options
Build Target
Paths
Compiler/Linker
Compiler Options
Linker Options
Linker Libs
Additional Options
Device Target Options
Floating Point Options
Nanolib vs. Newlib
Output Files
Project Properties
Project Dependencies
Build Targets
Project Debug / Download Options
Cortex Debug/Download Interface
Debugger Behaviors Tab
Cortex-M MCU Support
IDE and Compiler
File Properties
General Tab
Build Tab
Advanced Tab
USING THE CODEBLOCKS IDE
Creating a New Project
Wizard-Generated Files
Best Way to Create a New Project
Project Importers
ST CubeMX Importer
ImageCraft JumpStart C Project Import
Other Project Tasks
Opening a Project
Adding Include Files to a Project
Inter-project Dependencies in a Workspace
Renaming a Project
Cloning a Project
Saving a Project as an Archive
“Reparsing” a Project
Building a Project
Warning and Error Messages
Output File Memory Usage
Some Hints About Building Projects
Avoid Using the Same Output Directory for Multiple Targets or Projects
Building ST’s Library Files
Autosaving Changed Files
Improving Build Time
Changing the Order of File Building
“Cannot Create Process…” Build Error
Using Third-Party Libraries
Using JumpStart Embedded Tools Import Wizards
Source Code Libraries
Binary Libraries
Linker Memory File
Specifying the Heap and Stack Sizes
Memory Problems
Downloading to the Target MCU
Installing the USB Drivers
Editors
Syntax Highlighting Pitfall
Code Browsing and Other Productivity Aids
Mouse Hovering
Autocomplete
Code References
Bookmarks
Code Browsing
CodeBlocks Plugin
Enabling Plugins
AStyle Source Code Formatter
Browse Tracker
Mouse Actions
Browse Tracker Toolbar Icons
Drag Scroll
Key Binder
Doxy Blocks
Auto Versioning
Code Stat
Hex Editor
Smart Indent
CodeBlocks Built-in Variables (Macros)
Program Environment
CodeBlocks Workspace
Files and directories
Build targets
Language and encoding
Random values
Operating System Commands
JUMPSTART DEBUGGER (JDB)
JDB Overview
Debug Pod Support
USB Drivers
Basic Concepts
Invoking the Debugger
“Break” and Stop Debugger
Reset Target
CodeBlocks Debugger Functions
Breakpoints
Source Line Stepping
Call Stack
Variable Watching
“Quick Watching” A Variable
Advanced Debug Toolbar (ADT) Functions
Core (CPU) Register View
Code View
Peripheral (I/O Register) View
Memory View
Simple Trace or "Poor Man’s" Trace
Semihosting
Putting printf in Your Program Under Semihosting
Other “Behind the Scenes” Work
Debugger Issues
General Support Guidelines
Log files
JDB not starting
Recovering from a Debugger Crash
PROGRAMMING THE CORTEX-M MCU
Cortex-M MCU Architectures
Major Cortex-M Variants
GCC ARM Cortex-M Specific Information
CPU Options
Floating Point Options
C Libraries: Nanolib vs. Newlib
QFPLib Floating Point Library
CMSIS (Cortex Microcontroller Software Interface Standard)
System Initialization
Vendor SDK
Directory Structures
Supported Vendors
How to Use
Cortex-M Interrupt Architecture
Cortex-M Base Interrupts
The Interrupt Vector Table
Vendor Device-Specific Interrupts
Priority Level
NVIC
Disabling and Enabling of Interrupts
SYSTICK Interrupt
Interrupt Vector Table and Interrupt Handlers
Interrupt Vector Table
Writing an Interrupt Handler
Example of Adding an Interrupt Handler
GCC Weak Attribute
The Startup File
Retargeting printf
Using time.h C Library Functions
Running a Function From SRAM
JumpStart API
Using ST HAL or SPL with JSAPI
Active Target
Adding Include Files to a Project
Additional Options
Advanced Debug Toolbar (ADT) Functions
Advanced Tab
AStyle Source Code Formatter
Auto Versioning
Autocomplete
Autosaving Changed Files
Avoid Using the Same Output Directory for Multiple Targets or Projects
Basic Concepts
Best Way to Create a New Project
Binary Libraries
Bookmarks
Breakpoints
Browse Tracker Toolbar Icons
Browse Tracker
Build Tab
Build Target
Build Targets
Build targets
Building a Project
Building ST’s Library Files
C Libraries: Nanolib vs. Newlib
Call Stack
Changing the Order of File Building
Choosing C, or C++?
Cloning a Project
CMSIS (Cortex Microcontroller Software Interface Standard)
Code Browsing
Code References
Code Stat
Code View
Code Browsing and Other Productivity Aids
CodeBlocks Debugger Functions
CodeBlocks Plugin
CodeBlocks Built-in Variables (Macros)
CodeBlocks Workspace
Compiler Options
Compiler/Linker
Core (CPU) Register View
Cortex Debug/Download Interface
Cortex-M Base Interrupts
Cortex-M Interrupt Architecture
Cortex-M MCU Architectures
Cortex-M MCU Support
CPU Options
Creating a New Project
Debug Pod Support
Debugger Behaviors Tab
Debugger Issues
Debugging, Downloading, and Semihosting
Default Options
Demo, Non-Commercial, and Standard Compiler Editions
Device Target Options
Directory Structures
Disabling and Enabling of Interrupts
Downloading and Installing
Downloading to the Target MCU
Doxy Blocks
Drag Scroll
Editors
Enabling Plugins
End User License Agreement
EULA AND ADMINISTRATIVA
Example of Adding an Interrupt Handler
Features at A Glance
Features of the CodeBlocks IDE
File Properties
Files and directories
Floating Point Options
Floating Point Options
GCC ARM Cortex-M Specific Information
GCC Version
GCC Weak Attribute
General Support Guidelines
General Tab
Hex Editor
How to Use
IDE and Compiler
IDE OVERVIEW AND REFERENCES
ImageCraft JumpStart C Project Import
Improving Build Time
In a C file
In a C++ file:
Installing the USB Drivers
Installing Dongle Driver
Inter-project Dependencies in a Workspace
Interrupt Vector Table and Interrupt Handlers
Interrupt Vector Table
INTRODUCTION
Invoking the Debugger
JDB not starting
JDB Overview
JumpStart API
JumpStart C++ for Cortex
JUMPSTART DEBUGGER (JDB)
Key Binder
Language and encoding
Licensing the Software
LIMITED WARRANTY
Linker Libs
Linker Memory File
Linker Options
Log files
Maintenance Purchase and Version Upgrades
Major Cortex-M Variants
Memory View
Memory Problems
Menu and Popup Shortcuts
Mouse Hovering
Mouse Actions
Nanolib vs. Newlib
NVIC
Opening a Project
Operating System Commands
Operating System Requirements
Other Project Tasks
Other “Behind the Scenes” Work
Output File Memory Usage
Output Files
Overview
Overview of JumpStart Embedded Tools for Cortex
Paths
Peripheral (I/O Register) View
Priority Level
Program Environment
PROGRAMMING THE CORTEX-M MCU
Project
Project Importers
Project Build Options
Project Debug / Download Options
Project Dependencies
Project File Directories
Project Files
Project Properties
Projects, Targets, and Workspace
Putting printf in Your Program Under Semihosting
QFPLib Floating Point Library
Random values
Re-Licensing
Recovering from a Debugger Crash
Renaming a Project
Reset Target
Retargeting printf
Running a Function From SRAM
Saving a Project as an Archive
Semihosting
Simple Trace or "Poor Man’s" Trace
Smart Indent
Some Hints About Building Projects
Source Files
Source Line Stepping
Source Code Libraries
Specifying the Heap and Stack Sizes
ST CubeMX Importer
Support
Supported Vendors
Syntax Highlighting Pitfall
System Initialization
SYSTICK Interrupt
Targets
The Interrupt Vector Table
The Startup File
Toolbar Management
Transferring a License to Another Computer
Transferring a Software License to a Dongle
Upgrading a Dongle License
USB Drivers
Using the Hardware Dongle
Using the Software on Multiple Computers
Using C and C++ Together
Using JumpStart Embedded Tools Import Wizards
Using ST HAL or SPL with JSAPI
USING THE CODEBLOCKS IDE
Using Third-Party Libraries
Using time.h C Library Functions
Variable Watching
Vendor Device-Specific Interrupts
Vendor SDK
Visual Components of the IDE
Warning and Error Messages
What is JumpStart Embedded Tools for Cortex
What Does a Compiler Do Anyway?
Where is the C/C++ Language Manual?
Why ImageCraft’s JumpStart Embedded Tools?
Win8 / Win10 Unsigned Driver Hack
Wizard-Generated Files
Workspace
Writing an Interrupt Handler
“Break” and Stop Debugger
“Cannot Create Process…” Build Error
“Quick Watching” A Variable
“Reparsing” a Project
“Views” and Perspectives
Generated with
chmProcessor
Generated with
chmProcessor