PIC24 support library

The PIC24 support library is divided into external components, internal components, and utilities used in creating the library. External components should be called by the typical user to set up the PIC, communicate over the UART, I²C bus, etc. Internal components include both implementation details and information on adding support for PIC24 processors not currently supported by this library.

A simple example which echos characters via the UART:

#include "pic24_all.h"
int main(void) {
  // Set up clock, heartbeat, UART, print welcome message
  configBasic(HELLO_MSG);
  while (1) {
    // Echo characters
    outChar(inChar());
  }
  return 0;
}

Library components

External library components

• Development support
  • A single header file to include all the files below, in pic24_all.h
  • Delay routines in pic24_delay.h
  • Setup of IO ports in pic24_ports.h
  • Unit testing / assertions, in pic24_unittest.h
  • Miscellanous utilities in pic24_util.h
  • Processor-specific information in pic24_chip.h
  • Debug/data tranfer abilities in dataXfer.h
  • A byte-wise access to multibyte data in pic24_unions.h
• Peripheral support
  • Analog to digital converter routines, in pic24_adc.h
  • Direct memory access (DMA) routines, in pic24_dma.h
  • Enhanced controller area network (ECAN) routines, in pic24_ecan.h
  • Read/write of FLASH, in pic24_flash.h
  • Setup of timers, in pic24_timer.h
  • Serial communication support, in pic24_serial.h
  • I²C support, in pic24_i2c.h
  • SPI support, in pic24_spi.h

Internal library components

• User-configurable library settings, in pic24_libconfig.h
• Clock configuration, in pic24_clockfreq.h and pic24_clockfreq.c
• Configuration bit settings, in pic24_configbits.c
• UART support in pic24_uart.h and pic24_uart.c, which is typically called by routines in pic24_serial.h.

Utilities

The utilities page documents tools for library development and maintenance.