Skip to content

Commit a959a48

Browse files
committed
DM: update readme
1 parent d536980 commit a959a48

File tree

1 file changed

+3
-36
lines changed

1 file changed

+3
-36
lines changed

README.md

Lines changed: 3 additions & 36 deletions
Original file line numberDiff line numberDiff line change
@@ -1,48 +1,15 @@
11
# Arduino Core for SAMD21 and SAMD51 CPU
22

3-
## Known Issues:
4-
* gcc optimizations must be off for sketches to work consistently. We are working to track this down.
5-
* AREF must be tied to 3.3V for dac to work. This is a bug in the SAMD51 silicon.
6-
* USB host mode doesn't work yet
7-
* I2S doesn't work yet
8-
93
This repository contains the source code and configuration files of the Arduino Core
104
for Atmel's SAMD21 and SAMD51 processor (used on the Arduino/Genuino Zero, MKR1000 and MKRZero boards).
115

126
In particular, this adds support for the Adafruit SAMD Boards such as the Feather M0
137

14-
## ATSAMD51 Installation on Arduino IDE
15-
16-
The ATSAMD51 is a significantly new chip, so this is a detailed process for now! For the SAMD21, please install via the board manager (no extra steps required)
17-
18-
1. Install Arduino IDE 1.8.5 or greater
19-
2. Install/update the Adafruit SAMD board support package if you have installed it
20-
3. Now we need to update CMSIS! Download https://github.com/adafruit/ArduinoModule-CMSIS-Atmel/archive/master.zip and unzip
21-
4. Find your Arduino CMSIS, in Mac its "~/Library/Arduino15/packages/arduino/tools/CMSIS-Atmel/1.1.0/CMSIS" version # may vary, you'll need "Go to folder..." feature in the Finder to get to " ~/Library/Arduino15" as it is hidden. In Windows it is "C:\Users\yourusername\AppData\Local\Arduino15\packages\arduino\tools\CMSIS-Atmel\1.1.0\CMSIS" Inside is a folder named Device
22-
23-
For Linux: the Arduino stuff is located in ~/.arduino15/packages/arduino/tools/CMSIS-Atmel/1.1.0/CMSIS
24-
25-
5. Inside the downloaded CMSIS zip, go into the CMSIS-Atmel/CMSIS folder, you should see a folder named Device. *DRAG THE DEVICE FOLDER ONLY* from the zip to your arduino Library folder so that Device is merged with Device. It will replace a bunch of files.
26-
27-
For Linux, it may be better to just delete the original Device Folder then copy over the new one - the drag/drop worked ok on MACOS, but not so well on my Linux box.
28-
29-
6. You will also need to replace bossac. For Windows or Mac: Go here https://github.com/adafruit/BOSSA/releases and download either windows exe or mac app of latest bossac. unzip. Go to Step 12.
30-
31-
For Linux users it is best to build a copy of bossac locally -
32-
clone the Adafruit Repostitory to somewhere on your local machine.
33-
```
34-
git clone https://github.com/adafruit/BOSSA.git
35-
change to the arduino branch
36-
git checkout arduino
37-
```
38-
Follow the instructions to build bossac in README.md or at https://github.com/adafruit/BOSSA/tree/arduino.
39-
40-
7. Replace the binary at ".../Library/Arduino15/packages/arduino/tools/bossac/1.7.0/bossac" or "...\AppData\Local\Arduino15\packages\arduino\tools\bossac\1.7.0\bossac"
41-
8. On Windows 7 you will also need to install the updated serial driver, download https://github.com/adafruit/Adafruit_Windows_Drivers/archive/master.zip to get all the drivers, and point the Device Manager to the unzipped folder. It isn't signed, so just approve the installation manually.
42-
13. That's it!
43-
448
## Bugs or Issues
459

10+
* AREF must be tied to 3.3V for dac to work. This is a bug in the SAMD51 silicon.
11+
* USB host mode doesn't work yet
12+
4613
If you find a bug you can submit an issue here on github:
4714

4815
https://github.com/adafruit/ArduinoCore-samd

0 commit comments

Comments
 (0)