 |
 |
|
 |
 |
ZBasic System Library
270
ZX Microcontroller Family
StatusCom
Type
Function returning Byte
Invocation
StatusCom(chan)
Parameter
Method
Type
Description
chan
ByVal
Byte
The serial channel of interest.
Discussion
This function returns a set of flag bits that indicate the status of the specified serial channel. The meaning
of each of the flag bits is shown in the table below.
Serial Channel Status Bit Values
Value
Meaning
&H01
The channel number is valid but may or may not be open.
&H02
The channel is open.
&H04
The channel has data yet to be transmitted.
&H08
The channel is a software UART channel.
&H10
The channel’s receive flow control pin is in the inactive state.
&H20
The channel’s transmit flow control pin is in the inactive state.
The remaining bits are currently undefined but may convey additional information in the future. It is
strongly advised that you apply an AND mask to the returned value before comparing it to a fixed value.
Doing so will prevent the future addition of bits from affecting your existing code.
Note that use of this function can be combined with StatusQueue() to determine when all characters
have been completely transmitted on a serial channel. The example code below illustrates this
technique.
Example
' wait until all characters are transmitted
Do While StatusQueue(oq)
Loop
Do While CBool(StatusCom(chan) And &H04)
Loop
Compatibility
This function is not available in BasicX compatibility mode.
See Also
|
 |
|