@@ -69,16 +69,20 @@ is running, the LED, if configured, will PWM fade quickly (~4Hz).
69
69
70
70
### SD Card External Pins
71
71
72
- If SDCARD_USE_PIN1 is defined, then the SD Card bootloader will run depending
72
+ If only SDCARD_USE_PIN1 is defined, then the SD Card bootloader will run depending
73
73
on the state of an external pin and the value of SDCARD_PIN1_POLARITY. The
74
74
SPI peripheral and SPI pins will only be setup if the SD card bootloader runs.
75
+ This is the default setting with the precompiled binaries that include SD Card support.
76
+
77
+ * Hint: When doing development with an SD card installed, and thus probably using the*
78
+ * SAM-BA interface, either ensure there is no UPDATE.BIN, or use pin 1 to skip the SD card*
75
79
76
80
Pin1 | Action
77
81
----------------|---------------------
78
82
Inactive | Skip SD bootloader
79
83
Active | Run SD bootloader
80
84
81
- If SDCARD_USE_PIN1 and SDCARD_USE_PIN2 are defined, then the SD Card bootloader
85
+ If both SDCARD_USE_PIN1 and SDCARD_USE_PIN2 are defined, then the SD Card bootloader
82
86
will run depending on the state of two external pins and the values of
83
87
SDCARD_PIN1_POLARITY and SDCARD_PIN1_POLARITY. The SPI peripheral and pins
84
88
will only be setup if the SD card bootloader runs. Note that if SDCARD_USE_PIN2
@@ -155,6 +159,7 @@ at https://github.com/mattairtech/ArduinoCore-samd. Each board
155
159
and chip combination has two bootloaders available:
156
160
157
161
* SAM-BA interface only
162
+ * This is the bootloader that is installed by the Arduino IDE
158
163
* USB CDC only for all MattairTech boards
159
164
* Both USB CDC and UART for most Arduino boards
160
165
* The Generic board variants minimize external pin usage
@@ -263,9 +268,14 @@ If using Bossac standalone, download bossac directly at:
263
268
* https://www.mattairtech.com/software/arduino/bossac-1.7.0-mattairtech-1-i686-linux-gnu.tar.gz (Linux 32 bit)
264
269
* https://www.mattairtech.com/software/arduino/bossac-1.7.0-mattairtech-1-x86_64-apple-darwin.tar.gz (OS X 64 bit)
265
270
271
+ Linux 64 bit users can also download Bossa (GUI) and bossash (shell) from:
272
+
273
+ * https://www.mattairtech.com/software/arduino/Bossa-1.7.0-mattairtech-1-x86_64-linux-gnu.tar.gz (Linux 64 bit)
274
+
266
275
Note that the SAM-BA tools from Atmel will not work, and the version of bossac from the Arduino
267
276
SAMD Core currently does not support the L21, C21, or D11 (but it does support the D21).
268
277
278
+
269
279
#### Using Bossac Standalone
270
280
271
281
TODO: Update https://www.mattairtech.com/software/SAM-BA-bootloader-test-firmware.zip with new chips (L21 and C21).
@@ -281,17 +291,6 @@ Wl,sectionstart=.text=0x2000
281
291
You can also use a linker script. See the MattairTech SAM M0+ package for examples.
282
292
Be sure to generate and use a binary file. Many makefiles are set up to generate an elf, hex, and bin already.
283
293
284
- Download Bossac from:
285
-
286
- * https://www.mattairtech.com/software/arduino/bossac-1.7.0-mattairtech-1-mingw32.tar.gz (Windows 32 bit and 64 bit)
287
- * https://www.mattairtech.com/software/arduino/bossac-1.7.0-mattairtech-1-x86_64-linux-gnu.tar.gz (Linux 64 bit)
288
- * https://www.mattairtech.com/software/arduino/bossac-1.7.0-mattairtech-1-i686-linux-gnu.tar.gz (Linux 32 bit)
289
- * https://www.mattairtech.com/software/arduino/bossac-1.7.0-mattairtech-1-x86_64-apple-darwin.tar.gz (OS X 64 bit)
290
-
291
- Linux 64 bit users can also download Bossa (GUI) and bossash (shell) from:
292
-
293
- * https://www.mattairtech.com/software/arduino/Bossa-1.7.0-mattairtech-1-x86_64-linux-gnu.tar.gz (Linux 64 bit)
294
-
295
294
As an example, bossac will be used to upload the test firmware (blink sketch):
296
295
297
296
1 . Download firmware from https://www.mattairtech.com/software/SAM-BA-bootloader-test-firmware.zip and unzip.
0 commit comments