|
|
||
|---|---|---|
| .. | ||
| board_definitions.h | ||
| board_definitions_arduino_mkr1000.h | ||
| board_definitions_arduino_mkrfox1200.h | ||
| board_definitions_arduino_mkrzero.h | ||
| board_definitions_arduino_zero.h | ||
| board_definitions_genuino_mkr1000.h | ||
| board_definitions_genuino_zero.h | ||
| board_driver_led.c | ||
| board_driver_led.h | ||
| board_driver_serial.c | ||
| board_driver_serial.h | ||
| board_driver_usb.c | ||
| board_driver_usb.h | ||
| board_init.c | ||
| board_startup.c | ||
| bootloader_samd21x18.ld | ||
| build_all_bootloaders.sh | ||
| main.c | ||
| Makefile | ||
| README.md | ||
| sam_ba_cdc.c | ||
| sam_ba_cdc.h | ||
| sam_ba_monitor.c | ||
| sam_ba_monitor.h | ||
| sam_ba_serial.c | ||
| sam_ba_serial.h | ||
| sam_ba_usb.c | ||
| sam_ba_usb.h | ||
| samd21_sam_ba.atsln | ||
| samd21_sam_ba.bin | ||
| samd21_sam_ba.cproj | ||
| samd21_sam_ba.hex | ||
| samd21_sam_ba_genuino.bin | ||
| samd21_sam_ba_genuino.hex | ||
Arduino Zero Bootloader
1- Prerequisites
The project build is based on Makefile system. Makefile is present at project root and try to handle multi-platform cases.
Multi-plaform GCC is provided by ARM here: https://launchpad.net/gcc-arm-embedded/+download
Atmel Studio contains both make and ARM GCC toolchain. You don't need to install them in this specific use case.
For all builds and platforms you will need to have the Arduino IDE installed and the board support package for "Arduino SAMD Boards (32-bits ARM Cortex-M0+)". You can install the latter from the former's "Boards Manager" UI.
Windows
-
Native command line Make binary can be obtained here: http://gnuwin32.sourceforge.net/packages/make.htm
-
Cygwin/MSys/MSys2/Babun/etc... It is available natively in all distributions.
-
Atmel Studio An Atmel Studio 7 Makefile-based project is present at project root, just open samd21_sam_ba.atsln file in AS7.
Linux
Make is usually available by default.
OS X
Make is available through XCode package.
2- Selecting available SAM-BA interfaces
By default both USB and UART are made available, but this parameter can be modified in sam_ba_monitor.h, line 31:
Set the define SAM_BA_INTERFACE to
- SAM_BA_UART_ONLY for only UART interface
- SAM_BA_USBCDC_ONLY for only USB CDC interface
- SAM_BA_BOTH_INTERFACES for enabling both the interfaces
3- Behaviour
This bootloader implements the double-tap on Reset button. By quickly pressing this button two times, the board will reset and stay in bootloader, waiting for communication on either USB or USART.
The USB port in use is the USB Native port, close to the Reset button. The USART in use is the one available on pins D0/D1, labelled respectively RX/TX. Communication parameters are a baudrate at 115200, 8bits of data, no parity and 1 stop bit (8N1).
4- Description
Pinmap
The following pins are used by the program : PA25 : input/output (USB DP) PA24 : input/output (USB DM) PA11 : input (USART RX) PA10 : output (USART TX)
The application board shall avoid driving the PA25, PA24, PB23 and PB22 signals while the boot program is running (after a POR for example).
Clock system
CPU runs at 48MHz from Generic Clock Generator 0 on DFLL48M.
Generic Clock Generator 1 is using external 32kHz oscillator and is the source of DFLL48M.
USB and USART are using Generic Clock Generator 0 also.
Memory Mapping
Bootloader code will be located at 0x0 and executed before any applicative code.
Applications compiled to be executed along with the bootloader will start at 0x2000 (see linker script bootloader_samd21x18.ld).
Before jumping to the application, the bootloader changes the VTOR register to use the interrupt vectors of the application @0x2000.<- not required as application code is taking care of this.
5- How to build
If not specified the makefile builds for Arduino Zero:
make
if you want to make a custom bootloader for a derivative board you must supply all the necessary information in a board_definitions_xxx.h file, and add the corresponding case in board_definitions.h.
For example for the Arduino MKR1000 we use board_definitions_arduino_mkr1000.h and it is build with the following command:
BOARD_ID=arduino_mkr1000 NAME=samd21_sam_ba_arduino_mkr1000 make clean all