# Blinkin Getting Started ## Connections
Image of Blinkin LED Driver pointing to locations of buttons and ports listed in the table below
| **Mode/Up Button** | Switch between normal running mode and set-up mode. | | ---------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | **Strip Select/Down Button** | Switch which kind of LED strip is being controlled. | | **XT30 Power Input** | Connect to a 12V nominal battery or other equivalent power source. | | **PWM Input** | Provide a standard servo-style PWM signal to control the LED output pattern/color. | | **Status Indicator** | RGB LED mode indicator. See Setup and Configuration for colors and meanings. | | **Setup and Adjustment** | Three potentiometers are used to set customer color palette colors and addressable strip length in set-up mode, and are used to adjust brightness and other pattern properties like speed and pattern density during normal operation | | **5V/12V LED Indicators** | Indicate which kind of strip is currently selected as the output type | | **LED Strip Connection** | Use the included JST PH, 7-pin to JST SM pigtail connector to connect to LED strip(s). | ## Setup and Configuration 1. Connect 12V power to the Blinkin using an XT30 Cable 2. Select either a 12V or 5V Addressable LED strip and connect it to the 7-Pin JST PH Port using a [Blinkin LED Cable Adapter (REV-11-1196)](https://www.revrobotics.com/rev-11-1196/) 3. If the LED output indicator for the 12V/5V strip which is connected is not lit, press and hold the Strip Select button until the corresponding strip indicator LED is lit. Your LED strip should now be displaying the default pattern (29 - Color Waves, Party Palette), or the user programmed default pattern. ![](https://1166281274-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-ME3KPEhFI6-MDoP9nZD%2F-MlGPz1CWYuGxiyb512o%2F-MlGRGZTtqyDwm-O_Z0W%2FREV-11-1105-1.png?alt=media\&token=6cd3f034-26b6-4e07-beff-e55458cfc726) ![](https://1166281274-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-ME3KPEhFI6-MDoP9nZD%2F-MlGPz1CWYuGxiyb512o%2F-MlGRKln21pkFSMm3xLA%2FREV-11-1105-2.png?alt=media\&token=ffe69680-240d-4720-b466-fe2e6f679c55) 4. With no input PWM active (blue blinking Status LED), clicking (short press) the Up (Mode) and Down (Strip Select) buttons will change the pattern being displayed (See[ LED Pattern Tables](https://docs.revrobotics.com/rev-crossover-products/blinkin/gs/patterns)). This pattern will reset to the default after a power cycle unless the default is changed using the setup mode. ![](https://1166281274-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-ME3KPEhFI6-MDoP9nZD%2F-MlGPz1CWYuGxiyb512o%2F-MlGRQ2rQdeDllSsKLVE%2FREV-11-1105-3.png?alt=media\&token=1340d7c2-186d-440c-9486-b86cdaa0a53c) ## Setup Mode In addition to the pre-programmed fixed color palette patterns, the Blinkin can be customized to use user selected colors and strip length to create more unique look. These settings can be saved in to permanent memory so they persist through power cycles. #### Setup Mode Features * **Addressable Strip Length** - Up to 240 WS2812 LEDs * **Team Colors** - Select two of 22 different color options to represent your team * **Default No Signal Pattern** - Select which pattern is displayed with there is not PWM input ### Setup Mode Steps 1. Power up the Blinkin as described in [Getting Started.](#getting-started) The LED strip selected cannot be changed during setup mode, so ensure that the desired strip is connected and running before continuing. ![](https://1166281274-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-ME3KPEhFI6-MDoP9nZD%2F-MlGPz1CWYuGxiyb512o%2F-MlGRh5CTO_tmoQclb1O%2FREV-11-1105-4.png?alt=media\&token=6b923f95-c639-482a-b48a-5b9681abd1df) 2. To enter Setup Mode, press and hold the Mode button for \~6 seconds, the Status LED will change from blue to yellow. The LED strip will automatically display pattern 75 (Color 1 and Color 2: no blending) which uses Color 1 and Color 2 to aid in configuration. ![](https://1166281274-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-ME3KPEhFI6-MDoP9nZD%2F-MlGPz1CWYuGxiyb512o%2F-MlGRkShn9bYuODj7k_h%2FREV-11-1105-5.png?alt=media\&token=17ff605a-e3d8-4895-b352-ff8aba85e77b) 3. Use a small screwdriver, like the one included, to adjust the Color 1, Color 2, and Length potentiometers * Left: Color 1 – Primary Pattern Color * Middle: Color 2 – Secondary Pattern Color * Right: Addressable Strip Number of LEDs (1-240) ![](https://1166281274-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-ME3KPEhFI6-MDoP9nZD%2F-MlGPz1CWYuGxiyb512o%2F-MlGRvetCfgtO5u4RHnU%2FREV-11-1105-6.png?alt=media\&token=3addce38-9807-4a38-8723-d3da4c59fd54) 4. With no input PWM signal (yellow blinking Status LED), select the default no signal pattern by clicking (short press) the Up (Mode) and Down (Strip Select) buttons until the desired pattern is displayed. ![](https://1166281274-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-ME3KPEhFI6-MDoP9nZD%2F-MlGPz1CWYuGxiyb512o%2F-MlGS8tss1mDnm1v5e3V%2FREV-11-1105-7.png?alt=media\&token=25a4a47c-3104-42e8-a760-b9e46bf1018c) {% hint style="success" %} Leave the displayed pattern on the test pattern (75) on exit to leave the default no signal pattern unchanged. {% endhint %} ### Exiting Setup Mode * **Save and Exit:** Press and hold the Mode and Strip Select buttons for \~6 seconds. colors, strip length and new default no signal pattern values are permanently saved in EEPROM and will persist between power cycles. ![](https://1166281274-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-ME3KPEhFI6-MDoP9nZD%2F-MlGPz1CWYuGxiyb512o%2F-MlGSD5qjhGHQU1M1lZU%2FREV-11-1105-8.png?alt=media\&token=5a158fbb-d3ec-42c2-b164-02ad701b948a) * **Exit without Saving:** press and hold the Mode button. Nothing is saved and Blinkin will return to its previously saved state after power cycle. ![](https://1166281274-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-ME3KPEhFI6-MDoP9nZD%2F-MlGPz1CWYuGxiyb512o%2F-MlGSNtqrI-4BlVE558-%2FREV-11-1105-9.png?alt=media\&token=643e85e9-316f-4954-83a9-de3b25d3b6cf) {% hint style="success" %} The **Status LED** will return to blue when Setup Mode has been exited {% endhint %} ## PWM Control The Blinkin can be controlled via software using a standard servo-style PWM signal. The Blinkin measures the width of the incoming pulse from the PWM signal, and then based on that value selects a pattern from a corresponding pattern table. Valid input pulse widths are from 1000us to 2000us. 1.) Connect the Blinkin to a PWM control port on the robot controller, such as a Control Hub or roboRIO, using a standard PWM cable. 2.) Using the programming language of your choice, generate a PWM signal. {% hint style="info" %} For use with the FRC Control System and WPILib, create a motor of type SPARK. (Other Motor and Servo types will work, but might change the values associated with specific patterns) {% endhint %} 3.) In your main robot code where motor (or servo) output power is normally updated, set your output power to the value corresponding to the pattern desired (see [The LED Pattern Tables](https://docs.revrobotics.com/rev-crossover-products/blinkin/gs/patterns)). ## Pattern Adjustments All of the LED strips and patterns can have their overall brightness adjusted and many of the patterns can be adjusted to change the pattern density and speed. The[ LED Pattern Table](https://docs.revrobotics.com/rev-crossover-products/blinkin/gs/patterns) details what patterns have which adjustments. 1. While your Blinkin is not in Setup Mode, select a pattern which is adjustable 2. Use a small screwdriver, like the one included, to adjust the Adj. 1, Adj. 2, and Brightness potentiometers ![](https://1166281274-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-ME3KPEhFI6-MDoP9nZD%2F-MlGPz1CWYuGxiyb512o%2F-MlGT3pwPpQv4dFNckFp%2FREV-11-1105-10.png?alt=media\&token=acd32788-b175-41a6-95fc-f9befcedd87f) {% hint style="info" %} Generally, the three potentiometers will adjust the following during Normal Operation: * Adj. 1 - Pattern Density, Pattern Width, or Dimming * Adj. 2 - Speed * Brightness - Brightness of the whole LED Strip {% endhint %}