Here's a subject where RTFM does NOT apply.
In fact, the only place the PBP manual even mentions it is in the Reserved Words (Appendix C).
The EXT modifier for Variables and Constants can solve many problems that seem impossible otherwise. It can save TONs of code space in certain situations. And, it can also confuse the hell out of you if you're not sure how it works. Hopefully this will help with the latter part.
EXT's only function is to tell PBP that it doesn't need to figure out where a Variable is located, or what a Constant's value is. Because it will be handled in ASM at compile time. And, since PBP doesn't "Lock it in" we can change it to anything we want later on, even in the middle of the program if need be.
Using EXT with Constants
Using EXT with Labels
Using EXT with Variables
Typecasting Variables inside of Arrays
Arrays within Arrays
Limitations of EXT
Using EXT with Constants
@MyConstant = 1234h ;no space between @ and Name... is exactly the same as ...
MyConstant CON EXT
MyConstant CON $1234However, by using the EXT modifier you can change it at any point in the program. And, you can use the Power of a 32-bit assembler to calculate what those values should be.
For instance, if you wanted to select a constant to be loaded in a timer on each interrupt depending on the crystal being used, you might do something like thisOr, you could let the assembler do the math ...Code:TimerConst CON EXT ASM IF OSC == 4 ; Constants for 100hz interrupt from Timer1 TimerConst = 0D8F7h ; Executed at compile time only EndIF If OSC == 8 TimerConst = 0B1E7h EndIF If OSC == 10 TimerConst = 09E5Fh EndIF If OSC == 20 TimerConst = 03CB7h EndIF ENDASMEither way it does not use any program space in the pic. It's all done at "Compile Time".Code:TimerConst CON EXT Freq CON 100 @TimerConst = 65543-(OSC*1000000/4/_Freq) ; 100hz Constant for Timer1 reload
Using EXT with Labels ...
One of best uses of EXT is to find out the Address of ANYTHING (that's already been declared) in the program.
To the assembler, Variables, Constants and Labels are all the same thing. Numbers! It's how those numbers get used that makes the difference.
A Constant is just a number.
A variable is a number that represents the Address of a Ram location.
And a Label is a number that represents the Address of a location in Program Space.
So any of these items can be assigned to a constant for PBP.
In this example, a list of 14-bit WORD values can be created in a lookup "Table".
With DataTable defined as an "External" constant, it will be assigned the Address of the Label with the same name. This allows you to easily locate items stored in Program memory.
Or for 16-bit WORDS on an 18F, use this ReadCODE statement.Code:DataWord VAR WORD Offset VAR WORD DataTable CON EXT '-----[The DATA table]-------------------------------------------------------- GOTO OverData ; Make sure data doesn't try to execute ASM DataTable DW 1234h, 2178h ; etc. endasm OverData: '-----[Retrieve from DATA table]---------------------------------------------- Offset = 1 ReadCODE (DataTable + Offset), DataWord LCDOUT $FE, 1, HEX4 DataWordAbsolutely HUGE tables can be created in a small fraction of the space used by LOOKUP2.Code:ReadCODE (DataTable + (Offset<<1)), DataWord
Note: Only PIC chips that can access their own Flash memory can use ReadCODE.
And, DW only works properly in MPASM, not PM. (thanks BigWumpus).
Using EXT with Variables ...
@MyVar = 20h... is similar to ...
MyVar VAR BYTE EXT
MyVar VAR BYTE $20With the exception that PBP doesn't know about it. Reading or writing to the EXT MyVar will use the RAM location at $20, but PBP will assign another variable there since it doesn't know about it yet. So trying to use EXT to create NEW variables is pretty much useless.
However, using EXT to create variables that reference other variables, or other RAM/SFR locations, is Priceless.
This example shows how to use a 16-bit timer value as if it were just another word.With that, and the TimerConst example shown above. Re-Loading the timer is as simple as this ...Code:@Timer1 = TMR1L Timer1 VAR WORD EXTYou should stop the timer before reading or writing it's value, or it might overflow in-between the Low and High bytes.Code:T1CON.0 = 0 ; stop timer Timer1 = Timer1 + TimerConst T1CON.0 = 1 ; turn timer back on
Note: Do NOT enable RD16 when using a Timer value as a WORD. (T?CON.7) (Thanks Bruce!)
On an 18F, Timer0 is always RD16. You cannot use Timer0 as a WORD value.
Another example along the same lines ...Then the whole capture value can be used as a Word variable.Code:@Capture = CCPR1L Capture VAR WORD EXT
But here's the good stuff.
Typcasting Variables inside of Arrays
Using the EXT modifier, you can create combinations of Word and Byte variables that point to locations inside of Array variables.
Let's say that you received a "Packet" of information from some other device using the STR function of HSERIN. But the problem is that it's not all byte sized data, even though it was stored in a byte-sized array.
It's received 8 bytes and you need to separate them into different WORD and BYTE sized variables.
01 AE 7A 8B 00 00 10 2C
\ / \ / \ /
Arg0 Arg1 Arg2 Arg3 Arg4
WORD BYTE WORD WORD BYTE
With a few EXTernal variables, you can Parse the entire Packet, without a single WORD of program space.Now you simply read the Packet into the Array, and each Arg variable will have the correct value in it. This is also much quicker to run, since it doesn't need to do all the Array indexing that PBP would normally do.Code:MyArray VAR BYTE[8] BANK0 ASM Arg0 = _MyArray ; word Arg1 = _MyArray + 2 ; byte Arg2 = _MyArray + 3 ; word Arg3 = _MyArray + 5 ; word Arg4 = _MyArray + 7 ; byte ENDASM Arg0 VAR WORD EXT Arg1 VAR BYTE EXT Arg2 VAR WORD EXT Arg3 VAR WORD EXT Arg4 VAR BYTE EXT
If there are multiple types of packets being received, you can just create another set of variables pointing to the same Array space, with different combinations of bytes and words. Since they don't use any program space, you can make as many as you want. Sure beats using 4 or 5 different HSERIN statements for the different packet types.
And of course, it works the other way too. By setting the Arg variables first, you can easily SEND the "pre-formatted" packet with the STR function.
If you get an "Unable to fit variable ____ in requested bank x" warning, change the BANK0 modifier to BANK1 or another bank that has room.
The entire array must be in a single bank for this technique to work. (Thanks Charles_Leo)
Limitations of EXT
Since the value of an EXTernal constant/variable/label isn't known until the program is being Assembled. PBP cannot use the values itself.
Both of the lines above will fail since PBP needs to know what the value is for those statements when it's compiling. But they won't be known till it's assembled.Code:@MyConstant = 1234h MyConstant CON EXT AnotherCON CON MyConstant + 100 ; This will fail MyArray VAR BYTE[MyConstant] ; This will fail
This also holds true throughout the program. The value of an EXT var/con/label must be declared prior to anything trying to use it. If a label occurs after the current point in the program, you should get an error, but it's not always evident what the problem is.
Sometimes it will give a "Symbol not previously defined" error. Other times you might get an "Address label duplicated or different in second pass" error.
The error will indicate the name of the Label, so it's not too hard to figure out.
You can't use EXT with Arrays. That would just be too convenient.
Bookmarks