Utilities

The utilities below provide support for library development and maintenance.

Differences between PIC24H and PIC24E explains the approach used to create a library which builds on both E and H families.

Build tools

SCons provides automated library building and testing. Capabilities include:

• runAStyle.bat - enforce code formatting standards
• runscons.bat - Run SCons, collecting and filtering warnings
• SConstruct.py - Build all libraries and examples over many chips
  • SCons_bootloader.py - Build the bootloader
  • SCons_build.py - Build all libraries and examples
  • SCons_esos.py - Build ESOS chapter 14 applications
  • SCons_zipit.py - Build docs then create a .zip for distribution
  • SConscript.py - Build source files from template
  • SConstruct - Define the SCons build process

Bootloader

The bootloader allows the PIC to be programmed from the serial port. It’s based around Microchip’s AN1094.

• main.c - PIC Bootloader core code.
• mem.c - Read/write the PIC’s program memory.
• pic24_uart-small.h - Headers for bare minimum UART functionality for the bootloader.

Bootloader support

These utilities help create files needed by the bootloader, or linker files for use with the bootloader.

• convert_gld.py

Code generation tools

The files below assist in generating and maintaining a mapping between the Rxy pins on a PIC and its associated CNm, ANn pins for many processors.

• data_sheet_to_csv.py - GUI to assist in translating Microchip data sheets to pin mappings
• compect_csv.py - Group all processors with identical mappings together

Testing

The following programs provide some unit testing of various libary-related routines.

• dataXfer_test.c - Runs unit tests on PIC data transfor protocol
• test_ports.c - Test the GPIO configuration macros in includepic24_ports_config.h
• unitTest.c - Implements unit tests for the microcontroller comm protocol
• unittest_rounding.c - Unit tests of the round functions