Difference between revisions of "Unit RPIGPIOEXPANDER"

Revision as of 03:14, 28 March 2018

Return to Unit Reference

Description

Raspberry Pi Firmware GPIO Expander Driver unit

As of February 2017 the Raspberry Pi firmware contains a mailbox interface to allow control of the GPIO expander on the Raspberry Pi 3 and Compute Module 3.

Unlike the earlier virtual GPIO interface this mailbox service now supports most GPIO functionality including getting and setting a pin value, getting and changing the pin function and getting or changing the pull up/down options.

This driver implements most of the functionality available in the new mailbox service as a standard Ultibo GPIO device and also provides direct mailbox calls to allow access to any additional options not covered by the GPIO device API.

When included in a project this driver replaces the Virtual GPIO functions provided by the PlatformRPi2 and PlatformRPi3 units.

According to /arch/arm/boot/dts/bcm2710-rpi-3-b.dts the following pin assignments are known:

• GPIO_PIN_2 = Activity LED
• GPIO_PIN_4 = HDMI Detect (Input / Active Low)
• GPIO_PIN_7 = Power LED (Input / Active Low)

For the Raspberry Pi 3B+ the assignments show in /arch/arm/boot/dts/bcm2710-rpi-3-b.dts have changed as follows:

• GPIO_PIN_2 = Power LED (Active Low)
• GPIO_PIN_4 = HDMI Detect (Input / Active Low)

Note that this driver requires the most recent firmware (later than February 2017) and has been tested successfully with the firmware release from 17 March 2018.

The latest version of the firmware is available from https://github.com/raspberrypi/firmware

Constants

Type definitions

RPiGPIO expander specific types

Public variables

None defined

Function declarations

Initialization functions

procedure RPiGPIOExpanderInit;

RPiGPIO expander GPIO functions

function RPiGPIOExpanderStart(GPIO:PGPIODevice):LongWord;

function RPiGPIOExpanderStop(GPIO:PGPIODevice):LongWord;

function RPiGPIOExpanderInputGet(GPIO:PGPIODevice; Pin:LongWord):LongWord;

function RPiGPIOExpanderOutputSet(GPIO:PGPIODevice; Pin,Level:LongWord):LongWord;

function RPiGPIOExpanderPullGet(GPIO:PGPIODevice; Pin:LongWord):LongWord;

function RPiGPIOExpanderPullSelect(GPIO:PGPIODevice; Pin,Mode:LongWord):LongWord;

function RPiGPIOExpanderFunctionGet(GPIO:PGPIODevice; Pin:LongWord):LongWord;

function RPiGPIOExpanderFunctionSelect(GPIO:PGPIODevice; Pin,Mode:LongWord):LongWord;

RTL virtual GPIO functions

function SysVirtualGPIOInputGet(Pin:LongWord):LongWord;

function SysVirtualGPIOOutputSet(Pin,Level:LongWord):LongWord;

function SysVirtualGPIOFunctionGet(Pin:LongWord):LongWord;

function SysVirtualGPIOFunctionSelect(Pin,Mode:LongWord):LongWord;

RPiGPIO expander helper functions

function RPiGPIOExpanderGetState(GPIO:LongWord; var State:LongWord):LongWord;

function RPiGPIOExpanderSetState(GPIO,State:LongWord):LongWord;

function RPiGPIOExpanderGetConfig(GPIO:LongWord; var Direction,Polarity,Terminator,PullUp:LongWord):LongWord;

function RPiGPIOExpanderSetConfig(GPIO,Direction,Polarity,Terminator,PullUp,State:LongWord):LongWord;

Return to Unit Reference