View source

= <span class="f_Header">Action</span> =

Sets the available space for the frame.

<span style="font-family: Arial;">&nbsp;</span>

<span style="font-family: Arial;">&nbsp;</span>

= <span class="f_Header">Syntax</span> =

<span class="f_Syntax">$FRAMESIZE</span>&nbsp;= var

<span style="font-family: Arial;">&nbsp;</span>

<span style="font-family: Arial;">&nbsp;</span>

= <span class="f_Header">Remarks</span> =
<div style="padding: 0px; margin: 0px 0px 0px 4px;">
{| width="604" cellspacing="0" cellpadding="1" border="1" style="border: 2px solid rgb(0, 0, 0); border-spacing: 0px; border-collapse: collapse;"
|- style="vertical-align: top;"
| valign="top" width="10%" style="width: 57px; border: 1px solid rgb(0, 0, 0);" | 
Var

| valign="top" width="100%" style="width: 538px; border: 1px solid rgb(0, 0, 0);" | 
A numeric decimal value.

|}
</div>
<span style="font-family: Arial;">&nbsp;</span>

While you can configure the Frame Size in Options, Compiler, Chip, it is good practice to put the value into your code. This way you do no need the cfg(configuration) file.

<span style="font-family: Arial;">&nbsp;</span>

The $FRAMESIZE directive overrides the value from the IDE Options.

<span style="font-family: Arial;">&nbsp;</span>

It is important that the $FRAMESIZE directive occurs in your main project file. It may not be included in an $include file as only the main file is parsed for $FRAMESIZE. $FRAMESIZE only accepts numeric values.

&nbsp;

[[File:Notice.jpg|left|Notice.jpg]]Functions like&nbsp;[[PRINT]],&nbsp;[[LCD]],&nbsp;[[INPUT]]&nbsp;and the FP num <>&nbsp;[[FORMAT]]&nbsp;&nbsp;String conversion routines require a buffer in SRAM. Because of that&nbsp;<span style="font-weight: bold;">the compiler always is using 24 bytes of frame space</span>. This 24 Byte start at the beginning of the Frame which act as the conversion buffer within the frame (See also picture).

Because the FRAME is growing bottom up and this 24 Byte start at the beginning of the FRAME this 24 Byte conversion buffer start at the lowest FRAME Address (See picture). Here you also see that a too small $framesize causes an overwriting of Software Stack and/or Hardware Stack which lead to malfunction. If you use Print numVar, then the numeric variable "numvar" is converted into a string representation of the binary number. The framespace buffer is also used for that.

&nbsp;

&nbsp;

When there is not enough room inside the frame, the ERR variable will be set to 1.

&nbsp;

&nbsp;

= <span class="f_Header">See also</span> =

[[$SWSTACK]],&nbsp;[[$HWSTACK]],&nbsp;[[Memory usage|Memory usage]]





[[File:Framesize.png|center|Framesize.png]] Picture: Memory of ATXMEGA128A1

&nbsp;

A LOCAL variable is a temporary variable that is stored in frame.

There can be only LOCAL variables of the type BYTE, INTEGER, WORD, LONG, SINGLE, DOUBLE or STRING.

&nbsp;

A LOCAL Integer will use 2 Bytes of Frame ,

A LOCAL Long will use 4 Bytes.

A LOCAL string * 20 will use 20 + 1 = 21 Byte (this additional 1 Byte is because every String is terminated with a 0-Byte)

&nbsp;

&nbsp;

When the SUB or FUNCTION is terminated, the memory will be released back to the frame but the FRAME will not be cleared&nbsp;! Therefore a LOCAL variable is not initialized. So you can not assume the variable is 0. If you like it to be 0, you need to assign it&nbsp;!

&nbsp;

BIT variables are not possible as LOCAL because they are always GLOBAL to the system.

Arrays can NOT be used as LOCAL (but arrays can be passed by REFERENCE as parameter to SUB and FUNCTIONS which just need 2 Bytes Software Stack of the Address of Array start)

&nbsp;

See following example for frame calculation:

<span style="font-family: Arial;">&nbsp;</span>

