You are here

Peripheral Driver Library (PDL) | Cypress Semiconductor

Peripheral Driver Library (PDL)

Last Updated: 
Oct 20, 2016
Version: 
*B

The FM MCU Peripheral Driver Library (PDL) simplifies software development for the FM0+, FM3, and FM4 MCU portfolios.  The PDL reduces the need to understand the register usage and bit structures, thus easing the software development for the extensive set of peripherals in the FM portfolios.

The PDL is a superset of all the code required to build any driver for any FM0+, FM3, or FM4 device.  It provides a high-level API to configure, initialize, and use a peripheral.  Using the PDL makes porting code from one family to the other easier, because the same code supports all FM families.  The PDL provides numerous code examples that demonstrate how to use the peripherals.

Developers who wish to program at the register level should use the PDL.  PDL 2.1 includes the necessary startup code and IDE project files for each supported device.  In addition, the PDL is provided as source code.  Examining the PDL source code is a useful way to approach the detailed knowledge required to program a microcontroller at a low level.  Combined with study of the appropriate data sheet and peripheral manual, you can learn the information you need to program a peripheral at the register level.

For older versions of the PDL SW and Documentation, please visit the Peripheral Driver Library (PDL) Software and Documentation Archive page.

Note that the PDL 2.1 does not currently support the FM3 portfolio.  Developers targeting the FM3 portfolio should continue to use PDL 2.0.x.

 

Significant changes and improvements in PDL 2.1

Item

PDL 2.0.x*

PDL 2.1

Portfolio Support

FM0+, FM3, FM4

FM0+, FM4

Peripherals

 

Removed I2SL (the same functionality is in I2S)

Code Examples

A single project file for each IDE, must reconfigure for every microcontroller

A project file for each code example, for each IDE

Low-level programming

 

Preconfigured project file provided for each device package, for each IDE (does not include PDL files)

IDE Support

IAR Embedded Workbench 7.5
Keil µVision v 4.7

IAR Embedded Workbench 7.50.3
Keil µVision v 5.18
iSYSTEM winIDEA v9.12

Atollic TrueSTUDIO v5.5.2
GCC makefile

Documentation

 

Includes overview and setup information for each peripheral

Enhanced the left menu navigation to provide direct access to #defines, enums, structures, and functions

Device support

Monolithic, used #ifdef to configure PDL for a particular series and package

Dedicated device header file and startup code for each device package, using CMSIS v4.5

pdl_device.h

Required to specify series and package for gpio.h

No longer used

*Note that the PDL 2.1 does not currently support the FM3 portfolio.  Developers targeting the FM3 portfolio should continue to use PDL 2.0.x.

 

Supported Peripherals

Peripheral

Description

Peripheral

Description

BT

Base Timer

ICC

IC Card Interface

CAN

Controller Area Network

LCD

Liquid Crystal Display

CLK

Clock Functions

LPM

Low Power Modes

CR

RC Oscillator trimming

LVD

Low Voltage Detection

CRC

Cyclic Redundancy Check

MFS

Multi-Function Serial Interface

CSV

Clock Supervisor

MFT

Multi-Function Timer

DAC

Digital Analog Converter

PCRC

Programmable CRC

DMA

Direct Memory Access

PPG

Programmable Pulse Generator

DSTC

Descriptor System Data Transfer Controller

QPRC

Quadrature Position/Revolution Counter

DT

Dual Timer

RC

Remote Control

(HDMI-CEC/Remote Control Reception/Transmission)

EXINT

External Interrupts

RESET

Reset

EXTIF

External Bus Interface

RTC

Real Time Clock

Flash

Flash Memory

SDIF

SD Card Interface

GPIO

General Purpose I/O Ports

UID

Unique ID

HBIF

HyperBus Interface

VBAT

VBAT Domain

HSSPI

High Speed Quad Serial Peripheral Interface

WC

Watch Counter

I2CS

Inter IC Slave

WDG

Software and Hardware Watchdog Counter

I2S

Inter IC Sound

 

 

 

Supported Development Tools

The PDL Quick Start Guide available for download on this page may be a newer version than what is installed with the PDL.

The PDL is tested with and project files are provided for:

Translated documents are for reference only. We recommend that you refer to the English-language version of a document if you are engaged in development of a design.