SparkFun Qwiic Alphanumeric Display Hookup Guide
Contributors:
Ell C, MAKIN-STUFF
Alphanumeric Display Arduino Library
Note: Make sure you are using the latest stable version of the Arduino IDE on your desktop. If this is your first time using Arduino IDE, library, or board add-on, please review the following tutorials.
Before we get started, we'll need to download and install SparkFun's Alphanumeric Display Arduino library. You can use the Arduino Library Manager by searching "SparkFun Alphanumeric Display" to automatically install. Or you can download the library and install it using the button below.
Before we get started developing a sketch, let's look at the available functions of the library.
bool setBrightness(uint8_t duty);
--- This sets the brightness for all unitssetBrightnessSingle(uint8_t displayNumber, uint8_t duty);
--- This sets the brightness for a single unitsetBlinkRate(float rate);
--- Set the refresh rate for all units.setBlinkRateSingle(uint8_t displayNumber, float rate);
--- Set the refresh rate for a single unitdisplayOn();
--- Turn all display units ondisplayOff();
--- Turn all display units offdisplayOnSingle(uint8_t displayNumber);
--- Turn a single display unit ondisplayOffSingle(uint8_t displayNumber);
--- Turn a single display unit offsetDisplayOnOff(uint8_t displayNumber, bool turnOnDisplay);
--- Set or clear the display on/off bitenableSystemClock();
--- Turn on the system oscillator for all displays on the I2C busdisableSystemClock();
--- Turn off the system oscillator for all displays on the busenableSystemClockSingle(uint8_t displayNumber);
--- Turn on the system oscillator for normal operation modedisableSystemClockSingle(uint8_t displayNumber);
--- Turn off the system oscillator for standby modeilluminateSegment(uint8_t segment, uint8_t digit);
--- Given a segment and a digit, set the matching bit within the RAM of the Holtek RAM setilluminateChar(uint16_t disp, uint8_t digit);
--- Given a binary set of segments and a digit, store this data into the RAM arrayprintChar(uint8_t displayChar, uint8_t digit);
--- Print a character, for a given digit, on displayupdateDisplay();
--- Push the contents of displayRAM out to the various displays in 16 byte chunksdefineChar(uint8_t displayChar, uint16_t segmentsToTurnOn);
--- Update the list to define a new segments display for a particular charactergetSegmentsToTurnOn (uint8_t charPos);
--- Get the character map from the definition list or default tabledecimalOn();
--- Turn the decimal on for all displays on busdecimalOff();
--- Turn the decimal off for all displays on busdecimalOnSingle(uint8_t displayNumber);
--- Turn the decimal point on for a single displaydecimalOffSingle(uint8_t displayNumber);
--- Turn the decimal point off for a single displaysetDecimalOnOff(uint8_t displayNumber, bool turnOnDecimal);
--- Set or clear the decimal on/off bitcolonOn();
--- Turn the colon on for all displays on the buscolonOff();
--- Turn the colon off for all displays on the buscolonOnSingle(uint8_t displayNumber);
--- Turn the colon on for a single displaycolonOffSingle(uint8_t displayNumber);
--- Turn the colon off for a single displaysetColonOnOff(uint8_t displayNumber, bool turnOnColon);
--- Set or clear the colon on/off bitshiftRight(uint8_t shiftAmt = 1);
--- Shift the display content to the right one digitshiftLeft(uint8_t shiftAmt = 1);
--- Shift the display content to the left one digit