Revision df051abd

View differences:

drivers/switch/v1/alld_switch.c
1
/*
2
AMiRo-LLD is a compilation of low-level hardware drivers for the Autonomous Mini Robot (AMiRo) platform.
3
Copyright (C) 2016..2019  Thomas Schöpping et al.
4

  
5
This program is free software: you can redistribute it and/or modify
6
it under the terms of the GNU Lesser General Public License as published by
7
the Free Software Foundation, either version 3 of the License, or
8
(at your option) any later version.
9

  
10
This program is distributed in the hope that it will be useful,
11
but WITHOUT ANY WARRANTY; without even the implied warranty of
12
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
13
GNU Lesser General Public License for more details.
14

  
15
You should have received a copy of the GNU Lesser General Public License
16
along with this program.  If not, see <http://www.gnu.org/licenses/>.
17
*/
18

  
19
/**
20
 * @file    alld_switch.c
21
 * @brief   Switch function implementations.
22
 *
23
 * @addtogroup lld_switch
24
 * @{
25
 */
26

  
27
#include <alld_switch.h>
28

  
29
/******************************************************************************/
30
/* LOCAL DEFINITIONS                                                          */
31
/******************************************************************************/
32

  
33
/******************************************************************************/
34
/* EXPORTED VARIABLES                                                         */
35
/******************************************************************************/
36

  
37
/******************************************************************************/
38
/* LOCAL TYPES                                                                */
39
/******************************************************************************/
40

  
41
/******************************************************************************/
42
/* LOCAL VARIABLES                                                            */
43
/******************************************************************************/
44

  
45
/******************************************************************************/
46
/* LOCAL FUNCTIONS                                                            */
47
/******************************************************************************/
48

  
49
/******************************************************************************/
50
/* EXPORTED FUNCTIONS                                                         */
51
/******************************************************************************/
52

  
53
/**
54
 * @brief Get the current status of the switch.
55
 * @param[in]   switchd The switch driver object.
56
 * @param[out]  state   The state object to fill.
57
 * @return              An indicator whether the call was successful.
58
 */
59
apalExitStatus_t switch_lld_get(const SwitchDriver* const switchd, switch_lld_state_t* const state)
60
{
61
  apalDbgAssert(switchd != NULL);
62
  apalDbgAssert(state != NULL);
63

  
64
  apalControlGpioState_t gpio_state;
65
  apalExitStatus_t status = apalControlGpioGet(switchd->gpio, &gpio_state);
66
  *state = gpio_state == APAL_GPIO_ON ? SWITCH_LLD_STATE_ON : SWITCH_LLD_STATE_OFF;
67
  return status;
68
}
69

  
70
/** @} */
71

  
drivers/switch/v1/alld_switch.h
1
/*
2
AMiRo-LLD is a compilation of low-level hardware drivers for the Autonomous Mini Robot (AMiRo) platform.
3
Copyright (C) 2016..2019  Thomas Schöpping et al.
4

  
5
This program is free software: you can redistribute it and/or modify
6
it under the terms of the GNU Lesser General Public License as published by
7
the Free Software Foundation, either version 3 of the License, or
8
(at your option) any later version.
9

  
10
This program is distributed in the hope that it will be useful,
11
but WITHOUT ANY WARRANTY; without even the implied warranty of
12
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
13
GNU Lesser General Public License for more details.
14

  
15
You should have received a copy of the GNU Lesser General Public License
16
along with this program.  If not, see <http://www.gnu.org/licenses/>.
17
*/
18

  
19
/**
20
 * @file    alld_switch.h
21
 * @brief   Switch macros and structures.
22
 *
23
 * @addtogroup lld_switch
24
 * @{
25
 */
26

  
27
#ifndef AMIROLLD_SWITCH_H
28
#define AMIROLLD_SWITCH_H
29

  
30
#include <amiro-lld.h>
31

  
32
/******************************************************************************/
33
/* CONSTANTS                                                                  */
34
/******************************************************************************/
35

  
36
/******************************************************************************/
37
/* SETTINGS                                                                   */
38
/******************************************************************************/
39

  
40
/******************************************************************************/
41
/* CHECKS                                                                     */
42
/******************************************************************************/
43

  
44
/******************************************************************************/
45
/* DATA STRUCTURES AND TYPES                                                  */
46
/******************************************************************************/
47

  
48
/**
49
 * @brief Switch driver data structure.
50
 */
51
typedef struct {
52
  const apalControlGpio_t* gpio;  /**< @brief The identifier of the GPIO.  */
53
} SwitchDriver;
54

  
55
/**
56
 * @brief The state of the switch.
57
 */
58
typedef enum {
59
  SWITCH_LLD_STATE_OFF = 0x00,   /**< 'released' state of the switch */
60
  SWITCH_LLD_STATE_ON  = 0x01,   /**< 'pressed' state of the switch */
61
} switch_lld_state_t;
62

  
63
/******************************************************************************/
64
/* MACROS                                                                     */
65
/******************************************************************************/
66

  
67
/******************************************************************************/
68
/* EXTERN DECLARATIONS                                                        */
69
/******************************************************************************/
70

  
71
#ifdef __cplusplus
72
extern "C" {
73
#endif
74
  apalExitStatus_t switch_lld_get(const SwitchDriver* const switchp, switch_lld_state_t* const state);
75
#ifdef __cplusplus
76
}
77
#endif
78

  
79
/******************************************************************************/
80
/* INLINE FUNCTIONS                                                           */
81
/******************************************************************************/
82

  
83
#endif /* AMIROLLD_SWITCH_H */
84

  
85
/** @} */
86

  
drivers/switch/v1/alld_switch.mk
1
################################################################################
2
# AMiRo-LLD is a compilation of low-level hardware drivers for the Autonomous  #
3
# Mini Robot (AMiRo) platform.                                                 #
4
# Copyright (C) 2016..2019  Thomas Schöpping et al.                            #
5
#                                                                              #
6
# This program is free software: you can redistribute it and/or modify         #
7
# it under the terms of the GNU General Public License as published by         #
8
# the Free Software Foundation, either version 3 of the License, or            #
9
# (at your option) any later version.                                          #
10
#                                                                              #
11
# This program is distributed in the hope that it will be useful,              #
12
# but WITHOUT ANY WARRANTY; without even the implied warranty of               #
13
# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the                #
14
# GNU General Public License for more details.                                 #
15
#                                                                              #
16
# You should have received a copy of the GNU General Public License            #
17
# along with this program.  If not, see <http://www.gnu.org/licenses/>.        #
18
#                                                                              #
19
# This research/work was supported by the Cluster of Excellence Cognitive      #
20
# Interaction Technology 'CITEC' (EXC 277) at Bielefeld University, which is   #
21
# funded by the German Research Foundation (DFG).                              #
22
################################################################################
23

  
24

  
25

  
26
# path to this directory
27
AMIROLLD_switch_V1_DIR := $(dir $(lastword $(MAKEFILE_LIST)))
28

  
29
# include paths
30
AMIROLLD_INC += $(AMIROLLD_switch_V1_DIR)
31

  
32
# C source files
33
AMIROLLD_CSRC += $(AMIROLLD_switch_V1_DIR)alld_switch.c

Also available in: Unified diff