Mikroelektronika MIKROE-738 Datenbogen
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 flag. 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 -
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.