List of Software Functions

The following is a list of categories of Quarto-specific functions and related libraries. Click on a category for a full description of all the functions in that category. All code is open source and available at the qNimble GitHub Repository with most functions in quarto-lib and most libraries in arduino-quarto-libraries. For additional functions that can run on the Quarto, please see the Arduino Language Reference. The Quarto can run Arduino and standard c/c++ functions.

📄️ ADC

The following functions are available for configuring and reading analog data with the ADC. The "X" in any function name must be replaced by the channel number (1,2,3 or 4):

📄️ DAC

The following general DAC functions are available to set the Analog Output voltage. They take a DAC channel as an argument along with the DAC value.

📄️ Digital I/O

The Quarto has eight digital input and output pins, which can be utilized using standard Arduino™ functions:

📄️ External Clocks

These functions require firmware version 1.32.52 or higher. You can check your firmware version with the Arduino example "Device Info" under the "Testing" category. If you have an earlier firmware revision, please contact qNimble to get upgrade instructions.

📄️ LEDs

The Quarto has a user-controlled RGB LED on the front panel and the red, green and blue LEDs can be individually controlled with the following functions:

📄️ Memory

The Quarto has 96kB of user-accessible non-volatile memory (NVM) (sometimes called EEPROM). This is memory that will persist across reboots and reflashings of the Quarto. You can read and write to this memory with the following functions:

📄️ protoThreads

qProtothreads is the qNimble variant of the Protothreads library, a library used to simplify emulating having multiple functions run at the same time. The library works by designing functions to pause their execution so other functions can run and then having the function resume its execution where it left off. Unlike most libraries, Protothreads is a set of macros which get expanded before the c/c++ code is compiled. Because of this, the syntax sometimes differs from proper c/c++. For examples of how to use Protothreads, please look at the Threading Example.

📄️ SD / SdFs

SdFs and FsFile are class objects for interacting with the SD card reader. SdFs is necessary for initializing the SD card and can be used for listing files and directories, showing the file system and other functions. FsFile is a class object for interacting with a specific file or directory and can be used for reading and writing data. The two classes have some overlapping functionality (using either class works), but you must run SdFs' begin before using the SD card. For an example using these classes to interact with files on the SD card, see the SD Card Example.

📄️ SmartData

SmartData is a data class for storing and controlling data. While designed specifically with qControl and qCommand in mind, it can be used by itself as well. SmartData is a templated class, meaning it takes a type argument and the class has different properties for different types. To use the data class, add the following line to the top of your program:

📄️ Triggers

The following functions are available for the two Trigger lines. The "X" in a function name must be replaced by the trigger number (1 or 2):

📄️ qCommand

qCommand is a class object for linking data with commands. It can be used to get and set variables with serial commands (see Serial Commands example). It can also be used to plot data and set variables via the web application qControl. Some commands and features are only relevant when qCommand is used with qControl , while others are only relevant when used with Serial Commands. To use the class, add the following line to the top your program: