DWIN2_Display

Advanced ESP32 Libabry for DWIN DGUS T5L HMI Displays.
It is unofficial library for the DWIN DGUS Displays with extended features for ESP32.
Does not block execution of other code. Sends and receives data as fast as possible.
In the DWIN_Display_Interface folder you will find DGUS project example for the DWIN Display.

DWIN2 Ver. 1.0.2 changes

Added methods:

voidsetVarIcon(constint &icoNum); // to set Variables Icon.voidsetPos(constint &x, constint &y); // to set UI-element position.uint8_tgetVarIconIndex(); // to get current Variables Icon index.

Use

#defineHW_SERIAL_NUM (hw number)

at .h file to change default HardwareSerial number connected to the DWIN display.

DWIN2 Class Methods

// Common methods// Set page numbervoidsetPage(constuint8_t &pageNum);
// Get page numberuint8_tgetPage();
// Set diaplay brightnessvoidsetBrightness(constuint8_t &brightness);
// Get diaplay brightnessuint8_tgetBrightness();
// Restart displayvoidrestartHMI();
// Methods for ui elements// Set the id of the object to be createdvoidsetId(constuint8_t &id);
// Setting a new address for the UI elementvoidsetAddress(constuint16_t &spHexAddr, constuint16_t &vpHexAddr);
// Select the UI type of the display elementvoidsetUiType(constuitype_t &uitype);
// Set the min. and max. values, // delta to increase/decrease the valuevoidsetLimits(constuint32_t &minVal, constuint32_t &maxVal, constbool &loopRotation = false);
// For text data, limits can be calculated automaticallyvoidsetLimits(constbool& loopRotation = true);
// Setting the initial valuevoidsetStartVal(constdouble &currentVal);
// Set a text list of values for UI elementsvoidsetStrListVal(const std::vector<String> listStrVal);
// Set blink rate in millisecondsvoidsetBlinkPeriod(constuint64_t &blinkPeriodMs);
// Setting the called colbeck functionvoidsetUartCbHandler(CallbackFunction f);
// Enable/disable echo modevoidsetEcho(constbool &echo);
// Set color// Overloaded functionvoidsetColor(uint16_t colorHex);
voidsetColor(uicolor_t color);
// Dwin answer
String getDwinEcho();
// Blink ui element.voidblink(constbool &isBlink);
// Hide/unhide UI elementvoidshowUi();
voidhideUi();
// Sending numeric/text values to the display// Overloaded functionvoidsendData(constint &data);
voidsendData(constdouble &data);
voidsendData(const String &data);
// Send the command to the display in Hex formatvoidsendRawCommand(constuint8_t *cmd, constsize_t &cmdLength);
// Increment/decrement the value by a specified delta depending on the direction when calling the methodvoidupdate(constdouble &delta = 1.0, constbool &rightDir = true);
// Clearing the text fieldvoidclearText(uint8_t length = 10);
// Get blink statusboolgetBlinkStatus();
// Get the current value (as a number for int and dbl values and as an index for text values)doublegetCurrentVal();
// Get object IDuint8_tgetId();
// Read data from UI element
String getUiData(constuint8_t &textSize = 10);

DWIN Display QuickStart

