nuttx/boards/arm/lpc54xx/lpcxpresso-lpc54628/include/board.h

/****************************************************************************
 * boards/arm/lpc54xx/lpcxpresso-lpc54628/include/board.h
 *
 * Licensed to the Apache Software Foundation (ASF) under one or more
 * contributor license agreements.  See the NOTICE file distributed with
 * this work for additional information regarding copyright ownership.  The
 * ASF licenses this file to you under the Apache License, Version 2.0 (the
 * "License"); you may not use this file except in compliance with the
 * License.  You may obtain a copy of the License at
 *
 *   http://www.apache.org/licenses/LICENSE-2.0
 *
 * Unless required by applicable law or agreed to in writing, software
 * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT
 * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.  See the
 * License for the specific language governing permissions and limitations
 * under the License.
 *
 ****************************************************************************/

#ifndef __BOARDS_ARM_LPC54XX_LPCXPRESSO_LPC54628_INCLUDE_BOARD_H
#define __BOARDS_ARM_LPC54XX_LPCXPRESSO_LPC54628_INCLUDE_BOARD_H

/****************************************************************************
 * Included Files
 ****************************************************************************/

#include <nuttx/config.h>

/****************************************************************************
 * Pre-processor Definitions
 ****************************************************************************/

/* Clocking *****************************************************************/

#undef  BOARD_180MHz
#define BOARD_220MHz                    1

/* System PLL
 *
 * Notation:
 *   Fin  = the input to the PLL.
 *   Fout = the output of the PLL.
 *   Fref = the PLL reference frequency, the input to the phase frequency
 *          detector.
 *   N    = optional pre-divider value.
 *   M    = feedback divider value, which represents the multiplier for the
 *          PLL.
 *   P    = optional post-divider value. An additional divide-by-2 is
 *          included in the post-divider path.
 *
 * In all variations of normal mode, the following requirements must be met:
 *
 *   -275 MHz ≤ Fcco ≤ 550 MHz.
 *   4 kHz ≤ Fin / N ≤ 25 MHz.
 *
 * Normal mode with optional pre-divide.  In the equations, use N = 1 when
 * the pre-divider is not used.  The extra divide by 2 is in the feedback
 * divider path:
 *
 *   Fout = Fcco = 2 x M x Fin / N
 *
 * Normal mode with post-divide and optional pre-divide.  In the equations,
 * use N = 1 when the pre-divider is not used:
 *
 *   Fout = Fcco / (2 x P) = M x Fin / (N x P)
 */

#define BOARD_PLL_SOURCE                          /* Select source FR0 12MHz */
#define BOARD_PLL_FIN            LPC54_FRO_12MHZ  /* PLL input frequency */

#ifdef BOARD_180MHz
/* PLL Clock Source:             CLKIN
 * Main Clock Source:            PLL
 * Fout:                         220000000
 */

#  define BOARD_PLL_CLKSEL       SYSCON_SYSPLLCLKSEL_CLKIN
#  define BOARD_PLL_SELI         32               /* Bandwidth select I value */
#  define BOARD_PLL_SELP         16               /* Bandwidth select P value */
#  define BOARD_PLL_SELR         0                /* Bandwidth select R value */
#  define BOARD_PLL_MDEC         8191             /* Encoded M-divider coefficient */
#  define BOARD_PLL_NDEC         770              /* Encoded N-divider coefficient */
#  define BOARD_PLL_PDEC         98               /* Encoded P-divider coefficient */
#  define BOARD_PLL_FOUT         180000000U       /* Pll output frequency */

#else /* BOARD_220MHz */
/* PLL Clock Source:             FRO 12MHz
 * Main Clock Source:            PLL
 * Fout:                         220000000
 */

#  define BOARD_PLL_CLKSEL       SYSCON_SYSPLLCLKSEL_FFRO
#  define BOARD_PLL_SELI         34               /* Bandwidth select I value */
#  define BOARD_PLL_SELP         31               /* Bandwidth select P value */
#  define BOARD_PLL_SELR         0                /* Bandwidth select R value */
#  define BOARD_PLL_MDEC         13243            /* Encoded M-divider coefficient */
#  define BOARD_PLL_NDEC         1                /* Encoded N-divider coefficient */
#  define BOARD_PLL_PDEC         98               /* Encoded P-divider coefficient */
#  define BOARD_PLL_FOUT         220000000        /* Pll output frequency */
#endif

