ISSDK  1.8
IoT Sensing Software Development Kit
gpio_driver.c
Go to the documentation of this file.
1 /*
2  * Copyright 2017 NXP
3  * All rights reserved.
4  *
5  * SPDX-License-Identifier: BSD-3-Clause
6  */
7 
8 /**
9 * @file gpio_driver.c
10 * @brief The gpio_driver.c file contains Generic API Adaption to i.MXRT1050 SDK 2.0 GPIO Driver.
11 */
12 
13 #include "gpio_driver.h"
14 
15 /*******************************************************************************
16 * Definitions
17 ******************************************************************************/
18 #define GPIO_DRV_VERSION ARM_DRIVER_VERSION_MAJOR_MINOR(2, 3) /* driver version */
19 // ISR handler array for each gpio pin in the system
20 #define GPIO_NUMBER_OF_PIN 0x20
21 
22 /*******************************************************************************
23 * Variables
24 ******************************************************************************/
25 
26 /* Driver Version */
27 static const GENERIC_DRIVER_VERSION DriverVersion = {GPIO_API_VERSION, GPIO_DRV_VERSION};
29 static gpioConfigiMXSDK_t gpioConfigDefault = {
30  .pinConfig = {kGPIO_DigitalInput, 0}, .interruptMode = kGPIO_IntLowLevel};
31 
32 /*******************************************************************************
33  * Code
34  ******************************************************************************/
35 
36 /***********************************************************************
37  *
38  * Function Name : imxsdk_gpio_get_version
39  * Description : get the i.MXRT1050RT gpio driver version.
40  *
41  ***************************************************************************/
43 {
44  return DriverVersion;
45 }
46 
47 /***********************************************************************
48  *
49  * Function Name : imxsdk_gpio_pin_init
50  * Description : Initialize particular GPIO pin used by board.
51  *
52  ***************************************************************************/
54  pinID_t aPinId, gpio_direction_t dir, void *apPinConfig, gpio_isr_handler_t aIsrHandler, void *apUserData)
55 {
56  gpioConfigiMXSDK_t *pGpioConfig = (gpioConfigiMXSDK_t *)apPinConfig;
57  gpioHandleiMXSDK_t *pinHandle = (gpioHandleiMXSDK_t *)aPinId;
58  if (NULL == apPinConfig)
59  {
60  pGpioConfig = &gpioConfigDefault;
61  }
62 
63  pGpioConfig->pinConfig.direction = dir == GPIO_DIRECTION_IN ? kGPIO_DigitalInput : kGPIO_DigitalOutput;
64  /* Set the pin information */
65  GPIO_PinInit(pinHandle->base, pinHandle->pinNumber, &pGpioConfig->pinConfig);
66 
67  /* Isr is installed */
68  if (aIsrHandler)
69  {
70  /* Enable the IRQ */
71  EnableIRQ(pinHandle->irq);
72  isrObj[pinHandle->portNumber][pinHandle->pinNumber].isrHandle = aIsrHandler;
73  isrObj[pinHandle->portNumber][pinHandle->pinNumber].pUserData = apUserData;
74  /* Enable GPIO pin interrupt */
75  GPIO_PortEnableInterrupts(pinHandle->base, pinHandle->mask);
76  }
77 }
78 
79 /***********************************************************************
80  *
81  * Function Name : imxsdk_gpio_set_pin
82  * Description : Set output level of individual GPIO pin to logic 1.
83  *
84  ***************************************************************************/
86 {
87  gpioHandleiMXSDK_t *pinHandle = (gpioHandleiMXSDK_t *)aPinId;
88  pinHandle->pinStatus = PIN_SET;
89  GPIO_PinWrite(pinHandle->base, pinHandle->pinNumber, PIN_SET);
90 }
91 
92 /***********************************************************************
93  *
94  * Function Name : imxsdk_gpio_clr_pin
95  * Description : Set output level of individual GPIO pin to logic 0..
96  *
97  ***************************************************************************/
99 {
100  gpioHandleiMXSDK_t *pinHandle = (gpioHandleiMXSDK_t *)aPinId;
101  pinHandle->pinStatus = PIN_CLR;
102  GPIO_PinWrite(pinHandle->base, pinHandle->pinNumber, PIN_CLR);
103 }
104 
105 /***********************************************************************
106  *
107  * Function Name : ksdk_gpio_toggle_pin
108  * Description : toggle the currrent output logic of individual GPIO pin.
109  *
110  ***************************************************************************/
112 {
113  gpioHandleiMXSDK_t *pinHandle = (gpioHandleiMXSDK_t *)aPinId;
114 
115  /* Check PIN Status and toggle */
116  if (PIN_CLR == pinHandle->pinStatus)
117  {
118  imxsdk_gpio_set_pin(aPinId);
119  }
120  else if (PIN_SET == pinHandle->pinStatus)
121  {
122  imxsdk_gpio_clr_pin(aPinId);
123  }
124 }
125 
126 /***********************************************************************
127  *
128  * Function Name : imxsdk_gpio_write_pin
129  * Description : Set output level of individual GPIO pin to desired value, ie 1 or 0.
130  *
131  ***************************************************************************/
132 void imxsdk_gpio_write_pin(pinID_t aPinId, uint8_t aValue)
133 {
134  gpioHandleiMXSDK_t *pinHandle = (gpioHandleiMXSDK_t *)aPinId;
135  GPIO_WritePinOutput(pinHandle->base, pinHandle->pinNumber, aValue);
136 }
137 
138 /***********************************************************************
139  *
140  * Function Name : imxsdk_gpio_read_pin
141  * Description : Read current input value of individual GPIO pin.
142  *
143  ***************************************************************************/
145 {
146  gpioHandleiMXSDK_t *pinHandle = (gpioHandleiMXSDK_t *)aPinId;
147  return GPIO_ReadPinInput(pinHandle->base, pinHandle->pinNumber);
148 }
149 
150 /***********************************************************************
151  *
152  * Function Name : imxsdk_gpio_handle_interrupt
153  * Description : handle the gpio interrupt in a pin.
154  *
155  ***************************************************************************/
156 void imxsdk_gpio_handle_interrupt(GPIO_Type *apBase, port_number_t gpioPortNumber)
157 {
158  uint32_t isfr = GPIO_GetPinsInterruptFlags(apBase);
159 
160  /* Parse through all the pending interrupt for a PORT */
161  for (uint8_t i = 0; i < GPIO_NUMBER_OF_PIN; i++)
162  {
163  if (isfr & (1 << i))
164  {
165  gpio_isr_handler_t handle = isrObj[gpioPortNumber][i].isrHandle;
166  if (handle == NULL)
167  {
168  continue;
169  }
170  /* Call user defined handler */
171  handle(isrObj[gpioPortNumber][i].pUserData);
172  GPIO_ClearPinsInterruptFlags(apBase, (1 << i));
173  }
174  }
175 }
176 
180 };
uint32_t imxsdk_gpio_read_pin(pinID_t aPinId)
Definition: gpio_driver.c:144
The GPIO Pin Configuration i.MX SDK.
Definition: gpio_driver.h:40
void imxsdk_gpio_set_pin(pinID_t aPinId)
Definition: gpio_driver.c:85
gpio_pin_config_t pinConfig
Definition: gpio_driver.h:42
#define PIN_SET
Definition: gpio_driver.h:21
The gpio isr object.
Definition: gpio_driver.h:62
void(* gpio_isr_handler_t)(void *apUserData)
Definition: Driver_GPIO.h:34
Access structure of the GPIO Driver.
Definition: Driver_GPIO.h:38
void * pinID_t
GPIO Driver direction.
Definition: Driver_GPIO.h:30
void imxsdk_gpio_toggle_pin(pinID_t aPinId)
Definition: gpio_driver.c:111
#define GPIO_NUMBER_OF_PIN
Definition: gpio_driver.c:20
void * pUserData
Definition: gpio_driver.h:64
#define PIN_CLR
Definition: gpio_driver.h:22
IRQn_Type irq
Definition: gpio_driver.h:54
void imxsdk_gpio_clr_pin(pinID_t aPinId)
Definition: gpio_driver.c:98
void imxsdk_gpio_pin_init(pinID_t aPinId, gpio_direction_t dir, void *apPinConfig, gpio_isr_handler_t aIsrHandler, void *apUserData)
Definition: gpio_driver.c:53
gpio_isr_handler_t isrHandle
Definition: gpio_driver.h:65
GENERIC_DRIVER_GPIO Driver_GPIO_KSDK
Definition: gpio_driver.c:177
port_number_t portNumber
Definition: gpio_driver.h:55
#define GPIO_DRV_VERSION
Definition: gpio_driver.c:18
enum gpio_direction_en gpio_direction_t
ARM_DRIVER_VERSION GENERIC_DRIVER_VERSION
Definition: Driver_GPIO.h:32
GENERIC_DRIVER_VERSION imxsdk_gpio_get_version(void)
Definition: gpio_driver.c:42
#define GPIO_API_VERSION
Definition: Driver_GPIO.h:14
void imxsdk_gpio_handle_interrupt(GPIO_Type *apBase, port_number_t gpioPortNumber)
Definition: gpio_driver.c:156
uint32_t pinNumber
Definition: gpio_driver.h:52
enum port_number port_number_t
GPIO PORT NAMES.
The GPIO pin handle for i.MX SDK.
Definition: gpio_driver.h:49
GPIO_Type * base
Definition: gpio_driver.h:51
void imxsdk_gpio_write_pin(pinID_t aPinId, uint8_t aValue)
Definition: gpio_driver.c:132
uint8_t pinStatus
Definition: gpio_driver.h:56