256 lines
9.5 KiB
C
256 lines
9.5 KiB
C
/****************************************************************************
|
|
* boards/arm/samd2l2/samd21-xplained/src/samd21-xplained.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_SAMD2L2_SAMD21_XPLAINED_SRC_SAMD21_XPLAINED_H
|
|
#define __BOARDS_ARM_SAMD2L2_SAMD21_XPLAINED_SRC_SAMD21_XPLAINED_H
|
|
|
|
/****************************************************************************
|
|
* Included Files
|
|
****************************************************************************/
|
|
|
|
#include <nuttx/config.h>
|
|
#include <nuttx/compiler.h>
|
|
|
|
#include <stdint.h>
|
|
|
|
#include <arch/irq.h>
|
|
#include <nuttx/irq.h>
|
|
|
|
#include "sam_config.h"
|
|
#include "sam_pinmap.h"
|
|
|
|
/****************************************************************************
|
|
* Pre-processor Definitions
|
|
****************************************************************************/
|
|
|
|
/* LEDs:
|
|
* There are three LEDs on board the SAMD21 Xplained Pro board: The EDBG
|
|
* controls two of the LEDs, a power LED and a status LED. There is only
|
|
* one user controllable LED, a yellow LED labelled STATIS near the SAMD21
|
|
* USB connector.
|
|
*
|
|
* This LED is controlled by PB30 and the LED can be activated by driving
|
|
* PB30 to GND.
|
|
*
|
|
* When CONFIG_ARCH_LEDS is defined in the NuttX configuration, NuttX will
|
|
* control the LED as follows:
|
|
*
|
|
* SYMBOL Meaning LED
|
|
* ------------------- ----------------------- ------
|
|
* LED_STARTED NuttX has been started OFF
|
|
* LED_HEAPALLOCATE Heap has been allocated OFF
|
|
* LED_IRQSENABLED Interrupts enabled OFF
|
|
* LED_STACKCREATED Idle stack created ON
|
|
* LED_INIRQ In an interrupt N/C
|
|
* LED_SIGNAL In a signal handler N/C
|
|
* LED_ASSERTION An assertion failed N/C
|
|
* LED_PANIC The system has crashed FLASH
|
|
*
|
|
* Thus if the LED is statically on, NuttX has successfully booted and is,
|
|
* apparently, running normally. If the LED is flashing at approximately
|
|
* 2Hz, then a fatal error has been detected and the system has halted.
|
|
*/
|
|
|
|
#define PORT_STATUS_LED (PORT_OUTPUT | PORT_PULL_NONE | PORT_OUTPUT_SET | \
|
|
PORTB | PORT_PIN30)
|
|
|
|
/* Mechanical buttons:
|
|
*
|
|
* The SAMD21 Xplained Pro contains two mechanical buttons. One button is the
|
|
* RESET button connected to the SAMD21 reset line and the other is a generic
|
|
* user configurable button.
|
|
* When a button is pressed it will drive the I/O line to GND.
|
|
*
|
|
* PA15 SW0
|
|
*/
|
|
|
|
#define PORT_SW0 (PORT_INTERRUPT | PORT_PULL_UP | PORTA | PORT_PIN15)
|
|
#define IRQ_SW0 SAM_IRQ_PA15
|
|
|
|
/* I/O1
|
|
*
|
|
* Support for the microSD card slot on the I/O1 module. The I/O1 requires
|
|
* SPI support and two PORTs. These the PORTs will vary if the I/O1
|
|
* is installed on the EXT1 or EXT2 connector:
|
|
*
|
|
* --- ------------------ ---------------------- --------------------------
|
|
* PIN EXT1 EXT2 Description
|
|
* --- ------------------ ---------------------- --------------------------
|
|
* 15 PA05 SERCOM0 PAD[1] 15 PA17 SERCOM1 PAD[1] Active low chip select
|
|
* SPI SS SPI SS OUTPUT, pulled high on
|
|
* board.
|
|
* --- ------------------ ---------------------- --------------------------
|
|
* 10 PB05 PORT 10 PB15 PORT Active low card detect
|
|
* INPUT, must use internal
|
|
* pull-up.
|
|
* --- ------------------ ---------------------- --------------------------
|
|
*/
|
|
|
|
#ifdef CONFIG_SAMD21_XPLAINED_IOMODULE
|
|
|
|
# ifndef SAMD2L2_HAVE_SPI0
|
|
# error SAMD2L2_HAVE_SPI0 is required to use the I/O1 module
|
|
# endif
|
|
|
|
# if defined(CONFIG_SAMD21_XPLAINED_IOMODULE_EXT1)
|
|
|
|
# if defined(CONFIG_SAMD21_XPLAINED_OLED1MODULE) && \
|
|
defined(CONFIG_SAMD21_XPLAINED_OLED1MODULE_EXT1)
|
|
# error I/O1 and OLED1 modules cannot both reside in EXT1
|
|
# endif
|
|
|
|
# define PORT_SD_CD (PORT_INTERRUPT | PORT_INT_CHANGE | PORT_PULL_UP | \
|
|
PORTB | PORT_PIN5)
|
|
|
|
# define PORT_SD_CS (PORT_OUTPUT | PORT_PULL_NONE | PORT_OUTPUT_SET | \
|
|
PORTA | PORT_PIN5)
|
|
|
|
# elif defined(CONFIG_SAMD21_XPLAINED_IOMODULE_EXT2)
|
|
|
|
# if defined(CONFIG_SAMD21_XPLAINED_OLED1MODULE) && \
|
|
defined(CONFIG_SAMD21_XPLAINED_OLED1MODULE_EXT2)
|
|
# error I/O1 and OLED1 modules cannot both reside in EXT2
|
|
# endif
|
|
|
|
# define PORT_SD_CD (PORT_INTERRUPT | PORT_INT_CHANGE | PORT_PULL_UP | \
|
|
PORTB | PORT_PIN15)
|
|
|
|
# define PORT_SD_CS (PORT_OUTPUT | PORT_PULL_NONE | PORT_OUTPUT_SET | \
|
|
PORTA | PORT_PIN17)
|
|
|
|
# else
|
|
# error Which connector is the I/O1 module installed in?
|
|
# endif
|
|
#endif
|
|
|
|
/* OLED1
|
|
*
|
|
* Support for the microSD card slot on the I/O1 module.
|
|
* The I/O1 requires SPI support and three output PORTs.
|
|
* These the PORTs will vary if the OLED1 is installed on the EXT1
|
|
* or EXT2 connector:
|
|
*
|
|
*
|
|
* PIN EXT1 EXT2 Description
|
|
* --- ------------------- -------------------- ---------------------------
|
|
* 5 PB06 PORT PA20 PORT DATA_CMD_SEL
|
|
* 10 PB05 PORT PB15 PORT DISPLAY_RESET. Active low.
|
|
* 15 PA05 SERCOM0 PAD[1] PA17 SERCOM1 PAD[1] DISPLAY_SS. Active low.
|
|
* SPI SS SPI SS
|
|
*/
|
|
|
|
#ifdef CONFIG_SAMD21_XPLAINED_OLED1MODULE
|
|
|
|
# ifndef SAMD2L2_HAVE_SPI0
|
|
# error SAMD2L2_HAVE_SPI0 is required to use the OLED1 module
|
|
# endif
|
|
|
|
# ifndef CONFIG_SPI_CMDDATA
|
|
# error CONFIG_SPI_CMDDATA is required to use the OLED1 module
|
|
# endif
|
|
|
|
# ifndef CONFIG_LCD_SSD1306
|
|
# error CONFIG_LCD_SSD1306 is required to use the OLED1 module
|
|
# endif
|
|
|
|
# ifndef CONFIG_LCD_UG2832HSWEG04
|
|
# error CONFIG_LCD_UG2832HSWEG04 is required to use the OLED1 module
|
|
# endif
|
|
|
|
# if defined(CONFIG_SAMD21_XPLAINED_OLED1MODULE_EXT1)
|
|
|
|
# if defined(CONFIG_SAMD21_XPLAINED_IOMODULE) && \
|
|
defined(CONFIG_SAMD21_XPLAINED_IOMODULE_EXT1)
|
|
# error OLED1 and I/O1 modules cannot both reside in EXT1
|
|
# endif
|
|
|
|
# define PORT_OLED_DATA (PORT_OUTPUT | PORT_PULL_NONE | PORT_OUTPUT_CLEAR | \
|
|
PORTB | PORT_PIN6)
|
|
# define PORT_OLED_RST (PORT_OUTPUT | PORT_PULL_NONE | PORT_OUTPUT_CLEAR | \
|
|
PORTB | PORT_PIN5)
|
|
# define PORT_OLED_CS (PORT_OUTPUT | PORT_PULL_NONE | PORT_OUTPUT_SET | \
|
|
PORTA | PORT_PIN5)
|
|
|
|
# elif defined(CONFIG_SAMD21_XPLAINED_OLED1MODULE_EXT2)
|
|
|
|
# if defined(CONFIG_SAMD21_XPLAINED_IOMODULE) && \
|
|
defined(CONFIG_SAMD21_XPLAINED_IOMODULE_EXT2)
|
|
# error OLED1 and I/O1 modules cannot both reside in EXT2
|
|
# endif
|
|
|
|
# define PORT_OLED_DATA (PORT_OUTPUT | PORT_PULL_NONE | PORT_OUTPUT_CLEAR | \
|
|
PORTA | PORT_PIN20)
|
|
# define PORT_OLED_RST (PORT_OUTPUT | PORT_PULL_NONE | PORT_OUTPUT_CLEAR | \
|
|
PORTB | PORT_PIN15)
|
|
# define PORT_OLED_CS (PORT_OUTPUT | PORT_PULL_NONE | PORT_OUTPUT_SET | \
|
|
PORTA | PORT_PIN17)
|
|
|
|
# else
|
|
# error Which connector is the OLED1 module installed in?
|
|
# endif
|
|
#endif
|
|
|
|
#if defined(CONFIG_LCD_UG2864AMBAG01) || defined(CONFIG_LCD_UG2864HSWEG01)
|
|
# define PORT_SD_CS (PORT_OUTPUT | PORT_PULL_NONE | PORT_OUTPUT_SET | \
|
|
PORTB | PORT_PIN11) /* REVISIT */
|
|
#endif
|
|
|
|
/****************************************************************************
|
|
* Public Types
|
|
****************************************************************************/
|
|
|
|
/****************************************************************************
|
|
* Public Data
|
|
****************************************************************************/
|
|
|
|
#ifndef __ASSEMBLY__
|
|
|
|
/****************************************************************************
|
|
* Public Functions Definitions
|
|
****************************************************************************/
|
|
|
|
/****************************************************************************
|
|
* Name: sam_spidev_initialize
|
|
*
|
|
* Description:
|
|
* Called to configure SPI chip select PORT pins for the SAM3U-EK board.
|
|
*
|
|
****************************************************************************/
|
|
|
|
void weak_function sam_spidev_initialize(void);
|
|
|
|
/****************************************************************************
|
|
* Name: sam_sdinitialize
|
|
*
|
|
* Description:
|
|
* Initialize the SPI-based SD card.
|
|
* Requires CONFIG_SAMD21_XPLAINED_IOMODULE=y,
|
|
* CONFIG_DISABLE_MOUNTPOINT=n,
|
|
* CONFIG_MMCSD=y, and the appropriate SERCOM SPI port enabled.
|
|
*
|
|
****************************************************************************/
|
|
|
|
#ifdef CONFIG_SAMD21_XPLAINED_IOMODULE
|
|
int sam_sdinitialize(int port, int minor);
|
|
#endif
|
|
|
|
#endif /* __ASSEMBLY__ */
|
|
#endif /* __BOARDS_ARM_SAMD2L2_SAMD21_XPLAINED_SRC_SAMD21_XPLAINED_H */
|