#define BOARD_MAIN_CLK           BOARD_PLL_FOUT   /* Main clock frequency */

/* CPU Clock:
 *
 *   AHB Clock Divider:          1
 *   AHB Clock Frequency:        180,000,000 or 220,000,000
 */

#define BOARD_AHBCLKDIV          1                 /* (un-decremented) */
#define BOARD_AHB_FREQUENCY      (BOARD_MAIN_CLK / BOARD_AHBCLKDIV)
#define BOARD_CPU_FREQUENCY      BOARD_AHB_FREQUENCY

/* Fraction Rate Generator (FRG) Clock (Optional Flexcomm0 function clock)
 *
 * To use the fractional divider, the DIV value must be programmed with the
 * fixed value of 256.  Then:
 *
 *   Ffrg = (Finput) / (1 + (MULT / DIV))
 *
 * Mainclock is used as the FRG clock source.  Divider must be such that the
 * FRG output frequency is less than equal to 48MHz
 *
 *   MUL = (Finput - Ffrg) * 256) / Ffrg
 */

/* Revisit: FRGCLK <= 48MHz cannot be realized with the MainClk source */

#define BOARD FRGCLK_CLKSEL      SYSCON_FRGCLKSEL_MAINCLK
#define BOARD_FRGCLK_INPUT       BOARD_MAIN_CLK   /* FRG input frequency */
#define BOARD_FRGCLK             48000000         /* May not be exact */

/* SysTick:
 * The SysTick clock may be clocked internally either by the by the system
 * clock (CLKSOURCE==1) or by the SysTick function clock (CLKSOURCE==0).
 * The SysTick Function clock is equal to:
 *
 *   Fsystick = Fmainclk / SYSTICKCLKDIV
 *
 * Tips for selecting BOARD_SYSTICKCLKDIV:
 * The resulting SysTick reload value should be as large as possible,
 * but must be less than 2^24:
 *
 *   SYSTICKDIV > Fmainclk / CLK_TCK / 2^24
 *
 * The logic in lpc54_timerisr.c will always select the SysTick function
 * clock as the source (CLKSOURCE==0).
 * NOTE: When the system tick clock divider is selected as the clock source,
 * the CPU clock must be at least 2.5 times faster than the divider output.
 *
 *   SysTick Divider:            (SYSTICKCLKDIV)
 */

#ifndef CONFIG_SCHED_TICKLESS
#  if CONFIG_USEC_PER_TICK == 10000
#    define BOARD_SYSTICKCLKDIV  1
#  else
#    error Missing SYSTICK divider
#  endif
#  define BOARD_SYSTICK_CLOCK    (BOARD_AHB_FREQUENCY / BOARD_SYSTICKCLKDIV)
#endif

/* Flexcomm0:  USART0 (REVISIT) */

#define BOARD_FLEXCOMM0_CLKSEL   SYSCON_FCLKSEL_FRO12M
#define BOARD_FLEXCOMM0_FCLK     LPC54_FRO_12MHZ

/* Flexcomm2:  I2C2 (REVISIT) */

#define BOARD_FLEXCOMM2_CLKSEL   SYSCON_FCLKSEL_FRO12M
#define BOARD_FLEXCOMM2_FCLK     LPC54_FRO_12MHZ

/* EMC */

#ifdef BOARD_220MHz
#define BOARD_EMC_CLKDIV         3     /* EMC Clock = CPU FREQ/3 */
#else /* if BOARD_180MHz */
#define BOARD_EMC_CLKDIV         2     /* EMC Clock = CPU FREQ/2 */
#endif
#define BOARD_EMC_FREQUENCY      (BOARD_CPU_FREQUENCY / BOARD_EMC_CLKDIV)

/* SD/MMC or SDIO interface */

