Leave a comment

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

43 thoughts on “ESPixelStick V2 Assembly and Usage Manual

  • Brandon

    I have several strings of 100 ws2811 pixels. I have nodemcu boards that have 4 available I/O pins. Is it possible to use multiple pins to run pixels?

  • AJ Reynolds

    I had a power hit and blew out the regulators on 2 of my V2 ESPixelSticks, The PCB is fine but I need to replace the regulator, what part do I need to get to repair them? I’m unable to read the top due to a small hole that was created when they released the magic smoke.

  • kamal sonani

    hey Merrick,

    i found one silly spot on your “ESPSFlashTool.jar”
    when ssid & password’s value return values in string type make sure all characters are convert in string.

    Ex:- i have 2 ssid in my Lab
    esp is trying to join “Kmlu0027s_Lab” rather then
    SSID 1:- Kml’s_lab
    SSID 2:- Kml’s_Guest

    & “u0027s” >> is UNICODE value of ( ‘ )

    All n all Thanks for share your idea.


    Hello Shelby,
    My name is Henrique, I am from Brazil and I have little experience in use the ESP- Module.
    But I would like very much to do my own ESPixelStick and so I did the board using the schema of the Assembly and Usage.
    I did the first step and I did the upload how is wrote and until here nothing problem.
    But I have some doubt how can I use the web browse for to configure the IP and other information for that I can to use together with Xlight 4 and see my mini tree works.
    Please can you help me

      • HENRIQUE

        Hi Shelby,
        I am using the Flash tool,
        when I upload the information the Serial Output show me symbols and number that not have nothing how number the IP.

        Because this I don’t know what is number of IP that is in my Module.

        Do you know what can be happening ?

        Please help me.



        • Shelby Merrick Post author

          Configuration is stored in config.json in SPIFFS and if you’re compiling your own firmware, you can define a default SSID and Passphrase at the top of the sketch for fallback if there’s an issue connecting to your AP. If you’re compiling yourself, you have to “upload sketch data” to overwrite config.json in SPIFFS. If you’re using the pre-compiled version, there’s no hard-coded fallback config so you’ll have to re-flash using ESPS Flash Tool to reset it.

  • Tommy

    I’m getting an error when I run the ESPSFlashTool.jar file from the zip file. In version 2.0 I get three errors
    “Bad mode configuration: Firmware not found for mode Pixel (WS2811 / GECE)”
    “Bad mode configuration: Firmware not found form mode Serial (DMX/Renard)”
    “Failed deserialize: Unable to find ESPixelStick Configuration file”

    When I run the any of the 3.0 firmware I only get one error
    “Failed deserialize: Unable to find firmware configuration file”

    Can you please tell me what I need to do so I do not get these errors?

      • Tommy

        Thanks for the quick response. However I’ve already extracted the zip folder.
        I extracted it into a folder “ESPixelStick_Firmware-3.0rc2” in my home directory. Here is what is currently in the folder.

        ~/ESPixelStick_Firmware-3.0rc2$ ls
        bin espixelstick-3.0rc2-pixel.efu firmware README.md
        Changelog.html espixelstick-3.0rc2-serial.efu lib spiffs
        Changelog.md ESPSFlashTool.jar README.html

        Am I missing any files?

          • Tommy

            Looks like the configuration file is there. I guess the .jar file is just not reading it?

            ~/ESPixelStick_Firmware-3.0rc2/firmware$ ls
            firmware.json pixel-3.0rc2-1m_128k.bin README.md serial-3.0rc2-1m_128k.bin

            Also I’m not sure exactly what you mean by RC3…

          • Tommy

            Yes I’m running Ubuntu 17.04. Good question about instantiating it. Led me into getting it to work. So the errors come when I double click the .jar file in the folder. I was able to get it to work by running
            $ java -jar ESPSFlashTool.jar
            in the terminal from the directory.
            I’ve tried this in the 3.0 rc2 and rc3 and that worked in both of them.

            Thanks for your help!

  • Marc Severin

    Recently crossed the lines on a t connector while doing some power injection . I blew the fuse on the power distribution board but not on the espixelstick , now the espixelstick won’t start up. I swapped out the esp module to a different board and it still works, but I can’t get it power. Any ideas on where to start to fix the espixelstick?

  • Rob Orizino

    Hi Shelbly…I bought an ESPixelstick, hoping I could make it do what I saw in your videos when you were raising funds. Now that I have it, not knowing code, is there a dummies version of how to use/program it? I am familiar with ws2811 and other LED’s…Currently use LEDedit and T1000-s controllers. I am 67 years old and was hoping I could catchup with technology and impress my friends. Thankyou Shelby and good luck with your endeavors. I can be reached at …or on Facebook…Rob Orizino

    • Shelby Merrick Post author

      Have you been able to flash it yet? Once flashed, it’s a wireless sACN (E1.31 / DMX over Ethernet) controller. There are numerous programs to feed it data, however the controller grew out of the holiday lighting community where we typically use xLights or Vixen to program lighting sequences to music. There are other applications for live usage such as Jinx. These are all free as well. There are many more applications once you start delving into commercial DJ / stage apps. I’ll shoot you an email.

    • robert orizino

      Shelby….I bought your ESPixel stick so I could program it like the videos you posted. I am not a “coder” and was hoping you could send me to a link that would show me how a layman like myself can make it do anything at all. I am pretty good with the LEDedit software and the T-1000S SD hardware, but I liked what on saw on your videos. Can you help me get started? I appreciate this. Thankyou, ~~RoB~~

  • AJ Reynolds

    I just upgraded to RC3 so I could change the color order to aone of the new sequences added but I couldn’t locate it in the UI. Can you tell me where to find it?

  • RJHodge

    So not worried about the power for my pixels but just trying to figure out what kind of power I need to use one as a dedicated programmer at my desk. Will any wall wart work as long is it is at least 5V 500mA? Again this isn’t driving any pixels it is just so I can program a bunch of them when I need to.

  • Lutz

    Hello Shelby,

    the last days i tried ESPixelStick.

    I want to use it with QLCPlus and / or MagicQ.
    Thus i checked ESPixelstick with both programs.

    First i tried the newest version (3.0) with both programs:
    – QLC works
    – MagicQ forces ESPixelStick to reboot permanently.

    Thats why i tried an older version, actually version 1.3.

    Version 1.3 works with both programs.

    I had more tests with the lastest version and so I included some logging:
    void loop()
    e131_packet_t packet;

    #if LOG_LH
    LOG_PORT.println(F(“loop”)) ;

    // Reboot handler
    if (reboot)
    #if LOG_LH
    LOG_PORT.println(F(“REBOOT”)) ;

    if (config.testmode == TestMode::DISABLED || config.testmode ==
    // Parse a packet and update pixels
    if (!e131.isEmpty())
    #if LOG_LH
    LOG_PORT.println(F(“!e131.isEmpty()”)) ;

    The result is
    ets Jan 8 2013,rst cause:4, boot mode:(3,7)

    wdt reset
    load 0x4010f000, len 1384, room 16
    tail 8
    chksum 0x2d
    csum 0x2d
    ESPixelStick v3.1-dev (gece uart) (Dec 26 2017)
    – Configuration loaded.

    Although MagicQ is configured to send permanently, there seems to be no
    data received, but – as mentioned above – it works with version 1.3

    Do you have any idea what might cause that problem ?

    Regards, merry christmas and a happy new year