|
1 | 1 | # Arduino Core for SAMD21 and SAMD51 CPU |
2 | 2 |
|
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 | | - |
9 | 3 | This repository contains the source code and configuration files of the Arduino Core |
10 | 4 | for Atmel's SAMD21 and SAMD51 processor (used on the Arduino/Genuino Zero, MKR1000 and MKRZero boards). |
11 | 5 |
|
12 | 6 | In particular, this adds support for the Adafruit SAMD Boards such as the Feather M0 |
13 | 7 |
|
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 | | - |
44 | 8 | ## Bugs or Issues |
45 | 9 |
|
| 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 | + |
46 | 13 | If you find a bug you can submit an issue here on github: |
47 | 14 |
|
48 | 15 | https://github.com/adafruit/ArduinoCore-samd |
|
0 commit comments