Revision as of 15:53, 24 May 2018

Synopsys

This guide illustrates how to build and run a first ERIKA Enterprise v3 application for dsPIC33EV 5V CAN-LIN STARTER KIT board.

Prerequisites

Please remember to install Java, Cygwin, and Doxygen to obtain the full functionality described in this tutorial.

Additional information on prerequisites is available at the Quick Start Guide - Prerequisites.

RT-Druid Eclipse IDE

• Double-click the eclipse.exe application located in the eclipse folder extracted from the RT-Druid Package. Then, the workspace selection window will appear as shown in the following figure:

Figure 1: RT-Druid Eclipse IDE workspace selection.

• Browse the file-system to select Workspace folder and then click on the OK button to let the RT-Druid Eclipse IDE start as shown in the following figure:

Figure 2: RT-Druid Eclipse IDE welcome.

• Click on the Welcome tab-sheet close button to show the default RT-Druid Eclipse IDE C/C++ perspective as shown in the following figure:

Figure 3: RT-Druid Eclipse IDE C/C++ perspective.

RT-Druid Template Project

• Click on File->New->RT-Druid v3 Oil and C/C++ Project menu entry as shown in the following figure:

Figure 4: RT-Druid v3 Oil and C/C++ Project.

• The RT-Druid C/C++ Project Wizard will open as shown in the following figure:

Figure 5: RT-Druid C/C++ Project Wizard.

• Type the name of the project in the Project name text-box (e.g., EE3dsPIC33EV).

• Make sure the Cygwin GCC toolchain is selected and then click on the Next button.

• The wizard will show the window to select a project template as shown in the following figure:

Figure 6: RT-Druid Project Template Wizard.

• Click on Create a project using one of these templates check-box to let the Template Wizard to show the available templates as shown in the following figure:

Figure 7: RT-Druid Available Templates Wizard.

• Expand the dsPIC33-PIC24 and dsPIC33EV Starter Kit entries and choose the desired template to instantiate: Event Demo for example.

• Finally, click on the Finish button to instantiate an RT-Druid Eclipse project from a chosen template as shown in the following figure:

Figure 8: RT-Druid Eclipse Project.

RT-Druid Configuration

• Click on the Window->Preferences menu entry as shown in the following figure:

Figure 9: RT-Druid Eclipse Preferences.

• The RT-Druid Eclipse Preferences window will open as shown in the following figure:

Figure 10: RT-Druid Eclipse Preferences OIL.

• Click the Generator Properties entry in the OIL section of the left panel to show the RT-Druid Generator Properties to configure.

• Double-click on the MPLAB XC16 C Compiler property to configure the MPLAB XC16 C Compiler installation path as shown in the following figure:

Figure 11: RT-Druid MPLAB XC16 C Compiler Path Property.

• Browse the file-system to select the MPLAB XC16 C Compiler path (E.g. C:\Program Files (x86)\Microchip\xc16\v1.33) and then click the OK button.

• Double-click on the MPLAB-X IDE property to configure the MPLAB-X IDE installation path as shown in the following figure:

Figure 12: RT-Druid MPLAB-X IDE Path Property.

• Browse the file-system to select the MPLAB-X IDE path (E.g. C:\Program Files (x86)\Microchip\MPLABX\v4.05) and then click the OK button.

• Finally, click the OK button to confirm the configuration properties as shown in the following figure:

Figure 13: RT-Druid Configured Properties.

ERIKA distribution clean

• Right-Click on EE3dsPIC33EV project into Eclipse Project Explorer panel and click on Clean Erika context-menu entry as shown in the following figure:

Figure 14: Erika Clean.

• The Clean up Erika Files dialog window will appear as shown in the following figure:

Figure 15: Clean up Erika Files.

• Click on the Yes button to clean the whole ERIKA distribution.

NOTE: the distribution folder will be automatically regenerated if the flag Build Automatically is enabled.

Figure 16: Build automatically flag.

NOTE: this operation may be necessary every time an ERIKA or RT-Druid configuration property is modified.

ERIKA project build

• Right-click on EE3dsPIC33EV project into Eclipse Project Explorer panel and click on Build Project context-menu entry as shown in the following figure:

Figure 17: Erika project build.

• The build process starts as shown in the following figure:

Figure 18: Erika build process.

• The build process ends successfully as shown in the following figure:

Figure 19: Erika build successfully.

Add Upload Build Target

• Right-Click on EE3dsPIC33EV project into Eclipse Project Explorer panel and click on Create... item of the Build Target context-menu entry, as shown in the following figure:

Figure 20: Add Upload Build Target.

• The Create Build Target dialog window will appear as shown in the following figure:

Figure 21: Create Build Target.

• Type upload into Target name text-box, uncheck the Run all project builders check-box and then click on OK button.

• The upload target will be created as shown in the following figure:

Figure 22: Upload Target.

'NOTE: this operation should be done once for every ERIKA project.

Application Upload on dsPIC33EV-SK Board

• Double-Click on upload build target created in the previous section to start the upload process as shown in the following figure:

Figure 23: Upload Process.

• The upload process ends successfully as shown in the following figure:

Figure 24: Upload Process.

• Check the application running on dsPIC33EV-SK board.

Additional Notes

T.B.D.