How do I allow C variables to be accessed by assembly code that expects them in certain banks?

Bank qualifiers are not normally needed when writing program for an OCG (Omniscient Code Generation) compiler (such as the MPLAB XC8 compiler), however if there is assembly code that assumes these variables are in a certain bank then the C variables must be qualified using the bank qualifiers (bank0, bank1, bank2 etc).

The second thing that must be done is to ensure the qualifiers are honored by setting the --ADDRQUAL option to "require", or set the Address qualifiers selector to "Require" under the Compiler Settings. Without this, the qualifiers will be ignored by the compiler.

If the variables are not qualified and are placed in banks other than those expected by the assembly code, fixup errors may occur, or the code may fail. Projects are more portable if the assembly code always selects the bank of any object and applies the correct file address mask. In this way, there are no assumptions about the location of the objects accessed and the C variables do not need to be qualified.

© 2016 Microchip Technology, Inc.
Information contained on this site regarding device applications and the like is provided only for your convenience and may be superseded by updates. It is your responsibility to ensure that your application meets with your specifications. MICROCHIP MAKES NO REPRESENTATIONS OR WARRANTIES OF ANY KIND WHETHER EXPRESS OR IMPLIED, WRITTEN OR ORAL, STATUTORY OR OTHERWISE, RELATED TO THE INFORMATION, INCLUDING BUT NOT LIMITED TO ITS CONDITION, QUALITY, PERFORMANCE, MERCHANTABILITY OR FITNESS FOR PURPOSE. Microchip disclaims all liability arising from this information and its use. Use of Microchip devices in life support and/or safety applications is entirely at the buyer's risk, and the buyer agrees to defend, indemnify and hold harmless Microchip from any and all damages, claims, suits, or expenses resulting from such use. No licenses are conveyed, implicitly or otherwise, under any Microchip intellectual property rights.