Return to Unit Reference
Description
NXP PCF857X I/O Expander Driver unit
The NXP PCF8574 is an 8 bit I/O expander that provides GPIO pin control functions over an I2C connection.
The device can be represented in Ultibo as a standard GPIO device which is accessible via the GPIO unit functions. Because the PCF857X is a chip that can be used and configured in multiple different scenarios this unit does not autocreate a GPIO device, instead you need to call the function PCF8574GPIOCreate and pass an I2C device and address. The function will create and return a GPIO device with the appropriate number of pins and other information for the specified chip, the returned devices will have been registered with the GPIO device unit and started ready for use.
Note: This unit does not currently implement the interrupt capabilities of the PCF857X chips however it could be expanded to allow the interrupt pin to be connected to a GPIO pin on the SoC and use a trigger event from that to enable GPIOInputWait/GPIOInputEvent functions for the PCF857X chips.
Constants
[Expand]
PCF857X specific constants PCF8574_GPIO_*
PCF8574_GPIO_DESCRIPTION = 'NXP PCF8574 8-bit I/O Expander';
|
Description of PCF8574 device
|
|
PCF8574_GPIO_MIN_PIN = GPIO_PIN_0;
|
|
PCF8574_GPIO_MAX_PIN = GPIO_PIN_7;
|
|
PCF8574_GPIO_PIN_COUNT = 8;
|
|
|
PCF857X_GPIO_MAX_LEVEL = GPIO_LEVEL_HIGH;
|
|
|
PCF857X_GPIO_MAX_PULL = GPIO_PULL_UP;
|
|
|
PCF857X_GPIO_MIN_FUNCTION = GPIO_FUNCTION_IN;
|
|
PCF857X_GPIO_MAX_FUNCTION = GPIO_FUNCTION_OUT;
|
|
[Expand]
PCF857X chip PCF857X_CHIP_*
PCF857X_CHIP_PCF8574 = 0;
|
|
[Expand]
PCF857X I2C PCF8574_I2C_*
Note: The PCF857X is a single register device and does not have any direction, pull or configuration registers
|
PCF8574_I2C_RATE = 100000;
|
Default I2C clock rate (Device supports 100KHz only)
|
|
PCF8574_I2C_SIZE = 1;
|
Number of bytes to read/write all pin values
|
|
PCF857X_I2C_MAX_SIZE = 2;
|
Maximum number of bytes to read/write all pin values
|
Type definitions
PCF857X GPIO
[Expand]
PPCF857XGPIO = ^TPCF857XGPIO;
TPCF857XGPIO = record
GPIO Properties
|
GPIO:TGPIODevice;
|
|
PCF857X Properties
|
I2C:PI2CDevice;
|
The I2C device this GPIO is connected to
|
Address:Word;
|
The I2C address of the device
|
Chip:LongWord;
|
The chip type (eg PCF857X_CHIP_PCF8574)
|
Size:LongWord;
|
Size of an I2C read/write for the device
|
Rate:LongWord;
|
Clock rate for this device
|
GPIOValues:array[0..PCF857X_I2C_MAX_SIZE - 1] of Byte;
|
Buffer for GPIO port values (Output only)
|
GPPUValues:array[0..PCF857X_I2C_MAX_SIZE - 1] of Byte;
|
Buffer for GPPU pull up values
|
IODIRValues:array[0..PCF857X_I2C_MAX_SIZE - 1] of Byte;
|
Buffer for IODIR I/O direction values
|
Public variables
None defined
Function declarations
PCF857X functions
[Expand]
function PCF8574GPIOCreate(I2C:PI2CDevice; Address:Word):PGPIODevice;
Description: Create, register and start a new PCF8574 GPIO device connected to the specified I2C device
I2C
|
The I2C device this PCF8574 is connected to
|
Address
|
The I2C address for this PCF8574
|
Return
|
Pointer to the new GPIO device or nil on failure
|
[Expand]
function PCF857XGPIODestroy(GPIO:PGPIODevice):LongWord;
Description: Stop, deregister and destroy a PCF857X GPIO device created by this driver
GPIO
|
The GPIO device to destroy
|
Return
|
ERROR_SUCCESS if completed or another error code on failure
|
PCF857X GPIO functions
[Expand]
function PCF857XGPIOStart(GPIO:PGPIODevice):LongWord;
Description: Implementation of GPIODeviceStart API for PCF857X
Note
|
Not intended to be called directly by applications, use GPIODeviceStart instead.
|
[Expand]
function PCF857XGPIOStop(GPIO:PGPIODevice):LongWord;
Description: Implementation of GPIODeviceStop API for PCF857X
Note
|
Not intended to be called directly by applications, use GPIODeviceStop instead.
|
[Expand]
function PCF857XGPIORead(GPIO:PGPIODevice; Reg:LongWord):LongWord;
Description: Implementation of GPIODeviceRead API for PCF857X
Note
|
Not intended to be called directly by applications, use GPIODeviceRead instead.
Will read only a single register byte.
|
[Expand]
procedure PCF857XGPIOWrite(GPIO:PGPIODevice; Reg,Value:LongWord);
Description: Implementation of GPIODeviceWrite API for PCF857X
Note
|
Not intended to be called directly by applications, use GPIODeviceWrite instead.
Will write only a single register byte.
|
[Expand]
function PCF857XGPIOInputGet(GPIO:PGPIODevice; Pin:LongWord):LongWord;
Description: Implementation of GPIODeviceInputGet API for PCF857X
Note
|
Not intended to be called directly by applications, use GPIODeviceInputGet instead.
|
[Expand]
function PCF857XGPIOOutputSet(GPIO:PGPIODevice; Pin,Level:LongWord):LongWord;
Description: Implementation of GPIODeviceOutputSet API for PCF857X
Note
|
Not intended to be called directly by applications, use GPIODeviceOutputSet instead.
|
[Expand]
function PCF857XGPIOPullGet(GPIO:PGPIODevice; Pin:LongWord):LongWord;
Description: Implementation of GPIODevicePullGet API for PCF857X
Note
|
Not intended to be called directly by applications, use GPIODevicePullGet instead.
|
[Expand]
function PCF857XGPIOFunctionGet(GPIO:PGPIODevice; Pin:LongWord):LongWord;
Description: Implementation of GPIODeviceFunctionGet API for PCF857X
Note
|
Not intended to be called directly by applications, use GPIODeviceFunctionGet instead.
|
[Expand]
function PCF857XGPIOFunctionSelect(GPIO:PGPIODevice; Pin,Mode:LongWord):LongWord;
Description: Implementation of GPIODeviceFunctionSelect API for PCF857X
Note
|
Not intended to be called directly by applications, use GPIODeviceFunctionSelect instead.
|
Return to Unit Reference