Now that we have our library and board add-on installed, we can start experimenting with the breakout board. For the scope of this tutorial, we will highlight the example provided in the GitHub hardware repo to get started.
+From your downloads, open the example labeled as Example1-ReadButtons.ino. This example reads the button presses and writes to the non-addressable LED using the PCA9554 I/O I2C Expander.
+For users using an Arduino microcontroller, select your board in the Tools menu (in our case the SparkFun ESP32IoT RedBoard) and the correct Port it enumerated on.
+You can also copy or paste the code as shown below. Then click "Upload".
+/*
+ Using the Qwiic Directional Pad
+ By: Nathan Seidle
+ SparkFun Electronics
+ Date: October 8th, 2024
+
+ License: This code is public domain but you buy me a beer if you use this and we meet someday (Beerware license).
+
+ Feel like supporting our work? Buy a board from SparkFun!
+ https://www.sparkfun.com/products/14733
+
+ This example demonstrates how to use pinMode and digitalRead/Write to read the directional pad and turn
+ on/off the RGB LED channels.
+
+ Hardware Connections:
+ Plug the Qwiic board to your Arduino/ESP32 or other
+ Press the buttons
+ Watch each LED turn on one-at-a-time
+*/
+
+#include <SparkFun_I2C_Expander_Arduino_Library.h> // Click here to get the library: http://librarymanager/All#SparkFun_I2C_Expander_Arduino_Library
+
+SFE_PCA95XX io; // Defaults to the PCA9554 at I2C address 0x20
+
+int buttonUp = 0;
+int buttonDown = 1;
+int buttonRight = 2;
+int buttonLeft = 3;
+int buttonCenter = 4;
+int ledBlue = 5;
+int ledGreen = 6;
+int ledRed = 7;
+
+void setup()
+{
+ Serial.begin(115200);
+ delay(250);
+ Serial.println("Qwiic Directional Pad Example");
+
+ Wire.begin();
+
+ // Initialize the PCA9554, default address = 0x20
+ if (io.begin() == false) //Device Address, Number of GPIO
+ {
+ Serial.println("PCA9554 not detected. Please check wiring. Freezing...");
+ while (1)
+ ;
+ }
+
+ io.pinMode(buttonUp, INPUT);
+ io.pinMode(buttonDown, INPUT);
+ io.pinMode(buttonLeft, INPUT);
+ io.pinMode(buttonRight, INPUT);
+ io.pinMode(buttonCenter, INPUT);
+ io.pinMode(ledRed, OUTPUT);
+ io.pinMode(ledGreen, OUTPUT);
+ io.pinMode(ledBlue, OUTPUT);
+
+ //By default, on the PA9557, IO 4567 are inverted
+ /*io.revert(buttonCenter); //Set to not inverted
+ io.revert(ledRed); //Set to not inverted
+ io.revert(ledGreen); //Set to not inverted
+ io.revert(ledBlue); //Set to not inverted*/
+
+ redOff();
+ greenOff();
+ blueOff();
+
+ Serial.println("Qwiic Directional Pad online!");
+}
+
+void loop()
+{
+ Serial.print("Button: ");
+
+ if (io.digitalRead(buttonUp) == LOW)
+ {
+ Serial.print("Up");
+ redOn();
+ greenOff();
+ blueOff();
+ }
+ else if (io.digitalRead(buttonDown) == LOW)
+ {
+ Serial.print("Down");
+ redOff();
+ greenOn();
+ blueOff();
+ }
+ else if (io.digitalRead(buttonLeft) == LOW)
+ {
+ Serial.print("Left");
+ redOn();
+ greenOff();
+ blueOn();
+ }
+ else if (io.digitalRead(buttonRight) == LOW)
+ {
+ Serial.print("Right");
+ redOff();
+ greenOn();
+ blueOn();
+ }
+ else if (io.digitalRead(buttonCenter) == LOW)
+ {
+ Serial.print("Center");
+ redOn();
+ greenOn();
+ blueOn();
+ }
+ else
+ {
+ Serial.print(" None");
+ redOff();
+ greenOff();
+ blueOff();
+ }
+ Serial.println();
+
+ delay(100);
+}
+
+void redOn()
+{
+ io.digitalWrite(ledRed, LOW);
+}
+void redOff()
+{
+ io.digitalWrite(ledRed, HIGH);
+}
+void greenOn()
+{
+ io.digitalWrite(ledGreen, LOW);
+}
+void greenOff()
+{
+ io.digitalWrite(ledGreen, HIGH);
+}
+void blueOn()
+{
+ io.digitalWrite(ledBlue, LOW);
+}
+void blueOff()
+{
+ io.digitalWrite(ledBlue, HIGH);
+}
+After uploading the code, open the Serial Monitor or terminal emulator of your choice with the baud rate set to 115200. Press on any of the buttons. You will notice a serial output indicating which button was pressed in the Arduino Serial Monitor. Looking to the board, you will notice the LED changing color with respect to the button press.
+ |
+
| Arduino Serial Output | +
Arduino
+This example assumes you are using the latest 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.
+ +Note
+If you've never connected an CH340 device to your computer before, you may need to install drivers for the USB-to-serial converter. Check out our section on "How to Install CH340 Drivers" for help with the installation.
+ +SparkFun has written a basic example for the Qwiic Directional Pad and is provided in the GitHub Hardware repository.
+ + +You will need the has written a library to work with the Qwiic Directional Pad. You can obtain this library through the Arduino Library Manager by searching for "SparkFun I2C Expander Arduino Library". Find the one written by SparkFun Electronics and install the latest version. Users who prefer to manually install the library can get it from the GitHub Repository or download the .ZIP by clicking the button below:
+ + + + + + + + + + + + + + + + + + + + + + + + + + +Spot something wrong? Feel free to contribute our open-source design and documentation. 
All of this documentation can be modified by you! Please help us make it better.
+docs folder of the SparkFun Qwiic Directional Pad repository.All of our designs are open-source! Please help us make it better.
+Hardware folder of the SparkFun Qwiic Directional Pad repository.Let's provided some recognition to the contributors for this project!
+
+
+
Spot something wrong? Please let us know. 
Attention
+This is not where customers should seek assistance on a product. If you require technical assistance or have questions about a product that is not working as expected, please head over to the SparkFun Technical Assistance page for some initial troubleshooting. +
If you can't find what you need there, you'll need a Forum Account to search product forums and post questions.
+All of this documentation can be modified by you! Please help us make it better.
+docs folder of the SparkFun Qwiic Directional Pad repository.If a section of the documentation is incorrect, please open an issue and let us know.
+All of our designs are open-source! Please help us make it better.
+Hardware folder of the SparkFun Qwiic Directional Pad repository.If part of the design is confusing, please open an issue and let us know.
+Need to download or print our hookup guide?
+*.pdf file, select the Printer or Destination labeled Save as PDF. (Instructions will vary based on the browser)In this section, we will go over how to connect to the Qwiic Directional Pad.
+Insert a Qwiic cable between your Arduino microcontroller and the Qwiic Directional Pad. In this case, we used the SparkFun IoT RedBoard - ESP32 Development Board for the Arduino microcontroller. When ready, connect a USB cable to the Arduino to program, power, and view serial messages.
+ |
+
| IoT RedBoard - ESP32 and Qwiic Directional Pad Connectedvia Qwiic | +
For temporary connections to the PTHs, you could use IC hooks to test out the pins. However, you'll need to solder headers or wires of your choice to the board for a secure connection. You can choose between a combination of header pins and jumper wires, or stripping wire and soldering the wire directly to the board.
+For users that want to notify the microcontroller that there is a button press, you could connect the INT pin to one of the Arduino's interrupts. In this case, we connected the Directional Pad's INT pin to IoT RedBoard's pin 4.
+ |
+
| IoT RedBoard - ESP32 and Qwiic Directional Pad Connected via Qwiic and Interrupt Pin | +
In this section, we will highlight the hardware and pins that are broken out on the SparkFun Qwiic Directional Pad. For more information, check out our Resources and Going Further on the components used on the breakout board.
+ |
+  |
+
| Top View | +Bottom View | +
To power the board, you will need 3.3V. You can connect a Qwiic cable to Qwiic connector on either side of the board or you can solder directly to the PTHs. Below are the power pins that are broken out on the edge of the board.
+ |
+ |
+
| Power and Ground Highlighted - Top View | +Power, Ground, and Qwiic Connector Highlighted - Bottom View | +
A low profile 5-way directional pad is populated on the top side of the board. These buttons are small! We recommend using your fingernail when pressing down on a button. Each pad includes a momentary push button that is read by the PCA9554 8-bit I2C I/O expander that is populated on the bottom of the board.
+ |
+
| 5-Way Directional Pad Highlighted - Top View | +
Note
+You can only press one button at a time! For example, if the UP button is pressed down, it will only register the UP button being pressed down. Once the UP button is released, the board will be able to read another button press.
+The TI PCA9554 that is populated on the bottom side of the board is an 8-bit I2C I/O expander that enables users to read and write to the following GPIO pins through I2C. It is used to read the 5-way directional pad or write to the non-addressable RGB LED. The I2C address of the PCA9554 is set to 0x20 by default. By adjusting the jumpers on the back of the board, the alternative address can be any value between 0x21 to 0x27.
+ |
+  |
+
| PCA9554 and Some GPIO Pins Highlighted Top and Bottom View |
+
The board includes two horizontal Qwiic connectors to connect to other Qwiic-enabled I2C devices. However, the board still breaks out 0.1"-spaced pins for users who prefer a soldered connection.
+ |
+  |
+
| Qwiic Connector, I2C, and PCA9554 Highlighted | +
As explained in the previous section, the I2C address of the PCA9554 is set to 0x20 by default. By adjusting the jumpers on the back of the board, the alternative address can be any value between 0x21 to 0x27.
+The interrupt pin labeled as INT is for users that want to notify a microcontroller that there is a button being pressed down on the 5-way directional pad. This pin is active low.
+ |
+  |
+
| Interrupt Highlighted - Top and Bottom View | +|
The board includes two LEDs on the top and bottom of the board. Both can be disabled with the jumpers on the back of the board.
+ |
+  |
+
| LEDs Highlighted Top and Bottom View | +|
Note
+If this is your first time working with jumpers, check out the How to Work with Jumper Pads and PCB Traces tutorial for more information.
+The back of the board includes jumpers to configure the board.
+ |
+
| Jumpers Highlighted Bottom View |
+
A 3D model of the board and components was exported to a STEP file using KiCad.
+ + + +The board is 1.0" x 1.0" (25.4mm x 25.4mm). There are 2x mounting holes. You can use 4-40 standoffs to mount the board to a panel or enclosure.
+ |
+
| Board Dimensions | +
The SparkFun Qwiic Directional Pad adds a 5-way directional pad to your I2C bus! When connected to a microcontroller, press down on the directional pad (up, down, left, right, or center) to provide additional input for your application. The built-in RGB status LED provides visual feedback indicating which button is pressed.
+In this tutorial, we'll go over the hardware and how to hookup the SparkFun Qwiic Directional Pad to an Arduino. We will also go over an Arduino example to get started.
+To follow along with this tutorial, you will need the following materials. You may not need everything though depending on what you have. Add it to your cart, read through the guide, and adjust the cart as necessary.
+For those that want to take advantage of the Qwiic connector, you'll want to grab a Qwiic cable. There are a variety of other cable lengths available in the SparkFun catalog to choose from.
+For users connecting to the plated through holes, you will need a soldering iron, solder, and general soldering accessories.
+Depending on your setup, you may want to use IC hooks for a temporary connection. However, you will want to solder header pins to connect devices to the plated through holes for a secure connection.
+If you aren't familiar with the Qwiic Connection System, we recommend reading here for an overview.
+
+ 
+ |
+
| + |
If you aren’t familiar with the following concepts, we also recommend checking out a few of these tutorials before continuing.
+Now that you've successfully got your SparkFun Qwiic Directional Pad up and running, it's time to incorporate it into your own project! For more information, check out the resources below:
+Or check out the Qwiic Button or Qwiic Joystick!
+Placeholder file for index redirect functionality.
"},{"location":"arduino_example/","title":"Arduino Example","text":"Now that we have our library and board add-on installed, we can start experimenting with the breakout board. For the scope of this tutorial, we will highlight the example provided in the GitHub hardware repo to get started.
"},{"location":"arduino_example/#upload-arduino-example","title":"Upload Arduino Example","text":"From your downloads, open the example labeled as Example1-ReadButtons.ino. This example reads the button presses and writes to the non-addressable LED using the PCA9554 I/O I2C Expander.
For users using an Arduino microcontroller, select your board in the Tools menu (in our case the SparkFun ESP32IoT RedBoard) and the correct Port it enumerated on.
You can also copy or paste the code as shown below. Then click \"Upload\".
+ 
+ 
+ 
+ 
+ 
+ 
+ 
+ 
+ 
+ 
+ 
+ 
+ 
+ 
+ 
+ 
+ 
+ 
+ 
+ 
+ 
+ 
+ 
+ 
+ 
+ 
+ 
+ 
+ /*\n Using the Qwiic Directional Pad\n By: Nathan Seidle\n SparkFun Electronics\n Date: October 8th, 2024\n\n License: This code is public domain but you buy me a beer if you use this and we meet someday (Beerware license).\n\n Feel like supporting our work? Buy a board from SparkFun!\n https://www.sparkfun.com/products/14733\n\n This example demonstrates how to use pinMode and digitalRead/Write to read the directional pad and turn\n on/off the RGB LED channels.\n\n Hardware Connections:\n Plug the Qwiic board to your Arduino/ESP32 or other\n Press the buttons\n Watch each LED turn on one-at-a-time\n*/\n\n#include <SparkFun_I2C_Expander_Arduino_Library.h> // Click here to get the library: http://librarymanager/All#SparkFun_I2C_Expander_Arduino_Library\n\nSFE_PCA95XX io; // Defaults to the PCA9554 at I2C address 0x20\n\nint buttonUp = 0;\nint buttonDown = 1;\nint buttonRight = 2;\nint buttonLeft = 3;\nint buttonCenter = 4;\nint ledBlue = 5;\nint ledGreen = 6;\nint ledRed = 7;\n\nvoid setup()\n{\n Serial.begin(115200);\n delay(250);\n Serial.println(\"Qwiic Directional Pad Example\");\n\n Wire.begin();\n\n // Initialize the PCA9554, default address = 0x20\n if (io.begin() == false) //Device Address, Number of GPIO\n {\n Serial.println(\"PCA9554 not detected. Please check wiring. Freezing...\");\n while (1)\n ;\n }\n\n io.pinMode(buttonUp, INPUT);\n io.pinMode(buttonDown, INPUT);\n io.pinMode(buttonLeft, INPUT);\n io.pinMode(buttonRight, INPUT);\n io.pinMode(buttonCenter, INPUT);\n io.pinMode(ledRed, OUTPUT);\n io.pinMode(ledGreen, OUTPUT);\n io.pinMode(ledBlue, OUTPUT);\n\n //By default, on the PA9557, IO 4567 are inverted\n /*io.revert(buttonCenter); //Set to not inverted\n io.revert(ledRed); //Set to not inverted\n io.revert(ledGreen); //Set to not inverted\n io.revert(ledBlue); //Set to not inverted*/\n\n redOff();\n greenOff();\n blueOff();\n\n Serial.println(\"Qwiic Directional Pad online!\");\n}\n\nvoid loop()\n{\n Serial.print(\"Button: \");\n\n if (io.digitalRead(buttonUp) == LOW)\n {\n Serial.print(\"Up\");\n redOn();\n greenOff();\n blueOff();\n }\n else if (io.digitalRead(buttonDown) == LOW)\n {\n Serial.print(\"Down\");\n redOff();\n greenOn();\n blueOff();\n }\n else if (io.digitalRead(buttonLeft) == LOW)\n {\n Serial.print(\"Left\");\n redOn();\n greenOff();\n blueOn();\n }\n else if (io.digitalRead(buttonRight) == LOW)\n {\n Serial.print(\"Right\");\n redOff();\n greenOn();\n blueOn();\n }\n else if (io.digitalRead(buttonCenter) == LOW)\n {\n Serial.print(\"Center\");\n redOn();\n greenOn();\n blueOn();\n }\n else\n {\n Serial.print(\" None\");\n redOff();\n greenOff();\n blueOff();\n }\n Serial.println();\n\n delay(100);\n}\n\nvoid redOn()\n{\n io.digitalWrite(ledRed, LOW);\n}\nvoid redOff()\n{\n io.digitalWrite(ledRed, HIGH);\n}\nvoid greenOn()\n{\n io.digitalWrite(ledGreen, LOW);\n}\nvoid greenOff()\n{\n io.digitalWrite(ledGreen, HIGH);\n}\nvoid blueOn()\n{\n io.digitalWrite(ledBlue, LOW);\n}\nvoid blueOff()\n{\n io.digitalWrite(ledBlue, HIGH);\n}\nAfter uploading the code, open the Serial Monitor or terminal emulator of your choice with the baud rate set to 115200. Press on any of the buttons. You will notice a serial output indicating which button was pressed in the Arduino Serial Monitor. Looking to the board, you will notice the LED changing color with respect to the button press.
Arduino Serial Output"},{"location":"arduino_library/","title":"Setting Up Arduino","text":"Arduino
This example assumes you are using the latest 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.
Note
If you've never connected an CH340 device to your computer before, you may need to install drivers for the USB-to-serial converter. Check out our section on \"How to Install CH340 Drivers\" for help with the installation.
SparkFun has written a basic example for the Qwiic Directional Pad and is provided in the GitHub Hardware repository.
SparkFun Qwiic Directional Pad: Example 1 - Read ButtonsYou will need the has written a library to work with the Qwiic Directional Pad. You can obtain this library through the Arduino Library Manager by searching for \"SparkFun I2C Expander Arduino Library\". Find the one written by SparkFun Electronics and install the latest version. Users who prefer to manually install the library can get it from the GitHub Repository or download the .ZIP by clicking the button below:
SparkFun Qwiic I2C Expander Arduino Library (ZIP)"},{"location":"hard_copy/","title":"Hard copy","text":"Need to download or print our hookup guide?
*.pdf file, select the Printer or Destination labeled Save as PDF. (Instructions will vary based on the browser)In this section, we will go over how to connect to the Qwiic Directional Pad.
"},{"location":"hardware_hookup/#connecting-via-qwiic","title":"Connecting Via Qwiic","text":"Insert a Qwiic cable between your Arduino microcontroller and the Qwiic Directional Pad. In this case, we used the SparkFun IoT RedBoard - ESP32 Development Board for the Arduino microcontroller. When ready, connect a USB cable to the Arduino to program, power, and view serial messages.
IoT RedBoard - ESP32 and Qwiic Directional Pad Connectedvia Qwiic"},{"location":"hardware_hookup/#connecting-via-pth","title":"Connecting via PTH","text":"For temporary connections to the PTHs, you could use IC hooks to test out the pins. However, you'll need to solder headers or wires of your choice to the board for a secure connection. You can choose between a combination of header pins and jumper wires, or stripping wire and soldering the wire directly to the board.
How to Solder: Through Hole Soldering
Working with Wire
For users that want to notify the microcontroller that there is a button press, you could connect the INT pin to one of the Arduino's interrupts. In this case, we connected the Directional Pad's INT pin to IoT RedBoard's pin 4.
IoT RedBoard - ESP32 and Qwiic Directional Pad Connected via Qwiic and Interrupt Pin"},{"location":"hardware_overview/","title":"Hardware Overview","text":"In this section, we will highlight the hardware and pins that are broken out on the SparkFun Qwiic Directional Pad. For more information, check out our Resources and Going Further on the components used on the breakout board.
Top View Bottom View"},{"location":"hardware_overview/#power","title":"Power","text":"To power the board, you will need 3.3V. You can connect a Qwiic cable to Qwiic connector on either side of the board or you can solder directly to the PTHs. Below are the power pins that are broken out on the edge of the board.
A low profile 5-way directional pad is populated on the top side of the board. These buttons are small! We recommend using your fingernail when pressing down on a button. Each pad includes a momentary push button that is read by the PCA9554 8-bit I2C I/O expander that is populated on the bottom of the board.
5-Way Directional Pad Highlighted - Top ViewNote
You can only press one button at a time! For example, if the UP button is pressed down, it will only register the UP button being pressed down. Once the UP button is released, the board will be able to read another button press.
"},{"location":"hardware_overview/#pca9554-8-bit-i2c-io-expander","title":"PCA9554 8-bit I2C I/O Expander","text":"The TI PCA9554 that is populated on the bottom side of the board is an 8-bit I2C I/O expander that enables users to read and write to the following GPIO pins through I2C. It is used to read the 5-way directional pad or write to the non-addressable RGB LED. The I2C address of the PCA9554 is set to 0x20 by default. By adjusting the jumpers on the back of the board, the alternative address can be any value between 0x21 to 0x27.
The board includes two horizontal Qwiic connectors to connect to other Qwiic-enabled I2C devices. However, the board still breaks out 0.1\"-spaced pins for users who prefer a soldered connection.
As explained in the previous section, the I2C address of the PCA9554 is set to 0x20 by default. By adjusting the jumpers on the back of the board, the alternative address can be any value between 0x21 to 0x27.
"},{"location":"hardware_overview/#interrupt","title":"Interrupt","text":"The interrupt pin labeled as INT is for users that want to notify a microcontroller that there is a button being pressed down on the 5-way directional pad. This pin is active low.
Interrupt Highlighted - Top and Bottom View"},{"location":"hardware_overview/#leds","title":"LEDs","text":"The board includes two LEDs on the top and bottom of the board. Both can be disabled with the jumpers on the back of the board.
Note
If this is your first time working with jumpers, check out the How to Work with Jumper Pads and PCB Traces tutorial for more information.
The back of the board includes jumpers to configure the board.
A 3D model of the board and components was exported to a STEP file using KiCad.
Click Here for the STEP File"},{"location":"hardware_overview/#board-dimensions","title":"Board Dimensions","text":"The board is 1.0\" x 1.0\" (25.4mm x 25.4mm). There are 2x mounting holes. You can use 4-40 standoffs to mount the board to a panel or enclosure.
Board Dimensions"},{"location":"introduction/","title":"Introduction","text":"The SparkFun Qwiic Directional Pad adds a 5-way directional pad to your I2C bus! When connected to a microcontroller, press down on the directional pad (up, down, left, right, or center) to provide additional input for your application. The built-in RGB status LED provides visual feedback indicating which button is pressed.
SparkFun Qwiic Directional Pad PRT-26784 Purchase from SparkFun
In this tutorial, we'll go over the hardware and how to hookup the SparkFun Qwiic Directional Pad to an Arduino. We will also go over an Arduino example to get started.
"},{"location":"introduction/#required-materials","title":"Required Materials","text":"To follow along with this tutorial, you will need the following materials. You may not need everything though depending on what you have. Add it to your cart, read through the guide, and adjust the cart as necessary.
Reversible USB A to C Cable - 2m CAB-15424
SparkFun IoT RedBoard - ESP32 Development Board WRL-19177
SparkFun Qwiic Directional Pad PRT-26784
Qwiic Cable - 100mm PRT-14427
For those that want to take advantage of the Qwiic connector, you'll want to grab a Qwiic cable. There are a variety of other cable lengths available in the SparkFun catalog to choose from.
SparkFun Qwiic Cable Kit KIT-15081
Qwiic Cable - 100mm PRT-14427
Qwiic Cable - 500mm PRT-14429
Qwiic Cable - Breadboard Jumper (4-pin) PRT-14425
For users connecting to the plated through holes, you will need a soldering iron, solder, and general soldering accessories.
PINECIL Soldering Iron Kit TOL-24063
Solder Lead Free - 15-gram Tube TOL-09163
Hook-Up Wire - Assortment (Stranded, 22 AWG) PRT-11375
Wire Strippers - 30AWG (Hakko) TOL-12630
Flush Cutters - Hakko TOL-11952
Digital Multimeter - Basic TOL-12966
Depending on your setup, you may want to use IC hooks for a temporary connection. However, you will want to solder header pins to connect devices to the plated through holes for a secure connection.
Breadboard - Self-Adhesive (White) PRT-12002
IC Hook with Pigtail CAB-09741
Break Away Male Headers - Right Angle PRT-00553
Female Headers PRT-00115
Jumper Wires Premium 6\" M/M Pack of 10 PRT-08431
Jumper Wires Premium 6\" M/F Pack of 10 PRT-09140
If you aren't familiar with the Qwiic Connection System, we recommend reading here for an overview.
Qwiic Connection SystemIf you aren\u2019t familiar with the following concepts, we also recommend checking out a few of these tutorials before continuing.
Installing Arduino IDE
IoT RedBoard ESP32 Development Board Hookup Guide
Installing Board Definitions in the Arduino IDE
How to Install CH340 Drivers
Processor Interrupts with Arduino
Logic Levels
Now that you've successfully got your SparkFun Qwiic Directional Pad up and running, it's time to incorporate it into your own project! For more information, check out the resources below:
Or check out the Qwiic Button or Qwiic Joystick!
SparkFun Qwiic Button Hookup Guide
Qwiic Joystick Hookup Guide
The SparkFun Qwiic Directional Pad adds a 5-way directional pad to your I2C bus! When connected to a microcontroller, press down on the directional pad (up, down, left, right, or center) to provide additional input for your application. The built-in RGB status LED provides visual feedback indicating which button is pressed.
SparkFun Qwiic Directional Pad PRT-26784 Purchase from SparkFun
In this tutorial, we'll go over the hardware and how to hookup the SparkFun Qwiic Directional Pad to an Arduino. We will also go over an Arduino example to get started.
"},{"location":"single_page/#required-materials","title":"Required Materials","text":"To follow along with this tutorial, you will need the following materials. You may not need everything though depending on what you have. Add it to your cart, read through the guide, and adjust the cart as necessary.
Reversible USB A to C Cable - 2m CAB-15424
SparkFun IoT RedBoard - ESP32 Development Board WRL-19177
SparkFun Qwiic Directional Pad PRT-26784
Qwiic Cable - 100mm PRT-14427
For those that want to take advantage of the Qwiic connector, you'll want to grab a Qwiic cable. There are a variety of other cable lengths available in the SparkFun catalog to choose from.
SparkFun Qwiic Cable Kit KIT-15081
Qwiic Cable - 100mm PRT-14427
Qwiic Cable - 500mm PRT-14429
Qwiic Cable - Breadboard Jumper (4-pin) PRT-14425
For users connecting to the plated through holes, you will need a soldering iron, solder, and general soldering accessories.
PINECIL Soldering Iron Kit TOL-24063
Solder Lead Free - 15-gram Tube TOL-09163
Hook-Up Wire - Assortment (Stranded, 22 AWG) PRT-11375
Wire Strippers - 30AWG (Hakko) TOL-12630
Flush Cutters - Hakko TOL-11952
Digital Multimeter - Basic TOL-12966
Depending on your setup, you may want to use IC hooks for a temporary connection. However, you will want to solder header pins to connect devices to the plated through holes for a secure connection.
Breadboard - Self-Adhesive (White) PRT-12002
IC Hook with Pigtail CAB-09741
Break Away Male Headers - Right Angle PRT-00553
Female Headers PRT-00115
Jumper Wires Premium 6\" M/M Pack of 10 PRT-08431
Jumper Wires Premium 6\" M/F Pack of 10 PRT-09140
If you aren't familiar with the Qwiic Connection System, we recommend reading here for an overview.
Qwiic Connection SystemIf you aren\u2019t familiar with the following concepts, we also recommend checking out a few of these tutorials before continuing.
Installing Arduino IDE
IoT RedBoard ESP32 Development Board Hookup Guide
Installing Board Definitions in the Arduino IDE
How to Install CH340 Drivers
Processor Interrupts with Arduino
Logic Levels
In this section, we will highlight the hardware and pins that are broken out on the SparkFun Qwiic Directional Pad. For more information, check out our Resources and Going Further on the components used on the breakout board.
Top View Bottom View"},{"location":"single_page/#power","title":"Power","text":"To power the board, you will need 3.3V. You can connect a Qwiic cable to Qwiic connector on either side of the board or you can solder directly to the PTHs. Below are the power pins that are broken out on the edge of the board.
A low profile 5-way directional pad is populated on the top side of the board. These buttons are small! We recommend using your fingernail when pressing down on a button. Each pad includes a momentary push button that is read by the PCA9554 8-bit I2C I/O expander that is populated on the bottom of the board.
5-Way Directional Pad Highlighted - Top ViewNote
You can only press one button at a time! For example, if the UP button is pressed down, it will only register the UP button being pressed down. Once the UP button is released, the board will be able to read another button press.
"},{"location":"single_page/#pca9554-8-bit-i2c-io-expander","title":"PCA9554 8-bit I2C I/O Expander","text":"The TI PCA9554 that is populated on the bottom side of the board is an 8-bit I2C I/O expander that enables users to read and write to the following GPIO pins through I2C. It is used to read the 5-way directional pad or write to the non-addressable RGB LED. The I2C address of the PCA9554 is set to 0x20 by default. By adjusting the jumpers on the back of the board, the alternative address can be any value between 0x21 to 0x27.
The board includes two horizontal Qwiic connectors to connect to other Qwiic-enabled I2C devices. However, the board still breaks out 0.1\"-spaced pins for users who prefer a soldered connection.
As explained in the previous section, the I2C address of the PCA9554 is set to 0x20 by default. By adjusting the jumpers on the back of the board, the alternative address can be any value between 0x21 to 0x27.
"},{"location":"single_page/#interrupt","title":"Interrupt","text":"The interrupt pin labeled as INT is for users that want to notify a microcontroller that there is a button being pressed down on the 5-way directional pad. This pin is active low.
Interrupt Highlighted - Top and Bottom View"},{"location":"single_page/#leds","title":"LEDs","text":"The board includes two LEDs on the top and bottom of the board. Both can be disabled with the jumpers on the back of the board.
Note
If this is your first time working with jumpers, check out the How to Work with Jumper Pads and PCB Traces tutorial for more information.
The back of the board includes jumpers to configure the board.
A 3D model of the board and components was exported to a STEP file using KiCad.
Click Here for the STEP File"},{"location":"single_page/#board-dimensions","title":"Board Dimensions","text":"The board is 1.0\" x 1.0\" (25.4mm x 25.4mm). There are 2x mounting holes. You can use 4-40 standoffs to mount the board to a panel or enclosure.
Board Dimensions"},{"location":"single_page/#hardware-hookup","title":"Hardware Hookup","text":"In this section, we will go over how to connect to the Qwiic Directional Pad.
"},{"location":"single_page/#connecting-via-qwiic","title":"Connecting Via Qwiic","text":"Insert a Qwiic cable between your Arduino microcontroller and the Qwiic Directional Pad. In this case, we used the SparkFun IoT RedBoard - ESP32 Development Board for the Arduino microcontroller. When ready, connect a USB cable to the Arduino to program, power, and view serial messages.
IoT RedBoard - ESP32 and Qwiic Directional Pad Connectedvia Qwiic"},{"location":"single_page/#connecting-via-pth","title":"Connecting via PTH","text":"For temporary connections to the PTHs, you could use IC hooks to test out the pins. However, you'll need to solder headers or wires of your choice to the board for a secure connection. You can choose between a combination of header pins and jumper wires, or stripping wire and soldering the wire directly to the board.
How to Solder: Through Hole Soldering
Working with Wire
For users that want to notify the microcontroller that there is a button press, you could connect the INT pin to one of the Arduino's interrupts. In this case, we connected the Directional Pad's INT pin to IoT RedBoard's pin 4.
IoT RedBoard - ESP32 and Qwiic Directional Pad Connected via Qwiic and Interrupt Pin"},{"location":"single_page/#setting-up-arduino","title":"Setting Up Arduino","text":"Arduino
This example assumes you are using the latest 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.
Note
If you've never connected an CH340 device to your computer before, you may need to install drivers for the USB-to-serial converter. Check out our section on \"How to Install CH340 Drivers\" for help with the installation.
SparkFun has written a basic example for the Qwiic Directional Pad and is provided in the GitHub Hardware repository.
SparkFun Qwiic Directional Pad: Example 1 - Read ButtonsYou will need the has written a library to work with the Qwiic Directional Pad. You can obtain this library through the Arduino Library Manager by searching for \"SparkFun I2C Expander Arduino Library\". Find the one written by SparkFun Electronics and install the latest version. Users who prefer to manually install the library can get it from the GitHub Repository or download the .ZIP by clicking the button below:
SparkFun Qwiic I2C Expander Arduino Library (ZIP)"},{"location":"single_page/#arduino-example","title":"Arduino Example","text":"Now that we have our library and board add-on installed, we can start experimenting with the breakout board. For the scope of this tutorial, we will highlight the example provided in the GitHub hardware repo to get started.
"},{"location":"single_page/#upload-arduino-example","title":"Upload Arduino Example","text":"From your downloads, open the example labeled as Example1-ReadButtons.ino. This example reads the button presses and writes to the non-addressable LED using the PCA9554 I/O I2C Expander.
For users using an Arduino microcontroller, select your board in the Tools menu (in our case the SparkFun ESP32IoT RedBoard) and the correct Port it enumerated on.
You can also copy or paste the code as shown below. Then click \"Upload\".
/*\n Using the Qwiic Directional Pad\n By: Nathan Seidle\n SparkFun Electronics\n Date: October 8th, 2024\n\n License: This code is public domain but you buy me a beer if you use this and we meet someday (Beerware license).\n\n Feel like supporting our work? Buy a board from SparkFun!\n https://www.sparkfun.com/products/14733\n\n This example demonstrates how to use pinMode and digitalRead/Write to read the directional pad and turn\n on/off the RGB LED channels.\n\n Hardware Connections:\n Plug the Qwiic board to your Arduino/ESP32 or other\n Press the buttons\n Watch each LED turn on one-at-a-time\n*/\n\n#include <SparkFun_I2C_Expander_Arduino_Library.h> // Click here to get the library: http://librarymanager/All#SparkFun_I2C_Expander_Arduino_Library\n\nSFE_PCA95XX io; // Defaults to the PCA9554 at I2C address 0x20\n\nint buttonUp = 0;\nint buttonDown = 1;\nint buttonRight = 2;\nint buttonLeft = 3;\nint buttonCenter = 4;\nint ledBlue = 5;\nint ledGreen = 6;\nint ledRed = 7;\n\nvoid setup()\n{\n Serial.begin(115200);\n delay(250);\n Serial.println(\"Qwiic Directional Pad Example\");\n\n Wire.begin();\n\n // Initialize the PCA9554, default address = 0x20\n if (io.begin() == false) //Device Address, Number of GPIO\n {\n Serial.println(\"PCA9554 not detected. Please check wiring. Freezing...\");\n while (1)\n ;\n }\n\n io.pinMode(buttonUp, INPUT);\n io.pinMode(buttonDown, INPUT);\n io.pinMode(buttonLeft, INPUT);\n io.pinMode(buttonRight, INPUT);\n io.pinMode(buttonCenter, INPUT);\n io.pinMode(ledRed, OUTPUT);\n io.pinMode(ledGreen, OUTPUT);\n io.pinMode(ledBlue, OUTPUT);\n\n //By default, on the PA9557, IO 4567 are inverted\n /*io.revert(buttonCenter); //Set to not inverted\n io.revert(ledRed); //Set to not inverted\n io.revert(ledGreen); //Set to not inverted\n io.revert(ledBlue); //Set to not inverted*/\n\n redOff();\n greenOff();\n blueOff();\n\n Serial.println(\"Qwiic Directional Pad online!\");\n}\n\nvoid loop()\n{\n Serial.print(\"Button: \");\n\n if (io.digitalRead(buttonUp) == LOW)\n {\n Serial.print(\"Up\");\n redOn();\n greenOff();\n blueOff();\n }\n else if (io.digitalRead(buttonDown) == LOW)\n {\n Serial.print(\"Down\");\n redOff();\n greenOn();\n blueOff();\n }\n else if (io.digitalRead(buttonLeft) == LOW)\n {\n Serial.print(\"Left\");\n redOn();\n greenOff();\n blueOn();\n }\n else if (io.digitalRead(buttonRight) == LOW)\n {\n Serial.print(\"Right\");\n redOff();\n greenOn();\n blueOn();\n }\n else if (io.digitalRead(buttonCenter) == LOW)\n {\n Serial.print(\"Center\");\n redOn();\n greenOn();\n blueOn();\n }\n else\n {\n Serial.print(\" None\");\n redOff();\n greenOff();\n blueOff();\n }\n Serial.println();\n\n delay(100);\n}\n\nvoid redOn()\n{\n io.digitalWrite(ledRed, LOW);\n}\nvoid redOff()\n{\n io.digitalWrite(ledRed, HIGH);\n}\nvoid greenOn()\n{\n io.digitalWrite(ledGreen, LOW);\n}\nvoid greenOff()\n{\n io.digitalWrite(ledGreen, HIGH);\n}\nvoid blueOn()\n{\n io.digitalWrite(ledBlue, LOW);\n}\nvoid blueOff()\n{\n io.digitalWrite(ledBlue, HIGH);\n}\nAfter uploading the code, open the Serial Monitor or terminal emulator of your choice with the baud rate set to 115200. Press on any of the buttons. You will notice a serial output indicating which button was pressed in the Arduino Serial Monitor. Looking to the board, you will notice the LED changing color with respect to the button press.
Arduino Serial Output"},{"location":"single_page/#troubleshooting","title":"Troubleshooting","text":""},{"location":"single_page/#general-troubleshooting-help","title":"General Troubleshooting Help","text":"Note
Not working as expected and need help?
If you need technical assistance and more information on a product that is not working as you expected, we recommend heading on over to the SparkFun Technical Assistance page for some initial troubleshooting.
SparkFun Technical Assistance Page
If you don't find what you need there, the SparkFun Forums are a great place to find and ask for help. If this is your first visit, you'll need to create a forum account to search product forums and post questions.
Log Into SparkFun Forums
"},{"location":"single_page/#resources","title":"Resources","text":"Now that you've successfully got your SparkFun Qwiic Directional Pad up and running, it's time to incorporate it into your own project! For more information, check out the resources below:
Or check out the Qwiic Button or Qwiic Joystick!
SparkFun Qwiic Button Hookup Guide
Qwiic Joystick Hookup Guide
Note
Not working as expected and need help?
If you need technical assistance and more information on a product that is not working as you expected, we recommend heading on over to the SparkFun Technical Assistance page for some initial troubleshooting.
SparkFun Technical Assistance Page
If you don't find what you need there, the SparkFun Forums are a great place to find and ask for help. If this is your first visit, you'll need to create a forum account to search product forums and post questions.
Log Into SparkFun Forums
"},{"location":"assets/component_documentation/","title":"SparkFun Documentation","text":"This directory should include any necessary datasheets, example number crunching, etc.
"},{"location":"github/contribute/","title":"Contribute: Help Fix our Mistake!","text":"Spot something wrong? Feel free to contribute our open-source design and documentation.
"},{"location":"github/contribute/#improve-our-documentation","title":"Improve our Documentation","text":"All of this documentation can be modified by you! Please help us make it better.
docs folder of the SparkFun Qwiic Directional Pad repository.All of our designs are open-source! Please help us make it better.
Hardware folder of the SparkFun Qwiic Directional Pad repository.Let's provided some recognition to the contributors for this project!
"},{"location":"github/file_issue/","title":"Did we make a mistake?","text":"
Spot something wrong? Please let us know.
Attention
This is not where customers should seek assistance on a product. If you require technical assistance or have questions about a product that is not working as expected, please head over to the SparkFun Technical Assistance page for some initial troubleshooting. SparkFun Technical Assistance Page
If you can't find what you need there, you'll need a Forum Account to search product forums and post questions.
"},{"location":"github/file_issue/#discrepancies-in-the-documentation","title":"Discrepancies in the Documentation","text":"All of this documentation can be modified by you! Please help us make it better.
docs folder of the SparkFun Qwiic Directional Pad repository.If a section of the documentation is incorrect, please open an issue and let us know.
"},{"location":"github/file_issue/#do-you-have-a-suggested-correction","title":"Do you have a suggested correction?","text":"All of our designs are open-source! Please help us make it better.
Hardware folder of the SparkFun Qwiic Directional Pad repository.If part of the design is confusing, please open an issue and let us know.
"},{"location":"github/file_issue/#did-we-forget-to-include-an-important-function-of-the-board","title":"Did we forget to include an important function of the board?","text":"This folder should contain the files for the custom javascript that is enabled in the product documentation
"}]} \ No newline at end of file diff --git a/single_page/index.html b/single_page/index.html new file mode 100644 index 0000000..51c6677 --- /dev/null +++ b/single_page/index.html @@ -0,0 +1,2220 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + +The SparkFun Qwiic Directional Pad adds a 5-way directional pad to your I2C bus! When connected to a microcontroller, press down on the directional pad (up, down, left, right, or center) to provide additional input for your application. The built-in RGB status LED provides visual feedback indicating which button is pressed.
+In this tutorial, we'll go over the hardware and how to hookup the SparkFun Qwiic Directional Pad to an Arduino. We will also go over an Arduino example to get started.
+To follow along with this tutorial, you will need the following materials. You may not need everything though depending on what you have. Add it to your cart, read through the guide, and adjust the cart as necessary.
+For those that want to take advantage of the Qwiic connector, you'll want to grab a Qwiic cable. There are a variety of other cable lengths available in the SparkFun catalog to choose from.
+For users connecting to the plated through holes, you will need a soldering iron, solder, and general soldering accessories.
+Depending on your setup, you may want to use IC hooks for a temporary connection. However, you will want to solder header pins to connect devices to the plated through holes for a secure connection.
+If you aren't familiar with the Qwiic Connection System, we recommend reading here for an overview.
+|
+
+ |
+
| + |
If you aren’t familiar with the following concepts, we also recommend checking out a few of these tutorials before continuing.
+In this section, we will highlight the hardware and pins that are broken out on the SparkFun Qwiic Directional Pad. For more information, check out our Resources and Going Further on the components used on the breakout board.
+ |
+ |
+
| Top View | +Bottom View | +
To power the board, you will need 3.3V. You can connect a Qwiic cable to Qwiic connector on either side of the board or you can solder directly to the PTHs. Below are the power pins that are broken out on the edge of the board.
+ |
+ |
+
| Power and Ground Highlighted - Top View | +Power, Ground, and Qwiic Connector Highlighted - Bottom View | +
A low profile 5-way directional pad is populated on the top side of the board. These buttons are small! We recommend using your fingernail when pressing down on a button. Each pad includes a momentary push button that is read by the PCA9554 8-bit I2C I/O expander that is populated on the bottom of the board.
+ |
+
| 5-Way Directional Pad Highlighted - Top View | +
Note
+You can only press one button at a time! For example, if the UP button is pressed down, it will only register the UP button being pressed down. Once the UP button is released, the board will be able to read another button press.
+The TI PCA9554 that is populated on the bottom side of the board is an 8-bit I2C I/O expander that enables users to read and write to the following GPIO pins through I2C. It is used to read the 5-way directional pad or write to the non-addressable RGB LED. The I2C address of the PCA9554 is set to 0x20 by default. By adjusting the jumpers on the back of the board, the alternative address can be any value between 0x21 to 0x27.
+ |
+ |
+
| PCA9554 and Some GPIO Pins Highlighted Top and Bottom View |
+
The board includes two horizontal Qwiic connectors to connect to other Qwiic-enabled I2C devices. However, the board still breaks out 0.1"-spaced pins for users who prefer a soldered connection.
+ |
+ |
+
| Qwiic Connector, I2C, and PCA9554 Highlighted | +
As explained in the previous section, the I2C address of the PCA9554 is set to 0x20 by default. By adjusting the jumpers on the back of the board, the alternative address can be any value between 0x21 to 0x27.
+The interrupt pin labeled as INT is for users that want to notify a microcontroller that there is a button being pressed down on the 5-way directional pad. This pin is active low.
+ |
+ |
+
| Interrupt Highlighted - Top and Bottom View | +|
The board includes two LEDs on the top and bottom of the board. Both can be disabled with the jumpers on the back of the board.
+ |
+ |
+
| LEDs Highlighted Top and Bottom View | +|
Note
+If this is your first time working with jumpers, check out the How to Work with Jumper Pads and PCB Traces tutorial for more information.
+The back of the board includes jumpers to configure the board.
+ |
+
| Jumpers Highlighted Bottom View |
+
A 3D model of the board and components was exported to a STEP file using KiCad.
+ + + +The board is 1.0" x 1.0" (25.4mm x 25.4mm). There are 2x mounting holes. You can use 4-40 standoffs to mount the board to a panel or enclosure.
+ |
+
| Board Dimensions | +
In this section, we will go over how to connect to the Qwiic Directional Pad.
+Insert a Qwiic cable between your Arduino microcontroller and the Qwiic Directional Pad. In this case, we used the SparkFun IoT RedBoard - ESP32 Development Board for the Arduino microcontroller. When ready, connect a USB cable to the Arduino to program, power, and view serial messages.
+ |
+
| IoT RedBoard - ESP32 and Qwiic Directional Pad Connectedvia Qwiic | +
For temporary connections to the PTHs, you could use IC hooks to test out the pins. However, you'll need to solder headers or wires of your choice to the board for a secure connection. You can choose between a combination of header pins and jumper wires, or stripping wire and soldering the wire directly to the board.
+For users that want to notify the microcontroller that there is a button press, you could connect the INT pin to one of the Arduino's interrupts. In this case, we connected the Directional Pad's INT pin to IoT RedBoard's pin 4.
+ |
+
| IoT RedBoard - ESP32 and Qwiic Directional Pad Connected via Qwiic and Interrupt Pin | +
Arduino
+This example assumes you are using the latest 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.
+ +Note
+If you've never connected an CH340 device to your computer before, you may need to install drivers for the USB-to-serial converter. Check out our section on "How to Install CH340 Drivers" for help with the installation.
+ +SparkFun has written a basic example for the Qwiic Directional Pad and is provided in the GitHub Hardware repository.
+ + +You will need the has written a library to work with the Qwiic Directional Pad. You can obtain this library through the Arduino Library Manager by searching for "SparkFun I2C Expander Arduino Library". Find the one written by SparkFun Electronics and install the latest version. Users who prefer to manually install the library can get it from the GitHub Repository or download the .ZIP by clicking the button below:
+ + +Now that we have our library and board add-on installed, we can start experimenting with the breakout board. For the scope of this tutorial, we will highlight the example provided in the GitHub hardware repo to get started.
+From your downloads, open the example labeled as Example1-ReadButtons.ino. This example reads the button presses and writes to the non-addressable LED using the PCA9554 I/O I2C Expander.
+For users using an Arduino microcontroller, select your board in the Tools menu (in our case the SparkFun ESP32IoT RedBoard) and the correct Port it enumerated on.
+You can also copy or paste the code as shown below. Then click "Upload".
+/*
+ Using the Qwiic Directional Pad
+ By: Nathan Seidle
+ SparkFun Electronics
+ Date: October 8th, 2024
+
+ License: This code is public domain but you buy me a beer if you use this and we meet someday (Beerware license).
+
+ Feel like supporting our work? Buy a board from SparkFun!
+ https://www.sparkfun.com/products/14733
+
+ This example demonstrates how to use pinMode and digitalRead/Write to read the directional pad and turn
+ on/off the RGB LED channels.
+
+ Hardware Connections:
+ Plug the Qwiic board to your Arduino/ESP32 or other
+ Press the buttons
+ Watch each LED turn on one-at-a-time
+*/
+
+#include <SparkFun_I2C_Expander_Arduino_Library.h> // Click here to get the library: http://librarymanager/All#SparkFun_I2C_Expander_Arduino_Library
+
+SFE_PCA95XX io; // Defaults to the PCA9554 at I2C address 0x20
+
+int buttonUp = 0;
+int buttonDown = 1;
+int buttonRight = 2;
+int buttonLeft = 3;
+int buttonCenter = 4;
+int ledBlue = 5;
+int ledGreen = 6;
+int ledRed = 7;
+
+void setup()
+{
+ Serial.begin(115200);
+ delay(250);
+ Serial.println("Qwiic Directional Pad Example");
+
+ Wire.begin();
+
+ // Initialize the PCA9554, default address = 0x20
+ if (io.begin() == false) //Device Address, Number of GPIO
+ {
+ Serial.println("PCA9554 not detected. Please check wiring. Freezing...");
+ while (1)
+ ;
+ }
+
+ io.pinMode(buttonUp, INPUT);
+ io.pinMode(buttonDown, INPUT);
+ io.pinMode(buttonLeft, INPUT);
+ io.pinMode(buttonRight, INPUT);
+ io.pinMode(buttonCenter, INPUT);
+ io.pinMode(ledRed, OUTPUT);
+ io.pinMode(ledGreen, OUTPUT);
+ io.pinMode(ledBlue, OUTPUT);
+
+ //By default, on the PA9557, IO 4567 are inverted
+ /*io.revert(buttonCenter); //Set to not inverted
+ io.revert(ledRed); //Set to not inverted
+ io.revert(ledGreen); //Set to not inverted
+ io.revert(ledBlue); //Set to not inverted*/
+
+ redOff();
+ greenOff();
+ blueOff();
+
+ Serial.println("Qwiic Directional Pad online!");
+}
+
+void loop()
+{
+ Serial.print("Button: ");
+
+ if (io.digitalRead(buttonUp) == LOW)
+ {
+ Serial.print("Up");
+ redOn();
+ greenOff();
+ blueOff();
+ }
+ else if (io.digitalRead(buttonDown) == LOW)
+ {
+ Serial.print("Down");
+ redOff();
+ greenOn();
+ blueOff();
+ }
+ else if (io.digitalRead(buttonLeft) == LOW)
+ {
+ Serial.print("Left");
+ redOn();
+ greenOff();
+ blueOn();
+ }
+ else if (io.digitalRead(buttonRight) == LOW)
+ {
+ Serial.print("Right");
+ redOff();
+ greenOn();
+ blueOn();
+ }
+ else if (io.digitalRead(buttonCenter) == LOW)
+ {
+ Serial.print("Center");
+ redOn();
+ greenOn();
+ blueOn();
+ }
+ else
+ {
+ Serial.print(" None");
+ redOff();
+ greenOff();
+ blueOff();
+ }
+ Serial.println();
+
+ delay(100);
+}
+
+void redOn()
+{
+ io.digitalWrite(ledRed, LOW);
+}
+void redOff()
+{
+ io.digitalWrite(ledRed, HIGH);
+}
+void greenOn()
+{
+ io.digitalWrite(ledGreen, LOW);
+}
+void greenOff()
+{
+ io.digitalWrite(ledGreen, HIGH);
+}
+void blueOn()
+{
+ io.digitalWrite(ledBlue, LOW);
+}
+void blueOff()
+{
+ io.digitalWrite(ledBlue, HIGH);
+}
+After uploading the code, open the Serial Monitor or terminal emulator of your choice with the baud rate set to 115200. Press on any of the buttons. You will notice a serial output indicating which button was pressed in the Arduino Serial Monitor. Looking to the board, you will notice the LED changing color with respect to the button press.
+ |
+
| Arduino Serial Output | +
Note
+
+ Not working as expected and need help?
If you need technical assistance and more information on a product that is not working as you expected, we recommend heading on over to the SparkFun Technical Assistance page for some initial troubleshooting.
If you don't find what you need there, the SparkFun Forums are a great place to find and ask for help. If this is your first visit, you'll need to create a forum account to search product forums and post questions.
Now that you've successfully got your SparkFun Qwiic Directional Pad up and running, it's time to incorporate it into your own project! For more information, check out the resources below:
+Or check out the Qwiic Button or Qwiic Joystick!
+Note
+
+ Not working as expected and need help?
If you need technical assistance and more information on a product that is not working as you expected, we recommend heading on over to the SparkFun Technical Assistance page for some initial troubleshooting.
If you don't find what you need there, the SparkFun Forums are a great place to find and ask for help. If this is your first visit, you'll need to create a forum account to search product forums and post questions.