/* SD/MMC function clock.  The SDMMC source clock (Fsdmmc) is the main clock
 * which may be divided down by the SYSCON module (8-bit divider, functional
 * range, 1-256).  The SD clock is obtained by dividing the source clock
 * down once again (8-bit divider with functional range 1 (bypass) then 2-510
 * in steps of 2).
 *
 *   Fsdmmc = Fmck / SYSDIV
 *   Fsd    = Fsdmmc / SDDIV
 *
 * The optimal SYSCON divisor (SYSDIV) is the smallest divisor that will
 * assure that the smallest usable SD frequency (Fmin = 400KHz) can be
 * attained without overflowing the final 8-bit divider (SDDIV).  That is:
 *
 *  SYSDIV = Fmck / 400,000 / 510
 *
 * Example:  BOARD_MAIN_CLK=220MHz, CLKDIV=2, Finput=110MHz.
 *
 * REVISIT:  We could get getter timing resolution if we were to reset the
 * optimal SYSCON divider with each frequency change.  For example, at 220
 * MHz, we could set he divider to 1 for all operational frequencies.
 */

#define BOARD_SDMMC_CEIL(a,b)    (((a) + (b) - 1) / (b))

#define BOARD_SDMMC_CLKSRC       SYSCON_SDIOCLKSEL_MAINCLK
#define BOARD_SDMMC_CLKDIV       BOARD_SDMMC_CEIL(BOARD_MAIN_CLK, 400000 * 510)
#define BOARD_SDMMC_FREQUENCY    (BOARD_MAIN_CLK / BOARD_SDMMC_CLKDIV)

/* Mode-dependent function clock division
 *
 * Example:  BOARD_SDMMC_FREQUENCY=110MHz
 *           BOARD_CLKDIV_INIT=276[275],  Fsdmmc=399KHz  (400KHz max)
 *           BOARD_CLKDIV_MMCXFR=6,       Fsdmmc=18Mhz   (20MHz max)
 *           BOARD_CLKDIV_SDWIDEXFR=6[5], Fsdmmc=18MHz   (25MHz max)
 *           BOARD_CLKDIV_SDXFR=6[5],     Fsdmmc=18MHz   (25MHz max)
 *
 * NOTE:  Clock division is 2*n. For example, value of 0 means divide by
 * 2 * 0 = 0 (no division, bypass), value of 1 means divide by 2 * 1 = 2,
 * value of 255 means divide by 2 * 255 = 510, and so on.
 *
 * SD/MMC logic will write the value ((clkdiv + 1) >> 1) as the divisor.
 * So an odd value calculated below will be moved up to next higher divider
 * value.  So the value 3 will cause 2 to be written as the divider value
 * and the effective divider will be 4.
 */

#define BOARD_CLKDIV_INIT       BOARD_SDMMC_CEIL(BOARD_SDMMC_FREQUENCY, 400000)
#define BOARD_CLKDIV_MMCXFR     BOARD_SDMMC_CEIL(BOARD_SDMMC_FREQUENCY, 20000000)
#define BOARD_CLKDIV_SDWIDEXFR  BOARD_SDMMC_CEIL(BOARD_SDMMC_FREQUENCY, 25000000)
#define BOARD_CLKDIV_SDXFR      BOARD_SDMMC_CEIL(BOARD_SDMMC_FREQUENCY, 25000000)

/* Clocking *****************************************************************/

/* The LPCXpress-LPC54628 has three user LEDs: D9, D11, and D12.  These
 * LEDs are for application use. They are illuminated when the driving
 * signal from the LPC546xx is low. The LEDs are driven by ports P2-2 (D9),
 * P3-3 (D11) and P3-14 (D12).
 */

/* LED index values for use with board_userled() */

#define BOARD_D9                   0
#define BOARD_D11                  1
#ifndef CONFIG_ARCH_LEDS
#  define BOARD_D12                2
#  define BOARD_NLEDS              3
#else
#  define BOARD_NLEDS              2
#endif

/* LED bits for use with board_userled_all() */

#define BOARD_D9_BIT               (1 << BOARD_D9)
#define BOARD_D11_BIT              (1 << BOARD_D11)
#ifndef CONFIG_ARCH_LEDS
#  define BOARD_D12_BIT            (1 << BOARD_D12)
#endif

