X-Ring missing documentation

I recently bought a X-Ring WS2812B RGB on AliExpress.com. There is no information about the wiring or the bus how the X-Ring is controlled. So I did a little reverse engineering and want to share the information:
At first: the X-Ring is driven by a One-Wire connection.
There is a switch on the top:

The wiring is the following:

When I ordered they had “ESP8266, Wemos d1 mini” in the title. The board also has a Wemos-Logo on it. But it is not compatible to Wemos D1 mini. The widths do not match!

But you can easily mount an Wemos D1 mini to the board. I decided to connect the wemos to the bottom left side because then you can connect the Wemos D1 mini easily with wires to the board (5V, GND). You can choose to connect the Wemos D1 mini to RXD or TXD then (doesn’t matter). Basically all labels on the board are irrelevant for an Wemos D1 mini (except: 5V, GND) because it is not compatible.

 

The wiring on the pictures is as follows (how to read: on the left hand side the pin name on the ESP, right hand side the X-Ring):

GND->GND

5V->5V

D2->RXD(7)

Then you can start programming the X-Ring

And develop an own application for use with the X-Ring.

  8 comments for “X-Ring missing documentation

  1. 3rd September 2017 at 23:03

    Hello, I’ve just purchased an X-ring in Aliexpress with an ESP32. Unfortunately the ESP32 has broken so I will use it for the time being with an ESP8266 Lolin. Could you please show some code on how to use the X-Ring? I guess I need to program the X-Ring with one cable and connect it to a ESP8266 pin (plus GND and 5v). Do I need to mess with the microswitches on the X-Ring?

    Thanks a lot and best regards / Fernando

    • No3x
      9th September 2017 at 13:25

      Hi Fernando,
      you need 3 Wires: Of course connect GND, 5V according to my pictures. You have to choose a pin for the 1-Wire signal (please look carefully to the pin illustration I have made). In my case I have enabled pin 7 on the switch – that’s the RXD labeled pin on the X-Ring board. On the ESP I chose D2. The code is really simple due the Adafruit_NeoPixel library. I have added a simple example to the post that should run out of the box if you follow the wiring on my pictures.

    • No3x
      8th November 2017 at 09:20

      Thanks for the hint!

  2. Michal
    8th November 2017 at 13:02

    Hi,
    I’ve just wanted to thank you for your amazing write-up.
    Thanks to you I had my x-ring running in no time.

    Again Thank you very much.

    • No3x
      9th November 2017 at 14:38

      Hi Michal, thanks for your feedback! I’m really happy that it actually helps somebody. What are you going to develop with the X-Ring?

  3. Bjorn
    11th November 2017 at 00:41

    Hi,
    great info!!
    But on my x-ring, I only get one LED to change color following your setup.
    All the other LEDS are bright white.
    Any ideas whats wrong?

    • No3x
      11th November 2017 at 16:47

      Hi Bjorn, Miachel reported that the information helped him to setup the X-Ring and mine is working fine too. I can’t tell you what’s wrong. But if you get one LED to red the wiring should work. Maybe your X-Ring is broken and the LED after the first one are not connected to the bus properly. Please check the soldering to identify loose junctions.

Leave a Reply

Your email address will not be published. Required fields are marked *