Blame view

RIOT/cpu/kinetis_common/include/periph_cpu.h 5.87 KB
fb11e647   vrobic   reseau statique a...
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
  /*
   * Copyright (C) 2015 Freie Universitรคt Berlin
   *
   * This file is subject to the terms and conditions of the GNU Lesser
   * General Public License v2.1. See the file LICENSE in the top level
   * directory for more details.
   */
  
  /**
   * @ingroup         cpu_kinetis_common
   * @{
   *
   * @file
   * @brief           CPU specific definitions for internal peripheral handling
   *
   * @author          Hauke Petersen <hauke.peterse@fu-berlin.de>
   */
  
  #ifndef PERIPH_CPU_H_
  #define PERIPH_CPU_H_
  
  #include <stdint.h>
  
  #include "cpu.h"
  
  #ifdef __cplusplus
  extern "C" {
  #endif
  
  /**
   * @brief   Overwrite the default gpio_t type definition
   * @{
   */
  #define HAVE_GPIO_T
  typedef uint16_t gpio_t;
  /** @} */
  
  /**
   * @brief   Definition of a fitting UNDEF value
   */
  #define GPIO_UNDEF          (0xffff)
  
  /**
   * @brief   Define a CPU specific GPIO pin generator macro
   */
  #define GPIO_PIN(x, y)      (((x + 1) << 12) | (x << 6) | y)
  
  /**
   * @brief   Length of the CPU_ID in octets
   */
  #define CPUID_LEN           (16U)
  
  /**
   * @brief   Generate GPIO mode bitfields
   *
   * We use the following bits to encode the pin mode:
   * - bit 0: 0 for pull-down or 1 for pull-up
   * - bit 1: pull register enable (as configured in bit 0)
   * - bit 5: OD enable
   * - bit 7: output or input mode
   */
  #define GPIO_MODE(pu, pe, od, out)   (pu | (pe << 1) | (od << 5) | (out << 7))
  
  #ifndef DOXYGEN
  /**
   * @brief   Override GPIO modes
   * @{
   */
  #define HAVE_GPIO_MODE_T
  typedef enum {
      GPIO_IN    = GPIO_MODE(0, 0, 0, 0),     /**< IN */
      GPIO_IN_PD = GPIO_MODE(0, 1, 0, 0),     /**< IN with pull-down */
      GPIO_IN_PU = GPIO_MODE(1, 1, 0, 0),     /**< IN with pull-up */
      GPIO_OUT   = GPIO_MODE(0, 0, 0, 1),     /**< OUT (push-pull) */
      GPIO_OD    = GPIO_MODE(1, 0, 1, 1),     /**< OD */
      GPIO_OD_PU = GPIO_MODE(1, 1, 1, 1),     /**< OD with pull-up */
  } gpio_mode_t;
  /** @} */
  #endif /* ndef DOXYGEN */
  
  /**
   * @brief   Define a condensed set of PORT PCR values
   *
   * To combine values just aggregate them using a logical OR.
   */
  enum {
      GPIO_AF_ANALOG = PORT_PCR_MUX(0),       /**< use pin as analog input */
      GPIO_AF_GPIO   = PORT_PCR_MUX(1),       /**< use pin as GPIO */
      GPIO_AF_2      = PORT_PCR_MUX(2),       /**< use alternate function 2 */
      GPIO_AF_3      = PORT_PCR_MUX(3),       /**< use alternate function 3 */
      GPIO_AF_4      = PORT_PCR_MUX(4),       /**< use alternate function 4 */
      GPIO_AF_5      = PORT_PCR_MUX(5),       /**< use alternate function 5 */
      GPIO_AF_6      = PORT_PCR_MUX(6),       /**< use alternate function 6 */
      GPIO_AF_7      = PORT_PCR_MUX(7),       /**< use alternate function 7 */
      GPIO_PCR_OD    = (PORT_PCR_ODE_MASK),   /**< open-drain mode */
      GPIO_PCR_PD    = (PORT_PCR_PE_MASK),    /**< enable pull-down */
      GPIO_PCR_PU    = (PORT_PCR_PE_MASK | PORT_PCR_PS_MASK)  /**< enable PU */
  };
  
  #ifndef DOXYGEN
  /**
   * @brief   Override flank configuration values
   * @{
   */
  #define HAVE_GPIO_FLANK_T
  typedef enum {
      GPIO_RISING  = PORT_PCR_IRQC(0x9),  /**< emit interrupt on rising flank */
      GPIO_FALLING = PORT_PCR_IRQC(0xa),  /**< emit interrupt on falling flank */
      GPIO_BOTH    = PORT_PCR_IRQC(0xb),  /**< emit interrupt on both flanks */
  } gpio_flank_t;
  /** @} */
  #endif /* ndef DOXYGEN */
  
  /**
   * @brief   Available ports on the Kinetis family
   *
   * @todo    This is not equal for all members of the Kinetis family, right?
   */
  enum {
      PORT_A = 0,             /**< port A */
      PORT_B = 1,             /**< port B */
      PORT_C = 2,             /**< port C */
      PORT_D = 3,             /**< port D */
      PORT_E = 4,             /**< port E */
      PORT_F = 5,             /**< port F */
      PORT_G = 6,             /**< port G */
      GPIO_PORTS_NUMOF        /**< overall number of available ports */
  };
  
  #ifndef DOXYGEN
  /**
   * @brief   Override default ADC resolution values
   * @{
   */
  #define HAVE_ADC_RES_T
  typedef enum {
      ADC_RES_6BIT  = (0xfe),             /**< not supported */
      ADC_RES_8BIT  = ADC_CFG1_MODE(0),   /**< ADC resolution: 8 bit */
      ADC_RES_10BIT = ADC_CFG1_MODE(2),   /**< ADC resolution: 10 bit */
      ADC_RES_12BIT = ADC_CFG1_MODE(1),   /**< ADC resolution: 12 bit */
      ADC_RES_14BIT = (0xff),             /**< ADC resolution: 14 bit */
      ADC_RES_16BIT = ADC_CFG1_MODE(3)    /**< ADC resolution: 16 bit */
  } adc_res_t;
  /** @} */
  #endif /* ndef DOXYGEN */
  
  /**
   * @brief   CPU specific ADC configuration
   */
  typedef struct {
      ADC_Type *dev;          /**< ADC device */
      gpio_t pin;             /**< pin to use, set to GPIO_UNDEF for internal
                               *   channels */
      uint8_t chan;           /**< ADC channel */
  } adc_conf_t;
  
  /**
   * @brief   CPU specific DAC configuration
   */
  typedef struct {
      /** DAC device base pointer */
      DAC_Type *dev;
      /** Pointer to module clock gate bit in bitband region, use BITBAND_REGADDR() */
      uint32_t volatile *clk_gate;
  } dac_conf_t;
  
  /**
   * @brief   CPU specific timer PIT module configuration
   */
  typedef struct {
      /** Prescaler channel */
      uint8_t prescaler_ch;
      /** Counting channel, will be linked to the prescaler channel */
      uint8_t count_ch;
  } pit_conf_t;
  
  /**
   * @brief   CPU specific timer LPTMR module configuration
   */
  typedef struct {
      /** LPTMR device base pointer */
      LPTMR_Type *dev;
      /** Pointer to module clock gate bit in bitband region, use BITBAND_REGADDR() */
      uint32_t volatile *clk_gate;
      /** LPTMR device index */
      uint8_t index;
  } lptmr_conf_t;
  
  /**
   * @brief   Possible timer module types
   */
  enum {
      TIMER_PIT,
      TIMER_LPTMR,
  };
  
  /**
   * @brief   Hardware timer type-specific device macros
   */
  #define TIMER_PIT_DEV(x)   (TIMER_DEV(0 + (x)))
  #define TIMER_LPTMR_DEV(x) (TIMER_DEV(PIT_NUMOF + (x)))
  
  /**
   * @brief   CPU internal function for initializing PORTs
   *
   * @param[in] pin       pin to initialize
   * @param[in] pcr       value for the PORT's PCR register
   */
  void gpio_init_port(gpio_t pin, uint32_t pcr);
  
  #ifdef __cplusplus
  }
  #endif
  
  #endif /* PERIPH_CPU_H_ */
  /** @} */