#include<Arduino.h>
#include<Dwin2.h>// Rx Tx ESP gpio connected to DWin Display
#defineRX_PIN16
#defineTX_PIN17// Class of controlling UI elements of the displayDWIN2 dwc;
// Callback function to receive a response from the displayvoiddwinEchoCallback(DWIN2 &d);
voidsetup() {
Serial.begin(115200);
while (Serial.available()) {}
Serial.printf("-------- Start DWIN communication demo --------\n");
Serial.printf("-----------------------------------------------\n");
constint d = 1000;
delay(d);
//----------------------------------------------------------------------------------------
Serial.printf("\n----- Dwin Display Common commands start -----\n");
//************ DWIN Display Common commands **************// Init timers, tasks, serial communication and other
dwc.begin();
// Set callback for answer
dwc.setUartCbHandler(dwinEchoCallback);
// Show commands and answers
dwc.setEcho(true);
//---------------------------------------------------------------------------------------- // General commands that refer to the display and not its UI elements// Set/get display pages// Set page
dwc.setPage(2);
delay(d);
dwc.setPage(1);
delay(d);
dwc.setPage(0);
delay(d);
// Get pageuint8_t pageNum = dwc.getPage();
Serial.printf("Current page: %d\n", pageNum);
delay(d);
// Set/get brightness// Set display brightness (Should be from 0 to 127)
dwc.setBrightness(15);
delay(d);
uint8_t brtn = 0;
// Get display current brightness
brtn = dwc.getBrightness();
Serial.printf("Current brightness: %d\n", brtn);
delay(d);
// Set display brightness
dwc.setBrightness(127);
delay(d);
// Get display current brightness
brtn = dwc.getBrightness();
Serial.printf("Current brightness: %d\n", brtn);
delay(d);
// Send raw command// Set display brightness to 0%constuint8_t rawCmd1[] = {0x5A, 0xA5, 0x04, 0x82, 0x00, 0x82, 0x00};
// Set display brightness to 100% constuint8_t rawCmd2[] = {0x5A, 0xA5, 0x04, 0x82, 0x00, 0x82, 0x7F}; dwc.sendRawCommand(rawCmd1, sizeof(rawCmd1));
delay(d);
dwc.sendRawCommand(rawCmd2, sizeof(rawCmd2));
delay(d);
//----------------------------------------------------------------------------------------// Restart HMI//dwc.restartHMI();delay(1000);
Serial.printf("----- Dwin Display common commands end -----\n");
//----------------------------------------------------------------------------------------
Serial.printf("\n----- Dwin UI commands start -----\n");
// Set ui adress
dwc.setAddress(0x9000, 0x1000);
// Set ui type of the display elemet communicating with
dwc.setUiType(INT);
// Set text color
dwc.setColor(SKY_BLUE);
delay(d);
// Or set color in DWIN HEX fromat
dwc.setColor(0xFFFF);
// Send data
dwc.sendData(55);
// Set start val. Same as sendData. It is used with update() method. 
dwc.setStartVal(20);
// Set limits for the ui-elements. It will not less then min value, and greater than max value// You also can turn on cycle rotation when value reaches min or max value
dwc.setLimits(10, 50, true);
for (int i = 0; i < 10; i++)
{
// Increment/decrement the value by a given delta depending on the direction
dwc.update(2.0, true);
delay(200);
}
// Get value of the ui-element always return String
String val = dwc.getUiData();
Serial.printf("UI value: %s\n", val);
// Hide ui element
dwc.hideUi();
delay(d);
// Show ui element
dwc.showUi();
delay(d);
// Change ui address
dwc.setAddress(0x9030, 0x1030);
// Set new UI type
dwc.setUiType(UTF); // Set type of the UI element of the dwin display// Send UTF text to display
dwc.sendData("UTF Текст");
//----------------------------------------------------------------------------------------// Change ui address, return it to INT ui
dwc.setAddress(0x9030, 0x1030);
// Set new UI type
dwc.setUiType(INT); // Set type of the UI element of the dwin display// Lets blink it!// Blinking EXAMPLES:// Set blink period
Serial.printf("Blink 200\n");
dwc.setBlinkPeriod(200);
// Start blink
dwc.blink(true);
delay(2000);
// Set other blink period
dwc.setBlinkPeriod(600);
Serial.printf("Blink 800\n");
delay(3000);
// Stop blinking
dwc.blink(false);
delay(d);
//----------------------------------------------------------------------------------------// update() method is good to use with some interrupts,// such as button pushes, encoder rotating, etc.// update() EXAMPLES:// Set ui adress for the ASCII element
dwc.setAddress(0x9020, 0x1020);
// Set ui type of the display elemet communicating with
dwc.setUiType(ASCII);
std::vector<String> asciiList = {"One", "Two", "Three", "Four", "Five"};
dwc.setStrListVal(asciiList);
dwc.setLimits();
// Then set start value as index of the list
dwc.setStartVal(2);
// Simulate encoder rotationfor (int i = 0; i < 10; i++)
{
dwc.update(true);
delay(100);
}
// Set ui adress for the double element
dwc.setAddress(0x9010, 0x1010);
// Set ui type of the display elemet communicating with
dwc.setUiType(DOUBLE);
// Send some int data
dwc.setStartVal(25.8);
dwc.setLimits(10, 50, true);
for (int i = 0; i < 20; i++)
{
dwc.update(0.1, true);
delay(100);
}
delay(d);
Serial.printf("------ Dwin UI commands examples end ------\n");
//----------------------------------------------------------------------------------------
Serial.printf("\n--------------------------------------------------\n");
Serial.printf("-------- DWIN communication demo finished --------\n");
}
voidloop() {
delay(portMAX_DELAY);
}
voiddwinEchoCallback(DWIN2 &d)
{
Serial.print("Echo ");
Serial.println(d.getDwinEcho());
}