Admin: 1 revision

2013-02-15T19:07:17Z

1 revision

Admin: Created page with "= Action = Sets the available space for the software stack. ..."

2013-02-06T21:51:14Z

Created page with "= Action = Sets the available space for the software stack. ..."

New page

== (**COPIED FROM ENGLISH PAGE**) === Action =

Sets the available space for the software stack.

 

 

= Syntax =

$SWSTACK = var

 

 

= Remarks =
<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="9%" style="width: 51px; border: 1px solid rgb(0, 0, 0);" |
Var

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

|}
</div>
 

 

While you can configure the SW Stack 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.

 

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

 

[[File:Notice.jpg|left|Notice.jpg]] It is important that the $SWSTACK directive occurs in your main project file. It may not be included in an $include file as only the main file is parsed for $SWSTACK. $SWSTACK only accepts numeric values.

 

Software Stack stores the parameter addresses passed to a subroutine and LOCAL variable addresses.

So the Software stack stores the addresses of variables where each passed variable and local variable use 2 bytes per respective addresses.

 

When using SUB or FUNCTION there are 3 ways for parameters:
<div style="padding: 0px; margin: 0px;">
{| border="0" cellpadding="0" cellspacing="0"
|- valign="baseline" style="vertical-align: baseline;"
| width="13" | •
| Using BYREF pass a variable by reference with its ADDRESS (so it is pointing to an existing variable which is already in SRAM)
|}
</div><div style="padding: 0px; margin: 0px;">
{| border="0" cellpadding="0" cellspacing="0"
|- valign="baseline" style="vertical-align: baseline;"
| width="13" | •
| Using BYVAL the value is stored in FRAME (during the SUB is processed) so it is pointing to the address in FRAME.
|}
</div><div style="padding: 0px; margin: 0px;">
{| border="0" cellpadding="0" cellspacing="0"
|- valign="baseline" style="vertical-align: baseline;"
| width="13" | •
| Using BYLABEL pass the address of a label
|}
</div>
When nothing is specified the parameter will be passed BYREF.

 

= See also =

[[$HWSTACK]] , [[$FRAMESIZE]], [[Memory Usage|Memory Usage]]

 

For example if you have used 10 locals in a SUB and there are 3 parameters passed to it, you need:

(10 * 2 Byte) +  (3 * 2 Byte) = 26 Byte Software Stack.

 

The following SUB need 10 Byte of Software Stack:

5* 2 Byte = 10 Byte

 

[[File:Swstack.png|center]]

 

So the software stack size can be calculated by taking the maximum number of parameter passed to a SUB routine, adding the number of LOCAL variables and multiplying the result by 2. To be safe, add 4 more bytes for internally used LOCAL variables.

 

If you have several SUB or FUNCTIONS search for the SUB or FUNCTION with the most parameters and LOCAL variables and use that calculated maximum numbers for defining the Software Stack ($swstack).

The Software Stack is growing top down (see picture) and start direct after the Hardware Stack. The Software Stack grows against the FRAME.

[[File:Swstack memmap.png|center|Swstack memmap.png]]

Picture: Example Memory of ATXMEGA128A1

= Example =

 <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 'default us
</source> {{Languages}}

[[Category:BASCOM_Language_Reference/de]]

$SWSTACK/de - Revision history

Admin: 1 revision

Admin: Created page with "= Action = Sets the available space for the software stack. ..."