From f084e268b246cdb957efdedcd38c9c82ae2527b7 Mon Sep 17 00:00:00 2001 From: David Huss <dh@atoav.com> Date: Fri, 16 Feb 2024 21:35:09 +0100 Subject: [PATCH] Update readme, add install instructions for Arduino as well --- README.md | 57 +++++++++++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 57 insertions(+) diff --git a/README.md b/README.md index adfde81..ae1d7f6 100644 --- a/README.md +++ b/README.md @@ -110,6 +110,10 @@ Just like with real tape the pitch of the played back sounds changes when the sp ## Installation + + +### Option 1: Daisy Web Programmer + The fastest way to install this software on your daisyy is to use the Daisy Web Programmer, as this does not require you to install anything on your computer: 1. Download the `daisyy-looper.bin` in this projects *Releases* page @@ -124,3 +128,56 @@ The fastest way to install this software on your daisyy is to use the Daisy Web 6. Click on the <kbd>Choose File</kbd> button and select the `daisyy-looper.bin` file you downloaded in Step 1 7. Click on the <kbd>Program</kbd> button on the bottom to upload the code 8. If everything worked right there should be a text saying (among other things) *Done!* – your daisyy should restart and the looper should now run + + + +### Option 2: Arduino + +#### Arduino IDE Setup + +If you like you can follow [Electrosmith's Video Instructions](https://www.youtube.com/watch?v=UyQWK8JFTps) on how to setup the ardino IDE to work with daisy. The short list version is: + +1. Install Arduino IDE from [arduino.cc](https://www.arduino.cc/en/software) +2. Follow the instructions at [sm32duino](https://github.com/stm32duino/Arduino_Core_STM32/wiki/Getting-Started): + 1. In Arduino under `Preferences > Additional Board Manager URLs` add the following text: + `https://github.com/stm32duino/BoardManagerFiles/raw/main/package_stmicroelectronics_index.json` + (Note: If you already have other URLs there, you need to seperate them with a comma) + 2. Open the `Board Manager` in Arduino (one of the icons on the left) and install the board `STM32 MCU based boards` by STMicroelectronics + 3. Follow the extra step, download and install the STM32CubeProgrammer Software from [here](https://www.st.com/en/development-tools/stm32cubeprog.html) + <u>Mac:</u> You will have to use the workaround described [in the video](https://youtu.be/UyQWK8JFTps?t=164) + <u>Linux:</u> Make sure the stm32cube binaries can be found in the PATH by the Arduino IDE + +#### Install DaisyDuino Library + +1. Click on the `Library Manager` icon in the left bar +2. Search for `DaisyDuino` +3. Click <kbd>INSTALL</kbd> + +#### Arduino IDE Settings + +**NOTE:** It can happen that these settings get lost if you update the STM32 board files + +Change the following settings in the `Tool` menu on the top: + +| Name | Setting | +| ------------------------ | ------------------------------------------ | +| Board | `Generic STM32H7 Series` | +| Board part number | `Daisy Seed` | +| USB support | `CDC (generic 'Serial' supersede U(S)ART)` | +| U(S)ART support | `Enabled (Generic 'Serial')` | +| USB speed (if available) | `Low/Full Speed` | +| Upload method | `STM32CubeProgrammer (DFU)` | + +#### Uploading the Code + +1. Download the Code on this page by clicking on the <kbd>Code</kbd> button on top and selecting `.zip` +2. Unpack the zip file somewhere on your computer +3. Connect your Daisy Seed to your computer via USB. The red power LED should now glow +4. Set the daisy to DFU/Programming mode by pressing the buttons in the following order: + 1. Press and HOLD the `BOOT` button + 2. Click the `RESET` button` + 3. Release the `BOOT` button +5. Open the `daisyy-looper.ino` file in the unzipped project folder using the Arduino-IDE +6. Ensure on top next to the round buttons the board `Generic STM32H7 Series` is shown (if not follow the steps outlined above in the section *Arduino IDE Settings*) +7. Click on the round Upload button (an arrow pointing to the right) +8. After uploading the daisyy should restart and the looper should now work – any errors during the upload should be displayed -- GitLab