Skip to main content

Quick Start Guide

Hardware

  1. Take the included 5V power supply and plug into a wall output. Connect the barrel jack on the other end of the power supply as connect to the back of the Quarto as show in the picture below step #2.

  2. Connect the back panel USB to the included USB cable and connect the other end to your computer.

    img

Software

  1. Install the Arduino IDE (if not already installed). We highly recommend using the 2.0 version over the 1.8 version even though the 2.0 version is in beta and listed under 'Experimental Software'. It has significantly faster compile times, a cleaner interface and auto-completion of code among other features.

    Please select which version you have installed for the proper instructions:

  1. Open Arduino

  2. Open the preferences dialog by clicking on File and then Preferences:

    In the "Additional Boards Manager URLS" field, put:

    https://qnimble.com/package_qnimble_index.json

    If you already have url's there, add a comma (,) at the end of the list, then add the qNimble URL.

    tip

    If you want access to our latest beta software, instead of the above url, use:

     https://qnimble.com/package_qnimble_beta_index.json

img

caution

Due to a bug in Arduino IDE 2.0, after updating the board URL setting and clicking ok, you must restart the Arduino IDE. If you have multiple windows open, you must close all of them, then open the Arduino IDE to get Arduino to refresh the board list.

  1. Open the Boards Manager by clicking on Tools, Board and then Boards Manager

  2. Type "qnimble" into the text box at the top

img

  1. Then "qNimble iMXRT Boards" should show up, and click "install"

  2. Once the installation is complete, qNimble iMXRT Boards should be listed as INSTALLED and you can close the Boards Manager tab by clicking on the IC icon on the far left.

img

  1. If you do not have an empty sketch, click on File and New to open blank sketch.

  2. Click on Tools, Board, qNimble and select Quarto

img

  1. Click on Tools, Port to select the COM port associated with the Quarto. Under the heading 'Serial Ports' you should see all available communnication ports, including the two Quarto ports. Generally you want to select the lower numbered Quarto port, however, on most setups there should be another section labelled 'Qnimble ports' ('qNimble sam-ba emulator' on Arduino 1.X) that will only list the programming port of connected Quarto devices. Select that port:

img

  1. Put your code in your sketch, or if you want a simple program to blink the front panel LED, paste the following code:
   void setup() {
// put your setup code here, to run once:
}

void loop() {
static unsigned long lastrun = millis();
if (millis() > lastrun) {
lastrun = lastrun + 500; //Run once every 500ms
toggleLEDGreen(); //toggle green LED;
}
}

and when ready, click on Upload to load the code onto the Quarto.

img

Linux Users

Ubuntu and other Linux distributions use modem manager which sends some commands to serial devices when they are plugged in. These commands tell the Quarto bootloader to not automatically boot the application but to stay in the bootloader. This prevents the Quarto from running your application when you first power it on if it is connected to such a computer. The fix is to tell Linux to not send commands to the Quarto when it connects. Create a new file /etc/udev/rules.d/01-disable-mm-ttyACM.rules with the content

01-disable-mm-ttyACM.rules
KERNEL=="ttyACM*", ENV{ID_MM_DEVICE_IGNORE}="1"