[bl] Updating project documentation

Author: aethaniel

bootloaders/zero/README.md

@@ -1,5 +1,4 @@
 # Arduino Zero Bootloader
-# -----------------------
 
 ## 1- Prerequisites
 
@@ -8,16 +7,18 @@ 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.
+
 ### Windows
 
-Native command line:
+* Native command line
 Make binary can be obtained here: http://gnuwin32.sourceforge.net/packages/make.htm
 
-* Cygwin/MSys/MSys2/Babun/etc...:
+* Cygwin/MSys/MSys2/Babun/etc...
 It is available natively in all distributions.
 
-* Atmel Studio:
-An Atmel Studio Makefile-based project is present at project root, just open samd21_sam_ba.atsln file.
+* Atmel Studio
+An Atmel Studio **7** Makefile-based project is present at project root, just open samd21_sam_ba.atsln file in AS7.
 
 ### Linux
 
@@ -37,11 +38,35 @@ Set the define SAM_BA_INTERFACE to
 * 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.
+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.

bootloaders/zero/main.c

@@ -17,51 +17,6 @@
   Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA  02110-1301  USA
 */
 
-/**
- * --------------------
- * SAM-BA Implementation on SAMD21
- * --------------------
- * Requirements to use SAM-BA :
- *
- * Supported communication interfaces :
- * --------------------
- *
- * SERCOM5 : RX:PB23 TX:PB22
- * Baudrate : 115200 8N1
- *
- * USB : D-:PA24 D+:PA25
- *
- * Pins Usage (*outdated as of 2015/10/10*)
- * --------------------
- * The following pins are used by the program :
- * PA25 : input/output
- * PA24 : input/output
- * PB23 : input
- * PB22 : output
- * PA15 : input
- *
- * The application board shall avoid driving the PA25,PA24,PB23,PB22 and PA15 signals
- * while the boot program is running (after a POR for example)
- *
- * Clock system (*outdated as of 2015/10/10*)
- * --------------------
- * CPU clock source (GCLK_GEN_0) - 8MHz internal oscillator (OSC8M)
- * SERCOM5 core GCLK source (GCLK_ID_SERCOM5_CORE) - GCLK_GEN_0 (i.e., OSC8M)
- * GCLK Generator 1 source (GCLK_GEN_1) - 48MHz DFLL in Clock Recovery mode (DFLL48M)
- * USB GCLK source (GCLK_ID_USB) - GCLK_GEN_1 (i.e., DFLL in CRM mode)
- *
- * Memory Mapping
- * --------------------
- * SAM-BA 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.
- *
-*/
-
 #include <stdio.h>
 #include <sam.h>
 #include "sam_ba_monitor.h"