Create a Project

Create a new project and select the PIC16F1619 along with the Curiosity Board and MPLAB® XC8 compiler. If this is your first time creating a project, click on the link below to expand the directions.

Create A New "Stand-Alone" Project Instructions ►

Create A New "Stand-Alone" Project Instructions ▼

 Step-by-Step

1

Launch the new project wizard

Launch the New Project Wizard using one of the following methods:

• From the Toolbar: Click on the New Project icon , or
• From the Menu: Select File ► New Project, or
• From the Keyboard: Ctrl + Shift + N

The project wizard will walk you through the process and prompt you for all the required information. Your selections may be changed after the project has been created by modifying the project's properties.

2

Choose Project

a

Choose Microchip Embedded from the Categories column (center).

b

Choose Standalone Project from the Projects column (right).

c

Click the Next > button.

Click image to enlarge.

3

Select Device

a

Choose the device family from the Family drop-down box.

​

If you have used MPLAB X IDE previously, choosing Recently Used from the Family drop-down box will filter the Device list to the 3 devices you have used most recently.

b

Choose your device's part number from the Device drop down box. You may also type in the part number directly, and the list will adjust to the characters you enter.

Click image to enlarge.

4

Select Header

​

The wizard will automatically skip this step if a header is not available for your selected device.

If you are using a debug header with your debugger, select it from the Supported Debug Header drop-down box. They are listed by the header's part number.
If you are not using a debug header (i.e. the debugger is directly connected to the target device), select None.

Click image to enlarge.

5

Select Tool

If you are using a hardware debugger / programmer, you should see a serial number under its heading if it is connected to your system. Click on the serial number to associate that specific tool with your project. It is important to select the serial number itself because MPLAB X IDE permits multiple projects to be open simultaneously, and each one may use a different debug tool. For example, if you have three ICD3's connected to your PC, you could have three projects open and each one assigned to a different ICD3. This makes it possible to simultaneously debug multiple applications in the same instance of MPLAB X IDE.

For software based tools, such as the simulator, you only need to click on the tool's name to select it.

​

Hover your mouse pointer over the colored dots to see their meaning for a specific tool. Red = No Support, Yellow = Beta Support, Green = Production Tested.

Click image to enlarge.

6

Select Plug-in Board

​

The wizard will automatically skip this step if a plug-in board is not available for your selected device.

If you are using a plug-in board to enhance the features of your debugger (usually the Real ICE), select it from the Selected Plugin Board drop-down box. They are listed by function.
If you are not using a plug-in board (i.e. standard debugger configuration), select None.

Click image to enlarge.

7

Select Compiler

The IDE will display all compilers available on your system that support your selected device. Select the compiler (including version number) you wish to use for building the project.

Click image to enlarge.

8

Select Project Name and Folder

a

Choose a Project Name. This will be your project's name as well as the name of the project directory (with a ".X" appended) that the IDE will create.

b

Choose a Project Location. This is where the IDE will create the project directory.

If a directory with the specified name already exists and has no MPLAB X IDE project files in it, the IDE will use the existing directory for the new project. If the directory does have MPLAB X IDE files in it from another project, the wizard will give an error that must be fixed by choosing a different project name or location. If the directory does not exist, the IDE will create it and use it for the new project.

Click image to enlarge.

---

Launch MCC

Open the MPLAB Code Configurator under the Tools -> Embedded menu of MPLAB X IDE.

System Setup

From Project resources choose System Module to open the System Setup window within MCC.

• In the clock settings, make sure you select INTOSC
• Select the system clock FOSC.
• Set Internal Clock to 4MHz_HF setting.
• Check the PLL Enabled box.
• The Curiosity Board uses a programmer/debugger on board (PKOB) and uses a Low Voltage Program method to program the MCU, therefore we must enable low voltage programming by checking the Low-voltage programming Enable box.

Timer 6 Setup

Add the TMR6 peripheral to the project from the Device Resources area of MCC. To do that, scroll down to the Timer entry and expand the list by clicking on the arrow. Now double click-on the TMR6 entry to add it to the Project Resources list. Then click on the TMR6 to open the Timer 6 configuration setup screen.

1. Check the Enable Timer box
2. Select Clock Source LFINTOSC, Postscaler 1:1, Prescaler 1:32
3. Set Timer period value to 100.129 ms
4. Set External Reset Source to T6IN, Control mode setting to Roll over pulse,
5. Set Start/Reset Option to Software Control (this will inhibit hardware reset of timer).
6. Leave the Enable Timer Interrupt box unchecked.

ADC Setup

Add the ADC Peripheral to the Project Resources from the Device Resources area.
Scroll down to the ADC entry and expand the list.
Now double click-on the ADC entry to add it to the Project Resources list.

Click on the ADC and the setup window will show up. Follow the steps below.

