# Adafruit NeoSlider ## Overview ![](https://cdn-learn.adafruit.com/assets/assets/000/107/144/medium800thumb/adafruit_products_NS_double_in_use.jpg?1638989398) Our family of I2C-friendly user interface elements grows by one with this new product that makes it plug-n-play-easy to add a 75mm long slide potentiometer to any microcontroller or microcomputer with an I2C port. ![](https://cdn-learn.adafruit.com/assets/assets/000/107/145/medium800/adafruit_products_NS_top_angle.jpg?1638989449) Each breakout is 3" long and 0.8" wide, with a single linear slide pot in the center. Underneath, there are four under-lighting NeoPixels that can display any RGB color. In the middle, a small microcontroller takes I2C commands and converts them to analog reads (of the potentiometer) and NeoPixel control. [Goes great with our Stemma QT rotary encoder](https://www.adafruit.com/product/4991) and [1x4 NeoKey QT breakout](https://www.adafruit.com/product/4980). ![](https://cdn-learn.adafruit.com/assets/assets/000/107/146/medium800/adafruit_products_NS_bottom.jpg?1638989458) Thanks to the Stemma QT / Qwiic connectors underneath, you can easily connect using QT cables - no soldering required! There's even four I2C selection jumpers that you can cut to change the address from the default 0x30 to any value up to 0x3F so up to 16 slide pots can all share one chained cable. ![](https://cdn-learn.adafruit.com/assets/assets/000/107/147/medium800/adafruit_products_NS_side.jpg?1638989467) To get you going fast, we spun up a custom-made PCB with the seesaw chip and all supporting circuitry for 3 or 5V power and logic. The [STEMMA QT connectors](https://learn.adafruit.com/introducing-adafruit-stemma-qt/what-is-stemma-qt) on either side are compatible with the [SparkFun Qwiic](https://www.sparkfun.com/qwiic) I2C connectors. This allows you to make solderless connections between your development board and the rotary encoder or to chain them with a wide range of other sensors and accessories using a [**compatible cable**](https://www.adafruit.com/?q=stemma%20qt%20cable). [QT Cable is not included, but we have a variety in the shop](https://www.adafruit.com/?q=stemma+qt+cable&sort=BestMatch). ![](https://cdn-learn.adafruit.com/assets/assets/000/107/148/medium800/adafruit_products_NS_side_size_reference.jpg?1638989487) [You can use our Arduino library to control and read data](https://github.com/adafruit/Adafruit_Seesaw) with any compatible microcontroller. [We also have CircuitPython/Python code](https://github.com/adafruit/Adafruit_CircuitPython_seesaw) for use with computers or single-board Linux boards. # Adafruit NeoSlider ## Pinouts ![](https://cdn-learn.adafruit.com/assets/assets/000/107/175/medium800/adafruit_products_NS_pinouts_guide.jpg?1639086475) The NeoSlider has STEMMA QT connectors on it which make getting started with it super simple, but it also has header pins available for breadboard use. This page details the features of the NeoSlider. ## Slide Potentiometer ![](https://cdn-learn.adafruit.com/assets/assets/000/107/176/medium800/adafruit_products_NS_slide_potentiometer.jpg?1639087213) On the top of the NeoSlider is the 75mm long linear **slide potentiometer**. It is on pin **18** of the ATtiny microcontroller. ## NeoPixel LEDs ![](https://cdn-learn.adafruit.com/assets/assets/000/107/177/medium800/adafruit_products_NS_NeoPixels.jpg?1639087445) Along the bottom, under the slide potentiometer, are **four RGB NeoPixel LEDs**. They are reverse-mount, and attached to the bottom pointed upward to shine through the board and potentiometer. They are on pin **14** on the ATtiny microcontroller. ## STEMMA QT Connectors ![](https://cdn-learn.adafruit.com/assets/assets/000/107/178/medium800/adafruit_products_NS_STEMMA_QT.jpg?1639087554) On the bottom of the board, located one-third of the way from each end of the board, are **two STEMMA QT connectors**. These allow you to connect to development boards with [STEMMA QT](https://learn.adafruit.com/introducing-adafruit-stemma-qt) connectors or to [other breakouts](https://www.adafruit.com/category/1018) using [various associated accessories](https://www.adafruit.com/?q=JST%20SH%204). ## ATtiny Microcontroller ![](https://cdn-learn.adafruit.com/assets/assets/000/107/179/medium800/adafruit_products_NS_ATtiny.jpg?1639088103) The NeoSlider breakout uses an **ATtiny817 microcontroller** to take I2C commands and converts them to analog reads (of the potentiometer) and for NeoPixel control. ## Through-Hole Pads ![](https://cdn-learn.adafruit.com/assets/assets/000/107/181/medium800/adafruit_products_NS_through-hole_pads_top.jpg?1639088173) ![](https://cdn-learn.adafruit.com/assets/assets/000/107/182/medium800/adafruit_products_NS_through-hole_pads_bottom.jpg?1639088181) In the center of the board, on each edge, are a set of **six through-hole pads** for use with header pins and a solderless breadboard. They are labeled on the top and the bottom of the board for easy identification. When viewed from the of the top of the board: - **VIN** - This is the **power pin**. Since the chip can use 3 or 5 VDC. To power the board, give it the same power as the logic level of your microcontroller - e.g. for a 5V microcontroller like Arduino, use 5V. - **GND** - This is the  **ground** pin. It is the common ground for power and logic. - **SCL** - This is the **I2C clock pin**. Connect to your microcontroller I2C clock line. This pin can use 3-5V logic, and there's a **10K pullup** on this pin to VIN. - **SDA** - This is the **I2C data pin**. Connect to your microcontroller I2C data line. This pin can use 3-5V logic, and there's a **10K pullup** on this pin to VIN. - **INT** - This is the interrupt pin. The Seesaw allows for setting GPIO interrupts. This pin will go low when a button is pressed. - **UPDI** - This is the single-pin **U** nified **P** rogram and **D** ebug **I** nterface for the ATtiny817. This pin is for external programming or on-chip-debugging. ## Address Jumpers ![](https://cdn-learn.adafruit.com/assets/assets/000/107/183/medium800/adafruit_products_NS_address_jumpers.jpg?1639088206) In the center of the back of the board are **four address jumpers**. These jumpers allow you to chain up to 16 of these boards on the same pair of I2C clock and data pins. To do so, you cut the traces between the the two pads. The default I2C address is **0x30**. The other address options can be calculated by “adding” the **A0/A1/A2/A3** to the base of **0x30**. **A0** sets the lowest bit with a value of **1** , **A1** sets the next bit with a value of **2** , **A2** sets the next bit with a value of **4** , and **A3** sets the high bit with a value of **8**. The final address is **0x30 + A3 + A2 + A1 + A0** which would be **0x3F**. - 
If only **A0** is cut, the address is **0x30 + 1 = 0x31** - 
If only **A1** is cut, the address is **0x30 + 2 = 0x32** - 
If only **A2** is cut, the address is **0x30 + 4 = 0x34** - If only **A3** is cut, the address is **0x30 + 8 = 0x38** 
So for example if **A2** is cut and **A0** is cut, the address is **0x30 + 4 + 1 = 0x35**. The table below shows all possible addresses, and whether the pin should be high (cut) or low (closed). ![](https://cdn-learn.adafruit.com/assets/assets/000/107/187/medium800/adafruit_products_seesaw_possible_addresses_by_pin_setting.png?1639153398) ## Power LED and Jumper ![](https://cdn-learn.adafruit.com/assets/assets/000/107/184/medium800/adafruit_products_NS_power_LED_and_jumper.jpg?1639088237) In the lower left corner, on the back of the board, is the **power LED** , labeled **on**. To the left of the LED is the **power LED jumper pad** , which defaults to closed. Cut the trace to disable the power LED. Once cut, you can solder it closed again to enable the LED. # Adafruit NeoSlider ## Python & CircuitPython It's easy to use the NeoSlider with CircuitPython using the [Adafruit CircuitPython seesaw](https://github.com/adafruit/Adafruit_CircuitPython_seesaw) library. It allows you to write Python code to read the potentiometer values and control the NeoPixel LEDs. You can use the NeoSlider with any CircuitPython microcontroller board or with a computer that has GPIO and Python [thanks to Adafruit\_Blinka, our CircuitPython-for-Python compatibility library](https://learn.adafruit.com/circuitpython-on-raspberrypi-linux). ## CircuitPython Microcontroller Wiring First wire up a NeoSlider breakout to your board exactly as follows. The following is the breakout wired to a Feather using the STEMMA connector: - **Board 3V**  to **breakout VIN (red wire)** - **Board GND**  to **breakout GND (black wire)** - **Board SCL**  to **breakout SCL (yellow wire)** - **Board SDA**  to **breakout SDA (blue wire)** ![adafruit_products_NS_Feather_STEMMA_bb.jpg](https://cdn-learn.adafruit.com/assets/assets/000/107/195/medium640/adafruit_products_NS_Feather_STEMMA_bb.jpg?1639155565) The following is the breakout wired to a Feather using a solderless breadboard: - **Board 3V**  to **breakout VIN (red wire)** - **Board GND**  to **breakout GND (black wire)** - **Board SCL**  to **breakout SCL (yellow wire)** - **Board SDA**  to **breakout SDA (blue wire)** ![adafruit_products_NS_Feather_breadboard_bb.jpg](https://cdn-learn.adafruit.com/assets/assets/000/107/196/medium640/adafruit_products_NS_Feather_breadboard_bb.jpg?1639155607) ## Python Computer Wiring Since there's _dozens_ of Linux computers/boards you can use we will show wiring for Raspberry Pi. For other platforms, [please visit the guide for CircuitPython on Linux to see whether your platform is supported](https://learn.adafruit.com/circuitpython-on-raspberrypi-linux).  Here's the Raspberry Pi wired with I2C using the STEMMA connector: - **Pi 3V**  to **breakout VIN (red wire)** - **Pi GND**  to **breakout GND (black wire)** - **Pi SCL**  to **breakout SCL (yellow wire)** - **Pi SDA**  to **breakout SDA (blue wire)** ![adafruit_products_NS_RasPi_STEMMA_bb.jpg](https://cdn-learn.adafruit.com/assets/assets/000/107/197/medium640/adafruit_products_NS_RasPi_STEMMA_bb.jpg?1639155646) Here's the Raspberry Pi wired with I2C using a solderless breadboard: - **Pi 3V**  to **breakout VIN (red wire)** - **Pi GND**  to **breakout GND (black wire)** - **Pi SCL**  to **breakout SCL (yellow wire)** - **Pi SDA**  to **breakout SDA (blue wire)** ![adafruit_products_NS_RasPi_breadboard_bb.jpg](https://cdn-learn.adafruit.com/assets/assets/000/107/199/medium640/adafruit_products_NS_RasPi_breadboard_bb.jpg?1639155716) ## Python Installation of seesaw Library You'll need to install the **Adafruit\_Blinka** library that provides the CircuitPython support in Python. This may also require enabling I2C on your platform and verifying you are running Python 3. [Since each platform is a little different, and Linux changes often, please visit the CircuitPython on Linux guide to get your computer ready](https://learn.adafruit.com/circuitpython-on-raspberrypi-linux)! Once that's done, from your command line run the following command: - `pip3 install adafruit-circuitpython-seesaw` If your default Python is version 3 you may need to run `pip` instead. Just make sure you aren't trying to use CircuitPython on Python 2.x, it isn't supported! ## CircuitPython & Python Usage To demonstrate using this breakout with CircuitPython, you'll install the necessary libraries, update your code, and then [connect to the serial console](https://learn.adafruit.com/welcome-to-circuitpython/kattni-connecting-to-the-serial-console) to see the information printed out. To use the NeoSlider breakout with CircuitPython, you need to first install the seesaw library, and its dependencies, into the **lib** folder on your **CIRCUITPY** drive. Then you need to update **code.py**. Click the **Download Project Bundle** button below to download the necessary libraries and the **code.py** file in a zip file. Extract the contents of the zip file, and copy the **entire** **lib** **folder** and the **code.py** file to your **CIRCUITPY** drive. https://github.com/adafruit/Adafruit_Learning_System_Guides/blob/main/Adafruit_NeoSlider/CircuitPython_Rainbow_Slider/code.py ![](https://cdn-learn.adafruit.com/assets/assets/000/107/270/medium800thumb/adafruit_products_NS_single_in_use.jpg?1639179624) Now, [connect to the serial console](https://learn.adafruit.com/welcome-to-circuitpython/kattni-connecting-to-the-serial-console) to see the potentiometer values printed out. Try moving the potentiometer slider to see the values change, and the NeoPixels change color! That's all there is to using the NeoSlider with CircuitPython to read potentiometer values and control the built-in NeoPixels! # Adafruit NeoSlider ## Neocontroller Color Grading Input Box # Adafruit NeoSlider ## Python Docs # Adafruit NeoSlider ## Arduino The Adafruit NeoSlider uses a seesaw chip. To use the NeoSlider with Arduino, you'll use the Adafruit Seesaw library. With the STEMMA QT connectors, you can easily get started with no soldering necessary! ## I2C Wiring Here is how to wire up the breakout using one of the [**STEMMA QT**](https://learn.adafruit.com/introducing-adafruit-stemma-qt) connectors. The examples show a Metro but wiring will work the same for an Arduino or other compatible board. - Connect **board VIN (red wire)** to  **Arduino 5V**  if you are running a **5V** board Arduino (Uno, etc.). If your board is **3V,** connect to that instead. - Connect **board GND (black wire) **to  **Arduino** **GND** - Connect **board SCL (yellow wire) **to  **Arduino** **SCL** - Connect **board SDA (blue wire) **to  **Arduino** **SDA** ![adafruit_products_NS_Arduino_STEMMA_bb.jpg](https://cdn-learn.adafruit.com/assets/assets/000/107/266/medium640/adafruit_products_NS_Arduino_STEMMA_bb.jpg?1639179297) Here is how to wire the breakout to a board using a solderless breadboard. To do this, you must solder header pins to the breakout. - Connect **board VIN (red wire)** to  **Arduino 5V**  if you are running a **5V** board Arduino (Uno, etc.). If your board is **3V,** connect to that instead. - Connect **board GND (black wire) **to  **Arduino** **GND** - Connect **board SCL (yellow wire) **to  **Arduino** **SCL** - Connect **board SDA (blue wire) **to  **Arduino** **SDA** ![adafruit_products_NS_Arduino_breadboard_bb.jpg](https://cdn-learn.adafruit.com/assets/assets/000/107/267/medium640/adafruit_products_NS_Arduino_breadboard_bb.jpg?1639179325) ## Library Installation You can install the Adafruit Seesaw library for Arduino using the Library Manager in the Arduino IDE. ![](https://cdn-learn.adafruit.com/assets/assets/000/107/213/medium800/adafruit_products_Arduino_Open_Library_Manager.png?1639172849) Click the  **Manage Libraries ...** menu item, search for **seesaw** , and select the  **Adafruit** **seesaw** library: ![](https://cdn-learn.adafruit.com/assets/assets/000/107/215/medium800/adafruit_products_NS_Arduino_seesaw_library_install.png?1639172925) When asked to install the Adafruit Seesaw library dependencies, click **Install all**. ![](https://cdn-learn.adafruit.com/assets/assets/000/107/214/medium800/adafruit_products_Arduino_seesaw_dependencies.png?1639172884) ## Load Single NeoSlider Example Open the following example into the Arduino IDE. https://github.com/adafruit/Adafruit_Seesaw/blob/master/examples/NeoSlider/NeoSlider/NeoSlider.ino After opening the **NeoSlider.ino** file, upload it to the Arduino wired to your NeoSlider. Open the **Serial Monitor** at **115200 baud**. You should see the following as the sketch starts up. ![](https://cdn-learn.adafruit.com/assets/assets/000/107/216/medium800/adafruit_products_NS_Arduino_NeoSlider_serial_output.png?1639173105) Now try moving the potentiometer to see the values change and the NeoPixels change color. ![](https://cdn-learn.adafruit.com/assets/assets/000/107/264/medium800/adafruit_products_NS_Arduino_move_potentiometer.png?1639178878) That's all there is to using the NeoSlider with Arduino! # Dual NeoSlider Example The Adafruit NeoSlider comes with two STEMMA QT connectors, making it super simple to chain up multiple sliders. ## Dual I2C Wiring Here is how to wire up two breakouts using two of the [**STEMMA QT**](https://learn.adafruit.com/introducing-adafruit-stemma-qt) connectors. The examples show a Metro but wiring will work the same for an Arduino or other compatible board. - **Board 1 VIN (red wire)** to  **Arduino 5V** - **Board 1 GND (black wire)** to  **Arduino** **GND** - **Board 1 SCL (yellow wire)** to  **Arduino** **SCL** - **Board 1 SDA (blue wire)** to  **Arduino** **SDA** - **Board 2 VIN (red wire)** to **board 1 VIN** - **Board 2 GND (black wire)** to **board 1 GND** - **Board 2 SCL (yellow wire)** to **board 1 SCL** - **Board 2 SDA (blue wire)** to **board 1 SDA** ![adafruit_products_NS_Arduino_dual_STEMMA_bb.jpg](https://cdn-learn.adafruit.com/assets/assets/000/107/265/medium640/adafruit_products_NS_Arduino_dual_STEMMA_bb.jpg?1639179158) Info: ## Load Dual NeoSlider Example Open the following example into the Arduino IDE.  https://github.com/adafruit/Adafruit_Seesaw/blob/master/examples/NeoSlider/Dual_NeoSlider/Dual_NeoSlider.ino After opening the **Arduino\_NeoSlider\_Dual** file, upload it to the Arduino wired to your NeoSlider. Open the **Serial Monitor** at **115200 baud** to see the potentiometer values printed out. ![](https://cdn-learn.adafruit.com/assets/assets/000/107/268/medium800/adafruit_products_NS_Arduino_Dual_Slider_serial_output.png?1639179538) Try moving the sliders to see the values and the NeoPixel colors change. That's all there is to using two NeoSliders with Arduino! # Adafruit NeoSlider ## Arduino Docs # Adafruit NeoSlider ## Downloads ## Files - [ATtiny817 datasheet](https://cdn-learn.adafruit.com/assets/assets/000/105/460/original/ATtiny417-814-816-817-DataSheet-DS40002288A.pdf?1634157151) - [EagleCAD PCB files on GitHub](https://github.com/adafruit/Adafruit-NeoSlider-PCB) - [3D Models on GitHub](https://github.com/adafruit/Adafruit_CAD_Parts/tree/main/5295%20NeoSlider%20Stemma) - [Fritizing object in the Adafruit Fritzing Library](https://github.com/adafruit/Fritzing-Library/blob/master/parts/Adafruit%20NeoSlider.fzpz) - [Firmware running on the seesaw](https://github.com/adafruit/Adafruit_seesawPeripheral/blob/main/examples/example_pid5295/example_pid5295.ino) # Schematic and Fab Print ![](https://cdn-learn.adafruit.com/assets/assets/000/107/185/medium800/adafruit_products_NS_sch.png?1639094096) ![](https://cdn-learn.adafruit.com/assets/assets/000/107/186/medium800/adafruit_products_NS_fab_print.png?1639094107) ![](https://cdn-learn.adafruit.com/assets/assets/000/115/446/medium800/adafruit_products_5295_NeoSlider_Stemma.jpg?1664369029) ## Primary Products ### Adafruit NeoSlider I2C QT Slide Potentiometer with 4 NeoPixels [Adafruit NeoSlider I2C QT Slide Potentiometer with 4 NeoPixels](https://www.adafruit.com/product/5295) Our family of I2C-friendly user interface elements grows by one with this new product that makes it plug-n-play-easy to add a 75mm long slide potentiometer to any microcontroller or microcomputer with an I2C port. Each breakout is 3" long and 0.8" wide, with a single linear... In Stock [Buy Now](https://www.adafruit.com/product/5295) [Related Guides to the Product](https://learn.adafruit.com/products/5295/guides) ## Related Guides - [Raspberry Pi Video Synth with Blinka and Processing](https://learn.adafruit.com/raspberry-pi-video-synth-with-blinka-and-processing.md) - [Neocontroller Color Grading Input Box](https://learn.adafruit.com/neocontroller-color-grading-input-box.md) - [CircuitPython Trombone Champ Controller](https://learn.adafruit.com/circuitpython-trombone-champ-controller.md) - [Circuit Playground Express: Piano in the Key of Lime](https://learn.adafruit.com/circuit-playground-express-piano-in-the-key-of-lime.md) - [Adafruit QMC5883P - Triple Axis Magnetometer](https://learn.adafruit.com/adafruit-qmc5883p-triple-axis-magnetometer.md) - [Labo Piano Light FX](https://learn.adafruit.com/labo-piano-light-fx.md) - [TV-B-Gone Kit](https://learn.adafruit.com/tv-b-gone-kit.md) - [CircuitPython Essentials](https://learn.adafruit.com/circuitpython-essentials.md) - [Adafruit LSM6DS3TR-C + LIS3MDL - Precision 9 DoF IMU](https://learn.adafruit.com/adafruit-lsm6ds3tr-c-lis3mdl-precision-9-dof-imu.md) - [How to Add a New Board to CircuitPython](https://learn.adafruit.com/how-to-add-a-new-board-to-circuitpython.md) - [NeoPixel LED Mickey Ears](https://learn.adafruit.com/neopixel-led-mickey-ears.md) - [AD8495 Analog Output K-Type Thermocouple Amplifier](https://learn.adafruit.com/ad8495-thermocouple-amplifier.md) - [Adafruit TRRS Trinkey](https://learn.adafruit.com/adafruit-trrs-trinkey.md) - [Adafruit Mini I2C STEMMA QT Gamepad with seesaw](https://learn.adafruit.com/gamepad-qt.md) - [ST 9-DoF Combo Breakouts and Wings](https://learn.adafruit.com/st-9-dof-combo.md)