Using saddr area (__saddr)
|
When declared with __saddr, external variables and static variables in a function are allocated to the saddr area.
[Function]
- | Initialized variables are allocated to the .sdata section. |
- | Uninitialized variables are allocated to the .sbss section. |
- | Address reference always returns a near pointer. |
- | External variables and static variables in a function are allocated to the saddr area when they are declared with __saddr. |
- | These variables are handled in the same way as other variables in a C source file. |
[Effect]
- | Instructions that access the saddr area are shorter than those accessing the normal memory area and their object code also becomes smaller, leading to improved execution speed. |
[Usage]
- | Specify __saddr in the declaration of the variable to be allocated to the saddr area.
In a function, only variables with the extern or static storage class specifier can be declared with __saddr. |
__saddr variable-declaration;
extern __saddr variable-declaration;
static __saddr variable-declaration;
__saddr extern variable-declaration;
__saddr static variable-declaration;
|
[Restrictions]
- | If __saddr is specified for a const type variable, a compilation error will occur. |
- | If __saddr is specified for a function, a compilation error will occur. |
- | If __saddr is specified for a variable which does not have static storage duration, a compilation error will occur. |
- | If __saddr and __near or __far are specified together, a compilation error will occur. |
__saddr __near int ni; //Error
__saddr __far int fi; //Error
|
- | If __saddr is used in a typedef declaration, a compilation error will occur. |
typedef __saddr int SI; //Error
|
[Example]
The following shows a sample C source code.
__saddr int hsmm0; //.sbss
__saddr int hsmm1=1; //.sdata
__saddr int *hsptr; //hsptr is allocated to. sbss
//The pointed location is in a normal area.
void main(){
hsmm0 -= hsmm1;
hsptr = 0;
}
|
The following shows the declarations and section allocation in the assembly source code.
.PUBLIC _hsmm0 ;Declaration
.PUBLIC _hsmm1 ;Declaration
.PUBLIC _hsptr ;Declaration
.SECTION .sbss,SBSS ;Allocated to the .sbss section
.ALIGN 2
_hsmm0:
.DS 2
.ALIGN 2
_hsptr:
.DS 2
.SECTION .sdata,SDATA ;Allocated to the .sdata section
.ALIGN 2
_hsmm1:
.DB2 0x0001
|
The following shows the code in the function.
movw ax, _hsmm0
subw ax, _hsmm1
movw _hsmm0, ax
movw _hsptr, #0x0000
|
[Remark]
- | Difference between the __saddr keyword and #pragma saddr |
- | The __saddr keyword cannot be used together with the __near or __far keyword, and a compilation error will occur if used so. |
- | #pragma saddr can be specified for a variable with __near or __far keyword. #pragma saddr overrides the __near or __far specification without a warning. |