1. Check the Enable ADC box
2. Select Clock Source: FRC
3. Set Result Alignment: right
4. Set Postitive Vref is VDD
5. Set Auto-conversion Trigger to TMR6_postscaled
6. Check the Enable Timer Interrupt box

Pin Manager Setup

The potentiometer labeled POT1 and LEDs labeled D4-D7 on the Curiosity board need to be connected to the proper pins in software to match the hardware. This is easily done in the Pin Manager by clicking on the blue lock to change it to green.

1. Click on RC0 in ADC row
2. Click on RA1, RA2, RA5, and RC5 in the GPIO Output row.

Assign Custom Names
Click on the Pin Module in the project resources area.

1. Uncheck WPU (Weak Pull-up) box for all pins
2. Uncheck Analog box for all but RC0
3. Rename RC0 Custom Name to POT1_AN4
4. Rename RA1 Custom Name to D5_RA1
5. Rename RA2 Custom Name to D6_RA2
6. Rename RA5 Custom Name to D4_RA5
7. Rename RC5 Custom Name to D7_RC5

Generate Driver Code

Click on the Generate button in the Project Resources area of the MCC screen to have the MCC create the drivers and a base main.c file for the project.

adc.c

To control the LEDs based on the Analog to Digital conversion the interrupt service routine (ISR) needs to be updated in the adc.c file. The Timer 6 overflow starts the ADC conversion and then when the conversion is complete the ADC interrupt will run the adc.c file ISR.
These lines need to be added to the ADC_ISR function in the adc.c file. This will store the ADC result in a variable adval then light the LEDs based on that value.

adc_result_t adval = ADC_GetConversionResult();
D4_RA5_LAT = (adval > (1024*1)/5); // LEDD4 on if adval>204
D5_RA1_LAT = (adval > (1024*2)/5); // LEDD5 on if adval>409
D6_RA2_LAT = (adval > (1024*3)/5); // LEDD6 on if adval>614
D7_RC5_LAT = (adval > (1024*4)/5); // LEDD7 on if adval>819

The code is added to the adc.c file ADC_ISR function as shown below.

void ADC_ISR(void)
{
    adc_result_t adval = ADC_GetConversionResult();
    D4_RA5_LAT = (adval > (1024*1)/5); // LEDD4 on if adval>204
    D5_RA1_LAT = (adval > (1024*2)/5); // LEDD5 on if adval>409
    D6_RA2_LAT = (adval > (1024*3)/5); // LEDD6 on if adval>614
    D7_RC5_LAT = (adval > (1024*4)/5); // LEDD7 on if adval>819

    // Clear the ADC interrupt flag
    PIR1bits.ADIF = 0;
}

main.c

The generated main.c file needs two lines uncommented and one added for this project.
First, the Global Interrupt and Peripheral Interrupt Enable lines need to be uncommented by removing the // in front of these lines to enable interrupts.

// Enable the Global Interrupts
INTERRUPT_GlobalInterruptEnable();
// Enable the Peripheral Interrupts
INTERRUPT_PeripheralInterruptEnable();

   SYSTEM_Initialize();

    // When using interrupts, you need to set the Global and Peripheral Interrupt Enable bits
    // Use the following macros to:

    // Enable the Global Interrupts
    INTERRUPT_GlobalInterruptEnable();

    // Enable the Peripheral Interrupts
    INTERRUPT_PeripheralInterruptEnable();

    // Disable the Global Interrupts
    //INTERRUPT_GlobalInterruptDisable();

    // Disable the Peripheral Interrupts
    //INTERRUPT_PeripheralInterruptDisable();

The ADC conversion command line; ADC_StartConversion(POT1_AN4); is added to main.c before the continuous while(1) loop. This starts the Analog to Digital converter and then does nothing while looping yet the ADC runs in the background updating the LEDs based on the position of the potentiometer.

    ADC_StartConversion(POT1_AN4);
    while (1)
    {
        // Add your application code
    }

/**
 End of File
*/

Build Project

Click on the Build Project Icon (the Hammer) to compile the code and you will see a BUILD SUCCESSFUL message in the output window of MPLAB X within several seconds of processing time.

BUILD SUCCESSFUL (total time: 7s)

Make sure your Curiosity Board is connected to the USB port. Then click on the Make and Program Device icon. This will build the project again and launch the programmer built into the Curiosity Board. In the output window you should see a series of messages and when successful it will end with a Programming and Verify Successful message.

Output Window:

Connecting to MPLAB Starter Kit on Board...

Currently loaded firmware on Starter Kit on Board
Firmware Suite Version.....01.41.07
Firmware type..............Enhanced Midrange

Target detected
Device ID Revision = 2004

The following memory area(s) will be programmed:
program memory: start address = 0x0, end address = 0x7ff
configuration memory

Programming...
Programming/Verify complete