Arduino and Loom Manual Setup

This guide is intended to help users with the typical usage of Loom.

Table of Contents

• Setup Arduino
• Run an Example
• Update Feather M0 WiFi Firmware
• Usage

Install Arduino

• Download and install the latest version of the Arduino IDE

• NOTE: If installing on Windows, download the Windows Installer

• NOTE: If installing on Linux, see the official Linux install guide

Start the IDE and navigate to File->Preferences (Windows/Linux), Arduino->Preferences (MacOS/OSX)

• Find "Additional Boards Manager URLs" dialog box and copy/paste the following urls:

  https://adafruit.github.io/arduino-board-index/package_adafruit_index.json,https://github.com/OPEnSLab-OSU/Loom_Auxiliary/raw/master/package_loom_index.json

- Click OK, close and reopen the IDE

Install M0 board support for Arduino (32-bits ARM Cortex-M0+) SAMD Board and Adafruit SAMD Board:

• Open the Board Manager by navigating to Tools->Board->'Boards Manager'
• Install Arduino SAMD Boards Support (version 1.6.11 or later), by typing Arduino SAMD in the top search bar. Click install on the entry named "Arduino SAMD Boards (32-bits ARM Cortex-M0+)"

<

Install Adafruit SAMD Package to add board file definitions.

• Type Adafruit SAMD or feather in the top search bar. Click install on the entry named "Adafruit SAMD Boards". (IMPORTANT: Make sure the version is 1.5.7, otherwise, the files may not initialize correctly) The description of the package should mention support for feather M0

Install the Loom SAMD Package to add to board file definitions.

• Type in Loom SAMD in the top search bar. Click install on the entry named “Loom SAMD Boards”. The description should be short since we do not currently support many boards (At the time of writing this, Adafruit Feather M0).

• Close the board's manager, close and reopen the IDE

• Install drivers if on Windows 7

• For more detailed instructions, go to Adafruit's IDE Setup page

Run an Example

Select Board

• Make sure in the Tools > Board menu, that "Loomified Feather M0" is selected
  • If that board is not present, make sure you followed all the instructions in our Arduino Setup Guide
• Plug in your Feather board and then make sure in the Tools > Port menu that you select the device with "Adafruit Feather M0" in the name

Compile

• Start by compiling our Basic Loom examples (File > Examples > Loom > Basic) to ensure that it compiles. If not, review the previous steps.
  • Once the Basic example is open, click the checkbox icon "Verify" in the top. (This may take several minutes to compile, this is to be expected)
  • You should get white-color font text readout mentioning a successful compilation and x% memory used.
  • Note: may disregard orange-color warning text regarding nRF

Update Feather M0 WiFi Firmware

If you are using an Adafruit Feather M0 WiFi board (this step is not relevant to non-WiFi Feathers), you will want to update the firmware to be able to use SSL (used for Google Sheets and Spool). To do this:

• Open the WiFiFirmwareUpdater example from the File > Examples > Loom menu in the Arduino IDE
• Make sure in the Tools > Board > Loom SAMD Boards menu, that "Loomified Feather M0" is selected
• Plug in your Feather board and then make sure in the Tools > Port menu that you select the device with "Adafruit Feather M0" in the name
• Upload the sketch to the board, once uploaded proceed to the next step
• From the Tools menu in the Arduino IDE, select "WiFi101 / WiFiNINA Firmware Updater"
• In the window that opens:
  • Section 1: Select your board from the list
  • Section 2: Select the "WINC1501 Model B (19.6.1) (Arduino/Genuino MKR1000)" from the drop-down menu
  • Section: Click the "Update Firmware" button
• Once complete, your WiFi firmware has been updated

Usage

For details on Loom usage, see our Quick Start Guide.