/* These LEDs are not used by the NuttX port unless CONFIG_ARCH_LEDS is
 * defined.  In that case, the usage by the board port is defined in
 * include/board.h and src/lpc54_autoleds.c.  The LEDs are used to encode
 * OS-related events as follows:
 */

                                      /* D9     D11    D12 */
#define LED_STARTED                0  /* OFF    OFF    OFF */
#define LED_HEAPALLOCATE           1  /* ON     OFF    OFF */
#define LED_IRQSENABLED            2  /* OFF    ON     OFF */
#define LED_STACKCREATED           3  /* OFF    OFF    OFF */

#define LED_INIRQ                  4  /* NC     NC     ON  (momentary) */
#define LED_SIGNAL                 4  /* NC     NC     ON  (momentary) */
#define LED_ASSERTION              4  /* NC     NC     ON  (momentary) */
#define LED_PANIC                  4  /* NC     NC     ON  (2Hz flashing) */
#undef  LED_IDLE                      /* Sleep mode indication not supported */

/* After booting, LEDs D9 and D11 are available for use by the user.  If the
 * system booted properly, D9 and D11 should be OFF and D12 should be glowing
 * to indicate that interrupts are occurring.  If D12 is flash at 2Hz, then
 * the system has crashed.
 */

/* Button definitions *******************************************************/

/* The LPCXpresso has four switches:
 *
 *   SW2 ISP2         P0.6
 *   SW3 ISP1         P0.5
 *   SW4 ISP0         P0.4
 *   SW5 User Button  P1.1
 *
 * In all cased, the signal is low when the button is pressed.
 *
 * SW2, SW3, SW4 can be used to force the LPC546xx in to ISP boot modes.
 * After boot these buttons could be used as user buttons.  However, they are
 * not available when the on-board SRDRAM is used because P0.4, P0.5, and
 * P0.6 are also used as EMC_D2, EMC_D3, and EMC_D4, respectively.
 *
 * So SW5 is really the only button that that is generally available for
 * software usage.
 */

#define BUTTON_USER                0
#define NUM_BUTTONS                1

#define BUTTON_USER_BIT            (1 << BUTTON_USER)

/* Pin Disambiguation *******************************************************/

/* Flexcomm0/USART0
 *
 * USART0 connects to the serial bridge on LPC4322JET100 and is typically
 * used for the serial console.
 *
 *   BRIDGE_UART_RXD -> P0_29-ISP_FC0_RXD -> P0.29  GPIO_FC0_RXD_SDA_MOSI_2
 *   BRIDGE_UART_TXD <- P0_30-ISP_FC0_TXD <- P0.30  GPIO_FC0_TXD_SCL_MISO_2
 */

#define GPIO_USART0_RXD            (GPIO_FC0_RXD_SDA_MOSI_2 | GPIO_FILTER_OFF)
#define GPIO_USART0_TXD            (GPIO_FC0_TXD_SCL_MISO_2 | GPIO_FILTER_OFF)

/* An alternative for the serial console is a Arduino Uno compatible serial
 * shield:
 *
 *   Arduino Uno  J13    Board Signal
 *   ----------- ------ ----------------
 *    D0 RX      Pin 15 P3_26-FC4_RXD
 *    D1 TX      Pin 13 P3_27-FC4_TXD
 */

#define GPIO_USART4_RXD            (GPIO_FC4_RXD_SDA_MOSI_2 | GPIO_FILTER_OFF)
#define GPIO_USART4_TXD            (GPIO_FC4_TXD_SCL_MISO_2 | GPIO_FILTER_OFF)

