periph_cpu.h
Go to the documentation of this file.
1 /*
2  * Copyright (C) 2015-2016 Freie Universität Berlin
3  * 2017 HAW Hamburg
4  *
5  * This file is subject to the terms and conditions of the GNU Lesser
6  * General Public License v2.1. See the file LICENSE in the top level
7  * directory for more details.
8  */
9 
21 #ifndef PERIPH_CPU_H
22 #define PERIPH_CPU_H
23 
24 #include <stdint.h>
25 #include <stdio.h>
26 
27 #include "vendor/hw_soc_adc.h"
28 
29 #include "cpu.h"
30 #include "vendor/hw_ssi.h"
31 #include "vendor/hw_uart.h"
32 
33 #ifdef __cplusplus
34 extern "C" {
35 #endif
36 
40 #define CPUID_ADDR (&IEEE_ADDR_MSWORD)
41 
45 #define CPUID_LEN (8U)
46 
51 #define HAVE_GPIO_T
52 typedef uint32_t gpio_t;
59 #define PM_NUM_MODES (4)
60 
65 #define GPIO_UNDEF (0xffffffff)
66 
70 #define GPIO_MUX_NONE (0xff)
71 
77 #define GPIO_PIN(port, pin) (gpio_t)(((uint32_t)GPIO_BASE + \
78  (port << GPIO_PORTNUM_SHIFT)) | pin)
79 
87 void gpio_init_af(gpio_t pin, uint8_t sel, uint8_t over);
88 
97 void gpio_init_mux(gpio_t pin, uint8_t over, uint8_t sel, uint8_t func);
98 
103 #define PERIPH_I2C_NEED_READ_REG
104 #define PERIPH_I2C_NEED_READ_REGS
105 #define PERIPH_I2C_NEED_WRITE_REG
106 #define PERIPH_I2C_NEED_WRITE_REGS
107 
109 #ifndef DOXYGEN
110 
114 #define HAVE_I2C_SPEED_T
115 typedef enum {
116  I2C_SPEED_LOW = 0x01,
117  I2C_SPEED_NORMAL = 100000U,
118  I2C_SPEED_FAST = 400000U,
119  I2C_SPEED_FAST_PLUS = 0x02,
120  I2C_SPEED_HIGH = 0x03,
121 } i2c_speed_t;
123 #endif /* ndef DOXYGEN */
124 
128 typedef struct {
130  gpio_t scl_pin;
131  gpio_t sda_pin;
132 } i2c_conf_t;
133 
138 #define PERIPH_SPI_NEEDS_INIT_CS
139 #define PERIPH_SPI_NEEDS_TRANSFER_BYTE
140 #define PERIPH_SPI_NEEDS_TRANSFER_REG
141 #define PERIPH_SPI_NEEDS_TRANSFER_REGS
142 
144 #ifndef DOXYGEN
145 
149 #define HAVE_GPIO_MODE_T
150 typedef enum {
151  GPIO_IN = ((uint8_t)OVERRIDE_DISABLE),
152  GPIO_IN_ANALOG = ((uint8_t)OVERRIDE_ANALOG),
153  GPIO_IN_PD = ((uint8_t)OVERRIDE_PULLDOWN),
154  GPIO_IN_PU = ((uint8_t)OVERRIDE_PULLUP),
155  GPIO_OUT = ((uint8_t)OVERRIDE_ENABLE),
156  GPIO_OD = (0xff),
157  GPIO_OD_PU = (0xff)
158 } gpio_mode_t;
160 #endif /* ndef DOXYGEN */
161 
166 typedef struct {
168  gpio_t rx_pin;
169  gpio_t tx_pin;
170 #ifdef MODULE_PERIPH_UART_HW_FC
171  gpio_t cts_pin;
172  gpio_t rts_pin;
173 #endif
174 } uart_conf_t;
177 #ifndef DOXYGEN
178 
182 #define HAVE_UART_PARITY_T
183 typedef enum {
184  UART_PARITY_NONE = 0,
185  UART_PARITY_EVEN = (UART_LCRH_PEN | UART_LCRH_EPS),
186  UART_PARITY_ODD = UART_LCRH_PEN,
187  UART_PARITY_MARK = (UART_LCRH_PEN | UART_LCRH_SPS),
188  UART_PARITY_SPACE = (UART_LCRH_PEN | UART_LCRH_EPS | UART_LCRH_SPS)
189 } uart_parity_t;
196 #define HAVE_UART_DATA_BITS_T
197 typedef enum {
198  UART_DATA_BITS_5 = (0 << UART_LCRH_WLEN_S),
199  UART_DATA_BITS_6 = (1 << UART_LCRH_WLEN_S),
200  UART_DATA_BITS_7 = (2 << UART_LCRH_WLEN_S),
201  UART_DATA_BITS_8 = (3 << UART_LCRH_WLEN_S),
209 #define HAVE_UART_STOP_BITS_T
210 typedef enum {
211  UART_STOP_BITS_1 = 0,
212  UART_STOP_BITS_2 = UART_LCRH_STP2,
220 #define HAVE_SPI_MODE_T
221 typedef enum {
222  SPI_MODE_0 = 0,
223  SPI_MODE_1 = (SSI_CR0_SPH),
224  SPI_MODE_2 = (SSI_CR0_SPO),
225  SPI_MODE_3 = (SSI_CR0_SPO | SSI_CR0_SPH)
226 } spi_mode_t;
233 #define HAVE_SPI_CLK_T
234 typedef enum {
235  SPI_CLK_100KHZ = 0,
236  SPI_CLK_400KHZ = 1,
237  SPI_CLK_1MHZ = 2,
238  SPI_CLK_5MHZ = 3,
239  SPI_CLK_10MHZ = 4
240 } spi_clk_t;
242 #endif /* ndef DOXYGEN */
243 
247 typedef struct {
248  uint8_t cpsr;
249  uint8_t scr;
251 
252 #ifndef BOARD_HAS_SPI_CLK_CONF
253 
260 static const spi_clk_conf_t spi_clk_config[] = {
261  { .cpsr = 64, .scr = 4 }, /* 100khz */
262  { .cpsr = 16, .scr = 4 }, /* 400khz */
263  { .cpsr = 32, .scr = 0 }, /* 1.0MHz */
264  { .cpsr = 2, .scr = 2 }, /* 5.3MHz */
265  { .cpsr = 2, .scr = 1 } /* 8.0MHz */
266 };
267 #endif /* BOARD_HAS_SPI_CLK_CONF */
268 
273 typedef struct {
274  uint8_t num;
275  gpio_t mosi_pin;
276  gpio_t miso_pin;
277  gpio_t sck_pin;
278  gpio_t cs_pin;
279 } spi_conf_t;
288 typedef struct {
289  uint_fast8_t chn;
290  uint_fast8_t cfg;
291 } timer_conf_t;
292 
293 #ifndef DOXYGEN
294 
298 #define HAVE_ADC_RES_T
299 typedef enum {
300  ADC_RES_6BIT = (0xa00),
301  ADC_RES_7BIT = (0 << 4),
302  ADC_RES_8BIT = (0xb00),
303  ADC_RES_9BIT = (1 << 4),
304  ADC_RES_10BIT = (2 << 4),
305  ADC_RES_12BIT = (3 << 4),
306  ADC_RES_14BIT = (0xc00),
307  ADC_RES_16BIT = (0xd00),
308 } adc_res_t;
310 #endif /* ndef DOXYGEN */
311 
315 typedef gpio_t adc_conf_t;
316 
321 #define SOC_ADC_ADCCON3_EREF_INT (0 << SOC_ADC_ADCCON3_EREF_S)
322 #define SOC_ADC_ADCCON3_EREF_EXT (1 << SOC_ADC_ADCCON3_EREF_S)
323 #define SOC_ADC_ADCCON3_EREF_AVDD5 (2 << SOC_ADC_ADCCON3_EREF_S)
324 #define SOC_ADC_ADCCON3_EREF_DIFF (3 << SOC_ADC_ADCCON3_EREF_S)
331 #define SOCADC_7_BIT_RSHIFT (9U)
332 #define SOCADC_9_BIT_RSHIFT (7U)
333 #define SOCADC_10_BIT_RSHIFT (6U)
334 #define SOCADC_12_BIT_RSHIFT (4U)
341 #define RTT_DEV SMWDTHROSC
342 #define RTT_IRQ SM_TIMER_ALT_IRQn
343 #define RTT_IRQ_PRIO 1
344 #define RTT_ISR isr_sleepmode
345 #define RTT_MAX_VALUE (0xffffffff)
346 #define RTT_FREQUENCY (CLOCK_OSC32K)
347 /* When setting a new compare value, the value must be at least 5 more
348  than the current sleep timer value. Otherwise, the timer compare
349  event may be lost. */
350 #define RTT_MIN_OFFSET (5U)
351 
357 /* Limits are in clock cycles according to data sheet.
358  As the WDT is clocked by a 32 kHz clock and supports 4 intervals */
359 #define NWDT_TIME_LOWER_LIMIT (2U)
360 #define NWDT_TIME_UPPER_LIMIT (1000U)
361 
363 #ifdef __cplusplus
364 }
365 #endif
366 
367 #endif /* PERIPH_CPU_H */
368 
SPI_CLK_400KHZ
@ SPI_CLK_400KHZ
drive the SPI bus with 400KHz
Definition: periph_cpu.h:653
SPI_MODE_3
@ SPI_MODE_3
CPOL=1, CPHA=1.
Definition: spi.h:161
UART_PARITY_NONE
@ UART_PARITY_NONE
no parity
Definition: uart.h:127
UART_DATA_BITS_5
@ UART_DATA_BITS_5
5 data bits
Definition: uart.h:140
SPI_CLK_100KHZ
@ SPI_CLK_100KHZ
drive the SPI bus with 100KHz
Definition: periph_cpu.h:652
i2c_conf_t::scl_pin
gpio_t scl_pin
pin used for SCL
Definition: periph_cpu.h:130
ADC_RES_6BIT
@ ADC_RES_6BIT
ADC resolution: 6 bit.
Definition: adc.h:94
uart_conf_t::rx_pin
gpio_t rx_pin
pin used for RX
Definition: periph_cpu.h:168
uart_stop_bits_t
uart_stop_bits_t
Definition of possible stop bits lengths in a UART frame.
Definition: uart.h:151
I2C_SPEED_LOW
@ I2C_SPEED_LOW
low speed mode: ~10 kbit/s
Definition: i2c.h:176
GPIO_IN_PD
@ GPIO_IN_PD
configure as input with pull-down resistor
Definition: gpio.h:120
spi_clk_config
static const spi_clk_conf_t spi_clk_config[]
Pre-calculated clock divider values based on a CLOCK_CORECLOCK (32MHz)
Definition: periph_cpu.h:260
UART_STOP_BITS_2
@ UART_STOP_BITS_2
2 stop bits
Definition: uart.h:153
SPI_MODE_0
@ SPI_MODE_0
CPOL=0, CPHA=0.
Definition: spi.h:158
GPIO_OD
@ GPIO_OD
configure as output in open-drain mode without pull resistor
Definition: gpio.h:123
I2C_SPEED_NORMAL
@ I2C_SPEED_NORMAL
normal mode: ~100 kbit/s
Definition: i2c.h:177
UART_DATA_BITS_8
@ UART_DATA_BITS_8
8 data bits
Definition: uart.h:143
ADC_RES_14BIT
@ ADC_RES_14BIT
ADC resolution: 14 bit.
Definition: adc.h:98
adc_res_t
adc_res_t
Possible ADC resolution settings.
Definition: adc.h:93
spi_conf_t::sck_pin
gpio_t sck_pin
pin used for SCK
Definition: periph_cpu.h:277
GPIO_OUT
@ GPIO_OUT
configure as output in push-pull mode
Definition: gpio.h:122
ADC_RES_16BIT
@ ADC_RES_16BIT
ADC resolution: 16 bit.
Definition: adc.h:99
UART_DATA_BITS_6
@ UART_DATA_BITS_6
6 data bits
Definition: uart.h:141
uart_parity_t
uart_parity_t
Definition of possible parity modes.
Definition: uart.h:126
i2c_speed_t
i2c_speed_t
Default mapping of I2C bus speed values.
Definition: i2c.h:175
spi_mode_t
spi_mode_t
Available SPI modes, defining the configuration of clock polarity and clock phase.
Definition: spi.h:157
ADC_RES_8BIT
@ ADC_RES_8BIT
ADC resolution: 8 bit.
Definition: adc.h:95
spi_clk_conf_t::scr
uint8_t scr
SCR clock divider.
Definition: periph_cpu.h:249
GPIO_IN_PU
@ GPIO_IN_PU
configure as input with pull-up resistor
Definition: gpio.h:121
spi_clk_conf_t::cpsr
uint8_t cpsr
CPSR clock divider.
Definition: periph_cpu.h:248
SPI_CLK_10MHZ
@ SPI_CLK_10MHZ
drive the SPI bus with 10MHz
Definition: periph_cpu.h:656
spi_clk_t
uint32_t spi_clk_t
SPI clock type.
Definition: periph_cpu.h:662
GPIO_IN
@ GPIO_IN
configure as input without pull resistor
Definition: gpio.h:119
gpio_init_mux
void gpio_init_mux(gpio_t pin, uint8_t over, uint8_t sel, uint8_t func)
Configure an alternate function for the given pin.
uart_conf_t
UART device configuration.
Definition: periph_cpu.h:166
SPI_CLK_5MHZ
@ SPI_CLK_5MHZ
drive the SPI bus with 5MHz
Definition: periph_cpu.h:655
GPIO_OD_PU
@ GPIO_OD_PU
configure as output in open-drain mode with pull resistor enabled
Definition: gpio.h:125
UART_PARITY_SPACE
@ UART_PARITY_SPACE
space parity
Definition: uart.h:131
i2c_conf_t::sda_pin
gpio_t sda_pin
pin used for SDA
Definition: periph_cpu.h:131
spi_conf_t::num
uint8_t num
number of SSI device, i.e.
Definition: periph_cpu.h:274
gpio_init_af
void gpio_init_af(gpio_t pin, uint8_t sel, uint8_t over)
Configure an alternate function for the given pin.
uart_conf_t::dev
cc2538_uart_t * dev
pointer to the used UART device
Definition: periph_cpu.h:167
spi_conf_t::cs_pin
gpio_t cs_pin
pin used for CS
Definition: periph_cpu.h:278
UART_PARITY_EVEN
@ UART_PARITY_EVEN
even parity
Definition: uart.h:128
timer_conf_t
Timer configuration.
Definition: periph_cpu.h:288
adc_conf_t
gpio_t adc_conf_t
ADC configuration wrapper.
Definition: periph_cpu.h:315
timer_conf_t::chn
uint_fast8_t chn
number of channels
Definition: periph_cpu.h:289
uart_conf_t::tx_pin
gpio_t tx_pin
pin used for TX
Definition: periph_cpu.h:169
gpio_mode_t
gpio_mode_t
Available pin modes.
Definition: periph_cpu.h:70
ADC_RES_10BIT
@ ADC_RES_10BIT
ADC resolution: 10 bit.
Definition: adc.h:96
UART_DATA_BITS_7
@ UART_DATA_BITS_7
7 data bits
Definition: uart.h:142
ADC_RES_12BIT
@ ADC_RES_12BIT
ADC resolution: 12 bit.
Definition: adc.h:97
i2c_conf_t::speed
i2c_speed_t speed
baudrate used for the bus
Definition: periph_cpu.h:129
spi_clk_conf_t
Datafields for static SPI clock configuration values.
Definition: periph_cpu.h:247
UART_PARITY_MARK
@ UART_PARITY_MARK
mark parity
Definition: uart.h:130
UART_STOP_BITS_1
@ UART_STOP_BITS_1
1 stop bit
Definition: uart.h:152
uart_data_bits_t
uart_data_bits_t
Definition of possible data bits lengths in a UART frame.
Definition: uart.h:139
UART_PARITY_ODD
@ UART_PARITY_ODD
odd parity
Definition: uart.h:129
gpio_t
unsigned int gpio_t
GPIO type identifier.
Definition: gpio.h:91
i2c_conf_t
I2C configuration options.
Definition: periph_cpu.h:128
I2C_SPEED_FAST_PLUS
@ I2C_SPEED_FAST_PLUS
fast plus mode: ~1000 kbit/s
Definition: i2c.h:179
SPI_CLK_1MHZ
@ SPI_CLK_1MHZ
drive the SPI bus with 1MHz
Definition: periph_cpu.h:654
I2C_SPEED_FAST
@ I2C_SPEED_FAST
fast mode: ~400 kbit/s
Definition: i2c.h:178
timer_conf_t::cfg
uint_fast8_t cfg
timer config word
Definition: periph_cpu.h:290
I2C_SPEED_HIGH
@ I2C_SPEED_HIGH
high speed mode: ~3400 kbit/s
Definition: i2c.h:180
spi_conf_t
SPI configuration structure type.
Definition: periph_cpu.h:273
cc2538_uart_t
UART component registers.
Definition: cc2538_uart.h:32
SPI_MODE_1
@ SPI_MODE_1
CPOL=0, CPHA=1.
Definition: spi.h:159
SPI_MODE_2
@ SPI_MODE_2
CPOL=1, CPHA=0.
Definition: spi.h:160
spi_conf_t::mosi_pin
gpio_t mosi_pin
pin used for MOSI
Definition: periph_cpu.h:275
spi_conf_t::miso_pin
gpio_t miso_pin
pin used for MISO
Definition: periph_cpu.h:276