====== Installing the Digilent Core for Arduino ======

This guide will provide a step by step walk-through of installing the Digilent Core on Arduino (Windows/Mac/Linux). This will install the board files, compilers, and programmers necessary to program Digilent PIC32 boards using Arduino.

-----

===== Prerequisites =====

===Software===
  * **Arduino 1.6.9** 
    * [[https://www.arduino.cc/en/Main/OldSoftwareReleases#previous | Version 1.6.9 is highly recommended]]. The newer versions have introduced complications with file inclusions, and may not be compatible with the Digilent Core.
  * **Note:** If you have version 1.0.1 or earlier installed, you will need to first delete the "xc32-tools-Digilent-master-win.zip" located at:
    * **Windows** - %LocalAppData%\Arduino15\staging\packages 
    * **Mac** - /Users/<USERNAME>/Library/Arduino15/staging/packages
-----


=====Tutorial=====


====1. Adding the board manager URL ====

>1.1) **Open** Arduino and click **File>>Preferences**.
>
>Copy and paste the following URL into the "Additional Boards Manager URLs" box.
>https://s3-us-west-2.amazonaws.com/digilent/Software/Digilent_Core/package_digilent_index.json
>
>Click OK when finished.
>
>{{:learn:software:tutorials:digilent-core-install:boardurl.jpg?nolink&500|}}


>1.2) Click **Tools>Board>Boards Manager...** to open the Arduino boards manager.
>
>{{:learn:software:tutorials:digilent-core-install:board_manager.jpg?nolink&500|}}

>1.3) Scroll to the bottom and click the **Install** button for the Digilent Core to install it.
>
>{{:learn:software:tutorials:digilent-core-install:board_manager2.jpg?nolink&500|}}

>1.4) Once it has finished installing, the Digilent boards can be selected in the **Tools>Board** menu.
>
>{{:learn:software:tutorials:digilent-core-install:boards.jpg?nolink&500|}}

{{tag>digilent-core tutorial basys-mx3 pmod }}