/* Flexcomm2/I2C
 *
 * For I2C:
 *   Type A & D pins need:
 *     GPIO_OPENDRAIN + GPIO_FILTER_OFF
 *   Type I pins need for Standard mode I2C need:
 *     GPIO_FILTER_OFF + GPIO_I2C_FILTER_ON + GPIO_I2CDRIVE_LOW
 *   Type I pins need for fast speed I2C need:
 *     GPIO_FILTER_OFF + GPIO_I2C_FILTER_ON or OFF +
 *     GPIO_I2CDRIVE_LOW or HIGH
 *   Type I pins need for high speed I2C need:
 *     GPIO_FILTER_OFF + GPIO_I2C_FILTER_OFF + GPIO_I2CDRIVE_HIGH
 *
 * There are several on-board devices using I2C2:
 *
 *   Codec I2C address:        0x1a
 *   Accel I2C address:        0x1d
 *   Touch panel I2C address:  0x38
 *
 * In addition, these same I2C2 pins are brought out through D14 and D15 of
 * the Arduino Uno connector.
 */

#if defined(CONFIG_LPC54_I2C_FAST)
#  define _I2CFILTER               GPIO_I2C_FILTER_OFF
#  define _I2CDRIVE                GPIO_I2CDRIVE_HIGH
#elif defined(CONFIG_LPC54_I2C_HIGH)
#  define _I2CFILTER               GPIO_I2C_FILTER_OFF
#  define _I2CDRIVE                GPIO_I2CDRIVE_HIGH
#else
#  define _I2CFILTER               GPIO_I2C_FILTER_ON
#  define _I2CDRIVE                GPIO_I2CDRIVE_LOW
#endif

#define GPIO_I2C2_SCL              (GPIO_FC2_RTS_SCL_SSEL1_2 | \
                                    GPIO_FILTER_OFF | _I2CFILTER | \
                                    _I2CDRIVE)
#define GPIO_I2C2_SDA              (GPIO_FC2_CTS_SDA_SSEL0_2 | \
                                    GPIO_FILTER_OFF | _I2CFILTER | \
                                    _I2CDRIVE)

/* Flexcomm2/SPI
 *
 * There are no SPI devices on board the LPCXpresso-LPC54628.  SPI is
 * available on the Arduino Uno compatible connector, however:
 *
 *   Arduino Uno   J9     Board Signal   Pin Type
 *   ----------- ------ ---------------- ---------
 *    D10 SSEL   Pin 15 P3_20-FC9_SCK     Type D
 *    D11 MOSI   Pin 13 P3_21-FC9_MOSI    Type A
 *    D12 MISO   Pin 11 P3_22-FC9_MISO    Type A
 *    D13 SCK    Pin 9  P3_30-FC9_SSELn0  Type D
 *
 * For SPI:
 *   Type A & D pins need:
 *     GPIO_PUSHPULL (on outputs) + GPIO_SLEW_STANDARD (Type D) +
 *       GPIO_FILTER_OFF
 *     GPIO_SLEW_FAST is optional for high data rates (Type D).
 *   Type I need:
 *     GPIO_I2C_FILTER_OFF + GPIO_I2CDRIVE_LOW + GPIO_FILTER_OFF +
 *       GPIO_I2CSLEW_GPIO
 */

#define GPIO_FC9_RXD_SDA_MOSI      (GPIO_FC9_RXD_SDA_MOSI_1 | \
                                    GPIO_PUSHPULL | GPIO_FILTER_OFF)
#define GPIO_FC9_TXD_SCL_MISO      (GPIO_FC9_TXD_SCL_MISO_1 | \
                                    GPIO_FILTER_OFF)
#define GPIO_FC9_SCK               (GPIO_FC9_SCK_1 | GPIO_PUSHPULL | \
                                    GPIO_SLEW_STANDARD | GPIO_FILTER_OFF)

/* SD/MMC
 *
 *  P2_10-SD_CDn
 *  P2_6-SD_D0
 *  P2_7-SD_D1
 *  P2_8-SD_D2
 *  P2_9-SD_D3
 *  P2_3-SD_CLK
 *  P2_4-SD_CMD
 *  P2_5-SD_POW_EN
 *  P3_15-SD_WPn
 */