<span style="font-family: Arial;">&nbsp;</span>

<span style="font-family: Arial;">&nbsp;</span>

<span style="font-family: Arial;">&nbsp;</span>

= <span class="f_Header">Example</span> =

<br/><source lang="bascomavr">
$regfile = "xm128a1def.dat"
$crystal = 32000000 '32MHz
$hwstack = 64
$swstack = 128
$framesize = 288
 
Config Osc = Enabled , 32mhzosc = Enabled '32MHz
 
'configure the systemclock
Config Sysclock = 32mhz , Prescalea = 1 , Prescalebc = 1_1 '32MHz
 
'Config Interrupts
Config Priority = Static , Vector = Application , Lo = Enabled 'Enable Lo Level Interrupts
Config Com1 = 57600 , Mode = Asynchroneous , Parity = None , Stopbits = 1 , Databits = 8
 
 
Declare Sub My_sub()
 
Call My_sub()
 
End 'end program
 
Sub My_sub()
Local A1 As Byte , A2 As Byte , A3 As Byte , A4 As Byte , A5 As Byte
Local S As String * 254
 
For A1 = 1 To 254
 S = S + "1"
Next A1
 
 
A1 = 1
A2 = 2
A3 = 3
A4 = 4
A5 = 5
Print A1
End Sub
</source>

= <span class="f_Header">Now we calculate the FRAME:</span> =

The Print A1 will be placed in the first frame-Byte of the 24 Byte conversion buffer.

5 LOCAL Byte (A1 … A5) &nbsp;= &nbsp;5 Byte of FRAME

LOCAL String: 254 Byte + 1 Byte = 255 Byte

Frame needed = 24Byte Frame conversion Buffer + 5 Byte + 255 Byte = 284 Byte

This can be easy double checked with BASCOM-AVR Simulator (see following picture).

&nbsp;

In following picture &nbsp;you see the start of FRAME which start with the 24Byte conversion buffer. The 31 in the first Frame Byte is from Print A1. After the 24 Byte conversion buffer follow the 5 Local Byte variables (A1 …. A5) and then the 255 Byte for the LOCAL String.

&nbsp;

As with Software Stack you need to calculate the Framesize needed by the SUB or FUNCTION with the most LOCAL Variables and parameter passed by REFERENCE etc..

&nbsp;

Take care when calling a SUB within a SUB. In this case you need to add the FRAME needed by both SUB&nbsp;!

When both SUB need 284 Byte you need to use:

24 Byte conversion Buffer + 2* 5 Byte (A1…A5) + 2*255 Byte (String) =&nbsp;<span style="font-weight: bold;">544 Byte</span>

(the conversion buffer is needed only once&nbsp;!)

&nbsp;

[[File:Frame calc.png|center|Frame calc.png]] 

Picture: &nbsp;Memory window of BASCOM-AVR Simulator (Frame calculation example)

&nbsp;

&nbsp;

&nbsp;

For further investigation of Stacks and Frame we use a SUB with 5 LOCAL Byte Variables and a PRINT function within the SUB. We start with hwstack, swstack and framesize defined and in second step we set swstack to 0. In addition we will lower the framesize to a not recommended value to force overwriting of other stack bytes.
<div><br/></div><div><br/></div>
<source lang="bascomavr">
$regfile = "xm128a1def.dat"
$crystal = 32000000 '32MHz
$hwstack = 64
$swstack = 128
$framesize = 256
 
Config Osc = Enabled , 32mhzosc = Enabled '32MHz
 
'configure the systemclock
Config Sysclock = 32mhz , Prescalea = 1 , Prescalebc = 1_1 '32MHz
 
'Config Interrupts
Config Priority = Static , Vector = Application , Lo = Enabled 'Enable Lo Level Interrupts
Config Com1 = 57600 , Mode = Asynchroneous , Parity = None , Stopbits = 1 , Databits = 8
 
 
 
Declare Sub My_sub()
 
 
 
Call My_sub()
 
 
End 'end program
 
Sub My_sub()
Local A1 As Byte , A2 As B
</source><br/>{{Languages}}

[[Category:BASCOM Language Reference]]