fflorey/pixoo64rgb

A small library to access the REST API to the Divoom Pixoo64 device with an esp32 / arduino based SoC

Use your pixoo64 as a remote display for your esp32

This library gives a more easy access to the REST API of the Divoom Pixoo64 from your ESP32 or similiar devices (has only been tested with some esp32 dev boards!) The REST API can be found at https://www.divoom.com/de-de/apps/help-center#!hc-pixoo64-developeropen-sourcesdkapiopen-source (as of Feb 2022)

Tutorial

I recorded a screencast to explain on how to use the library in your esp32 projects.

https://www.youtube.com/watch?v=HHFJNIR5YQw

Thanks

A big "thank you" for the idea to create the image in memory upfront with some simple algorithms goes to Ron Talman and his work: https://github.com/SomethingWithComputers/pixoo

With some simple lines of code and this library, you can use the Pixoo64 as a wireless display for your ESP32.

Example:

#include <Arduino.h>
#include <HTTPClient.h>
#include <Wifi.h>
#include <divoom64com.h>
#include <rgbplot.h>

const char* ssid = "YOUR WLAN SSID GOES HERE";
const char* password = "AND YOUR PASSSWORD...";

RGB* pixoo64Display = NULL;

void setup() {
    Serial.begin(115200);  // Any baud rate should work
    Serial.println("Hello Arduino\n");
    Serial.print("Connecting to WiFi");
    WiFi.begin(ssid, password);
    while (WiFi.status() != WL_CONNECTED) {
        delay(100);
        Serial.print(".");
    }
    Serial.println(" Connected!");
    // initialize display
    pixoo64Display = newRGB();

}

void loop() {
    Serial.println("go");
    if (WiFi.status() == WL_CONNECTED) {
        Divoom64Communicator divoomClient; // setup communication line to device
        fillRGB(pixoo64Display, 0x0, 0x0, 0x0); // fill internal image black
        plotRect(pixoo64Display, 1,10,10,10,0xfc, 0xf4, 0x03 ); // plot a rect at x:1, y:10 width:10, height: 10
        divoomClient.resetPicID();
        divoomClient.sendRGB(pixoo64Display);  // finally, send to pixoo device
    }
    delay(25000);
}

Documentation for Divoom64Communicator - class

This class is performing all the calls to the DIVOOM64-Device. All of the following calls are conducted by calling the device via http in your local network.

playBuzzer ( int ActiveTimeInCycle, int OffTimeInCycle, int PlayTotalTime );

Play the buzzer. Example: If you want to get 5 beeps in one second you will use: playBuzzer ( 100,100,1000);

int sendRGB(RGB *screen);

This function will send the screen to the Device. This function is necessary to make any other graphics operation (e.g. fillRGB)

int clearAllTexts();

Clear all texts on display which are drawn with sendText, sendScrollText.

int resetPicID();

Sets the internal used PicID on the divoom device back to 0: You should allways use this before sending your first rgb to device

int sendRGB(RGB *screen);

Send (prepared) RGB * to device

int sendText(int x, int y, String text, int textID, String rgbColor, int font = 3);

Note: Divoom provides 7 different fonts (parameter font), the textID identifies the string on the display. This lets you modify a specific string on the display if needed

int sendScrollText ( int x, int y, String text, int textID, String rgbColor, int textWidth, int scrollSpeed, int font = 3);

Same as sendText, but Text is scrolling with scrollSpeed scrollSpeed

int displayList ( String list);

Display Messages, Time or Temperatur strings with a single statement. Note: You can only use one displayList statement on a screen. Multiple calls deletes other Texts. Note: fonts are different to the ones available for sendText. Use this method especially, when you need small fonts

int displaySmallText ( int x, int y, String text, int textID, String rgbColor );

int displayTime ( int x, int y, int textID, String rgbColor, int withSeconds=0 );

int displayTemperatur ( int x, int y, String text, int textID, String rgbColor, int tempmode=0 );

All methods are needed for displayList

String Time(int  x, int  y, int textID, String rgbColor, int withSeconds=0 );
String Temperatur ( int  x, int  y, String text, int textID, String rgbColor, int tempmode=0 );
String Message ( int x, int y, String text, int textID, String rgbColor );

Documentation for RGB helper lib

RGB *newRGB();

Create new internal RGB-image represenation

void fillRGB(RGB *pic, char r, char g, char b);

fill image with the given color (in RGB)

void flushRGB(RGB *pic);

debugging only - print RGB-representation to stdout. Maybe usefill when playing around with postman and the REST-API directly

Very simple graphic operations

void plotPoint(RGB *pic, int x, int y, char r, char g, char b);

void plotFilledRect(RGB *pic, int x, int width, int y, int height, char r, char g, char b);

void plotRect(RGB *pic, int x, int width, int y, int height, char r, char g, char b);

void plotLine(RGB *pic, int x0, int y0, int x1, int y1, char r, char g, char b);

void plotCircle(RGB *pic, int xc, int yc, int r, char rcolor, char g, char b);

void plotFilledCircle(RGB *pic, int x0, int y0, int radius, char rcolor, char g, char b);

void getBase64Encoded(RGB *pic, size_t *size, String &result_str );

Can be used for debugging purposes

void plotSprite(RGB *pic, int xpos, int ypos, Sprite *sprite );

This lets you print a sprite onto the internal image at a certain position

(Directory structure follows PlatformIO instructions.)