2015-05-18 21:16:32 +02:00
|
|
|
|
README
|
2015-05-19 22:32:09 +02:00
|
|
|
|
======
|
2015-05-18 21:16:32 +02:00
|
|
|
|
|
|
|
|
|
This README discusses issues unique to NuttX configurations for the
|
|
|
|
|
Atmel SAML21 Xplained Pro development board. This board features the
|
|
|
|
|
ATSAML21J18A MCU.
|
|
|
|
|
|
|
|
|
|
Contents
|
2015-05-19 22:32:09 +02:00
|
|
|
|
========
|
2015-05-18 21:16:32 +02:00
|
|
|
|
|
2015-05-25 18:23:11 +02:00
|
|
|
|
- STATUS/ISSUES
|
2015-05-18 21:16:32 +02:00
|
|
|
|
- Modules
|
|
|
|
|
- Development Environment
|
|
|
|
|
- GNU Toolchain Options
|
|
|
|
|
- IDEs
|
|
|
|
|
- NuttX EABI "buildroot" Toolchain
|
2015-05-19 22:32:09 +02:00
|
|
|
|
- LEDs and Buttons
|
2015-05-18 21:16:32 +02:00
|
|
|
|
- Serial Consoles
|
|
|
|
|
- Atmel Studio 6.1
|
2015-05-25 18:13:06 +02:00
|
|
|
|
- JTAG
|
2015-05-18 21:16:32 +02:00
|
|
|
|
- SAML21 Xplained Pro-specific Configuration Options
|
|
|
|
|
- Configurations
|
|
|
|
|
|
2015-05-25 18:23:11 +02:00
|
|
|
|
STATUS/ISSUES
|
|
|
|
|
=============
|
|
|
|
|
|
|
|
|
|
- Since this port is a leverage of the SAMD20 Xplained port, some of the
|
|
|
|
|
STATUS/ISSUES in the SAMD20 Xplained README.txt may apply here as well.
|
|
|
|
|
|
2015-06-09 15:03:25 +02:00
|
|
|
|
- 2015-5-26: The basic port is running at 48MHz (using 32.768 XTAL input
|
|
|
|
|
and the digital frequency locked loop). The basic NuttShell (NSH)
|
|
|
|
|
configuration is working well with the serial console provided by
|
|
|
|
|
SERCOM4 as 115200 8N1.
|
2015-05-25 18:23:11 +02:00
|
|
|
|
|
2015-06-15 19:37:16 +02:00
|
|
|
|
- 2015-6-14: Added a DMAC driver. There is no way to verify it at present
|
|
|
|
|
and, hence, depends upon CONFIG_EXPERIMENTAL=y
|
2015-06-14 22:27:58 +02:00
|
|
|
|
|
2015-05-18 21:16:32 +02:00
|
|
|
|
Modules
|
2015-05-19 22:32:09 +02:00
|
|
|
|
=======
|
|
|
|
|
|
2015-05-22 19:28:02 +02:00
|
|
|
|
There are several I/O modules available that will work with the SAML21
|
|
|
|
|
Xplained Pro Starter Kit:
|
|
|
|
|
|
|
|
|
|
1) I/O1 - An MMC/SD card slot, PWM LED control, ADC light sensor, USART
|
|
|
|
|
loopback, TWI AT30TSE758 Temperature sensor.
|
|
|
|
|
2) OLED1 - An OLED plus 3 additional switches and 3 additional LEDs
|
|
|
|
|
3) PROTO1 - A prototyping board with logic on board (other than power-
|
|
|
|
|
related logic).
|
2015-06-21 15:48:46 +02:00
|
|
|
|
4) And others. See http://www.atmel.com/products/microcontrollers/avr/xplained.aspx
|
2015-05-22 19:28:02 +02:00
|
|
|
|
|
2015-06-09 15:03:25 +02:00
|
|
|
|
Some of these are discussed further below.
|
2015-05-18 21:16:32 +02:00
|
|
|
|
|
|
|
|
|
I/O1
|
|
|
|
|
----
|
|
|
|
|
The primary function of this module is to provide SD card support, but
|
|
|
|
|
the full list of modules features include:
|
|
|
|
|
|
|
|
|
|
- microSD card connector (SPI interface)
|
|
|
|
|
- PWM (LED control)
|
|
|
|
|
- ADC (light sensor)
|
|
|
|
|
- USART loopback
|
|
|
|
|
- TWI AT30TSE758 Temperature sensor with EEPROM
|
|
|
|
|
|
|
|
|
|
SPI is available on two of the SAML21 Xplained connectors, EXT1 and EXT2.
|
|
|
|
|
They mate with the I/O1 connector as indicated in this table.
|
|
|
|
|
|
|
|
|
|
I/O1 CONNECTOR
|
|
|
|
|
----------------- ---------------------- ---------------------- ------------------------------------
|
|
|
|
|
I/O1 EXT1 EXT2 Other use of either pin
|
|
|
|
|
----------------- ---------------------- ---------------------- ------------------------------------
|
|
|
|
|
1 ID 1 1 Communication line to ID chip on
|
|
|
|
|
extension board.
|
|
|
|
|
----------------- ---------------------- ---------------------- ------------------------------------
|
|
|
|
|
2 GND 2 GND 2 GND
|
|
|
|
|
----------------- ---------------------- ---------------------- ------------------------------------
|
2020-02-23 09:50:23 +01:00
|
|
|
|
3 LIGHT_SENSOR 3 PB05 AIN[13] 3 PA10 AIN[18]
|
2015-05-18 21:16:32 +02:00
|
|
|
|
----------------- ---------------------- ---------------------- ------------------------------------
|
2015-05-19 22:32:09 +02:00
|
|
|
|
4 LP_OUT 4 PA03 AIN[1] 4 PA11 AIN[19]
|
2015-05-18 21:16:32 +02:00
|
|
|
|
----------------- ---------------------- ---------------------- ------------------------------------
|
|
|
|
|
5 GPIO1 5 PB06 GPIO 5 PA20 GPIO
|
|
|
|
|
----------------- ---------------------- ---------------------- ------------------------------------
|
|
|
|
|
6 GPIO2 6 PB07 GPIO 6 PA21 GPIO
|
|
|
|
|
----------------- ---------------------- ---------------------- ------------------------------------
|
2015-05-19 22:32:09 +02:00
|
|
|
|
7 LED 7 PA12 TCC2/WO[0] 7 PB12 TC4/WO[0]
|
2015-05-18 21:16:32 +02:00
|
|
|
|
----------------- ---------------------- ---------------------- ------------------------------------
|
2015-05-19 22:32:09 +02:00
|
|
|
|
8 LP_IN 8 PA13 TCC2/WO[1] 8 PB13 TC4/WO[1]
|
2015-05-18 21:16:32 +02:00
|
|
|
|
----------------- ---------------------- ---------------------- ------------------------------------
|
|
|
|
|
9 TEMP_ALERT 9 PB04 EXTINT[4] 9 PB14 EXTINT[14]
|
|
|
|
|
----------------- ---------------------- ---------------------- ------------------------------------
|
2015-05-19 22:32:09 +02:00
|
|
|
|
10 microSD_DETECT 10 PA02 GPIO 10 PB15 GPIO
|
2015-05-18 21:16:32 +02:00
|
|
|
|
----------------- ---------------------- ---------------------- ------------------------------------
|
|
|
|
|
11 TWI SDA 11 PA08 SERCOM2 PAD[0] 11 PA08 SERCOM2 PAD[0] EXT1, EXT2, EXT3 and EDBG
|
|
|
|
|
I<>C SDA I<>C SDA
|
|
|
|
|
----------------- ---------------------- ---------------------- ------------------------------------
|
|
|
|
|
12 TWI SCL 12 PA09 SERCOM2 PAD[1] 12 PA09 SERCOM2 PAD[1] EXT2, EXT3 and EDBG
|
|
|
|
|
I<>C SCL I<>C SCL
|
|
|
|
|
----------------- ---------------------- ---------------------- ------------------------------------
|
2015-05-19 22:32:09 +02:00
|
|
|
|
13 USART RX 13 PB09 SERCOM4 PAD[1] 13 PA19 SERCOM1 PAD[3] The SERCOM4 module is shared between
|
2015-05-18 21:16:32 +02:00
|
|
|
|
USART RX USART RX EXT1, 2 and 3 USART's, but uses
|
|
|
|
|
different pins
|
|
|
|
|
----------------- ---------------------- ---------------------- ------------------------------------
|
2015-05-19 22:32:09 +02:00
|
|
|
|
14 USART TX 14 PB08 SERCOM4 PAD[0] 14 PA18 SERCOM1 PAD[2] The SERCOM4 module is shared between
|
2015-05-18 21:16:32 +02:00
|
|
|
|
USART TX USART TX EXT1, 2 and 3 USART's, but uses
|
|
|
|
|
different pins
|
|
|
|
|
----------------- ---------------------- ---------------------- ------------------------------------
|
2015-05-19 22:32:09 +02:00
|
|
|
|
15 microSD_SS 15 PA05 SERCOM0 PAD[1] 15 PA17 GPIO
|
|
|
|
|
SPI SS
|
2015-05-18 21:16:32 +02:00
|
|
|
|
----------------- ---------------------- ---------------------- ------------------------------------
|
2015-05-19 22:32:09 +02:00
|
|
|
|
16 SPI_MOSI 16 PA06 SERCOM0 PAD[2] 16 PB22 SERCOM5 PAD[2]
|
2015-05-18 21:16:32 +02:00
|
|
|
|
SPI MOSI SPI MOSI
|
|
|
|
|
----------------- ---------------------- ---------------------- ------------------------------------
|
2015-05-19 22:32:09 +02:00
|
|
|
|
17 SPI_MISO 17 PA04 SERCOM0 PAD[0] 17 PB16 SERCOM5 PAD[0]
|
2015-05-18 21:16:32 +02:00
|
|
|
|
SPI MISO SPI MISO
|
|
|
|
|
----------------- ---------------------- ---------------------- ------------------------------------
|
2015-05-19 22:32:09 +02:00
|
|
|
|
18 SPI_SCK 18 PA07 SERCOM0 PAD[3] 18 PB23 SERCOM5 PAD[3]
|
2015-05-18 21:16:32 +02:00
|
|
|
|
SPI SCK SPI SCK
|
|
|
|
|
----------------- ---------------------- ---------------------- ------------------------------------
|
|
|
|
|
19 GND 19 GND GND
|
|
|
|
|
----------------- ---------------------- ---------------------- ------------------------------------
|
|
|
|
|
20 VCC 20 VCC VCC
|
|
|
|
|
----------------- ---------------------- ---------------------- ------------------------------------
|
|
|
|
|
|
|
|
|
|
The mapping between the I/O1 pins and the SD connector are shown in the
|
|
|
|
|
following table.
|
|
|
|
|
|
|
|
|
|
SD Card Connection
|
|
|
|
|
------------------
|
|
|
|
|
I/O1 SD PIN Description
|
|
|
|
|
---- ---- --- -------------------------------------------------
|
|
|
|
|
D2 1 Data line 2 (not used)
|
|
|
|
|
15 D3 2 Data line 3. Active low chip select, pulled high
|
|
|
|
|
16 CMD 3 Command line, connected to SPI_MOSI.
|
|
|
|
|
20 VDD 4
|
|
|
|
|
18 CLK 5 Clock line, connected to SPI_SCK.
|
|
|
|
|
2/19 GND 6
|
|
|
|
|
17 D0 7 Data line 0, connected to SPI_MISO.
|
|
|
|
|
D1 8 Data line 1 (not used)
|
|
|
|
|
10 SW_A 9 Card detect
|
|
|
|
|
2/19 SW_B 10 GND
|
|
|
|
|
|
|
|
|
|
Card Detect
|
|
|
|
|
-----------
|
|
|
|
|
When a microSD card is put into the connector SW_A and SW_B are short-
|
|
|
|
|
circuited. SW_A is connected to the microSD_DETECT signal. To use this
|
|
|
|
|
as a card indicator remember to enable internal pullup in the target
|
|
|
|
|
device.
|
|
|
|
|
|
|
|
|
|
GPIOs
|
|
|
|
|
-----
|
|
|
|
|
So all that is required to connect the SD is configure the SPI
|
|
|
|
|
|
|
|
|
|
--- ------------------ ---------------------- -------------------------------------
|
|
|
|
|
PIN EXT1 EXT2 Description
|
|
|
|
|
--- ------------------ ---------------------- -------------------------------------
|
2015-05-19 22:32:09 +02:00
|
|
|
|
15 PA05 SERCOM0 PAD[1] 15 PA17 GPIO Active low chip select OUTPUT, pulled
|
|
|
|
|
SPI SS high on board.
|
2015-05-18 21:16:32 +02:00
|
|
|
|
--- ------------------ ---------------------- -------------------------------------
|
2015-05-19 22:32:09 +02:00
|
|
|
|
10 PA02 GPIO 10 PB15 GPIO Active low card detect INPUT, must
|
2015-05-18 21:16:32 +02:00
|
|
|
|
use internal pull-up.
|
|
|
|
|
--- ------------------ ---------------------- -------------------------------------
|
|
|
|
|
|
|
|
|
|
Configuration Options:
|
|
|
|
|
----------------------
|
|
|
|
|
CONFIG_SAML21_XPLAINED_IOMODULE=y : Informs the system that the
|
|
|
|
|
I/O1 module is installed
|
|
|
|
|
CONFIG_SAML21_XPLAINED_IOMODULE_EXT1=y : The module is installed in EXT1
|
|
|
|
|
CONFIG_SAML21_XPLAINED_IOMODULE_EXT2=y : The mdoule is installed in EXT2
|
|
|
|
|
|
|
|
|
|
See the set-up in the discussion of the nsh configuration below for other
|
|
|
|
|
required configuration options.
|
|
|
|
|
|
|
|
|
|
NOTE: As of this writing, only the SD card slot is supported in the I/O1
|
|
|
|
|
module.
|
|
|
|
|
|
|
|
|
|
OLED1
|
|
|
|
|
-----
|
|
|
|
|
This module provides an OLED plus 3 additional switches and 3 additional
|
|
|
|
|
LEDs.
|
|
|
|
|
|
|
|
|
|
OLED1 CONNECTOR
|
|
|
|
|
----------------- ---------------------- ---------------------- ------------------------------------
|
|
|
|
|
OLED1 EXT1 EXT2 Other use of either pin
|
|
|
|
|
----------------- ---------------------- ---------------------- ------------------------------------
|
|
|
|
|
1 ID 1 1 Communication line to ID chip on
|
|
|
|
|
extension board.
|
|
|
|
|
----------------- ---------------------- ---------------------- ------------------------------------
|
|
|
|
|
2 GND 2 GND 2 GND
|
|
|
|
|
----------------- ---------------------- ---------------------- ------------------------------------
|
2015-05-19 22:32:09 +02:00
|
|
|
|
3 BUTTON2 3 PB05 AIN[13] 3 PA10 AIN[18]
|
2015-05-18 21:16:32 +02:00
|
|
|
|
----------------- ---------------------- ---------------------- ------------------------------------
|
2015-05-19 22:32:09 +02:00
|
|
|
|
4 BUTTON3 4 PA03 AIN[1] 4 PA11 AIN[19]
|
2015-05-18 21:16:32 +02:00
|
|
|
|
----------------- ---------------------- ---------------------- ------------------------------------
|
|
|
|
|
5 DATA_CMD_SEL 5 PB06 GPIO 5 PA20 GPIO
|
|
|
|
|
----------------- ---------------------- ---------------------- ------------------------------------
|
|
|
|
|
6 LED3 6 PB07 GPIO 6 PA21 GPIO
|
|
|
|
|
----------------- ---------------------- ---------------------- ------------------------------------
|
2015-05-19 22:32:09 +02:00
|
|
|
|
7 LED1 7 PA12 TCC2/WO[0] 7 PB12 TC4/WO[0]
|
2015-05-18 21:16:32 +02:00
|
|
|
|
----------------- ---------------------- ---------------------- ------------------------------------
|
2015-05-19 22:32:09 +02:00
|
|
|
|
8 LED2 8 PA13 TCC2/WO[1] 8 PB13 TC4/WO[1]
|
2015-05-18 21:16:32 +02:00
|
|
|
|
----------------- ---------------------- ---------------------- ------------------------------------
|
|
|
|
|
9 BUTTON1 9 PB04 EXTINT[4] 9 PB14 EXTINT[14]
|
|
|
|
|
----------------- ---------------------- ---------------------- ------------------------------------
|
2015-05-19 22:32:09 +02:00
|
|
|
|
10 DISPLAY_RESET 10 PA02 GPIO 10 PB15 GPIO
|
2015-05-18 21:16:32 +02:00
|
|
|
|
----------------- ---------------------- ---------------------- ------------------------------------
|
|
|
|
|
11 N/C 11 PA08 SERCOM2 PAD[0] 11 PA08 SERCOM2 PAD[0] EXT1, EXT2, EXT3 and EDBG
|
|
|
|
|
I<>C SDA I<>C SDA
|
|
|
|
|
----------------- ---------------------- ---------------------- ------------------------------------
|
|
|
|
|
12 N/C 12 PA09 SERCOM2 PAD[1] 12 PA09 SERCOM2 PAD[1] EXT2, EXT3 and EDBG
|
|
|
|
|
I<>C SCL I<>C SCL
|
|
|
|
|
----------------- ---------------------- ---------------------- ------------------------------------
|
2015-05-19 22:32:09 +02:00
|
|
|
|
13 N/C 13 PB09 SERCOM4 PAD[1] 13 PA19 SERCOM1 PAD[3] The SERCOM4 module is shared between
|
2015-05-18 21:16:32 +02:00
|
|
|
|
USART RX USART RX EXT1, 2 and 3 USART's, but uses
|
|
|
|
|
different pins
|
|
|
|
|
----------------- ---------------------- ---------------------- ------------------------------------
|
2015-05-19 22:32:09 +02:00
|
|
|
|
14 N/C 14 PB08 SERCOM4 PAD[0] 14 PA18 SERCOM1 PAD[2] The SERCOM4 module is shared between
|
2015-05-18 21:16:32 +02:00
|
|
|
|
USART TX USART TX EXT1, 2 and 3 USART's, but uses
|
|
|
|
|
different pins
|
|
|
|
|
----------------- ---------------------- ---------------------- ------------------------------------
|
2015-05-19 22:32:09 +02:00
|
|
|
|
15 DISPLAY_SS 15 PA05 SERCOM0 PAD[1] 15 PA17 GPIO
|
|
|
|
|
SPI SS
|
2015-05-18 21:16:32 +02:00
|
|
|
|
----------------- ---------------------- ---------------------- ------------------------------------
|
2015-05-19 22:32:09 +02:00
|
|
|
|
16 SPI_MOSI 16 PA06 SERCOM0 PAD[2] 16 PB22 SERCOM5 PAD[2]
|
2015-05-18 21:16:32 +02:00
|
|
|
|
SPI MOSI SPI MOSI
|
|
|
|
|
----------------- ---------------------- ---------------------- ------------------------------------
|
2015-05-19 22:32:09 +02:00
|
|
|
|
17 N/C 17 PA04 SERCOM0 PAD[0] 17 PB16 SERCOM5 PAD[0]
|
2015-05-18 21:16:32 +02:00
|
|
|
|
SPI MISO SPI MISO
|
|
|
|
|
----------------- ---------------------- ---------------------- ------------------------------------
|
2015-05-19 22:32:09 +02:00
|
|
|
|
18 SPI_SCK 18 PA07 SERCOM0 PAD[3] 18 PB23 SERCOM5 PAD[3]
|
2015-05-18 21:16:32 +02:00
|
|
|
|
SPI SCK SPI SCK
|
|
|
|
|
----------------- ---------------------- ---------------------- ------------------------------------
|
|
|
|
|
19 GND 19 GND GND
|
|
|
|
|
----------------- ---------------------- ---------------------- ------------------------------------
|
|
|
|
|
20 VCC 20 VCC VCC
|
|
|
|
|
----------------- ---------------------- ---------------------- ------------------------------------
|
|
|
|
|
|
|
|
|
|
Configuration Options:
|
|
|
|
|
----------------------
|
|
|
|
|
CONFIG_SAML21_XPLAINED_OLED1MODULE=y : Informs the system that the
|
|
|
|
|
I/O1 module is installed
|
|
|
|
|
CONFIG_SAML21_XPLAINED_OLED1MODULE_EXT1=y : The module is installed in EXT1
|
|
|
|
|
CONFIG_SAML21_XPLAINED_OLED1MODULE_EXT2=y : The mdoule is installed in EXT2
|
|
|
|
|
|
|
|
|
|
See the set-up in the discussion of the nsh configuration below for other
|
|
|
|
|
required configuration options.
|
|
|
|
|
|
|
|
|
|
PROTO1
|
|
|
|
|
------
|
|
|
|
|
A prototyping board with logic on board (other than power-related logic).
|
|
|
|
|
There is no built-in support for the PROTO1 module.
|
|
|
|
|
|
|
|
|
|
Development Environment
|
2015-05-19 22:32:09 +02:00
|
|
|
|
=======================
|
2015-05-18 21:16:32 +02:00
|
|
|
|
|
|
|
|
|
Either Linux or Cygwin on Windows can be used for the development environment.
|
|
|
|
|
The source has been built only using the GNU toolchain (see below). Other
|
|
|
|
|
toolchains will likely cause problems. Testing was performed using the Cygwin
|
|
|
|
|
environment.
|
|
|
|
|
|
|
|
|
|
GNU Toolchain Options
|
2015-05-19 22:32:09 +02:00
|
|
|
|
=====================
|
2015-05-18 21:16:32 +02:00
|
|
|
|
|
|
|
|
|
The NuttX make system can be configured to support the various different
|
|
|
|
|
toolchain options. All testing has been conducted using the NuttX buildroot
|
|
|
|
|
toolchain. To use alternative toolchain, you simply need to add change of
|
|
|
|
|
the following configuration options to your .config (or defconfig) file:
|
|
|
|
|
|
2020-05-13 16:18:31 +02:00
|
|
|
|
CONFIG_ARMV7M_TOOLCHAIN_BUILDROOT=y : NuttX buildroot under Linux or Cygwin (default)
|
|
|
|
|
CONFIG_ARMV7M_TOOLCHAIN_GNU_EABIL=y : Generic GCC ARM EABI toolchain for Linux
|
|
|
|
|
CONFIG_ARMV7M_TOOLCHAIN_GNU_EABIW=y : Generic GCC ARM EABI toolchain for Windows
|
2015-05-18 21:16:32 +02:00
|
|
|
|
|
|
|
|
|
NOTE about Windows native toolchains
|
|
|
|
|
------------------------------------
|
|
|
|
|
|
|
|
|
|
There are basically three kinds of GCC toolchains that can be used:
|
|
|
|
|
|
|
|
|
|
1. A Linux native toolchain in a Linux environment,
|
|
|
|
|
2. The buildroot Cygwin tool chain built in the Cygwin environment,
|
|
|
|
|
3. A Windows native toolchain.
|
|
|
|
|
|
|
|
|
|
There are several limitations to using a Windows based toolchain (#3) in a
|
|
|
|
|
Cygwin environment. The three biggest are:
|
|
|
|
|
|
|
|
|
|
1. The Windows toolchain cannot follow Cygwin paths. Path conversions are
|
|
|
|
|
performed automatically in the Cygwin makefiles using the 'cygpath'
|
|
|
|
|
utility but you might easily find some new path problems. If so, check
|
|
|
|
|
out 'cygpath -w'
|
|
|
|
|
|
|
|
|
|
2. Windows toolchains cannot follow Cygwin symbolic links. Many symbolic
|
2020-10-19 06:09:06 +02:00
|
|
|
|
links are used in NuttX (e.g., include/arch). The make system works
|
2015-05-18 21:16:32 +02:00
|
|
|
|
around these problems for the Windows tools by copying directories
|
|
|
|
|
instead of linking them. But this can also cause some confusion for
|
|
|
|
|
you: For example, you may edit a file in a "linked" directory and find
|
|
|
|
|
that your changes had no effect. That is because you are building the
|
|
|
|
|
copy of the file in the "fake" symbolic directory. If you use a
|
|
|
|
|
Windows toolchain, you should get in the habit of making like this:
|
|
|
|
|
|
|
|
|
|
make clean_context all
|
|
|
|
|
|
|
|
|
|
An alias in your .bashrc file might make that less painful.
|
|
|
|
|
|
|
|
|
|
IDEs
|
2015-05-19 22:32:09 +02:00
|
|
|
|
====
|
2015-05-18 21:16:32 +02:00
|
|
|
|
|
|
|
|
|
NuttX is built using command-line make. It can be used with an IDE, but some
|
|
|
|
|
effort will be required to create the project.
|
|
|
|
|
|
|
|
|
|
Makefile Build
|
|
|
|
|
--------------
|
|
|
|
|
Under Eclipse, it is pretty easy to set up an "empty makefile project" and
|
|
|
|
|
simply use the NuttX makefile to build the system. That is almost for free
|
|
|
|
|
under Linux. Under Windows, you will need to set up the "Cygwin GCC" empty
|
|
|
|
|
makefile project in order to work with Windows (Google for "Eclipse Cygwin" -
|
|
|
|
|
there is a lot of help on the internet).
|
|
|
|
|
|
|
|
|
|
Native Build
|
|
|
|
|
------------
|
|
|
|
|
Here are a few tips before you start that effort:
|
|
|
|
|
|
|
|
|
|
1) Select the toolchain that you will be using in your .config file
|
|
|
|
|
2) Start the NuttX build at least one time from the Cygwin command line
|
|
|
|
|
before trying to create your project. This is necessary to create
|
|
|
|
|
certain auto-generated files and directories that will be needed.
|
2020-02-22 19:31:14 +01:00
|
|
|
|
3) Set up include paths: You will need include/, arch/arm/src/sam34,
|
2015-05-18 21:16:32 +02:00
|
|
|
|
arch/arm/src/common, arch/arm/src/armv7-m, and sched/.
|
|
|
|
|
4) All assembly files need to have the definition option -D __ASSEMBLY__
|
|
|
|
|
on the command line.
|
|
|
|
|
|
|
|
|
|
Startup files will probably cause you some headaches. The NuttX startup file
|
|
|
|
|
is arch/arm/src/sam34/sam_vectors.S. You may need to build NuttX
|
|
|
|
|
one time from the Cygwin command line in order to obtain the pre-built
|
|
|
|
|
startup object needed by an IDE.
|
|
|
|
|
|
|
|
|
|
NuttX EABI "buildroot" Toolchain
|
2015-05-19 22:32:09 +02:00
|
|
|
|
================================
|
2015-05-18 21:16:32 +02:00
|
|
|
|
|
2017-04-26 18:12:13 +02:00
|
|
|
|
A GNU GCC-based toolchain is assumed. The PATH environment variable should
|
2015-05-18 21:16:32 +02:00
|
|
|
|
be modified to point to the correct path to the Cortex-M0 GCC toolchain (if
|
|
|
|
|
different from the default in your PATH variable).
|
|
|
|
|
|
|
|
|
|
If you have no Cortex-M0 toolchain, one can be downloaded from the NuttX
|
2015-06-28 17:14:52 +02:00
|
|
|
|
Bitbucket download site (https://bitbucket.org/nuttx/buildroot/downloads/).
|
2015-05-18 21:16:32 +02:00
|
|
|
|
This GNU toolchain builds and executes in the Linux or Cygwin environment.
|
|
|
|
|
|
2020-10-19 06:09:06 +02:00
|
|
|
|
1. You must have already configured NuttX in <some-dir>/nuttx.
|
2015-05-18 21:16:32 +02:00
|
|
|
|
|
2019-08-06 00:53:39 +02:00
|
|
|
|
tools/configure.sh saml21-xplained:<sub-dir>
|
2015-05-18 21:16:32 +02:00
|
|
|
|
|
|
|
|
|
2. Download the latest buildroot package into <some-dir>
|
|
|
|
|
|
|
|
|
|
3. unpack the buildroot tarball. The resulting directory may
|
|
|
|
|
have versioning information on it like buildroot-x.y.z. If so,
|
|
|
|
|
rename <some-dir>/buildroot-x.y.z to <some-dir>/buildroot.
|
|
|
|
|
|
|
|
|
|
4. cd <some-dir>/buildroot
|
|
|
|
|
|
2019-08-05 15:13:48 +02:00
|
|
|
|
5. cp boards/cortexm0-eabi-defconfig-4.6.3 .config
|
2015-05-18 21:16:32 +02:00
|
|
|
|
|
|
|
|
|
6. make oldconfig
|
|
|
|
|
|
|
|
|
|
7. make
|
|
|
|
|
|
2017-04-26 18:12:13 +02:00
|
|
|
|
8. Make sure that the PATH variable includes the path to the newly built
|
|
|
|
|
binaries.
|
2015-05-18 21:16:32 +02:00
|
|
|
|
|
2019-08-05 15:13:48 +02:00
|
|
|
|
See the file boards/README.txt in the buildroot source tree. That has more
|
2015-05-18 21:16:32 +02:00
|
|
|
|
details PLUS some special instructions that you will need to follow if you are
|
|
|
|
|
building a Cortex-M0 toolchain for Cygwin under Windows.
|
|
|
|
|
|
2015-05-19 22:32:09 +02:00
|
|
|
|
LEDs and Buttons
|
|
|
|
|
================
|
|
|
|
|
|
|
|
|
|
LED
|
|
|
|
|
---
|
|
|
|
|
There is one yellow LED available on the SAML21 Xplained Pro board that
|
2015-05-18 21:16:32 +02:00
|
|
|
|
can be turned on and off. The LED can be activated by driving the connected
|
2015-05-19 22:32:09 +02:00
|
|
|
|
PB10 I/O line to GND.
|
2015-05-18 21:16:32 +02:00
|
|
|
|
|
|
|
|
|
When CONFIG_ARCH_LEDS is defined in the NuttX configuration, NuttX will
|
|
|
|
|
control the LED as follows:
|
|
|
|
|
|
|
|
|
|
SYMBOL Meaning LED0
|
|
|
|
|
------------------- ----------------------- ------
|
|
|
|
|
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 is LED is statically on, NuttX has successfully booted and is,
|
|
|
|
|
apparently, running normally. If LED is flashing at approximately
|
|
|
|
|
2Hz, then a fatal error has been detected and the system has halted.
|
|
|
|
|
|
2015-05-19 22:32:09 +02:00
|
|
|
|
Button
|
|
|
|
|
------
|
|
|
|
|
SAM L21 Xplained Pro contains one mechanical button on PA02 that can be
|
|
|
|
|
controlled by software. When a button is pressed it will drive the I/O
|
|
|
|
|
line to GND. Note: There is no pull-up resistor connected to the generic
|
|
|
|
|
user button. Remember to enable the internal pull-up in the SAM L21 to
|
|
|
|
|
use the button.
|
|
|
|
|
|
|
|
|
|
QTouch Button
|
|
|
|
|
-------------
|
|
|
|
|
To be provided
|
|
|
|
|
|
2015-05-18 21:16:32 +02:00
|
|
|
|
Serial Consoles
|
2015-05-19 22:32:09 +02:00
|
|
|
|
===============
|
2015-05-18 21:16:32 +02:00
|
|
|
|
|
2015-05-19 22:32:09 +02:00
|
|
|
|
SERCOM0
|
|
|
|
|
-------
|
|
|
|
|
SERCOM0 is dedicated for use with SPI at the EXT1 connector
|
2015-05-18 21:16:32 +02:00
|
|
|
|
|
2015-05-19 22:32:09 +02:00
|
|
|
|
SERCOM1
|
|
|
|
|
-------
|
|
|
|
|
SERCOM1 is available as a USART on EXT2 and EXT3
|
2015-05-18 21:16:32 +02:00
|
|
|
|
|
|
|
|
|
PIN EXT1 EXT2 EXT3 GPIO Function
|
|
|
|
|
---- ---- ---- ---- ------------------
|
2015-05-19 22:32:09 +02:00
|
|
|
|
13 --- PA19 PA19 SERCOM1 / USART RX
|
|
|
|
|
14 --- PA18 PA18 SERCOM1 / USART TX
|
2015-05-18 21:16:32 +02:00
|
|
|
|
19 GND GND GND N/A
|
|
|
|
|
20 VCC VCC VCC N/A
|
|
|
|
|
|
2015-05-19 22:32:09 +02:00
|
|
|
|
SERCOM2
|
|
|
|
|
-------
|
|
|
|
|
SERCOM0 is dedicated for use with I2C at the EXT1, EXT2, and EXT3
|
|
|
|
|
connectors.
|
|
|
|
|
|
|
|
|
|
SERCOM3
|
|
|
|
|
-------
|
|
|
|
|
SERCOM3 is not available on any EXT connector but is dedicated for
|
|
|
|
|
use with Virtual COM (see below).
|
|
|
|
|
|
|
|
|
|
SERCOM4
|
|
|
|
|
-------
|
|
|
|
|
SERCOM1 is available as a USART on EXT1
|
|
|
|
|
|
|
|
|
|
PIN EXT1 EXT2 EXT3 GPIO Function
|
|
|
|
|
---- ---- ---- ---- ------------------
|
|
|
|
|
13 PB09 --- --- SERCOM4 / USART RX
|
|
|
|
|
14 PB08 --- --- SERCOM4 / USART TX
|
|
|
|
|
19 GND GND GND N/A
|
|
|
|
|
20 VCC VCC VCC N/A
|
|
|
|
|
|
|
|
|
|
SERCOM5
|
|
|
|
|
-------
|
|
|
|
|
|
|
|
|
|
SERCOM5 is dedicated for use with SPI at the EXT2 and EXT3 connectors
|
|
|
|
|
|
|
|
|
|
Configuration
|
|
|
|
|
-------------
|
2015-05-18 21:16:32 +02:00
|
|
|
|
There are options available in the NuttX configuration to select which
|
|
|
|
|
connector SERCOM4 is on: SAML21_XPLAINED_USART4_EXTn, where n=1, 2, or 3.
|
|
|
|
|
|
|
|
|
|
If you have a TTL to RS-232 converter then this is the most convenient
|
|
|
|
|
serial console to use (because you don't lose the console device each time
|
|
|
|
|
you lose the USB connection). It is the default in all of these
|
|
|
|
|
configurations. An option is to use the virtual COM port.
|
|
|
|
|
|
|
|
|
|
Virtual COM Port
|
|
|
|
|
----------------
|
|
|
|
|
|
|
|
|
|
The SAML21 Xplained Pro contains an Embedded Debugger (EDBG) that can be
|
|
|
|
|
used to program and debug the ATSAML21J18A using Serial Wire Debug (SWD).
|
|
|
|
|
The Embedded debugger also include a Virtual COM port interface over
|
|
|
|
|
SERCOM3. Virtual COM port connections:
|
|
|
|
|
|
2015-05-19 22:32:09 +02:00
|
|
|
|
PA22 SERCOM3 / USART TXD
|
|
|
|
|
PA23 SERCOM3 / USART RXD
|
2015-05-18 21:16:32 +02:00
|
|
|
|
|
|
|
|
|
Atmel Studio 6.1
|
2015-05-19 22:32:09 +02:00
|
|
|
|
================
|
|
|
|
|
|
2017-06-28 21:18:41 +02:00
|
|
|
|
NOTE: These instructions are old. The SAML21 requires Atmel Studio 6.2.
|
2015-05-19 22:32:09 +02:00
|
|
|
|
They may still prove useful to you, however.
|
2015-05-18 21:16:32 +02:00
|
|
|
|
|
|
|
|
|
Loading Code into FLASH:
|
|
|
|
|
-----------------------
|
2015-05-25 21:54:17 +02:00
|
|
|
|
|
2015-05-18 21:16:32 +02:00
|
|
|
|
Tools menus: Tools -> Device Programming.
|
|
|
|
|
|
|
|
|
|
Debugging the NuttX Object File
|
|
|
|
|
-------------------------------
|
2015-05-25 21:54:17 +02:00
|
|
|
|
|
2015-05-18 21:16:32 +02:00
|
|
|
|
1) Rename object file from nutt to nuttx.elf. That is an extension that
|
|
|
|
|
will be recognized by the file menu.
|
|
|
|
|
|
|
|
|
|
2) File menu: File -> Open -> Open object file for debugging
|
2015-05-25 21:54:17 +02:00
|
|
|
|
|
2015-05-18 21:16:32 +02:00
|
|
|
|
- Select nuttx.elf object file
|
|
|
|
|
- Select AT91SAML21J18
|
|
|
|
|
- Select files for symbols as desired
|
|
|
|
|
- Select debugger
|
|
|
|
|
|
|
|
|
|
3) Debug menu: Debug -> Start debugging and break
|
2015-05-25 21:54:17 +02:00
|
|
|
|
|
2015-05-18 21:16:32 +02:00
|
|
|
|
- This will reload the nuttx.elf file into FLASH
|
|
|
|
|
|
2015-05-25 18:13:06 +02:00
|
|
|
|
JTAG
|
|
|
|
|
====
|
|
|
|
|
|
|
|
|
|
I did all of the debug of the SAML21 Xplained using a Segger J-Link
|
|
|
|
|
connected to the micro JTAG connector on board the SAML21 Xplained.
|
|
|
|
|
I used an Olimex ARM-JTAG 20-10 Adapter to connect the J-Link to
|
|
|
|
|
the SAML21 Xplained.
|
|
|
|
|
|
2015-05-18 21:16:32 +02:00
|
|
|
|
SAML21 Xplained Pro-specific Configuration Options
|
2015-05-19 22:32:09 +02:00
|
|
|
|
==================================================
|
2015-05-18 21:16:32 +02:00
|
|
|
|
|
|
|
|
|
CONFIG_ARCH - Identifies the arch/ subdirectory. This should
|
|
|
|
|
be set to:
|
|
|
|
|
|
|
|
|
|
CONFIG_ARCH=arm
|
|
|
|
|
|
|
|
|
|
CONFIG_ARCH_family - For use in C code:
|
|
|
|
|
|
|
|
|
|
CONFIG_ARCH_ARM=y
|
|
|
|
|
|
|
|
|
|
CONFIG_ARCH_architecture - For use in C code:
|
|
|
|
|
|
|
|
|
|
CONFIG_ARCH_CORTEXM0=y
|
|
|
|
|
|
|
|
|
|
CONFIG_ARCH_CHIP - Identifies the arch/*/chip subdirectory
|
|
|
|
|
|
2018-07-22 23:54:12 +02:00
|
|
|
|
CONFIG_ARCH_CHIP="samd2l2"
|
2015-05-18 21:16:32 +02:00
|
|
|
|
|
|
|
|
|
CONFIG_ARCH_CHIP_name - For use in C code to identify the exact
|
|
|
|
|
chip:
|
|
|
|
|
|
2018-07-23 03:13:49 +02:00
|
|
|
|
CONFIG_ARCH_CHIP_SAML2X
|
2015-05-18 21:16:32 +02:00
|
|
|
|
CONFIG_ARCH_CHIP_SAML21
|
|
|
|
|
CONFIG_ARCH_CHIP_ATSAML21J18
|
|
|
|
|
|
2019-08-05 15:13:48 +02:00
|
|
|
|
CONFIG_ARCH_BOARD - Identifies the boards/ subdirectory and
|
2015-05-18 21:16:32 +02:00
|
|
|
|
hence, the board that supports the particular chip or SoC.
|
|
|
|
|
|
2015-05-19 22:32:09 +02:00
|
|
|
|
CONFIG_ARCH_BOARD="saml21-xplained" (for the SAML21 Xplained Pro development board)
|
2015-05-18 21:16:32 +02:00
|
|
|
|
|
|
|
|
|
CONFIG_ARCH_BOARD_name - For use in C code
|
|
|
|
|
|
|
|
|
|
CONFIG_ARCH_BOARD_SAML21_XPLAINED=y
|
|
|
|
|
|
|
|
|
|
CONFIG_ARCH_LOOPSPERMSEC - Must be calibrated for correct operation
|
|
|
|
|
of delay loops
|
|
|
|
|
|
|
|
|
|
CONFIG_ENDIAN_BIG - define if big endian (default is little
|
|
|
|
|
endian)
|
|
|
|
|
|
|
|
|
|
CONFIG_RAM_SIZE - Describes the installed DRAM (SRAM in this case):
|
|
|
|
|
|
|
|
|
|
CONFIG_RAM_SIZE=0x00010000 (64KB)
|
|
|
|
|
|
|
|
|
|
CONFIG_RAM_START - The start address of installed DRAM
|
|
|
|
|
|
|
|
|
|
CONFIG_RAM_START=0x20000000
|
|
|
|
|
|
|
|
|
|
CONFIG_ARCH_LEDS - Use LEDs to show state. Unique to boards that
|
|
|
|
|
have LEDs
|
|
|
|
|
|
|
|
|
|
CONFIG_ARCH_INTERRUPTSTACK - This architecture supports an interrupt
|
|
|
|
|
stack. If defined, this symbol is the size of the interrupt
|
|
|
|
|
stack in bytes. If not defined, the user task stacks will be
|
|
|
|
|
used during interrupt handling.
|
|
|
|
|
|
|
|
|
|
CONFIG_ARCH_STACKDUMP - Do stack dumps after assertions
|
|
|
|
|
|
|
|
|
|
CONFIG_ARCH_LEDS - Use LEDs to show state. Unique to board architecture.
|
|
|
|
|
|
|
|
|
|
Individual subsystems can be enabled:
|
|
|
|
|
|
2018-07-22 23:54:12 +02:00
|
|
|
|
CONFIG_SAMD2L2_AC - Analog Comparator
|
|
|
|
|
CONFIG_SAMD2L2_ADC - Analog-to-Digital Converter
|
|
|
|
|
CONFIG_SAMD2L2_DAC - Digital-to-Analog Converter
|
|
|
|
|
CONFIG_SAMD2L2_DMAC - Analog Comparator
|
|
|
|
|
CONFIG_SAMD2L2_EVSYS - Event System
|
|
|
|
|
CONFIG_SAMD2L2_NVMCTRL - Non-Volatile Memory Controller
|
|
|
|
|
CONFIG_SAMD2L2_PTC - Peripheral Touch Controller
|
|
|
|
|
CONFIG_SAMD2L2_RTC - Real Time Counter
|
|
|
|
|
CONFIG_SAMD2L2_SERCOM0 - Serial Communication Interface 0
|
|
|
|
|
CONFIG_SAMD2L2_SERCOM1 - Serial Communication Interface 1
|
|
|
|
|
CONFIG_SAMD2L2_SERCOM2 - Serial Communication Interface 2
|
|
|
|
|
CONFIG_SAMD2L2_SERCOM3 - Serial Communication Interface 3
|
|
|
|
|
CONFIG_SAMD2L2_SERCOM4 - Serial Communication Interface 4
|
|
|
|
|
CONFIG_SAMD2L2_SERCOM5 - Serial Communication Interface 5
|
|
|
|
|
CONFIG_SAMD2L2_TCC0 - Timer/Counter 0 for Control
|
|
|
|
|
CONFIG_SAMD2L2_TCC1 - Timer/Counter 1 for Control
|
|
|
|
|
CONFIG_SAMD2L2_TCC2 - Timer/Counter 2 for Control
|
|
|
|
|
CONFIG_SAMD2L2_TC3 - Timer/Counter 3
|
|
|
|
|
CONFIG_SAMD2L2_TC4 - Timer/Counter 4
|
|
|
|
|
CONFIG_SAMD2L2_TC5 - Timer/Counter 5
|
|
|
|
|
CONFIG_SAMD2L2_TC6 - Timer/Counter 6
|
|
|
|
|
CONFIG_SAMD2L2_TC7 - Timer/Counter 6
|
|
|
|
|
CONFIG_SAMD2L2_USB - USB device or host
|
|
|
|
|
CONFIG_SAMD2L2_WDT - Watchdog Timer
|
2015-05-18 21:16:32 +02:00
|
|
|
|
|
|
|
|
|
Some subsystems can be configured to operate in different ways. The drivers
|
|
|
|
|
need to know how to configure the subsystem.
|
|
|
|
|
|
2018-07-22 23:54:12 +02:00
|
|
|
|
CONFIG_SAMD2L2_SERCOM0_ISI2C, CONFIG_SAMD2L2_SERCOM0_ISSPI, or CONFIG_SAMD2L2_SERCOM0_ISUSART
|
|
|
|
|
CONFIG_SAMD2L2_SERCOM1_ISI2C, CONFIG_SAMD2L2_SERCOM1_ISSPI, or CONFIG_SAMD2L2_SERCOM1_ISUSART
|
|
|
|
|
CONFIG_SAMD2L2_SERCOM2_ISI2C, CONFIG_SAMD2L2_SERCOM2_ISSPI, or CONFIG_SAMD2L2_SERCOM2_ISUSART
|
|
|
|
|
CONFIG_SAMD2L2_SERCOM3_ISI2C, CONFIG_SAMD2L2_SERCOM3_ISSPI, or CONFIG_SAMD2L2_SERCOM3_ISUSART
|
|
|
|
|
CONFIG_SAMD2L2_SERCOM4_ISI2C, CONFIG_SAMD2L2_SERCOM4_ISSPI, or CONFIG_SAMD2L2_SERCOM4_ISUSART
|
|
|
|
|
CONFIG_SAMD2L2_SERCOM5_ISI2C, CONFIG_SAMD2L2_SERCOM5_ISSPI, or CONFIG_SAMD2L2_SERCOM5_ISUSART
|
2015-05-18 21:16:32 +02:00
|
|
|
|
|
|
|
|
|
SAML21 specific device driver settings
|
|
|
|
|
|
|
|
|
|
CONFIG_USARTn_SERIAL_CONSOLE - selects the USARTn (n=0,1,2,..5) for the
|
|
|
|
|
console and ttys0 (default is the USART4).
|
|
|
|
|
CONFIG_USARTn_RXBUFSIZE - Characters are buffered as received.
|
|
|
|
|
This specific the size of the receive buffer
|
|
|
|
|
CONFIG_USARTn_TXBUFSIZE - Characters are buffered before
|
|
|
|
|
being sent. This specific the size of the transmit buffer
|
|
|
|
|
CONFIG_USARTn_BAUD - The configure BAUD of the USART. Must be
|
|
|
|
|
CONFIG_USARTn_BITS - The number of bits. Must be either 7 or 8.
|
|
|
|
|
CONFIG_USARTn_PARTIY - 0=no parity, 1=odd parity, 2=even parity
|
|
|
|
|
CONFIG_USARTn_2STOP - Two stop bits
|
|
|
|
|
|
|
|
|
|
Configurations
|
2015-05-19 22:32:09 +02:00
|
|
|
|
==============
|
2015-05-18 21:16:32 +02:00
|
|
|
|
|
|
|
|
|
Each SAML21 Xplained Pro configuration is maintained in a sub-directory and
|
|
|
|
|
can be selected as follow:
|
|
|
|
|
|
2019-08-06 00:53:39 +02:00
|
|
|
|
tools/configure.sh saml21-xplained:<subdir>
|
2015-05-18 21:16:32 +02:00
|
|
|
|
|
2017-04-26 18:12:13 +02:00
|
|
|
|
Before building, make sure that the PATH environmental variable includes the
|
|
|
|
|
correct path to the directory than holds your toolchain binaries.
|
2015-05-18 21:16:32 +02:00
|
|
|
|
|
|
|
|
|
And then build NuttX by simply typing the following. At the conclusion of
|
|
|
|
|
the make, the nuttx binary will reside in an ELF file called, simply, nuttx.
|
|
|
|
|
|
|
|
|
|
make
|
|
|
|
|
|
|
|
|
|
The <subdir> that is provided above as an argument to the tools/configure.sh
|
|
|
|
|
must be is one of the following.
|
|
|
|
|
|
|
|
|
|
NOTE: These configurations use the mconf-based configuration tool. To
|
|
|
|
|
change any of these configurations using that tool, you should:
|
|
|
|
|
|
|
|
|
|
a. Build and install the kconfig-mconf tool. See nuttx/README.txt
|
2015-06-28 16:08:57 +02:00
|
|
|
|
see additional README.txt files in the NuttX tools repository.
|
2015-05-18 21:16:32 +02:00
|
|
|
|
|
|
|
|
|
b. Execute 'make menuconfig' in nuttx/ in order to start the
|
|
|
|
|
reconfiguration process.
|
|
|
|
|
|
|
|
|
|
NOTES:
|
|
|
|
|
|
|
|
|
|
1. These configurations use the mconf-based configuration tool. To
|
|
|
|
|
change any of these configurations using that tool, you should:
|
|
|
|
|
|
|
|
|
|
a. Build and install the kconfig-mconf tool. See nuttx/README.txt
|
2015-06-28 16:08:57 +02:00
|
|
|
|
see additional README.txt files in the NuttX tools repository.
|
2015-05-18 21:16:32 +02:00
|
|
|
|
|
|
|
|
|
b. Execute 'make menuconfig' in nuttx/ in order to start the
|
|
|
|
|
reconfiguration process.
|
|
|
|
|
|
|
|
|
|
2. Unless stated otherwise, all configurations generate console
|
2015-05-19 22:32:09 +02:00
|
|
|
|
output of on SERCOM4 which is available on EXT1 (see the section
|
|
|
|
|
"Serial Consoles" above). The SERCOM1 on EXT2 or EXT3 or the
|
|
|
|
|
virtual COM port on SERCOME could be used, instead, by
|
|
|
|
|
reconfiguring to use SERCOM1 or SERCOM3 instead of SERCOM4:
|
|
|
|
|
|
2015-05-18 21:16:32 +02:00
|
|
|
|
System Type -> SAMD/L Peripheral Support
|
2018-07-22 23:54:12 +02:00
|
|
|
|
CONFIG_SAMD2L2_SERCOM1=y : Enable one or both
|
|
|
|
|
CONFIG_SAMD2L2_SERCOM3=y
|
|
|
|
|
CONFIG_SAMD2L2_SERCOM4=n
|
2015-05-18 21:16:32 +02:00
|
|
|
|
|
|
|
|
|
Device Drivers -> Serial Driver Support -> Serial Console
|
2015-05-19 22:32:09 +02:00
|
|
|
|
CONFIG_USART1_SERIAL_CONSOLE=y : Select only one for the console
|
|
|
|
|
CONFIG_USART3_SERIAL_CONSOLE=y : Select only one for the console
|
2015-05-18 21:16:32 +02:00
|
|
|
|
CONFIG_USART4_SERIAL_CONSOLE=n
|
|
|
|
|
|
2015-05-19 22:32:09 +02:00
|
|
|
|
Device Drivers -> Serial Driver Support -> SERCOMn Configuration
|
|
|
|
|
where n=1 or 3:
|
|
|
|
|
|
|
|
|
|
CONFIG_USARTn_2STOP=0
|
|
|
|
|
CONFIG_USARTn_BAUD=115200
|
|
|
|
|
CONFIG_USARTn_BITS=8
|
|
|
|
|
CONFIG_USARTn_PARITY=0
|
|
|
|
|
CONFIG_USARTn_RXBUFSIZE=256
|
|
|
|
|
CONFIG_USARTn_TXBUFSIZE=256
|
2015-05-18 21:16:32 +02:00
|
|
|
|
|
|
|
|
|
3. Unless otherwise stated, the configurations are setup for
|
|
|
|
|
Cygwin under Windows:
|
|
|
|
|
|
|
|
|
|
Build Setup:
|
|
|
|
|
CONFIG_HOST_WINDOWS=y : Windows Host
|
2020-02-23 09:50:23 +01:00
|
|
|
|
CONFIG_WINDOWS_CYGWIN=y : Cygwin environment on windows
|
2015-05-18 21:16:32 +02:00
|
|
|
|
|
2020-05-13 16:18:31 +02:00
|
|
|
|
4. These configurations use the ARM EABI toolchain. But
|
2015-05-18 21:16:32 +02:00
|
|
|
|
that is easily reconfigured:
|
|
|
|
|
|
|
|
|
|
System Type -> Toolchain:
|
2020-05-13 16:18:31 +02:00
|
|
|
|
CONFIG_ARMV6M_TOOLCHAIN_GNU_EABIW=y
|
2015-05-18 21:16:32 +02:00
|
|
|
|
|
|
|
|
|
Any re-configuration should be done before making NuttX or else the
|
|
|
|
|
subsequent 'make' will fail. If you have already attempted building
|
|
|
|
|
NuttX then you will have to 1) 'make distclean' to remove the old
|
2018-05-09 19:41:46 +02:00
|
|
|
|
configuration, 2) 'tools/configure.sh sam3u-ek/ksnh' to start
|
2015-05-18 21:16:32 +02:00
|
|
|
|
with a fresh configuration, and 3) perform the configuration changes
|
|
|
|
|
above.
|
|
|
|
|
|
|
|
|
|
Also, make sure that your PATH variable has the new path to your
|
|
|
|
|
Atmel tools. Try 'which arm-none-eabi-gcc' to make sure that you
|
2017-04-26 18:12:13 +02:00
|
|
|
|
are selecting the right tool.
|
2015-05-18 21:16:32 +02:00
|
|
|
|
|
|
|
|
|
See also the "NOTE about Windows native toolchains" in the section
|
|
|
|
|
called "GNU Toolchain Options" above.
|
|
|
|
|
|
|
|
|
|
Configuration sub-directories
|
|
|
|
|
-----------------------------
|
|
|
|
|
|
|
|
|
|
nsh:
|
|
|
|
|
This configuration directory will built the NuttShell. See NOTES above
|
|
|
|
|
and below:
|
|
|
|
|
|
|
|
|
|
NOTES:
|
|
|
|
|
|
|
|
|
|
1. This configuration is set up to build on Windows using the Cygwin
|
2020-05-13 16:18:31 +02:00
|
|
|
|
environment using the ARM EABI toolchain. This can be easily
|
2015-05-18 21:16:32 +02:00
|
|
|
|
changed as described above under "Configurations."
|
|
|
|
|
|
|
|
|
|
2. By default, this configuration provides a serial console on SERCOM4
|
2015-05-22 19:28:02 +02:00
|
|
|
|
at 115200 8N1 via EXT1:
|
|
|
|
|
|
|
|
|
|
PIN EXT1 GPIO Function
|
|
|
|
|
---- ---- ------------------
|
|
|
|
|
13 PB09 SERCOM4 / USART RX
|
|
|
|
|
14 PB08 SERCOM4 / USART TX
|
|
|
|
|
19 GND N/A
|
|
|
|
|
20 VCC N/A
|
|
|
|
|
|
|
|
|
|
If you would prefer to use the EDBG serial COM port or would prefer
|
|
|
|
|
to use SERCOM4 on EXT1 or EXT2, you will need to reconfigure the
|
|
|
|
|
SERCOM as described under "Configurations". See also the section
|
|
|
|
|
entitled "Serial Consoles" above.
|
2015-05-18 21:16:32 +02:00
|
|
|
|
|
|
|
|
|
3. NOTE: If you get a compilation error like:
|
|
|
|
|
|
|
|
|
|
libxx_new.cxx:74:40: error: 'operator new' takes type 'size_t'
|
|
|
|
|
('unsigned int') as first parameter [-fper
|
|
|
|
|
|
|
|
|
|
Sometimes NuttX and your toolchain will disagree on the underlying
|
|
|
|
|
type of size_t; sometimes it is an 'unsigned int' and sometimes it is
|
|
|
|
|
an 'unsigned long int'. If this error occurs, then you may need to
|
2020-02-17 13:19:25 +01:00
|
|
|
|
toggle the value of CONFIG_ARCH_SIZET_LONG.
|
2015-05-18 21:16:32 +02:00
|
|
|
|
|
2015-05-25 18:23:11 +02:00
|
|
|
|
4. WARNING: This info comes from the SAMD20 Xplained README. I have
|
|
|
|
|
not tried the I/O1 module on the SAML21!
|
|
|
|
|
|
|
|
|
|
If the I/O1 module is connected to the SAML21 Xplained Pro, then
|
2015-05-18 21:16:32 +02:00
|
|
|
|
support for the SD card slot can be enabled by making the following
|
|
|
|
|
changes to the configuration. These changes assume that the I/O1
|
|
|
|
|
modules is connected in EXT1. Most of the modifications necessary
|
|
|
|
|
to work with the I/O1 in a different connector are obvious.. except
|
|
|
|
|
for the selection of SERCOM SPI support:
|
|
|
|
|
|
|
|
|
|
EXT1: SPI is provided through SERCOM0
|
|
|
|
|
EXT2: SPI is provided through SERCOM1
|
|
|
|
|
EXT3: SPI is provided through SERCOM5
|
|
|
|
|
|
|
|
|
|
File Systems:
|
|
|
|
|
CONFIG_FS_FAT=y : Enable the FAT file system
|
|
|
|
|
CONFIG_FAT_LCNAMES=y : Enable upper/lower case 8.3 file names (Optional, see below)
|
|
|
|
|
CONFIG_FAT_LFN=y : Enable long file named (Optional, see below)
|
|
|
|
|
CONFIG_FAT_MAXFNAME=32 : Maximum supported file name length
|
|
|
|
|
|
|
|
|
|
There are issues related to patents that Microsoft holds on FAT long
|
2021-04-01 17:16:03 +02:00
|
|
|
|
file name technologies. See the top level NOTICE file for further
|
2015-05-18 21:16:32 +02:00
|
|
|
|
details.
|
|
|
|
|
|
|
|
|
|
System Type -> Peripherals:
|
2018-07-22 23:54:12 +02:00
|
|
|
|
CONFIG_SAMD2L2_SERCOM0=y : Use SERCOM0 if the I/O is in EXT1
|
|
|
|
|
CONFIG_SAMD2L2_SERCOM0_ISSPI=y : Configure SERCOM0 as an SPI master
|
2015-05-18 21:16:32 +02:00
|
|
|
|
|
|
|
|
|
Device Drivers
|
|
|
|
|
CONFIG_SPI=y : Enable SPI support
|
|
|
|
|
CONFIG_SPI_EXCHANGE=y : The exchange() method is supported
|
|
|
|
|
|
|
|
|
|
CONFIG_MMCSD=y : Enable MMC/SD support
|
|
|
|
|
CONFIG_MMCSD_NSLOTS=1 : Only one MMC/SD card slot
|
2021-12-21 12:55:38 +01:00
|
|
|
|
CONFIG_MMCSD_MULTIBLOCK_LIMIT=0 : Should not need to disable multi-block transfers
|
2015-05-18 21:16:32 +02:00
|
|
|
|
CONFIG_MMCSD_MMCSUPPORT=n : May interfere with some SD cards
|
2021-12-21 12:55:38 +01:00
|
|
|
|
CONFIG_MMCSD_HAVE_CARDDETECT=y : I/O1 module as a card detect GPIO
|
2015-05-18 21:16:32 +02:00
|
|
|
|
CONFIG_MMCSD_SPI=y : Use the SPI interface to the MMC/SD card
|
|
|
|
|
CONFIG_MMCSD_SPICLOCK=20000000 : This is a guess for the optimal MMC/SD frequency
|
|
|
|
|
CONFIG_MMCSD_SPIMODE=0 : Mode 0 is required
|
|
|
|
|
|
|
|
|
|
Board Selection -> Common Board Options
|
|
|
|
|
CONFIG_NSH_MMCSDSLOTNO=0 : Only one MMC/SD slot, slot 0
|
|
|
|
|
CONFIG_NSH_MMCSDSPIPORTNO=0 : Use port=0 -> SERCOM0 if the I/O1 is in EXT1
|
|
|
|
|
|
|
|
|
|
Board Selection -> SAML21 Xplained Pro Modules
|
|
|
|
|
CONFIG_SAML21_XPLAINED_IOMODULE=y : I/O1 module is connected
|
2015-05-19 22:32:09 +02:00
|
|
|
|
CONFIG_SAML21_XPLAINED_IOMODULE_EXT2=y : I/O1 modules is in EXT2
|
2015-05-18 21:16:32 +02:00
|
|
|
|
|
|
|
|
|
Application Configuration -> NSH Library
|
|
|
|
|
CONFIG_NSH_ARCHINIT=y : Board has architecture-specific initialization
|
|
|
|
|
|
|
|
|
|
NOTE: If you enable the I/O1 this configuration with SERCOM4 as the
|
|
|
|
|
console and with the I/O1 module in EXT1, you *must* remove USART
|
2015-05-19 22:32:09 +02:00
|
|
|
|
jumper. Otherwise, you have lookback on SERCOM4 and NSH will *not*
|
2015-05-18 21:16:32 +02:00
|
|
|
|
behave very well (since its outgoing prompts also appear as incoming
|
|
|
|
|
commands).
|
|
|
|
|
|
|
|
|
|
STATUS: As of 2013-6-18, this configuration appears completely
|
|
|
|
|
functional. Testing, however, has been very light. Example:
|
|
|
|
|
|
|
|
|
|
NuttShell (NSH) NuttX-6.34
|
|
|
|
|
nsh> mount -t vfat /dev/mmcsd0 /mnt/stuff
|
|
|
|
|
nsh> ls /mnt/stuff
|
|
|
|
|
/mnt/stuff:
|
|
|
|
|
nsh> echo "This is a test" >/mnt/stuff/atest.txt
|
|
|
|
|
nsh> ls /mnt/stuff
|
|
|
|
|
/mnt/stuff:
|
|
|
|
|
atest.txt
|
|
|
|
|
nsh> cat /mnt/stuff/atest.txt
|
|
|
|
|
This is a test
|
|
|
|
|
nsh>
|
|
|
|
|
|
2015-05-25 18:23:11 +02:00
|
|
|
|
5. WARNING: This info comes from the SAMD20 Xplained README. I have
|
|
|
|
|
not tried the OLED1 module on the SAML21!
|
|
|
|
|
|
2015-05-18 21:16:32 +02:00
|
|
|
|
5. If the OLED1 module is connected to the SAML21 Xplained Pro, then
|
|
|
|
|
support for the OLED display can be enabled by making the following
|
|
|
|
|
changes to the configuration. These changes assume that the I/O1
|
|
|
|
|
modules is connected in EXT1. Most of the modifications necessary
|
|
|
|
|
to work with the I/O1 in a different connector are obvious.. except
|
|
|
|
|
for the selection of SERCOM SPI support:
|
|
|
|
|
|
|
|
|
|
EXT1: SPI is provided through SERCOM0
|
|
|
|
|
EXT2: SPI is provided through SERCOM1
|
|
|
|
|
EXT3: SPI is provided through SERCOM5
|
|
|
|
|
|
|
|
|
|
System Type -> Peripherals:
|
2018-07-22 23:54:12 +02:00
|
|
|
|
CONFIG_SAMD2L2_SERCOM1=y : Use SERCOM1 if the I/O is in EXT2
|
|
|
|
|
CONFIG_SAMD2L2_SERCOM1_ISSPI=y : Configure SERCOM1 as an SPI master
|
2015-05-18 21:16:32 +02:00
|
|
|
|
|
|
|
|
|
Device Drivers -> SPI
|
|
|
|
|
CONFIG_SPI=y : Enable SPI support
|
|
|
|
|
CONFIG_SPI_EXCHANGE=y : The exchange() method is supported
|
|
|
|
|
CONFIG_SPI_CMDDATA=y : CMD/DATA support is required
|
|
|
|
|
|
|
|
|
|
Device Drivers -> LCDs
|
|
|
|
|
CONFIG_LCD=y : Enable LCD support
|
|
|
|
|
CONFIG_LCD_MAXCONTRAST=255 : Maximum contrast value
|
|
|
|
|
CONFIG_LCD_LANDSCAPE=y : Landscape orientation (see below*)
|
|
|
|
|
CONFIG_LCD_UG2832HSWEG04=y : Enable support for the OLED
|
|
|
|
|
CONFIG_LCD_SSD1306_SPIMODE=0 : SPI Mode 0
|
|
|
|
|
CONFIG_LCD_SSD1306_SPIMODE=3500000 : Pick an SPI frequency
|
|
|
|
|
|
|
|
|
|
Board Selection -> SAML21 Xplained Pro Modules
|
|
|
|
|
CONFIG_SAML21_XPLAINED_OLED1MODULE=y : OLED1 module is connected
|
|
|
|
|
CONFIG_SAML21_XPLAINED_OLED1MODULE_EXT2=y : OLED1 modules is in EXT2
|
|
|
|
|
|
|
|
|
|
The NX graphics subsystem also needs to be configured:
|
|
|
|
|
|
|
|
|
|
CONFIG_NX=y : Enable graphics support
|
|
|
|
|
CONFIG_NX_LCDDRIVER=y : Using an LCD driver
|
|
|
|
|
CONFIG_NX_NPLANES=1 : With a single color plane
|
2015-05-19 22:32:09 +02:00
|
|
|
|
CONFIG_NX_WRITEONLY=n : You can read from the LCD (see below*)
|
2015-05-18 21:16:32 +02:00
|
|
|
|
CONFIG_NX_DISABLE_2BPP=y : Disable all resolutions except 1BPP
|
|
|
|
|
CONFIG_NX_DISABLE_4BPP=y
|
|
|
|
|
CONFIG_NX_DISABLE_8BPP=y
|
|
|
|
|
CONFIG_NX_DISABLE_16BPP=y
|
|
|
|
|
CONFIG_NX_DISABLE_24BPP=y
|
|
|
|
|
CONFIG_NX_DISABLE_32BPP=y
|
|
|
|
|
CONFIG_NX_PACKEDMSFIRST=y : LSB packed first (shouldn't matter)
|
2017-10-16 00:15:05 +02:00
|
|
|
|
CONFIG_NXSTART_EXTERNINIT=y : We have board_graphics_setup()
|
2015-05-18 21:16:32 +02:00
|
|
|
|
CONFIG_NXTK_BORDERWIDTH=2 : Use a small border
|
|
|
|
|
CONFIG_NXTK_DEFAULT_BORDERCOLORS=y : Default border colors
|
|
|
|
|
CONFIG_NXFONTS_CHARBITS=7 : 7-bit fonts
|
|
|
|
|
CONFIG_NXFONT_SANS17X23B=y : Pick a font (any that will fit)
|
|
|
|
|
|
2015-05-19 22:32:09 +02:00
|
|
|
|
* The hardware is write only, but the driver maintains a frame buffer
|
2015-05-18 21:16:32 +02:00
|
|
|
|
to support read and read-write-modiry operations on the LCD.
|
|
|
|
|
Reading from the frame buffer is, however, untested.
|
|
|
|
|
|
|
|
|
|
Then, in order to use the OLED, you will need to build some kind of
|
|
|
|
|
graphics application or use one of the NuttX graphics examples.
|
|
|
|
|
Here, for example, is the setup for the graphic "Hello, World!"
|
|
|
|
|
example:
|
|
|
|
|
|
|
|
|
|
CONFIG_EXAMPLES_NXHELLO=y : Enables the example
|
|
|
|
|
CONFIG_EXAMPLES_NXHELLO_DEFAULT_COLORS=y : Use default colors (see below *)
|
|
|
|
|
CONFIG_EXAMPLES_NXHELLO_DEFAULT_FONT=y : Use the default font
|
|
|
|
|
CONFIG_EXAMPLES_NXHELLO_BPP=1 : One bit per pixel
|
|
|
|
|
CONFIG_EXAMPLES_NXHELLO_EXTERNINIT=y : Special initialization is required.
|
|
|
|
|
|
2015-05-25 18:23:11 +02:00
|
|
|
|
* The OLED is monochrome so the only "colors" are black and white.
|
2015-05-18 21:16:32 +02:00
|
|
|
|
The default "colors" will give you while text on a black background.
|
|
|
|
|
You can override the faults it you want black text on a while background.
|