User manual

mikroBasic PRO for dsPIC30/33 and PIC24
MikroElektronika
461
Soft_UART_Read
Soft_UART_Write
Prototype
sub function Soft_UART_Read(dim byref error as byte) as byte
Description The function receives a byte via software UART.
This is a blocking function call (waits for start bit). Programmer can unblock it by calling Soft_UART_
Break routine.
Parameters - error: Error ag. Error code is returned through this variable.
Values:
- 0 - no error
- 1 - stop bit error
- 255 - user abort, Soft_UART_Break called
Returns Byte received via UART.
Requires Software UART must be initialized before using this function. See the Soft_UART_Init routine.
Example
dim data_ as byte
error as word
...
‘ wait until data is received
do
data_ = Soft_UART_Read(error)
loop until (error = 0)
Notes The Software UART library implements time-based activities, so interrupts need to be disabled when
using it.
Prototype
sub procedure Soft_UART_Write(dim udata as byte)
Description This routine sends one byte via the Software UART bus.
Parameters - udata: data to be sent.
Returns Nothing.
Requires Software UART must be initialized before using this function. See the Soft_UART_Init routine.
Be aware that during transmission, software UART is incapable of receiving data – data transfer
protocol must be set in such a way to prevent loss of information.
Example
dim some_byte as byte
...
some_byte = $0A
‘ Write a byte via Soft UART
Soft_UART_Write(some_byte)
Notes The Software UART library implements time-based activities, so interrupts need to be disabled when
using it.