User manual

mikroBasic PRO for PIC32
MikroElektronika
143
Linker Directives
mikroBasic PRO for PIC32 uses internal algorithm to distribute objects within memory. If you need to have a variable
or routine at the specic predened address, use the linker directives absolute and org.
When using these directives, be sure to use them in proper memory segments, i.e. for functions it is the KSEG0 and
for variables it is the KSEG1. Linker directives are used with the virtual addresses.
Directive absolute
Directive absolute species the starting address in RAM for a variable. If the variable is multi-byte, higher bytes will
be stored at the consecutive locations.
Directive absolute is appended to declaration of a variable:
‘ Variable x will occupy 1 word (16 bits) at address 0x32
dim x as word absolute 0x32
‘ Variable y will occupy 2 words at addresses 0x34 and 0x36
dim y as longint absolute 0x34
Be careful when using absolute directive, as you may overlap two variables by accident. For example:
dim i as word absolute 0x42
‘ Variable i will occupy 1 word at address 0x42;
dim jj as longint absolute 0x40
‘ Variable will occupy 2 words at 0x40 and 0x42; thus,
‘ changing i changes jj at the same time and vice versa
Directive org
Directive org species the starting address of a constant or a routine in ROM. It is appended to the constant or a
routine declaration.
To place a constant array in Flash memory, write the following:
‘ Constant array MONTHS will be placed starting from the address 0x800
const MONTHS as byte[12] = (31,28,31,30,31,30,31,31,30,31,30,31) org 0x800
If you want to place simple type constant into Flash memory, instead of following declaration:
sub procedure proc(dim par as word) org 0x200
‘ Procedure will start at the address 0x200;
...
end sub