TASKING VX-toolset for ARM

v1.1r2 RELEASE NOTE

 


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


SUMMARY

This release note describes ABI issues, important developers notes and changes and new features with respect to version v1.1r1 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. There is no support yet for Vector Floating Point (VFP).


IMPORTANT DEVELOPER NOTES

Startup code, vector table & separate stack pointers for each processor mode (since version 1.1r2)

The startup code and  the way the vector table is created is substantialy improved since version 1.1r2. Please read the concerning chapter Run-time Environment of the ARM Embedded Tools Reference for a full overview of the new situation.

Alignment of composite types (since version 1.1r2)

The alignment of composite types is changed from optimal to natural to be in line with the EABI. You can set the optimal alignment with the compiler option --align-composites


C++ COMPILER

The C++ compiler is not part of this release.


C COMPILER

New compiler options (since version 1.1r2)

 Option Description
--call-info Generate info for call graph
--align-composites Set the alignment for composite types (structs, unions and arrays)

New compiler keywords (since version 1.1r2)

Keyword Description
__novector Do not generate the exception vector
__interrupt_iabt Define exception handler for a prefetch abort
__interrupt_dabt Define exception handler for a data abort
__interrupt_und Define exception handler for an undefined instruction
__unaligned Suppress the alignment of objects or structure members
__packed__ Prevent alignment gaps in structures


ASSEMBLER

.code16 & .code32 (since version 1.1r2)

The .code16 and .code32 directives are useful when you have files that contain both ARM and Thumb instructions. Since version 1.1r2 the handling by the assembler of those directives has slightly changed. The directives must now appear before the instruction set change and between a .SECTION/.ENDSEC. The default instruction set at the start of a section depends on the use of assembler option --thumb.

Compatibility with ARM RVCT v2.2 assembly

The assembler supports the pseudo-instructions defined by ARM RVCT v2.2 tools, including the POP, PUSH, LSL, LSR, ASR, ROR and RRX instructions for ARM state.

The assembler accepts the condition code as the last element of any mnemonic.

When the --relaxed option is switched on 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'.

The assembler does not accept that both registers are specified for double-word memory access instructions. An instruction pair is specified by its even register.

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.

EABI issues

The assembler (and the linker) do not emit mapping symbols ($a, $d and $t) to mark address ranges containing ARM code, data or Thumb code respectively. This implies that in some situations the debugger does not correctly disassemble the code.


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 enabled 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.


LIBRARIES

All product libraries are compiled for ARM-Thumb interworking.

The startup code for ARM and Thumb (cstart.asm) included in the run-time library (rtarm.lib & rtthumb.lib) provide basic functionality: it initialises 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 initialisation.You may contact Altium Support for assistance on hardware-specific issues pertaining to the use of the TASKING VX-toolset.

Run-time library (since version 1.1r2)

Since version 1.1r2 the compiler related functions are removed from the C library and put into a separated run-time library (rtarm.lib & rtthumb.lib)


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-2006 Altium BV