A VIDEO VERSION OF THIS GUIDE

Getting Started

1. Prepare the development environment

• Download the latest version of theArduino IDE
• Launch the Arduino IDE and open its Settings under the File or Arduino IDE tab
• In the Additional Boards Manager URLs field, paste the following and click OK: https://dl.espressif.com/dl/package_esp32_index.json
• Go to Tools > Board > Boards Manager...
• Enter ESP32 in the search field and click Install in the search result titled ESP32 by Espressif Systems
• The board definitions are now downloaded and installed. INSTALLED appears when it is ready.

2. Install Mozzi and MIDI libraries

• In the Arduino IDE go to Tools > Manage Libraries...
• Type Mozzi into the search bar
• The only result should be Mozzi by Tim Barrass. Install version 2.0.1, not any newer versions
• Type MIDI Library into the search bar and press enter
• Install the latest version of the library by Francois Best, Iathoub

3. Install MEAP Library

• Download and unzip the MEAP code repository (click the green "Code" button and press "download ZIP)"
• Navigate to your Arduino sketchbook directory

This can be located by opening the Settings menu in the Arduino IDE and noting the path listed at the top of the window.

• Drag the downloaded MEAP-main folder to the libraries folder

4. Add MEAP board definitions

NOTE: if your Arduino IDE ever updates your ESP32 board definitions, it will likely overwrite these changes and you will need to repeat this step.

• Navigate to the Arduino15 folder:

  This location will vary depending on your operating sytem. Find your location here. On a mac, it should be located at ~/Library/Arduino15

• Within Arduino15, navigate to the ESP32 Board definitions

  Go to packages/esp32/hardware/esp32/3.x.x/

• Modify "boards.txt"

Open boards.txt in your text editor of choice and paste the contents of meap_boards.txt onto the end of it.

• Add MEAP partition file

Paste meap.csv into tools/partitions

5. Uploading an example program

• Open the "MEAP_HW_TEST.ino" file within the Testing and Templates directory inside of the examples folder of Meap-main using the Arduino IDE.
• Connect your MEAP to your computer using a USB data cable (be sure that you are not using a charging-only cable)
• At the top of the Arduino IDE window, open the board selection menu and choose Select other board and port
• For Boards, choose MEAP 4C, and for Ports, choose the USB device that appears when MEAP is plugged in.
• Press the upload button within the Arduino IDE. This is the right-facing arrow in the top left of the window.
• Wait a few seconds until it is done uploading.
• Switch your MEAP's speaker on (or plug in headphones) and turn up the volume knob and you should hear two tones playing.
• Open the serial monitor by pressing the magnifying glass in the top right of the window.
• Try pressing touch pads or toggling DIP switches, the serial monitor at the bottom of the window should tell you which pads/switches you are pressing.

6. Learn to use your MEAP

You're ready to make some fantastic music! I recommend you get started by...

• looking through the Basic tutorials to learn the basics of MEAP's audio engine and hardware peripherals.
• reading this overview of some potentially confusing aspects of programming MEAP, especially if you are new to C++.
• checking out the software documentation