mikroSDK Reference Manual
drv_port.h
Go to the documentation of this file.
1 /****************************************************************************
2 **
3 ** Copyright (C) 2023 MikroElektronika d.o.o.
4 ** Contact: https://www.mikroe.com/contact
5 **
6 ** This file is part of the mikroSDK package
7 **
8 ** Commercial License Usage
9 **
10 ** Licensees holding valid commercial NECTO compilers AI licenses may use this
11 ** file in accordance with the commercial license agreement provided with the
12 ** Software or, alternatively, in accordance with the terms contained in
13 ** a written agreement between you and The MikroElektronika Company.
14 ** For licensing terms and conditions see
15 ** https://www.mikroe.com/legal/software-license-agreement.
16 ** For further information use the contact form at
17 ** https://www.mikroe.com/contact.
18 **
19 **
20 ** GNU Lesser General Public License Usage
21 **
22 ** Alternatively, this file may be used for
23 ** non-commercial projects under the terms of the GNU Lesser
24 ** General Public License version 3 as published by the Free Software
25 ** Foundation: https://www.gnu.org/licenses/lgpl-3.0.html.
26 **
27 ** The above copyright notice and this permission notice shall be
28 ** included in all copies or substantial portions of the Software.
29 **
30 ** THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
31 ** OF MERCHANTABILITY, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED
32 ** TO THE WARRANTIES FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.
33 ** IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM,
34 ** DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT
35 ** OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE
36 ** OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
37 **
38 ****************************************************************************/
44 #ifndef _DRV_PORT_H_
45 #define _DRV_PORT_H_
46 
47 #ifdef __cplusplus
48 extern "C"{
49 #endif
50 
51 #include "drv_name.h"
52 #include "hal_gpio.h"
53 
57 typedef enum
58 {
60  PORT_ERROR = (-1)
61 } port_err_t;
62 
66 typedef enum
67 {
71 
81 typedef struct
82 {
84  port_name_t name;
85 } port_t;
86 
139 err_t port_init( port_t *port, port_name_t name, port_size_t mask,
140  pin_direction_t direction
141  );
142 
166 #if defined(FLATTEN_ME) && (FLATTEN_ME_LEVEL >= FLATTEN_ME_LEVEL_HIGH)
167 #define port_write(_handle,_value) hal_gpio_write_port_output( (hal_gpio_port_t *)_handle, _value )
168 #else
169 err_t port_write( port_t *port, port_size_t value );
170 #endif
171 
191 #if defined(FLATTEN_ME) && (FLATTEN_ME_LEVEL >= FLATTEN_ME_LEVEL_HIGH)
192 #define port_read_input(_handle) hal_gpio_read_port_input( (hal_gpio_port_t *)_handle )
193 #else
195 #endif
196 
216 #if defined(FLATTEN_ME) && (FLATTEN_ME_LEVEL >= FLATTEN_ME_LEVEL_HIGH)
217 #define port_read_output(_handle) hal_gpio_read_port_output( (hal_gpio_port_t *)_handle )
218 #else
220 #endif
221 
241 #define port_read port_read_output
242  // portgroup // drvgroup // pergroup
246 
247 #ifdef __cplusplus
248 }
249 #endif
250 
251 #endif // _DRV_PORT_H_
252 // ------------------------------------------------------------------------- END
drv_name.h
Pin and port name type definitions.
port_name_t
hal_port_name_t port_name_t
Definition: drv_name.h:75
pin_direction_t
pin_direction_t
Definition: drv_port.h:65
port_read_output
port_size_t port_read_output(port_t *port)
Read from port.
PIN_DIRECTION_DIGITAL_OUTPUT
Definition: drv_port.h:68
port_write
err_t port_write(port_t *port, port_size_t value)
Write to port.
PIN_DIRECTION_DIGITAL_INPUT
Definition: drv_port.h:67
port_size_t
hal_port_size_t port_size_t
Definition: drv_name.h:77
hal_gpio.h
This file contains all the functions prototypes for the GPIO library.
port_init
err_t port_init(port_t *port, port_name_t name, port_size_t mask, pin_direction_t direction)
Initialize GPIO port.
port_t
Port driver context structure, consisted of the following fields :
Definition: drv_port.h:80
port_err_t
port_err_t
Definition: drv_port.h:56
PORT_SUCCESS
Definition: drv_port.h:58
port_read_input
port_size_t port_read_input(port_t *port)
Read from port.
PORT_ERROR
Definition: drv_port.h:59
hal_gpio_t
GPIO HAL context structure, consisted of the following fields :
Definition: hal_gpio.h:74
err_t
int32_t err_t
Definition: hal_target.h:63