zephyr/drivers/gpio/gpio_xlnx_ps.h
Immo Birnbaum ca33905248 drivers: gpio: Xilinx PS MIO / EMIO GPIO driver
Driver implementation for the Xilinx Processor System MIO / EMIO GPIO
controller as contained in the Zynq-7000 and ZynqMP (UltraScale) SoCs.

The driver is split up into source and header for a parent controller
device and source and header for 1..n child GPIO pin bank devices.
The parent device driver takes care of IRQ handling, the GPIO pin bank
driver provides pin / bank access according to the API defined by the
GPIO subsystem.

More than one device for this type of GPIO controller is required as
it provides access to a number of GPIO pins well in excess of the 32
pins addressable by the current GPIO API (whereever parameters or
return values come in the form of a bit mask):

- Zynq-7000: 54 MIO GPIO pins, 64 EMIO GPIO pins in 4 banks.
- ZynqMP:    78 MIO GPIO pins, 96 EMIO GPIO pins in 6 banks.

Signed-off-by: Immo Birnbaum <Immo.Birnbaum@weidmueller.com>
2022-03-15 08:44:46 -07:00

46 lines
1.2 KiB
C

/*
* Xilinx Processor System MIO / EMIO GPIO controller driver
*
* Driver private data declarations, parent (IRQ handler) module
*
* Copyright (c) 2022, Weidmueller Interface GmbH & Co. KG
* SPDX-License-Identifier: Apache-2.0
*/
#ifndef _ZEPHYR_DRIVERS_GPIO_GPIO_XLNX_PS_H_
#define _ZEPHYR_DRIVERS_GPIO_GPIO_XLNX_PS_H_
/* Type definitions */
/* IRQ handler function type */
typedef void (*gpio_xlnx_ps_config_irq_t)(const struct device *dev);
/**
* @brief Run-time modifiable device data structure.
*
* This struct contains all data of the PS GPIO controller parent
* (IRQ handler) which is modifiable at run-time.
*/
struct gpio_xlnx_ps_dev_data {
struct gpio_driver_data common;
};
/**
* @brief Constant device configuration data structure.
*
* This struct contains all data of the PS GPIO controller parent
* which is required for proper operation (such as base memory
* addresses, references to all associated banks etc.) which don't
* have to and therefore cannot be modified at run-time.
*/
struct gpio_xlnx_ps_dev_cfg {
struct gpio_driver_config common;
uint32_t base_addr;
const struct device **bank_devices;
uint32_t num_banks;
gpio_xlnx_ps_config_irq_t config_func;
};
#endif /* _ZEPHYR_DRIVERS_GPIO_GPIO_XLNX_PS_H_ */