User manual

426
mikoC PRO for PIC32
MikroElektronika
Soft_UART_Read
Soft_UART_Write
Prototype
char Soft_UART_Read(char *error);
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
char data_;
char error;
...
// wait until data is received
do
data = Soft_UART_Read(&error);
while (error);
// Now we can work with data:
if (data_) {...}
Notes The Software UART library implements time-based activities, so interrupts need to be disabled when
using it.
Prototype
void Soft_UART_Write(char udata);
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
char some_byte = 0x0A;
...
// 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.