#define GPIO_SD_CARD_DET_N         GPIO_SD_CARD_DET_N_2     /* P2.10 */
#define GPIO_SD_D0                 GPIO_SD_D0_3             /* P2.6 */
#define GPIO_SD_D1                 GPIO_SD_D1_3             /* P2.7 */
#define GPIO_SD_D2                 GPIO_SD_D2_3             /* P2.8 */
#define GPIO_SD_D3                 GPIO_SD_D3_3             /* P2.9 */
#define GPIO_SD_CLK                GPIO_SD_CLK_3            /* P2.3 */
#define GPIO_SD_CMD                GPIO_SD_CMD_3            /* P2.4 */
#define GPIO_SD_POW_EN             GPIO_SD_POW_EN_2         /* P2.5 */
#define GPIO_SD_WR_PRT             GPIO_SD_WR_PRT_2         /* P2.15 */

/* REVISIT: Due to chip errata, Rev. 1.7, Issue 3.7, DAT4-7 must also be
 * configured.  Otherwise the SD interface will not work.
 */

#define GPIO_SD_D4                 (GPIO_SD_D4_3 | GPIO_PULLUP) /* P4.29 */
#define GPIO_SD_D5                 (GPIO_SD_D5_3 | GPIO_PULLUP) /* P4.30 */
#define GPIO_SD_D6                 (GPIO_SD_D6_3 | GPIO_PULLUP) /* P4.31 */
#define GPIO_SD_D7                 (GPIO_SD_D7_3 | GPIO_PULLUP) /* P5.0 */

/* LCD
 *
 *   There are no alternatives for LCD pins except for the VD0-VD3 pins.
 *   VD0-VD2 are not used in this hardware configuration.  VD3 is on
 *   P2.21.
 */

#define GPIO_LCD_VD3               GPIO_LCD_VD3_1

/* Ethernet Clock
 *
 * The Lpcxpresso-LPC546258 uses a LAN8720A PHY in RMII mode.  Clocking is
 * provided via a 25MHz crystal (Y1).  CLKOUT on P3.12 is an option if JS4
 * is reversed.
 */

#define BOARD_PHY_CLOCK            25000000  /* 25MHz crystal */

/* Ethernet RMII mode pins:
 *
 *   P4_16-ENET_MDIO     Ethernet MIIM data input and output
 *   P4_15-ENET_MDC      Ethernet MIIM clock
 *
 *   P4_11-ENET_RXD0     Ethernet receive data 0-1
 *   P4_12-ENET_RXD1
 *   P4_8-ENET_TXD0      Ethernet transmit data 0-1
 *   P0_17-ENET_TXD1
 *   P4_10-ENET_CRS_DV   Ethernet receive data valid
 *   P4_13-ENET_TX_EN    Ethernet transmit data enable
 *
 *   P4_14-ENET_RX_CLK   REF_CLK, Reference clock
 *   P2_26-ENET_PHY_RSTn nRST (Controlled by board logic)
 *
 * NOTE:  You must set JP11 and JP12 to close 1-2 to enable Ethernet
 * port functionality.  Some pins are shared with USB0 overcurrent
 * feature.
 */

#define GPIO_ENET_MDIO             GPIO_ENET_MDIO_2   /* P4.16 */
#define GPIO_ENET_MDC              GPIO_ENET_MDC_2    /* P4.15 */

#define GPIO_ENET_RXD0             GPIO_ENET_RXD0_2   /* P4.11 */
#define GPIO_ENET_RXD1             GPIO_ENET_RXD1_2   /* P4.12 */
#define GPIO_ENET_TXD0             GPIO_ENET_TXD0_3   /* P4.8 */
#define GPIO_ENET_TXD1             GPIO_ENET_TXD1_4   /* P0.17 */
#define GPIO_ENET_RX_DV            GPIO_ENET_RX_DV_2  /* P4.10 */
#define GPIO_ENET_TX_EN            GPIO_ENET_TX_EN_2  /* P4.13 */

#define GPIO_ENET_REF_CLK          GPIO_ENET_RX_CLK_2 /* P4.14 */

/****************************************************************************
 * 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
 ****************************************************************************/

#undef EXTERN
#if defined(__cplusplus)
}
#endif

#endif /* __ASSEMBLY__ */
#endif /* __BOARDS_ARM_LPC54XX_LPCXPRESSO_LPC54628_INCLUDE_BOARD_H */