Admin at 21:03, 11 February 2013

2013-02-11T21:03:32Z

Admin: Created page with "= Action = Sends a byte to a hardware port or internal or external memory address.
2013-02-11T21:03:06Z

Created page with "= Action = Sends a byte to a hardware port or internal or external memory address. Action =

Sends a byte to a hardware port or internal or external memory address.

 

 

= Syntax =

OUT address, value

 

 

= Remarks =
<div style="padding: 0px; margin: 0px 0px 0px 4px;">
{| width="443" 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="21%" style="width: 89px; border: 1px solid rgb(0, 0, 0);" |
Address

| valign="top" width="93%" style="width: 345px; border: 1px solid rgb(0, 0, 0);" |
The address where to send the byte to in the range of 0-FFFF hex.

For Xmega which supports huge memory, the address is in range from 0-&HFFFFFF.

|- style="vertical-align: top;"
| valign="top" width="21%" style="width: 89px; border: 1px solid rgb(0, 0, 0);" |
Value

| valign="top" width="93%" style="width: 345px; border: 1px solid rgb(0, 0, 0);" |
The variable or value to output.

|}
</div>
 

The OUT statement can write a value to any AVR memory location.

 

It is advised to use Words for the address. An integer might have a negative value and will write of course to a word address. So it will be 32767 higher as supposed. This because an integer has it's most significant bit set when it is negative.

 

[[File:Notice.jpg|left|Notice.jpg]] To write to XRAM locations you must enable the External RAM access in the [http://avrhelp.mcselec.com/options_compiler_chip.htm Compiler Chip Options].

 

You do not need to use OUT when setting a port variable. Port variables and other registers of the micro can be set like this : PORTB = value , where PORTB is the name of the register.

 

 

[[File:Notice.jpg|left|Notice.jpg]]Take special care when using register variables. The address-part of the OUT statement, expects a numeric variable or constant. When you use a hardware register like for example PORTB, what will happen is that the value of PORTB will be used. Just as when you use a variable, it will use the variable value.

So when the goal is to just write to a hardware register, you need to use the normal assignment : PORTB=3

 

 

 

= See also =

[[INP]] , [[PEEK]] , [[POKE]] , [[SETREG]], [[GETREG]]

 

 

= Example =

 <source lang="bascomavr">
Out &H8000 , 1 'send 1 to the databus(d0-d7) at hex address 8000
End
</source> {{Languages}}

[[Category:BASCOM Language Reference]]

@@ Line 46: / Line 46: @@
 <span style="font-family: Arial;">&nbsp;</span>
-[[File:Notice.jpg|left|Notice.jpg]]&nbsp;To write to XRAM locations you must enable the External RAM access in the&nbsp;[http://avrhelp.mcselec.com/options_compiler_chip.htm Compiler Chip Options].
+[[File:Notice.jpg|left|Notice.jpg]]&nbsp;To write to XRAM locations you must enable the External RAM access in the&nbsp;[[Compiler_Chip_Options|Compiler Chip Options]].
 <span style="font-family: Arial;">&nbsp;</span>