board support: stm32f401c_discovery -> st_stm32f401cdiscovery

2 files changed, 283 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..4527a42
--- /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
+//
+// XXX: 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..119f111
--- /dev/null
+++ b/wirish/boards/st_stm32f401cdiscovery/include/board/board.h
@@ -0,0 +1,106 @@
+/******************************************************************************
+ * 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
+
+/* Pin number for the built-in button. */
+#define BOARD_BUTTON_PIN        0
+
+/* Pin number for the built-in LED. */
+#define BOARD_LED_PIN           63
+
+/* Number of USARTs/UARTs whose pins are broken out to headers. */
+#define BOARD_NR_USARTS         3
+
+/* USART pin numbers. */
+#define BOARD_USART1_TX_PIN     9
+#define BOARD_USART1_RX_PIN     10
+#define BOARD_USART2_TX_PIN     2
+#define BOARD_USART2_RX_PIN     3
+
+/* Number of SPI ports broken out to headers. */
+#define BOARD_NR_SPI            2
+
+/* SPI pin numbers. */
+#define BOARD_SPI1_NSS_PIN      10
+#define BOARD_SPI1_MOSI_PIN     11
+#define BOARD_SPI1_MISO_PIN     12
+#define BOARD_SPI1_SCK_PIN      13
+#define BOARD_SPI2_NSS_PIN      31
+#define BOARD_SPI2_MOSI_PIN     34
+#define BOARD_SPI2_MISO_PIN     33
+#define BOARD_SPI2_SCK_PIN      32
+
+/* 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