/************************************************************************************ * configs/open1788/include/board.h * include/arch/board/board.h * * Copyright (C) 2013 Gregory Nutt. All rights reserved. * Author: Gregory Nutt * * Redistribution and use in source and binary forms, with or without * modification, are permitted provided that the following conditions * are met: * * 1. Redistributions of source code must retain the above copyright * notice, this list of conditions and the following disclaimer. * 2. Redistributions in binary form must reproduce the above copyright * notice, this list of conditions and the following disclaimer in * the documentation and/or other materials provided with the * distribution. * 3. Neither the name NuttX nor the names of its contributors may be * used to endorse or promote products derived from this software * without specific prior written permission. * * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS * FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE * COPYRIGHT OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, * INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, * BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS * OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED * AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN * ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE * POSSIBILITY OF SUCH DAMAGE. * ************************************************************************************/ #ifndef __CONFIG_OPEN1788_INCLUDE_BOARD_H #define __CONFIG_OPEN1788_INCLUDE_BOARD_H /************************************************************************************ * Included Files ************************************************************************************/ #include #include #if defined(CONFIG_ARCH_IRQBUTTONS) && defined(CONFIG_GPIO_IRQ) # include #endif /************************************************************************************ * Definitions ************************************************************************************/ /* Clocking *************************************************************************/ /* NOTE: The following definitions require lpc17_syscon.h. It is not included here * because the including C file may not have that file in its include path. */ #define BOARD_XTAL_FREQUENCY (12000000) /* XTAL oscillator frequency */ #define BOARD_OSCCLK_FREQUENCY BOARD_XTAL_FREQUENCY /* Main oscillator frequency */ #define BOARD_RTCCLK_FREQUENCY (32768) /* RTC oscillator frequency */ #define BOARD_INTRCOSC_FREQUENCY (4000000) /* Internal RC oscillator frequency */ #define BOARD_WDTOSC_FREQUENCY (500000) /* WDT oscillator frequency */ /* This is the clock setup we configure for: * * SYSCLK = BOARD_OSCCLK_FREQUENCY = 12MHz -> Select Main oscillator for source * PLL0CLK = (10 * SYSCLK) / 1 = 120MHz -> PLL0 multipler=10, pre-divider=1 * CCLCK = 120MHz -> CCLK divider = 1 */ #define LPC17_CCLK 120000000 /* 120Mhz */ #define BOARD_PCLKDIV 2 /* Peripheral clock = LPC17_CCLK/2 */ #define BOARD_PCLK_FREQUENCY (LPC17_CCLK / BOARD_PCLKDIV) /* Select the main oscillator as the frequency source. SYSCLK is then the frequency * of the main oscillator. * * If BOARD_XTAL_FREQUENCY > 15000000, then the SCS OSCRS bit (bit 4) should also * be set in the BOARD_SCS_VALUE. */ #undef CONFIG_LPC17_MAINOSC #define CONFIG_LPC17_MAINOSC 1 #define BOARD_SCS_VALUE SYSCON_SCS_OSCEN /* Select the main oscillator and CCLK divider. The output of the divider is CCLK. * The input to the divider (PLLCLK) will be determined by the PLL output. */ #define BOARD_CCLKSEL_DIVIDER 1 #define BOARD_CCLKSEL_VALUE (BOARD_CCLKSEL_DIVIDER | SYSCON_CCLKSEL_CCLKSEL) /* PLL0. PLL0 is used to generate the CPU clock (PLLCLK). * * Source clock: Main oscillator * PLL0 Multiplier value (M): 10 * PLL0 Pre-divider value (P): 1 * * PLL0CLK = (M * SYSCLK) = 120MHz */ #undef CONFIG_LPC17_PLL0 #define CONFIG_LPC17_PLL0 1 #define BOARD_CLKSRCSEL_VALUE SYSCON_CLKSRCSEL_MAIN #define BOARD_PLL0CFG_MSEL 10 #define BOARD_PLL0CFG_PSEL 1 #define BOARD_PLL0CFG_VALUE \ (((BOARD_PLL0CFG_MSEL-1) << SYSCON_PLLCFG_MSEL_SHIFT) | \ ((BOARD_PLL0CFG_PSEL-1) << SYSCON_PLLCFG_PSEL_SHIFT)) /* PLL1 : PLL1 is used to generate clock for the USB */ #undef CONFIG_LPC17_PLL1 #define BOARD_PLL1CFG_MSEL 4 #define BOARD_PLL1CFG_PSEL 2 #define BOARD_PLL1CFG_VALUE \ (((BOARD_PLL1CFG_MSEL-1) << SYSCON_PLLCFG_MSEL_SHIFT) | \ ((BOARD_PLL1CFG_PSEL-1) << SYSCON_PLLCFG_PSEL_SHIFT)) #ifdef CONFIG_LPC17_EMC /* EMC clock selection. * * The EMC clock should not be driven above 80MHz. As a result the EMC * uses the CPU clock divided by two. */ # define BOARD_EMCCLKSEL_DIVIDER 2 # define BOARD_EMCCLKSEL_VALUE SYSCON_EMCCLKSEL_CCLK_DIV2 # define LPC17_EMCCLK (LPC17_CCLK / BOARD_EMCCLKSEL_DIVIDER) #endif #if defined(CONFIG_LPC17_USBHOST) || (CONFIG_LPC17_USBDEV) /* USB divider. The output of the PLL is used as the USB clock * * USBCLK = PLL1CLK = (SYSCLK * 4) = 48MHz */ # define BOARD_USBCLKSEL_DIVIDER 1 # define BOARD_USBCLKSEL_VALUE (SYSCON_USBCLKSEL_USBDIV_DIV1 | \ SYSCON_USBCLKSEL_USBSEL_PLL1) #endif /* FLASH Configuration */ #undef CONFIG_LPC17_FLASH #define CONFIG_LPC17_FLASH 1 /* Flash access use 6 CPU clocks - Safe for any allowed conditions */ #define BOARD_FLASHCFG_VALUE (SYSCON_FLASHCFG_TIM_5 | 0x03a) /* Ethernet configuration */ #define ETH_MCFG_CLKSEL_DIV ETH_MCFG_CLKSEL_DIV20 #ifdef CONFIG_LPC17_SDCARD /* SDIO dividers. Note that slower clocking is required when DMA is disabled * in order to avoid RX overrun/TX underrun errors due to delayed responses * to service FIFOs in interrupt driven mode. * SDCARD_CLOCK=PCLK/(2*(SDCARD_CLKDIV+1)) */ # define SDCARD_CLKDIV_INIT 74 /* 400Khz */ # define SDCARD_INIT_CLKDIV (SDCARD_CLKDIV_INIT) # define SDCARD_NORMAL_CLKDIV 1 /* DMA ON: SDCARD_CLOCK=15MHz */ #define SDCARD_SLOW_CLKDIV 14 /* DMA OFF: SDCARD_CLOCK=2MHz */ # ifdef CONFIG_SDIO_DMA # define SDCARD_MMCXFR_CLKDIV (SDCARD_NORMAL_CLKDIV) # else # define SDCARD_MMCXFR_CLKDIV (SDCARD_SLOW_CLKDIV) # endif # ifdef CONFIG_SDIO_DMA # define SDCARD_SDXFR_CLKDIV (SDCARD_NORMAL_CLKDIV) # else # define SDCARD_SDXFR_CLKDIV (SDCARD_SLOW_CLKDIV) # endif #endif /* Set EMC delay values: * * CMDDLY: Programmable delay value for EMC outputs in command delayed * mode. The delay amount is roughly CMDDLY * 250 picoseconds. * FBCLKDLY: Programmable delay value for the feedback clock that controls * input data sampling. The delay amount is roughly (FBCLKDLY+1) * 250 * picoseconds. * CLKOUT0DLY: Programmable delay value for the CLKOUT0 output. This would * typically be used in clock delayed mode. The delay amount is roughly * (CLKOUT0DLY+1) * 250 picoseconds. * CLKOUT1DLY: Programmable delay value for the CLKOUT1 output. This would * typically be used in clock delayed mode. The delay amount is roughly * (CLKOUT1DLY+1) * 250 picoseconds. * * Optimal for NOR: {1,1,1,1} * Needed for NAND and SDRAM: {17,1,2,1} */ #ifdef CONFIG_LPC17_EMC #if defined(CONFIG_ARCH_EXTNAND) || defined(CONFIG_ARCH_EXTDRAM) # define BOARD_CMDDLY 17 # define BOARD_FBCLKDLY 17 # define BOARD_CLKOUT0DLY 1 # define BOARD_CLKOUT1DLY 1 #else # define BOARD_CMDDLY 1 # define BOARD_FBCLKDLY 1 # define BOARD_CLKOUT0DLY 1 # define BOARD_CLKOUT1DLY 1 #endif #endif /* LED definitions ******************************************************************/ /* If CONFIG_ARCH_LEDS is not defined, then the user can control the LEDs in * any way. The following definitions are used to access individual LEDs. * * LED1 -- Connected to P1[14] * LED2 -- Connected to P0[16] (shared with UART1 RXD) * LED3 -- Connected to P1[13] * LED4 -- Connected to P4[27] * * These LEDs are connecte to ground so a high output value will illuminate them. */ /* LED index values for use with lpc17_setled() */ #define BOARD_LED1 0 #define BOARD_LED2 1 #define BOARD_LED3 2 #define BOARD_LED4 3 #define BOARD_NLEDS 4 /* LED bits for use with lpc17_setleds() */ #define BOARD_LED1_BIT (1 << BOARD_LED1) #define BOARD_LED2_BIT (1 << BOARD_LED2) #define BOARD_LED3_BIT (1 << BOARD_LED3) #define BOARD_LED4_BIT (1 << BOARD_LED4) /* If CONFIG_ARCH_LEDs is defined, then NuttX will control the four LEDs * on the WaveShare Open1788K. The following definitions describe how NuttX * controls the LEDs: */ /* LED1 LED2 LED3 LED4 */ #define LED_STARTED 0 /* OFF OFF OFF OFF */ #define LED_HEAPALLOCATE 1 /* ON OFF OFF OFF */ #define LED_IRQSENABLED 2 /* OFF ON OFF OFF */ #define LED_STACKCREATED 3 /* ON ON OFF OFF */ #define LED_INIRQ 4 /* LED3 glows, on while in interupt */ #define LED_SIGNAL 4 /* LED3 glows, on while in signal handler */ #define LED_ASSERTION 4 /* LED3 glows, on while in assertion */ #define LED_PANIC 4 /* LED3 Flashes at 2Hz */ #define LED_IDLE 5 /* LED4 glows: ON while active * * OFF while sleeping */ /* Button definitions ***************************************************************/ /* The Open1788 supports several buttons. All must be pulled up by the Open1788. * When closed, the pins will be pulled to ground. So the buttons will read "1" * when open and "0" when closed. All except USER1 are capable of generating * interrupts. * * USER1 -- Connected to P4[26] * USER2 -- Connected to P2[22] * USER3 -- Connected to P0[10] * * And a Joystick * * JOY_A -- Connected to P2[25] * JOY_B -- Connected to P2[26] * JOY_C -- Connected to P2[23] * JOY_D -- Connected to P2[19] * JOY_CTR -- Connected to P0[14] (shared with SSP1 SSEL) * * For the interrupting buttons, interrupts are generated on both edges (press and * release). */ #define BOARD_BUTTON_USER1 0 #define BOARD_BUTTON_USER2 1 #define BOARD_BUTTON_USER3 2 #define BOARD_JOYSTICK_A 3 #define BOARD_JOYSTICK_B 4 #define BOARD_JOYSTICK_C 5 #define BOARD_JOYSTICK_D 6 #define BOARD_JOYSTICK_CTR 7 #define BOARD_NUM_BUTTONS 8 #define BOARD_BUTTON_USER1_BIT (1 << BOARD_BUTTON_USER1) #define BOARD_BUTTON_USER2_BIT (1 << BOARD_BUTTON_USER2) #define BOARD_BUTTON_USER3_BIT (1 << BOARD_BUTTON_USER3) #define BOARD_JOYSTICK_A_BIT (1 << BOARD_JOYSTICK_A) #define BOARD_JOYSTICK_B_BIT (1 << BOARD_JOYSTICK_B) #define BOARD_JOYSTICK_C_BIT (1 << BOARD_JOYSTICK_C) #define BOARD_JOYSTICK_D_BIT (1 << BOARD_JOYSTICK_D) #define BOARD_JOYSTICK_CTR_BIT (1 << BOARD_JOYSTICK_CTR) /* Alternate pin selections *********************************************************/ /* UART0: * * TX --- Connected to P0[2] * RX --- Connected to P0[3] */ #define GPIO_UART0_TXD GPIO_UART0_TXD_2 #define GPIO_UART0_RXD GPIO_UART0_RXD_2 /* UART1: * * All pin options are controlled by older briges on the bottom of the board. There * are the default settings on my board as it came out of the box: * * RTS --- Connected to P0[22] * RI --- Connected to P0[21] * DSR --- Connected to P0[19] * DCD --- Connected to P0[18] * CTS --- Connected to P0[17] * DTR --- Connected to P0[20] * TXD --- Connected to P0[15] * RXD --- Connected to P0[16] (Shared with LED2) */ #define GPIO_UART1_RTS GPIO_UART1_RTS_2 #define GPIO_UART1_RI GPIO_UART1_RI_1 #define GPIO_UART1_DSR GPIO_UART1_DSR_1 #define GPIO_UART1_DCD GPIO_UART1_DCD_1 #define GPIO_UART1_CTS GPIO_UART1_CTS_1 #define GPIO_UART1_DTR GPIO_UART1_DTR_1 #define GPIO_UART1_TXD GPIO_UART1_TXD_1 #define GPIO_UART1_RXD GPIO_UART1_RXD_1 /* MCI-SDIO: * * D0 --- Connected to P1[6] * D1 --- Connected to P2[11] * D2 --- Connected to P2[12] * D3 --- Connected to P2[13] * CLK --- Connected to P1[2] * CMD --- Connected to P1[3] */ #define GPIO_SD_DAT0 GPIO_SD_DAT0_2 #define GPIO_SD_DAT1 GPIO_SD_DAT1_2 #define GPIO_SD_DAT2 GPIO_SD_DAT2_2 #define GPIO_SD_DAT3 GPIO_SD_DAT3_2 #define GPIO_SD_CLK GPIO_SD_CLK_2 #define GPIO_SD_CMD GPIO_SD_CMD_2 /* LCD R: * * VD0 --- Connected to P0[4] * VD1 --- Connected to P0[5] * VD2 --- Connected to P4[28] * VD3 --- Connected to P4[29] * VD4 --- Connected to P2[6] * VD5 --- Connected to P2[7] * VD6 --- Connected to P2[8] * VD7 --- Connected to P2[9] */ #define GPIO_LCD_VD0 GPIO_LCD_VD0_1 #define GPIO_LCD_VD1 GPIO_LCD_VD1_1 #define GPIO_LCD_VD2 GPIO_LCD_VD2_2 #define GPIO_LCD_VD3 GPIO_LCD_VD3_3 #define GPIO_LCD_VD4 GPIO_LCD_VD4_1 #define GPIO_LCD_VD5 GPIO_LCD_VD5_1 #define GPIO_LCD_VD6 GPIO_LCD_VD6_2 #define GPIO_LCD_VD7 GPIO_LCD_VD7_2 /* LED G: * * VD8 --- Connected to P0[6] * VD9 --- Connected to P0[7] * VD10 --- Connected to P1[20] * VD11 --- Connected to P1[21] * VD12 --- Connected to P1[22] * VD13 --- Connected to P1[23] * VD14 --- Connected to P1[24] * VD15 --- Connected to P1[25] */ #define GPIO_LCD_VD8 GPIO_LCD_VD8_1 #define GPIO_LCD_VD9 GPIO_LCD_VD9_1 #define GPIO_LCD_VD10 GPIO_LCD_VD10_1 #define GPIO_LCD_VD11 GPIO_LCD_VD11_1 #define GPIO_LCD_VD12 GPIO_LCD_VD12_1 #define GPIO_LCD_VD13 GPIO_LCD_VD13_1 #define GPIO_LCD_VD14 GPIO_LCD_VD14_1 #define GPIO_LCD_VD15 GPIO_LCD_VD15_1 /* LCD B: * * VD16 --- Connected to P0[8] * VD17 --- Connected to P0[9] * VD18 --- Connected to P2[12] * VD19 --- Connected to P2[13] * VD20 --- Connected to P1[26] * VD21 --- Connected to P1[27] * VD22 --- Connected to P1[28] * VD23 --- Connected to P1[29] * * DCLK --- Connected to P2[2] * LP --- Connected to P2[5] * FP --- Connected to P2[3] * ENAB_M --- Connected to P2[4] * PWR --- Connected to P2[0] */ /* XPT2046 Touchscreen: * /* -------------- -------------------- ------------ -------------------------------- * XTPT2046 Module Module Open1788 LED * Signal Connector Connector * -------------- -------------------- ------------ --------------------------------- * Pin 11 PENIRQ\ PENIRQ (pulled high) PORT3 Pin 1 P2.15 PENIRQ * Pin 12 DOUT MISO PORT3 Pin 4 P1.18 MISO1 (Also USB HOST UP LED) * Pin 13 BUSY BUSY (pulled high) PORT3 Pin 9 P2.14 BUSY * Pin 14 DIN MOSI PORT3 Pin 3 P0.13 MOSI1 (Also USB Device up LED and SD CD pin) * Pin 15 CS\ SSEL (pulled high) PORT3 Pin 6 P1.8 GPIO (Also RMII_CRS_DV) * Pin 16 DCLK SCK PORT3 Pin 5 P1.19 SCK1 * -------------- -------------------- ------------ --------------------------------- */ #define GPIO_SSP1_MISO GPIO_SSP1_MISO_3 #define GPIO_SSP1_MOSI GPIO_SSP1_MOSI_2 #define GPIO_SSP1_SCK GPIO_SSP1_SCK_2 /************************************************************************************ * Public Types ************************************************************************************/ #ifndef __ASSEMBLY__ /************************************************************************************ * Public Data ************************************************************************************/ #undef EXTERN #if defined(__cplusplus) #define EXTERN extern "C" extern "C" { #else #define EXTERN extern #endif /************************************************************************************ * Public Function Prototypes ************************************************************************************/ /************************************************************************************ * Name: lpc17_boardinitialize * * Description: * All LPC17xx architectures must provide the following entry point. This entry * point is called early in the intitialization -- after all memory has been * configured and mapped but before any devices have been initialized. * ************************************************************************************/ EXTERN void lpc17_boardinitialize(void); /************************************************************************************ * Name: lpc17_ledinit, lpc17_setled, and lpc17_setleds * * Description: * If CONFIG_ARCH_LEDS is defined, then NuttX will control the on-board LEDs. If * CONFIG_ARCH_LEDS is not defined, then the following interfacesare available to * control the LEDs from user applications. * ************************************************************************************/ #ifndef CONFIG_ARCH_LEDS EXTERN void lpc17_ledinit(void); EXTERN void lpc17_setled(int led, bool ledon); EXTERN void lpc17_setleds(uint8_t ledset); #endif /************************************************************************************ * Name: up_buttoninit * * Description: * up_buttoninit() must be called to initialize button resources. After that, * up_buttons() may be called to collect the current state of all buttons or * up_irqbutton() may be called to register button interrupt handlers. * ************************************************************************************/ #ifdef CONFIG_ARCH_BUTTONS EXTERN void up_buttoninit(void); /************************************************************************************ * Name: up_buttons * * Description: * up_buttoninit() must be called to initialize button resources. After that, * up_buttons() may be called to collect the current state of all buttons. * * After up_buttoninit() has been called, up_buttons() may be called to collect * the state of all buttons. up_buttons() returns an 8-bit bit set with each bit * associated with a button. See the BOARD_BUTTON_*_BIT and BOARD_JOYSTICK_*_BIT * definitions above for the meaning of each bit. * ************************************************************************************/ EXTERN uint8_t up_buttons(void); /************************************************************************************ * Button support. * * Description: * up_buttoninit() must be called to initialize button resources. After that, * up_irqbutton() may be called to register button interrupt handlers. * * up_irqbutton() may be called to register an interrupt handler that will be called * when a button is depressed or released. The ID value is a button enumeration * value that uniquely identifies a button resource. See the BOARD_BUTTON_* and * BOARD_JOYSTICK_* definitions in above for the meaning of enumeration values * The previous interrupt handler address is returned (so that it may restored, if * so desired). * * Note that up_irqbutton() also enables button interrupts. Button interrupts * will remain enabled after the interrupt handler is attached. Interrupts may * be disabled (and detached) by calling up_irqbutton with irqhandler equal to * NULL. * ************************************************************************************/ #if defined(CONFIG_ARCH_IRQBUTTONS) && defined(CONFIG_GPIO_IRQ) EXTERN xcpt_t up_irqbutton(int id, xcpt_t irqhandler); #endif #endif /* CONFIG_ARCH_BUTTONS */ #undef EXTERN #if defined(__cplusplus) } #endif #endif /* __ASSEMBLY__ */ #endif /* __CONFIG_OPEN1788_INCLUDE_BOARD_H */