TASKING VX-toolset for ARM.

v2.0r1 RELEASE NOTES

 


TASKING ARM Product Page, TASKING ARM Support Page, TASKING Developers' Forum, TASKING Home Page


SUMMARY

These release notes describes ABI issues, important notes and changes and new features since version v1.2r1 of the TASKING VX-toolset for ARM.

The following parts are described:

The tools support architectures ARMv4, ARMv4T, ARMv5T, ARMv5TE and XScale. The Jazelle extension of the ARMv5TE architecture (ARMv5TEJ) is supported only by the assembler, i.e. the bxj instruction is supported.

With version v2.0r1 support is added for ARMv6-M, ARMv7-M and for Vector Floating Point (VFP).


IMPORTANT NOTES

Thumb-2 Instruction Set

The ARMv7-M architecture profile implements the Thumb-2 instruction set. Besides some new 16-bit Thumb instructions it introduces 32-bit Thumb instructions and an IT instruction for conditional execution. This makes the Thumb-2 instruction set almost as powerful as the 32-bit ARM instruction set. The 32-bit Thumb-2 instructions can be executed in Thumb state and need only be half-word aligned in memory. The IT instruction (If/Then) sets the conditions for up to four instructions following the IT instruction. For a number of Thumb-2 instructions both 16-bit encodings as well as 32-bit encodings exists. The assembler selects the proper encoding for such an instruction, although in some situations the user/compiler can force the selection of a specific encoding.

Unified Assembly Language (UAL)

With the Thumb-2 instruction set ARM Ltd introduced the Unified Assembly Language (UAL) which provides a canonical form for all ARM and Thumb instructions. The UAL allows you to write assembly code which can be assembled using 32-bit ARM instructions or using 16-bit and 32-bit Thumb-2 instructions. This means that you can use IT instructions followed by a block of up to four conditional instructions in both ARM and Thumb-2 code. The assembler checks for consistency between the two, and assembles the appropriate code depending on the current instruction set.

With version v2.0r1 the C compiler generates UAL code for all architectures.


C++ COMPILER

The TASKING VX-toolset for ARM optionally includes a C++ compiler.

The C++ compiler accepts the C++ language of the ISO/IEC 14882:1998 C++ standard (with some minor exceptions) and can be seen as a preprocessor or front end which accepts C++ source files or sources using C++ language features. The output generated by the C++ compiler is C, which can be translated by the C compiler. The C++ compiler also accepts embedded C++ language extensions.


C COMPILER

With version v2.0r1 the C compiler generates Unified Assembly Language (UAL) code.

New compiler options (since version 2.0r1)

 Option Description
--fpu=fpu With this option you define the kind of FPU support with which you create your application.
--unaligned-access With this option you tell the compiler to generate more efficient instructions to access unaligned 16-bit or larger data. Halfword or word load and store instructions are used instead of byte instructions. This option is only useful for cores that have support for unaligned access.
--call={far|near}
-m{f|n}
To address the memory of the ARM, you can use far 32-bit indirect calls or near 26-bit PC-relative calls.
This option is especially relevant for ARMv6-M. For other architectures near calls (the default) are preferred and the linker will generate veneers if necessary.

New function qualifiers (since version 2.0r1)

Keyword Description
__interrupt_svc Software interrupt (replaces old function qualifier __interrupt_swi).
__interrupt(n) Interrupt for vector n.

New intrinsic functions (since version 2.0r1)

Intrinsic Description
__getapsr() Get the value of the APSR status register (ARMv6-M and ARMv7-M).
__setapsr(int set, int clear) Set or clear bits in the APSR status register (ARMv6-M and ARMv7-M).
__getipsr() Get the value of the IPSR status register (ARMv6-M and ARMv7-M).
__svc(int number) Generates a supervisor call (replaces old intrinsic function __swi() ).


ASSEMBLER

With version v2.0r1 the assembler runs in UAL mode by default. Use the assembler option --old-syntax to get the old behavior.

New assembler options (since version 2.0r1)

 Option Description
--old-syntax The assembler will run in pre-UAL mode.
--inversions With this option you tell the assembler to try to invert some data processing instructions with an immediate operand. Inversions are available for MOV/MVN, CMP/CMN, AND/BIC, ADC/SBC, and ADD/SUB.

New assembler directives (since version 2.0r1)

Intrinsic Description
.FLOAT/.DOUBLE Define a 32-bit / 64-bit floating-point constant.
.THUMB/.ARM Treat instructions as Thumb or ARM instructions using UAL syntax.

Compatibility with ARM RVCT v3.0 assembly

The assembler supports the pseudo-instructions defined by ARM RVCT v3.0 tools (except the ADRL pseudo-instruction for Thumb-2), and the canonical forms for POP, PUSH, LSL, LSR, ASR, ROR and RRX instructions, .

For Thumb-2 the assembler only accepts the condition code as the last element of any mnemonic. For ARM the assembler accepts infix condition code, but only if --old-syntax option or .code32 directive is used.

The assembler only supports the UAL syntax for VFP instructions.

With the option --relaxed the assembler accepts 2-operand versions of 3-operand instructions when the first and second operand are a destination and a source register and the same register is used for both. E.g. 'add r1,r1,r3' may be written as 'add r1,r3' and 'add r1,r1,#4' may be written as 'add r1,#4'.

You should not add 1 to Thumb label expressions in literal pools or data sections. This will be taken care of automatically by the assembler and the linker.


LINKER

The linker automatically generates ARM-Thumb interworking veneers when needed. This release always creates a long veneer, i.e. short veneers and inline veneers are not used. Veneer symbol names do not follow the convention proposed by the EABI (not mandatory).

The linker does not generate long-branch veneers for out-of-range function calls by default. You can enable this feature with option --long-branch-veneers, but use it with care. The option slows down the linking process considerably and it can lead to larger code size even when veneers are not needed after all. It is better to prevent long branches and only use this option when long branches are out of range.

The ARMv6-M architecture profile has no support for veneers. Use compiler option --call to force far 32-bit indirect calls or near 26-bit PC-relative calls.


LIBRARIES

All product libraries are suitable for ARM-Thumb interworking. None of the libraries are optimized for VFP.

The startup code for ARM and Thumb included in the C library (carm.lib & cthumb.lib) provides basic functionality: it initializes the separate stack pointers for each processor mode, copies global data from ROM to RAM, calls the application's main function and calls the exit function upon return from main. It does not do any hardware initialization. You may contact Altium Support for assistance on hardware-specific issues pertaining to the use of the TASKING VX-toolset.


CROSSVIEW PRO DEBUGGER

The CrossView Pro instruction set simulator debugger is part of this release.

The debugger recognizes register alias names IP, SP, LR and PC for general purpose registers R12, R13, R14 and R15. You can display these aliases in the register window. The disassembler only shows the general purpose names.

 


Copyright 2004-2007 Altium BV