Mikroelektronika MIKROE-738 Datenbogen

Seite von 682
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 
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.