Setting Up the Toolchain

You will need a PIC programmer to write your own HEX files onto the badge. PICkit 3 and PICkit 4 have both been tested to work as programmers via the pin header on the badge.

The BASIC badge is based around a PIC32MX370F512H. Software is compiled using MPLABX, XC32 compiler, and legacy peripheral libraries from Microchip.

1. Download three packages:
   • Navigate to the Downloads" tab at the bottom of the Microchip Compilers page.
   • Download MPLAB® XC32/32++ Compiler v2.05 for your operating system
   • Download PIC32 Legacy Peripheral Libraries for your operating system
   • Navigate to the "Downloads" tab part way down the screen at the Microchip MPLAB X IDE page.
2. Install the packages:
   • Install the XC32 compiler first
   • Install the peripheral libraries next. IMPORTANT: You must specify the same directory as the XC32 compiler. This will likely not be the default option during install. For Linux installation this director was: /opt/microchip/xc32/v2.05/
   • Install MPLABX IDE
3. Open the MPLABX project from this repository
   • A PIC programmer like the PICKIT3 is required to program your badge
   • On the PIC programmer, pins 1-5 correspond to RES, V+, GND, B0, and B1 on the badge

User Examples for C Programming

The stock firmware includes an example program that has both a menu entry, and many of the commands that will commonly be needed to write your own C code.

• Selecting user program will run void user_program_init(void) first.
  • This is where you should do all of your program setup. This is a good function to call from your program when you want it to start over again.
• After the init function is called, void user_program_loop(void) will be called
  • This is where the main functionality of your program should be stored.
  • If this function returns, it will immediately be called again.
• millis() is a 32-bit upcounting millisecond timer. Non-blocking delays are a matter of setting a variable as millis()+1000 and then polling millis() until it is larger than this variable.

Advanced

• The screen defaults to scanning a 40x20 character array (screen will automatically update when array data changes). For direct control of the screen:
  • enable_display_scanning(0); //Turns off auto  screen scanning, value of 1 turns back on
  • view disp.h for screen manipulation functions to use in manual mode

• When directly controlling the screen, you will want to perform a screen refresh after badge wakes up from sleep
  • There is function pointer in hw.h that will call your screen refresh function on wake. Here is the example for setting which function will be executed (do this in the initialization function of your program):
  • start_after_wake = &you_refresh_function;