diff options
Diffstat (limited to 'wirish/boards/st_stm32f401cdiscovery')
-rw-r--r-- | wirish/boards/st_stm32f401cdiscovery/board.cpp | 177 | ||||
-rw-r--r-- | wirish/boards/st_stm32f401cdiscovery/include/board/board.h | 127 |
2 files changed, 304 insertions, 0 deletions
diff --git a/wirish/boards/st_stm32f401cdiscovery/board.cpp b/wirish/boards/st_stm32f401cdiscovery/board.cpp new file mode 100644 index 0000000..7f89ab6 --- /dev/null +++ b/wirish/boards/st_stm32f401cdiscovery/board.cpp @@ -0,0 +1,177 @@ +/****************************************************************************** + * The MIT License + * + * Copyright (c) 2011 LeafLabs, LLC. + * + * Permission is hereby granted, free of charge, to any person + * obtaining a copy of this software and associated documentation + * files (the "Software"), to deal in the Software without + * restriction, including without limitation the rights to use, copy, + * modify, merge, publish, distribute, sublicense, and/or sell copies + * of the Software, and to permit persons to whom the Software is + * furnished to do so, subject to the following conditions: + * + * The above copyright notice and this permission notice shall be + * included in all copies or substantial portions of the Software. + * + * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, + * EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF + * MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND + * NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS + * BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN + * ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN + * CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE + * SOFTWARE. + *****************************************************************************/ + +/** + * @file wirish/boards/maple/board.cpp + * @author Perry Huang <iperry@leaflabs.com>, Bryan Newbold <bnewbold@robocracy.org + * @brief STM32F401C Discovery board file. + */ + +#include <board/board.h> // For this board's header file + +#include <wirish/wirish_types.h> // For stm32_pin_info and its contents + // (these go into PIN_MAP). + +#include "boards_private.h" // For PMAP_ROW(), which makes + // PIN_MAP easier to read. + +// boardInit(): nothing special to do for Maple. +// +// When defining your own board.cpp, you can put extra code in this +// function if you have anything you want done on reset, before main() +// or setup() are called. +// +// If there's nothing special you need done, feel free to leave this +// function out. +void boardInit(void) { + // Disable on-board MEMS Gycroscope by pulling PE3 high (nCS line). + // If this isn't done, use of SPI peripheral 1 will fail mysteriously due + // to the Gyro writing to MISO. + // To re-enable and use the gyro, pull PE3 (D67) low in setup(). + gpio_set_mode(GPIOE, 3, GPIO_MODE_OUTPUT); + gpio_write_bit(GPIOE, 3, 1); +} + +// Pin map: this lets the basic I/O functions (digitalWrite(), +// analogRead(), pwmWrite()) translate from pin numbers to STM32 +// peripherals. +// +// PMAP_ROW() lets us specify a row (really a struct stm32_pin_info) +// in the pin map. Its arguments are: +// +// - GPIO device for the pin (GPIOA, etc.) +// - GPIO bit for the pin (0 through 15) +// - Timer device, or NULL if none +// - Timer channel (1 to 4, for PWM), or 0 if none +// - ADC device, or NULL if none +// - ADC channel, or ADCx if none +// +// TODO: This table is definately not complete for the STM32F401C!! +extern const stm32_pin_info PIN_MAP[BOARD_NR_GPIO_PINS] = { + PMAP_ROW(GPIOA, 0, NULL, 0, NULL, ADCx), /* D0/PA0 */ + PMAP_ROW(GPIOA, 1, NULL, 0, NULL, ADCx), /* D1/PA1 */ + PMAP_ROW(GPIOA, 2, NULL, 0, NULL, ADCx), /* D2/PA2 */ + PMAP_ROW(GPIOA, 3, NULL, 0, NULL, ADCx), /* D3/PA3 */ + PMAP_ROW(GPIOA, 4, NULL, 0, NULL, ADCx), /* D4/PA4 */ + PMAP_ROW(GPIOA, 5, NULL, 0, NULL, ADCx), /* D5/PA5 */ + PMAP_ROW(GPIOA, 6, NULL, 0, NULL, ADCx), /* D6/PA6 */ + PMAP_ROW(GPIOA, 7, NULL, 0, NULL, ADCx), /* D7/PA7 */ + PMAP_ROW(GPIOA, 8, NULL, 0, NULL, ADCx), /* D8/PA8 */ + PMAP_ROW(GPIOA, 9, NULL, 0, NULL, ADCx), /* D9/PA9 */ + PMAP_ROW(GPIOA, 10, NULL, 0, NULL, ADCx), /* D10/PA10 */ + PMAP_ROW(GPIOA, 11, NULL, 0, NULL, ADCx), /* D11/PA11 */ + PMAP_ROW(GPIOA, 12, NULL, 0, NULL, ADCx), /* D12/PA12 */ + PMAP_ROW(GPIOA, 13, NULL, 0, NULL, ADCx), /* D13/PA13 */ + PMAP_ROW(GPIOA, 14, NULL, 0, NULL, ADCx), /* D14/PA14 */ + PMAP_ROW(GPIOA, 15, NULL, 0, NULL, ADCx), /* D15/PA15 */ + + PMAP_ROW(GPIOB, 0, NULL, 0, NULL, ADCx), /* D16/PB0 */ + PMAP_ROW(GPIOB, 1, NULL, 0, NULL, ADCx), /* D17/PB1 */ + PMAP_ROW(GPIOB, 2, NULL, 0, NULL, ADCx), /* D18/PB2 */ + PMAP_ROW(GPIOB, 3, NULL, 0, NULL, ADCx), /* D19/PB3 */ + PMAP_ROW(GPIOB, 4, NULL, 0, NULL, ADCx), /* D20/PB4 */ + PMAP_ROW(GPIOB, 5, NULL, 0, NULL, ADCx), /* D21/PB5 */ + PMAP_ROW(GPIOB, 6, NULL, 0, NULL, ADCx), /* D22/PB6 */ + PMAP_ROW(GPIOB, 7, NULL, 0, NULL, ADCx), /* D23/PB7 */ + PMAP_ROW(GPIOB, 8, NULL, 0, NULL, ADCx), /* D24/PB8 */ + PMAP_ROW(GPIOB, 9, NULL, 0, NULL, ADCx), /* D25/PB9 */ + PMAP_ROW(GPIOB, 10, NULL, 0, NULL, ADCx), /* D26/PB10 */ + PMAP_ROW(GPIOB, 11, NULL, 0, NULL, ADCx), /* D27/PB11 */ + PMAP_ROW(GPIOB, 12, NULL, 0, NULL, ADCx), /* D28/PB12 */ + PMAP_ROW(GPIOB, 13, NULL, 0, NULL, ADCx), /* D29/PB13 */ + PMAP_ROW(GPIOB, 14, NULL, 0, NULL, ADCx), /* D30/PB14 */ + PMAP_ROW(GPIOB, 15, NULL, 0, NULL, ADCx), /* D31/PB15 */ + + PMAP_ROW(GPIOC, 0, NULL, 0, NULL, ADCx), /* D32/PC0 */ + PMAP_ROW(GPIOC, 1, NULL, 0, NULL, ADCx), /* D33/PC1 */ + PMAP_ROW(GPIOC, 2, NULL, 0, NULL, ADCx), /* D34/PC2 */ + PMAP_ROW(GPIOC, 3, NULL, 0, NULL, ADCx), /* D35/PC3 */ + PMAP_ROW(GPIOC, 4, NULL, 0, NULL, ADCx), /* D36/PC4 */ + PMAP_ROW(GPIOC, 5, NULL, 0, NULL, ADCx), /* D37/PC5 */ + PMAP_ROW(GPIOC, 6, NULL, 0, NULL, ADCx), /* D38/PC6 */ + PMAP_ROW(GPIOC, 7, NULL, 0, NULL, ADCx), /* D39/PC7 */ + PMAP_ROW(GPIOC, 8, NULL, 0, NULL, ADCx), /* D40/PC8 */ + PMAP_ROW(GPIOC, 9, NULL, 0, NULL, ADCx), /* D41/PC9 */ + PMAP_ROW(GPIOC, 10, NULL, 0, NULL, ADCx), /* D42/PC10 */ + PMAP_ROW(GPIOC, 11, NULL, 0, NULL, ADCx), /* D43/PC11 */ + PMAP_ROW(GPIOC, 12, NULL, 0, NULL, ADCx), /* D44/PC12 */ + PMAP_ROW(GPIOC, 13, NULL, 0, NULL, ADCx), /* D45/PC13 */ + PMAP_ROW(GPIOC, 14, NULL, 0, NULL, ADCx), /* D46/PC14 */ + PMAP_ROW(GPIOC, 15, NULL, 0, NULL, ADCx), /* D47/PC15 */ + + PMAP_ROW(GPIOD, 0, NULL, 0, NULL, ADCx), /* D48/PD0 */ + PMAP_ROW(GPIOD, 1, NULL, 0, NULL, ADCx), /* D49/PD1 */ + PMAP_ROW(GPIOD, 2, NULL, 0, NULL, ADCx), /* D50/PD2 */ + PMAP_ROW(GPIOD, 3, NULL, 0, NULL, ADCx), /* D51/PD3 */ + PMAP_ROW(GPIOD, 4, NULL, 0, NULL, ADCx), /* D52/PD4 */ + PMAP_ROW(GPIOD, 5, NULL, 0, NULL, ADCx), /* D53/PD5 */ + PMAP_ROW(GPIOD, 6, NULL, 0, NULL, ADCx), /* D54/PD6 */ + PMAP_ROW(GPIOD, 7, NULL, 0, NULL, ADCx), /* D55/PD7 */ + PMAP_ROW(GPIOD, 8, NULL, 0, NULL, ADCx), /* D56/PD8 */ + PMAP_ROW(GPIOD, 9, NULL, 0, NULL, ADCx), /* D57/PD9 */ + PMAP_ROW(GPIOD, 10, NULL, 0, NULL, ADCx), /* D58/PD10 */ + PMAP_ROW(GPIOD, 11, NULL, 0, NULL, ADCx), /* D59/PD11 */ + PMAP_ROW(GPIOD, 12, NULL, 0, NULL, ADCx), /* D60/PD12 */ + PMAP_ROW(GPIOD, 13, NULL, 0, NULL, ADCx), /* D61/PD13 */ + PMAP_ROW(GPIOD, 14, NULL, 0, NULL, ADCx), /* D62/PD14 */ + PMAP_ROW(GPIOD, 15, NULL, 0, NULL, ADCx), /* D63/PD15 */ + + PMAP_ROW(GPIOE, 0, NULL, 0, NULL, ADCx), /* D64/PE0 */ + PMAP_ROW(GPIOE, 1, NULL, 0, NULL, ADCx), /* D65/PE1 */ + PMAP_ROW(GPIOE, 2, NULL, 0, NULL, ADCx), /* D66/PE2 */ + PMAP_ROW(GPIOE, 3, NULL, 0, NULL, ADCx), /* D67/PE3 */ + PMAP_ROW(GPIOE, 4, NULL, 0, NULL, ADCx), /* D68/PE4 */ + PMAP_ROW(GPIOE, 5, NULL, 0, NULL, ADCx), /* D69/PE5 */ + PMAP_ROW(GPIOE, 6, NULL, 0, NULL, ADCx), /* D70/PE6 */ + PMAP_ROW(GPIOE, 7, NULL, 0, NULL, ADCx), /* D71/PE7 */ + PMAP_ROW(GPIOE, 8, NULL, 0, NULL, ADCx), /* D72/PE8 */ + PMAP_ROW(GPIOE, 9, NULL, 0, NULL, ADCx), /* D73/PE9 */ + PMAP_ROW(GPIOE, 10, NULL, 0, NULL, ADCx), /* D74/PE10 */ + PMAP_ROW(GPIOE, 11, NULL, 0, NULL, ADCx), /* D75/PE11 */ + PMAP_ROW(GPIOE, 12, NULL, 0, NULL, ADCx), /* D76/PE12 */ + PMAP_ROW(GPIOE, 13, NULL, 0, NULL, ADCx), /* D77/PE13 */ + PMAP_ROW(GPIOE, 14, NULL, 0, NULL, ADCx), /* D78/PE14 */ + PMAP_ROW(GPIOE, 15, NULL, 0, NULL, ADCx), /* D79/PE15 */ +}; + +// Array of pins you can use for pwmWrite(). Keep it in Flash because +// it doesn't change, and so we don't waste RAM. +extern const uint8 boardPWMPins[] __FLASH__ = { + 0, 1, 2, 3, 5, 6, 7, 8, 9, 11, 12, 14, 24, 27, 28 +}; + +// Array of pins you can use for analogRead(). +extern const uint8 boardADCPins[] __FLASH__ = { + 0, +}; + +// Array of pins that the board uses for something special. Other than +// the button and the LED, it's usually best to leave these pins alone +// unless you know what you're doing. +extern const uint8 boardUsedPins[] __FLASH__ = { + BOARD_LED_PIN, BOARD_BUTTON_PIN, BOARD_JTMS_SWDIO_PIN, + BOARD_JTCK_SWCLK_PIN, BOARD_JTDI_PIN, BOARD_JTDO_PIN, BOARD_NJTRST_PIN +}; diff --git a/wirish/boards/st_stm32f401cdiscovery/include/board/board.h b/wirish/boards/st_stm32f401cdiscovery/include/board/board.h new file mode 100644 index 0000000..d93bc30 --- /dev/null +++ b/wirish/boards/st_stm32f401cdiscovery/include/board/board.h @@ -0,0 +1,127 @@ +/****************************************************************************** + * The MIT License + * + * Copyright (c) 2011 LeafLabs, LLC. + * + * Permission is hereby granted, free of charge, to any person + * obtaining a copy of this software and associated documentation + * files (the "Software"), to deal in the Software without + * restriction, including without limitation the rights to use, copy, + * modify, merge, publish, distribute, sublicense, and/or sell copies + * of the Software, and to permit persons to whom the Software is + * furnished to do so, subject to the following conditions: + * + * The above copyright notice and this permission notice shall be + * included in all copies or substantial portions of the Software. + * + * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, + * EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF + * MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND + * NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS + * BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN + * ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN + * CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE + * SOFTWARE. + *****************************************************************************/ + +/** + * @file wirish/boards/maple/include/board/board.h + * @author Perry Huang <iperry@leaflabs.com>, Bryan Newbold <bnewbold@robocracy.org + * @brief STM32F401C Discovery board file. + */ + +#ifndef _BOARD_STM32F401_DISCOVERY_H_ +#define _BOARD_STM32F401_DISCOVERY_H_ + +/* 84 MHz -> 84 cycles per microsecond. */ +#define CYCLES_PER_MICROSECOND 84 + +// PLL config for 8 MHz external crystal +// --> 84 MHz SYSCLK, with 48 MHz PLL48CK. +// +// Additional constraints: +// ASSERT_FAULT((data->pllq >= 4) && (data->pllq <= 15)); +// ASSERT_FAULT((data->pllp >= 2) && (data->pllp <= 8)); +// ASSERT_FAULT(!(data->pllp & 1)); +// ASSERT_FAULT((data->plln >= 192) && (data->plln <= 432)); +// ASSERT_FAULT((data->pllm >= 2) && (data->pllm <= 63)); +// +// f_VCO = (INPUT) X (PLL_N / PLL_M) +#define BOARD_PLL_N 336 +#define BOARD_PLL_M 8 +// SYSCLK = f_PLL = f_VCO / PLL_P; PLL_P = {2, 4, 6, 8} +#define BOARD_PLL_P 4 +// PLL48CK = f_USBETC = f_VCO / PLL_Q; 2 <= PLL_Q <= 15 +#define BOARD_PLL_Q 7 // should be 2? + +/* Pin number for the built-in button (USER button on STM32F401DISCOVERY) */ +#define BOARD_BUTTON_PIN PA0 + +/* Pin number for the built-in LED (blue LED on STM32F401DISCOVERY) */ +#define BOARD_LED_PIN PD15 + +/* Number of USARTs/UARTs whose pins are broken out to headers. */ +#define BOARD_NR_USARTS 3 + +/* USART pin numbers. */ +#define BOARD_USART1_TX_PIN PA9 +#define BOARD_USART1_RX_PIN PA10 +#define BOARD_USART2_TX_PIN PA2 +#define BOARD_USART2_RX_PIN PA3 +#define BOARD_USART3_TX_PIN PB10 +#define BOARD_USART3_RX_PIN PB11 + +/* Number of SPI ports broken out to headers. */ +#define BOARD_NR_SPI 2 + +/* SPI pin numbers. */ +#define BOARD_SPI1_NSS_PIN PA4 +#define BOARD_SPI1_MOSI_PIN PA7 +#define BOARD_SPI1_MISO_PIN PA6 +#define BOARD_SPI1_SCK_PIN PA5 + +#define BOARD_SPI2_NSS_PIN 28 +#define BOARD_SPI2_MOSI_PIN 31 +#define BOARD_SPI2_MISO_PIN 30 +#define BOARD_SPI2_SCK_PIN 29 + +/* Total number of GPIO pins that are broken out to headers and + * intended for use. This includes pins like the LED, button, and + * debug port (JTAG/SWD) pins. */ +#define BOARD_NR_GPIO_PINS 80 + +/* Number of pins capable of PWM output. */ +#define BOARD_NR_PWM_PINS 5 + +/* Number of pins capable of ADC conversion. */ +#define BOARD_NR_ADC_PINS 1 + +/* Number of pins already connected to external hardware. For Maple, + * these are just BOARD_LED_PIN, BOARD_BUTTON_PIN, and the debug port + * pins (see below). */ +#define BOARD_NR_USED_PINS 7 + +/* Debug port pins. */ +#define BOARD_JTMS_SWDIO_PIN 39 +#define BOARD_JTCK_SWCLK_PIN 40 +#define BOARD_JTDI_PIN 41 +#define BOARD_JTDO_PIN 42 +#define BOARD_NJTRST_PIN 43 + +/* USB configuration. BOARD_USB_DISC_DEV is the GPIO port containing + * the USB_DISC pin, and BOARD_USB_DISC_BIT is that pin's bit. */ +#define BOARD_USB_DISC_DEV GPIOC +#define BOARD_USB_DISC_BIT 12 + +/* Pin aliases: these give the GPIO port/bit for each pin as an + * enum. These are optional, but recommended. They make it easier to + * write code using low-level GPIO functionality. */ +enum { + PA0, PA1, PA2, PA3, PA4, PA5, PA6, PA7, PA8, PA9, PA10, PA11, PA12, PA13, PA14, PA15, + PB0, PB1, PB2, PB3, PB4, PB5, PB6, PB7, PB8, PB9, PB10, PB11, PB12, PB13, PB14, PB15, + PC0, PC1, PC2, PC3, PC4, PC5, PC6, PC7, PC8, PC9, PC10, PC11, PC12, PC13, PC14, PC15, + PD0, PD1, PD2, PD3, PD4, PD5, PD6, PD7, PD8, PD9, PD10, PD11, PD12, PD13, PD14, PD15, + PE0, PE1, PE2, PE3, PE4, PE5, PE6, PE7, PE8, PE9, PE10, PE11, PE12, PE13, PE14, PE15, +}; + +#endif |