doc/html/uart_xc16_demo1_2main_8c-example.html

#define THIS_IS_MAIN_FILE   //Uniquely identifies this as the file with the main application entry function main()


// Includes /////////////////////////////////////

#include "HardwareProfile.h"    //Required for all Netcruzer projects

#define USE_AND_OR              //Required by XC16 to enable AND_OR mask setting

#include "uart.h"


//Add debugging. DEBUG_CONF_MAIN macro sets debugging to desired level (defined in projdefs.h)

#if !defined(DEBUG_CONF_MAIN)

    #define DEBUG_CONF_MAIN     DEBUG_CONF_DEFAULT   //Default Debug Level, disabled if DEBUG_LEVEL_ALLOFF defined, else DEBUG_LEVEL_ERROR

#endif

#define MY_DEBUG_LEVEL   DEBUG_CONF_MAIN

#include "nz_debug.h"


// Variables ////////////////////////////////////

WORD tmrFlashLed = 0;        //Timer for flashing system LED


//Buffer for transmit data, with get (used in interrupt) and put (used in code) pointer.

BYTE Txdata[256];   //Ensure size is 256 bytes, meaning put and get pointer will automatically increment from 255 to 0!

BYTE putTxdata = 0;

BYTE getTxdata = 0;


//Buffer for receive data, with get (used in code) and put (used in interrupt) pointer.

BYTE Rxdata[256];   //Ensure size is 256 bytes, meaning put and get pointer will automatically increment from 255 to 0!

BYTE putRxdata = 0;

BYTE getRxdata = 0;


// Function Prototypes //////////////////////////

void Test_UART2_Interrupt(void);

void Test_UART2_Polling(void);


//TX interrupt ISR

void __attribute__ ((interrupt,no_auto_psv)) _U2TXInterrupt(void)

{

    //debugPutString("\nT");

    U2TX_Clear_Intr_Status_Bit;


    //If any byte available in transmit buffer, sent it

    if(putTxdata != getTxdata) {

        while(BusyUART2()); //Wait for USART to become available

        WriteUART2((unsigned int)Txdata[getTxdata++]);

    }

}


//RX interrupt ISR

void __attribute__ ((interrupt,no_auto_psv)) _U2RXInterrupt(void)

{

    //debugPutString("\nR");

    U2RX_Clear_Intr_Status_Bit;


    //If Parity, Framing or Overrun error occured, clear error flag

    if (U2STAbits.PERR || U2STAbits.FERR || U2STAbits.OERR) {

        debugPutString("\nRxErr");

        U2STAbits.PERR = U2STAbits.FERR = U2STAbits.OERR = 0;

    }


    //Save any received bytes to receive buffer

    while (DataRdyUART2())

        Rxdata[putRxdata++] = ReadUART2();

}


int main(void) {


    //Default initialization. All ports inputs. All analog features disabled. Tick 1ms

    nzSysInitDefault();


    DEBUG_PUT_STR(DEBUG_LEVEL_INFO, "\nThis is a test debug message from uart_xc16_demo1 demo");


    DIR_SYSLED = OUTPUT_PIN;    //Set System LED port as outputs


    nzDelayMs(300);


    //Initialze UART2

    iPPSOutput(PPS_OUT_36, OUT_FN_PPS_U2TX);        //Port 36 - (old port name Y6) is TX

    iPPSOutput(PPS_OUT_38, OUT_FN_PPS_U2RTS);       //Port 38 (old port name Y8) is RTS

    iPPSInput(IN_FN_PPS_U2RX, PPS_IN_37);           //Port 37 (old port name Y7) is RX

    iPPSInput(IN_FN_PPS_U2CTS, PPS_IN_39);          //Port 39 (old port name Y9) is CTS

    CloseUART2();


    //Enable UART intruupts

    ConfigIntUART2(UART_RX_INT_EN | UART_RX_INT_PR6 | UART_TX_INT_EN | UART_TX_INT_PR6);


    //UART initialized, 9600 baudrate (103=9K6 at 16MHz clock), 8bit, no parity, 1 stop bit

    OpenUART2(UART_EN, UART_TX_ENABLE, 103);


    //Main loop

    while(1)

    {

        nzSysTaskDefault();     //Main netcruzer task, call in main loop.


        //Print any data received in UART2 receive interrupt (ISR)

        while (putRxdata != getRxdata) {

            debugPutString("\nReceived 0x");

            debugPutHexByte(Rxdata[getRxdata++]);

        }


        //Enter every 500ms

        if (tick16TestTmr(tmrFlashLed)) {

            tick16UpdateTmrMS(tmrFlashLed, 500); //Update timer to expire in 10ms again


            LAT_SYSLED = !LAT_SYSLED;       //Toggle System LED


            if (LAT_SYSLED)

                Test_UART2_Interrupt();

            else

                Test_UART2_Polling();

        }

    }//end while

}


//Send message on UART using polling

void Test_UART2_Polling(void) {

    char message[] = "Hi";


    DisableIntU2TX;         //Disable TX interrupt

    DisableIntU2RX;         //Disable RX interrupt


    //Transmit data

    while(BusyUART2());     //Wail till available

    putsUART2((unsigned int *)message);

    while(BusyUART2());     //Wail till all bytes sent


    //Read all data from UART2 receive buffer

    while(DataRdyUART2()) {

        debugPutString("\nReceived 0x");

        debugPutHexByte(ReadUART2());

    }


    //Clear TX and RX interrupt flags that would have been set above

    U2TX_Clear_Intr_Status_Bit;

    U2RX_Clear_Intr_Status_Bit;

}


//Send message on UART using interrupt method

void Test_UART2_Interrupt(void) {

    char message[] = "Hello";

    BYTE i;


    EnableIntU2TX;          //Enable TX interrupt

    EnableIntU2RX;          //Enable RX interrupt


    //Write "Hello" to Txdata buffer

    for (i=0; i<5; i++)

        Txdata[putTxdata++] = message[i];


    //Set Transmit interrupt flag to start Transmit ISR, and send message

    IFS1bits.U2TXIF = 1;

}


#if defined(HAS_NZ_DEBUGGING)


void debugService(void) {

    //Check if a debug message was received

    if (cbufHasWholePacket(CIRBUF_RX_DEBUG)) {

        //'hi' - Reply with "Hello" on a new line

        if (cbufPacketStrcmp(CIRBUF_RX_DEBUG, "hi") == 0) {

            debugPutString("\nHello");

        }

        //Add custom debug message processing

        else if (cbufPacketStrcmp(CIRBUF_RX_DEBUG, "...") == 0) {

            //..... Do something

        }


        //Remove received packet. If it was not processed above, it is lost!

        cbufRemovePacket(CIRBUF_RX_DEBUG);

    }

}

#endif