BUFSPACE - Revision history

Admin at 18:05, 17 January 2017

2017-01-17T18:05:39Z

Admin at 11:54, 7 February 2013

2013-02-07T11:54:40Z

Admin: Created page with "= Action = Returns the amount of free space of a serial buffer.
2013-02-07T11:54:00Z

Created page with "= Action = Returns the amount of free space of a serial buffer. Action =

Returns the amount of free space of a serial buffer.

 

 

= Syntax =

Var = BufSpace(n)

 

 

= Remarks =
<div style="padding: 0px; margin: 0px 0px 0px 4px;">
{| width="631" 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: 53px; border: 1px solid rgb(0, 0, 0);" |
Var

| valign="top" width="100%" style="width: 569px; border: 1px solid rgb(0, 0, 0);" |
A word or integer variable that is assigned with the free buffer space.

|- style="vertical-align: top;"
| valign="top" width="9%" style="width: 53px; border: 1px solid rgb(0, 0, 0);" |
N

| valign="top" width="100%" style="width: 569px; border: 1px solid rgb(0, 0, 0);" |
A constant in the range from 0-3.

A value of 0 : output buffer first UART

A value of 1 : input buffer first UART

A value of 2 : output buffer second UART

A value of 3 : input buffer second UART

|}
</div>
 

While serial buffers are great because you do not have to wait/block the processor, the buffer can become full when the micro has no time to empty the buffer. With the bufspace() function you can determine if there is still room in the buffer.

 

 

= See Also =

[[CONFIG_SERIAL|CONFIG SERIAL]] , [[CLEAR]]

 

 

= Example =



'---------------------------------------------------------

NONE

@@ Line 60: / Line 60: @@
 = <span class="f_Header">Example</span> =
-<span class="f_Header"></span>
+<br/><source lang="bascomavr">
-<span style="font-family: 'Courier New';">'---------------------------------------------------------</span>
+[[Category:BASCOM Language Reference]]
-−
-<span style="font-family: 'Courier New';">NONE</span>

@@ Line 16: / Line 16: @@
 = <span class="f_Header">Remarks</span> =
-<div style="padding: 0px; margin: 0px 0px 0px 4px;">
+<div style="padding: 0px; margin: 0px 0px 0px 4px;"><div style="padding: 0px; margin: 0px 0px 0px 4px;">
-{| width="631" cellspacing="0" cellpadding="1" border="1" style="border: 2px solid rgb(0, 0, 0); border-spacing: 0px; border-collapse: collapse;"
+{| style="border: solid 2px #000000; border-spacing:0px; border-collapse: collapse;" width="631" cellspacing="0" cellpadding="1" border="1"
 |- style="vertical-align: top;"
-| valign="top" width="9%" style="width: 53px; border: 1px solid rgb(0, 0, 0);" |
+| style="width:9%; border: solid 1px #000000;" width="9%" valign="top" |
 Var
-| valign="top" width="100%" style="width: 569px; border: 1px solid rgb(0, 0, 0);" |
+| style="width:100%; border: solid 1px #000000;" width="100%" valign="top" |
 A word or integer variable that is assigned with the free buffer space.
 |- style="vertical-align: top;"
-| valign="top" width="9%" style="width: 53px; border: 1px solid rgb(0, 0, 0);" |
+| style="width:9%; border: solid 1px #000000;" width="9%" valign="top" |
+N
-| valign="top" width="100%" style="width: 569px; border: 1px solid rgb(0, 0, 0);" |
+| style="width:100%; border: solid 1px #000000;" width="100%" valign="top" |
-A constant in the range from 0-3.
+A constant in the range from 0-15.
-A value of 0 : output buffer first UART
+Odd numbers are for the INPUT buffers. Even numbers are for the OUTPUT buffers.
-A value of 1 : input buffer first UART
+&nbsp;
-A value of 2 : output buffer second UART
+A value of 0 : output buffer USART0 (first UART)
-A value of 3 : input buffer second UART
+A value of 1 : input buffer USART0 (first UART)
 |}
@@ Line 46: / Line 94: @@
 While serial buffers are great because you do not have to wait/block the processor, the buffer can become full when the micro has no time to empty the buffer. With the bufspace() function you can determine if there is still room in the buffer.
 <span style="font-family: Arial;">&nbsp;</span>