Chameleon-PIC Nurve Networks, Chameleon-PIC Datasheet - Page 147

• Manufacturer Part Number: Chameleon-PIC
• Description: MCU, MPU & DSP Development Tools PIC24 & PROPELLER DEV SYSTEM (SBC)
• Manufacturer: Nurve Networks

Specifications of Chameleon-PIC

• Processor To Be Evaluated: PIC24
• Data Bus Width: 16 bit
• Interface Type: USB, VGA, PS/2, I2C, ISP, SPI
• Operating Supply Voltage: 3.3 V, 5 V
• Lead Free Status / RoHS Status: Lead free / RoHS Compliant

The above #defines are used as parameters to void UART_vt100SetAttr(unsigned char attr) that is used for setting VT100
terminal modes as discussed in the previous section.
extern volatile unsigned char UART1_tx_buffer[UART1_TX_BUFFER_SIZE];
extern volatile unsigned int UART1_tx_buffer_add_pointer;
extern volatile unsigned int UART1_tx_buffer_send_pointer;
extern volatile unsigned int UART1_tx_buffer_bytes_to_send;
extern volatile unsigned char UART1_rx_buffer[UART1_RX_BUFFER_SIZE];
extern volatile unsigned int UART1_rx_buffer_add_pointer;
extern volatile unsigned int UART1_rx_buffer_out_pointer;
extern volatile unsigned int UART1_rx_buffer_bytes_in_buffer;
These globals simply contain the internal pointers and circular buffers used in the UART driver. Users typically would not
modify these directly but we extern them here for the unlikely scenario.
18.4 API Listing Reference
The API listing for the “UART and RS-232” module CHAM_PIC_UART_DRV_V010.c is listed in Table 18.2 categorized
by functionality.
Function Name
Initialization
void UART_Init(unsigned long BaudRate);
Transmission
void UART_printf( const char *buff, ...);
void UART_puts( const char *buff);
int UART_putchar(int ch);
void UART_Newline();
void UART_BlockSend(unsigned char ch);
Reception
int UART_gets(unsigned char *Data);
int UART_getchar(unsigned char *ch);
unsigned char UART_BlockRead();
VT100 Commands
void UART_vt100Init(void);
void UART_vt100ClearScreen(void);
void UART_vt100SetCursor(…);
void UART_vt100SetAttr(unsigned char attr);
18.5 API Functional Declarations
The following lists each function, a description, comments, and example usage of the function.
_____________________________________________________________________________________________
Table 18.2 – UART driver API functions listing.
Description
Initializes the UART peripheral hardware.
Sends the string with variable arguments to the UART.
Sends the NULL terminated.
Transmits a single character.
Transmits an ASCII line feed <CR/LF>.
Sends a single byte and blocks until character has been transmitted.
Reads in a string up to and including the carriage return <CR>.
Gets a single character if any are available.
Waits until a character has been received.
Resets the VT100 terminal.
Clears the VT100 terminal screen
Sets the terminal cursor to the specified line/column.
Sets the next printed text’s attributes.
© 2009 NURVE NETWORKS LLC “Exploring the Chameleon PIC 16-Bit”
147