chipKIT core

From chipKIT
Jump to: navigation, search


The chipKIT core is a plugin for Arduino-style development environments. It contains all the files you need to start programming a chipKIT™ board with the well-known Arduino API. Included in the package are the API source code, the compiler, board definitions for all the common chipKIT boards, and the programming tools needed to upload your sketch to your desired board. In addition, a number of libraries that mirror the standard Arduino libraries are included: SPI.h, Wire.h, and more. Note that the chipKIT core replaced the need for MPIDE, and as such, the now portable bundle of files easily drops into environments like Arduino IDE and UECIDE.

Install in Arduino IDE

The easiest way to get started is to use Arduino IDE. The instructions below provide these details.

Tutorial

For guided install instructions, reference the "Installing and Using the Arduino IDE Development Tool" lab from PONTECH's Education page.

Installation Methods

Before installing the chipKIT core, you must first download Arduino IDE and install it. Once installed, there are two methods (detailed below) for installing the chipKIT-core component within the Arduino IDE. Note that Arduino 1.6.7+ is required for method #1 below, but method #2 below can be used with version 1.6.4+.

IMPORTANT NOTE: (added April 20th, 2016) Version 1.6.8 of the Arduino IDE has a bug in it (at least under Windows - possibly the others too) that will prevent it from working properly with any board that uses an FTDI USB to Serial bridge chip - which includes all Digilent chipKIT board except the DP32. The Fubarino SD, Fubarino Mini, chipKIT Pi and DP32 do not use FTDI chips, and so will not have this problem. The solution is to either use version 1.6.7 of the Arduino IDE, or use a nightly build of 1.6.9, which has the problem fixed.

1) Auto install via URL from within Arduino IDE (latest version chipKIT-core v1.3.1)

This is the easiest and best method for end users. Follow these steps:

  • If that field is not blank, then click the little box icon to the right of the text field, and copy/paste the URL https://github.com/chipKIT32/chipKIT-core/raw/master/package_chipkit_index.json onto the next line of the text entry field. Arduino lets you have as many different cores as you want loaded into the IDE as long as each URL is on a separate line. Click OK to close the Additional Boards Manager URLs dialog box and then click OK again to close the Preferences dialog box.
  • Now select the Tools->Board->Board Manager menu from the Arduino IDE, and it will open up the Boards Manager window. From there, scroll down until you see the chipKIT board. Click once on any of the text in the chipKIT section, and you will see a button appear that says "Install". It will take some time to download all of the chipKIT components and install them, but when it's done, you can click the Close button to close the Board Manager window.
  • Now choose a chipKIT board from the Tools->Board menu and program your chipKIT board!

Note that as new versions of the chipKIT-core files are released, you will get to update your chipKIT-core files from inside the Arduino IDE, and select which version you'd like to install/update to.

Currently the MacOS X, Windows, and Linux32 OSes are fully supported using this method, as of chipKIT-core v1.0.1. The Linux64 version also works, but you must install the 32-bit compatibility libraries on your system to make it work as the compiler is only a 32 bit executable.

If you are using Linux you need to add the user to the "dialout" group before programming the board. This step is required in order to obtain the necessary permissions. For Ubuntu this can be achieved with the following command: sudo adduser <username> dialout. Logoff and login may also be needed after this step.

2) Manual install by copying ZIP file

This is the second method for installing chipKIT-core, and it is normally used by chipKIT developers who want to have the very latest chipKIT-core code available for testing.

  • Download the latest version of the chipKIT-core archive file for your platform (see below for the download links).
  • Extract the chipkit-core folder from the archive file, and move it into your Arduino/hardware folder. If there is no 'hardware' folder, you can create one. The location of the Arduino folder will be different in every system (for example, "C:\Users\Brian\Documents\Arduino\hardware" under Windows) but if you want to know where yours is, simply open the Arduino IDE, and go to File->Preferences and look at the value in the "Sketchbook location:" field.
  • Make sure that you have "Arduino\hardware\chipkit-core\pic32\", as it's possible to get an extra level of chipkit-core folder in there, which will prevent things from working right.
  • Now fire up the Arduino IDE with this new core installed, and from the Tools->Board menu you should see all of the chipKIT boards available. Choose the board you have, and you are ready to compile.

64-Bit Linux

Unfortunately the compiler is only available as 32-bit. This means you will need to install (if not already done) 32-bit support in Linux. The other binaries (e.g., pic32prog) in the 64-bit packages are true 64-bit binaries.

To install 32-bit support in 64-bit Debian based operating systems (such as Ubuntu) you need to install libc6-i386:

   $ sudo apt-get install libc6-i386

For other flavours of Linux please check the documentation and other online guides for installation instructions.

Drivers

For information on the USB drivers that chipKIT boards use, see the ChipKIT Drivers page.

ChipKIT-core Release Notes

ChipKIT core release notes lists each release of chipKIT-core and what has changed between each version.

Download Links

chipKIT-core builds are designated either 'test' or 'release'. Test builds are created by the development team when a new feature or significant bugs have been fixed, and they are tested by users who want the latest but are willing to tolerate some instability or issues. Release builds are created once a test build has been tested by many people and few if any issues are found.

Release Builds

2016-September-2 - Version 1.3.1 (same code as URL install version v1.3.1) Release Notes ChipKIT core release notes

2016-August-29 - Version 1.3.0 (same code as URL install version v1.3.0) Release Notes ChipKIT core release notes

2016-June-7 - Version 1.2.0 (same code as URL install version v1.2.0) Release Notes ChipKIT core release notes

2016-Jan-10 - Version 1.1.0 (same code as URL install version v1.1.0) Release Notes ChipKIT core release notes

Test Builds

2015-10-18

2015-09-03