UART Wildcard User Guide

<< Previous | Next>>

Glossary Entries

C: int Ask_Key_UART ( int channel_num, int module_num )
4th: Ask_Key_UART ( channel_num\module_num -- flag )
Returns a flag indicating the receipt of a character on the specified serial channel. The flag is true (-1) if there is at least one character in the input FIFO of the specified channel. Otherwise the returned flag is false (0). See also Ch1_Ask_Key and Ch2_Ask_Key.

C: int Ch1_Ask_Key ( void )
4th: Ch1_Ask_Key ( -- flag )
Returns a flag indicating the receipt of a character on serial channel 1. The value set by the last execution of Set_UART_Number specifies the module number. The flag is true true (-1) if there is at least one character in the input FIFO. Otherwise the returned flag is false (0). The demonstration program shows how to use this function to revector serial I/O in a task. See also Ask_Key_UART.

C: void Ch1_Emit ( uchar character )
4th: Ch1_Emit ( char -- )
This function queues the specified character in the output FIFO for transmission on serial channel 1. The value set by the last execution of Set_UART_Number specifies the Wildcard number. If the output FIFO is full, this routine waits and PAUSEs until there is room in the FIF0, then puts the specified character in the FIFO so that it will be transmitted. The demonstration program shows how to use this function to revector serial I/O in a task. See also Emit_UART.

C: uchar Ch1_Key ( void )
4th: Ch1_Key ( -- char )
Waits (if necessary) for receipt of a character from channel 1, and returns the received character. The value set by the last execution of Set_UART_Number specifies the Wildcard number. PAUSEs while waiting. The returned byte is the next pending character in the FIFO (that is, the oldest unretrieved character in the receive FIFO). The demonstration program shows how to use this function to revector serial I/O in a task. See also Key_UART.

C: int Ch2_Ask_Key ( void )
4th: Ch2_Ask_Key ( -- flag )
Returns a flag indicating the receipt of a character on serial channel 2. The value set by the last execution of Set_UART_Number specifies the Wildcard number. The flag is true true (-1) if there is at least one character in the input FIFO. Otherwise the returned flag is false (0). The demonstration program shows how to use this function to revector serial I/O in a task. See also Ask_Key_UART.

C: void Ch2_Emit ( uchar character )
4th: Ch2_Emit ( char -- )
This function queues the specified character in the output FIFO for transmission on serial channel 2. The value set by the last execution of Set_UART_Number specifies the Wildcard number. If the output FIFO is full, this routine waits and PAUSEs until there is room in the FIF0, then puts the specified character in the FIFO so that it will be transmitted. The demonstration program shows how to use this function to revector serial I/O in a task. See also Emit_UART.

C: uchar Ch2_Key ( void )
4th: Ch2_Key ( -- char )
Waits (if necessary) for receipt of a character from channel 2, and returns the received character. The value set by the last execution of Set_UART_Number specifies the Wildcard number. PAUSEs while waiting. The returned byte is the next pending character in the FIFO (that is, the oldest unretrieved character in the receive FIFO). The demonstration program shows how to use this function to revector serial I/O in a task. See also Key_UART.

<< Previous | Next>>