User manual

mikroPascal PRO for dsPIC30/33 and PIC24
MikroElektronika
460
Soft_UART_Read
Soft_UART_Write
Prototype
function Soft_UART_Read(var error : byte) : 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
var data_ : byte;
error : word;
...
// wait until data is received
repeat
data_ := Soft_UART_Read(error);
until (error = 0);
// Now we can work with data:
if (data_) then begin ... end
Notes The Software UART library implements time-based activities, so interrupts need to be disabled when
using it.
Prototype
procedure Soft_UART_Write(udata : 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
var some_byte : 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.