User manual

4. Creating a project Raisonance Tools for ARM
Starter Kit Limited: This option should be used when debugging in RAM with the limited version of the
RLink, such as the RLinks embedded in the REva evaluation boards, and the standard RLinks.
• Because these RLinks only access the lower 64Kbytes of each memory area (RAM, Flash,
etc.), the linker must initialize the stack pointer at an address lower than 64K and not at the very
end of the RAM as it would do otherwise.
• Also, it generates a link error if your application uses more than this reduced amount of RAM.
If you are using the simulator, an RLink with “Pro” capabilities, JTAGJet, or if you are only
programming the ARM’s Flash (without debugging it), then you should not select this option
because it greatly reduces the possibilities of the system.
4.4.2.4 Libraries
Use ST Precompiled library (STRx):
• This option only appears when the selected device is an STRx device.
• When set (by default), this option adds a precompiled library to the application, containing a
standard API designed by STMicroelectronics for handling the target peripherals.
• Library files are available for every STRx (in thumb and ARM modes) target supported. The
library sources can be found in this folder: <Ride>\LIB\ARM\<family>_LIB\ but you should
download the latest version from ST's website. You can use and distribute them freely.
Note: This option should not be used for C++ applications, because the libraries are compiled for C only.
To use these libraries in a C++ application, you must include the library sources in your project. See the
section about C++ applications for more information.
Use OLD Precompiled library (STM32x)
• This option only appears when the selected device is a STM32x device.
• When set (NOT set by default), this option adds a precompiled library to the application
containing a standard API designed by STMicroelectronics for handling the target peripherals.
• THIS OPTION IS DEPRECATED.
It should only be used for compiling old projects, created using old versions of the RKit-ARM.
It cannot be used in C++ applications.
The normal way to use the ST library is to include its sources in your application's project.
We recommend using the latest versions from ST's website, the package there includes Ride7
example projects showing you how to use them, by including the libraries sources in the project.
(The STM32 examples provided with Ride7 also show how this should be done, but the source
may be obsolete.)
Note: Other manufacturers (NXP, TI) also provide peripheral libraries for their CPUs. You should find
them on these manufacturer's websites.
Include UART0 putchar
• This option only appears for some target devices.
• This option adds io_putchar.a (or io_putchar_thumb.a), which includes standard putchar and
getchar functions using the UART0.
• It should be used in conjunction with UART0_stdio.h (instead of stdio.h).
• It redirects the output for functions using stdout, like printf, to the UART0.
• The “TEST” example shows how to use it.
• The library source can be found in <Ride>\LIB\ARM\IO_PUTCHAR\…
• You can use and distribute them freely.
printf capabilities
• This option adds a library which includes a reduced version of printf.
• The standard version from libc.a (“Full GNU printf”) includes many rarely used things..
- 18 -