From a959a48da2fd8503490f96db3ff73101397b50d6 Mon Sep 17 00:00:00 2001 From: dean Date: Mon, 10 Sep 2018 11:44:16 -0400 Subject: [PATCH] DM: update readme --- README.md | 39 +++------------------------------------ 1 file changed, 3 insertions(+), 36 deletions(-) diff --git a/README.md b/README.md index 1e44951f..10615da5 100644 --- a/README.md +++ b/README.md @@ -1,48 +1,15 @@ # Arduino Core for SAMD21 and SAMD51 CPU -## Known Issues: -* gcc optimizations must be off for sketches to work consistently. We are working to track this down. -* AREF must be tied to 3.3V for dac to work. This is a bug in the SAMD51 silicon. -* USB host mode doesn't work yet -* I2S doesn't work yet - This repository contains the source code and configuration files of the Arduino Core for Atmel's SAMD21 and SAMD51 processor (used on the Arduino/Genuino Zero, MKR1000 and MKRZero boards). In particular, this adds support for the Adafruit SAMD Boards such as the Feather M0 -## ATSAMD51 Installation on Arduino IDE - -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) - -1. Install Arduino IDE 1.8.5 or greater -2. Install/update the Adafruit SAMD board support package if you have installed it -3. Now we need to update CMSIS! Download https://github.com/adafruit/ArduinoModule-CMSIS-Atmel/archive/master.zip and unzip -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 - -For Linux: the Arduino stuff is located in ~/.arduino15/packages/arduino/tools/CMSIS-Atmel/1.1.0/CMSIS - -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. - -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. - -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. - -For Linux users it is best to build a copy of bossac locally - -clone the Adafruit Repostitory to somewhere on your local machine. -``` -git clone https://github.com/adafruit/BOSSA.git -change to the arduino branch -git checkout arduino -``` -Follow the instructions to build bossac in README.md or at https://github.com/adafruit/BOSSA/tree/arduino. - -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" -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. -13. That's it! - ## Bugs or Issues +* AREF must be tied to 3.3V for dac to work. This is a bug in the SAMD51 silicon. +* USB host mode doesn't work yet + If you find a bug you can submit an issue here on github: https://github.com/adafruit/ArduinoCore-samd