/** * Copyright (c) 2017-2018 Tara Keeling * 2020 Philippe G. * * This software is released under the MIT License. * https://opensource.org/licenses/MIT */ #include #include #include #include #include #include #include "gds.h" #include "gds_private.h" #define SHADOW_BUFFER #define USE_IRAM #define PAGE_BLOCK 2048 #define ENABLE_WRITE 0x5c #define min(a,b) (((a) < (b)) ? (a) : (b)) static char TAG[] = "SSD1351"; struct PrivateSpace { uint8_t *iRAM, *Shadowbuffer; uint8_t ReMap, PageSize; }; // Functions are not declared to minimize # of lines static void WriteByte( struct GDS_Device* Device, uint8_t Data ) { Device->WriteData( Device, &Data, 1 ); } static void SetColumnAddress( struct GDS_Device* Device, uint8_t Start, uint8_t End ) { Device->WriteCommand( Device, 0x15 ); WriteByte( Device, Start ); WriteByte( Device, End ); } static void SetRowAddress( struct GDS_Device* Device, uint8_t Start, uint8_t End ) { Device->WriteCommand( Device, 0x75 ); WriteByte( Device, Start ); WriteByte( Device, End ); } static void Update16( struct GDS_Device* Device ) { struct PrivateSpace *Private = (struct PrivateSpace*) Device->Private; #ifdef SHADOW_BUFFER uint32_t *optr = (uint32_t*) Private->Shadowbuffer, *iptr = (uint32_t*) Device->Framebuffer; int FirstCol = Device->Width / 2, LastCol = 0, FirstRow = -1, LastRow = 0; for (int r = 0; r < Device->Height; r++) { // look for change and update shadow (cheap optimization = width is always a multiple of 2) for (int c = 0; c < Device->Width / 2; c++, iptr++, optr++) { if (*optr != *iptr) { *optr = *iptr; if (c < FirstCol) FirstCol = c; if (c > LastCol) LastCol = c; if (FirstRow < 0) FirstRow = r; LastRow = r; } } // wait for a large enough window - careful that window size might increase by more than a line at once ! if (FirstRow < 0 || ((LastCol - FirstCol + 1) * (r - FirstRow + 1) * 4 < PAGE_BLOCK && r != Device->Height - 1)) continue; FirstCol *= 2; LastCol = LastCol * 2 + 1; SetRowAddress( Device, FirstRow, LastRow ); SetColumnAddress( Device, FirstCol, LastCol ); Device->WriteCommand( Device, ENABLE_WRITE ); int ChunkSize = (LastCol - FirstCol + 1) * 2; // own use of IRAM has not proven to be much better than letting SPI do its copy if (Private->iRAM) { uint8_t *optr = Private->iRAM; for (int i = FirstRow; i <= LastRow; i++) { memcpy(optr, Private->Shadowbuffer + (i * Device->Width + FirstCol) * 2, ChunkSize); optr += ChunkSize; if (optr - Private->iRAM < PAGE_BLOCK && i < LastRow) continue; Device->WriteData(Device, Private->iRAM, optr - Private->iRAM); optr = Private->iRAM; } } else for (int i = FirstRow; i <= LastRow; i++) { Device->WriteData( Device, Private->Shadowbuffer + (i * Device->Width + FirstCol) * 2, ChunkSize ); } FirstCol = Device->Width / 2; LastCol = 0; FirstRow = -1; } #else // always update by full lines SetColumnAddress( Device, 0, Device->Width - 1); for (int r = 0; r < Device->Height; r += min(Private->PageSize, Device->Height - r)) { int Height = min(Private->PageSize, Device->Height - r); SetRowAddress( Device, r, r + Height - 1 ); Device->WriteCommand(Device, ENABLE_WRITE); if (Private->iRAM) { memcpy(Private->iRAM, Device->Framebuffer + r * Device->Width * 2, Height * Device->Width * 2 ); Device->WriteData( Device, Private->iRAM, Height * Device->Width * 2 ); } else { Device->WriteData( Device, Device->Framebuffer + r * Device->Width * 2, Height * Device->Width * 2 ); } } #endif } static void Update24( struct GDS_Device* Device ) { struct PrivateSpace *Private = (struct PrivateSpace*) Device->Private; int FirstCol = (Device->Width * 3) / 2, LastCol = 0, FirstRow = -1, LastRow = 0; #ifdef SHADOW_BUFFER uint16_t *optr = (uint16_t*) Private->Shadowbuffer, *iptr = (uint16_t*) Device->Framebuffer; for (int r = 0; r < Device->Height; r++) { // look for change and update shadow (cheap optimization = width always / by 2) for (int c = 0; c < (Device->Width * 3) / 2; c++, optr++, iptr++) { if (*optr != *iptr) { *optr = *iptr; if (c < FirstCol) FirstCol = c; if (c > LastCol) LastCol = c; if (FirstRow < 0) FirstRow = r; LastRow = r; } } // do we have enough to send (cols are divided by 3/2) if (FirstRow < 0 || ((((LastCol - FirstCol + 1) * 2 + 3 - 1) / 3) * (r - FirstRow + 1) * 3 < PAGE_BLOCK && r != Device->Height - 1)) continue; FirstCol = (FirstCol * 2) / 3; LastCol = (LastCol * 2 + 1) / 3; SetRowAddress( Device, FirstRow, LastRow ); SetColumnAddress( Device, FirstCol, LastCol ); Device->WriteCommand( Device, ENABLE_WRITE ); int ChunkSize = (LastCol - FirstCol + 1) * 3; // own use of IRAM has not proven to be much better than letting SPI do its copy if (Private->iRAM) { uint8_t *optr = Private->iRAM; for (int i = FirstRow; i <= LastRow; i++) { memcpy(optr, Private->Shadowbuffer + (i * Device->Width + FirstCol) * 3, ChunkSize); optr += ChunkSize; if (optr - Private->iRAM < PAGE_BLOCK && i < LastRow) continue; Device->WriteData(Device, Private->iRAM, optr - Private->iRAM); optr = Private->iRAM; } } else for (int i = FirstRow; i <= LastRow; i++) { Device->WriteData( Device, Private->Shadowbuffer + (i * Device->Width + FirstCol) * 3, ChunkSize ); } FirstCol = (Device->Width * 3) / 2; LastCol = 0; FirstRow = -1; } #else // always update by full lines SetColumnAddress( Device, 0, Device->Width - 1); for (int r = 0; r < Device->Height; r += min(Private->PageSize, Device->Height - r)) { int Height = min(Private->PageSize, Device->Height - r); SetRowAddress( Device, r, r + Height - 1 ); Device->WriteCommand(Device, ENABLE_WRITE); if (Private->iRAM) { memcpy(Private->iRAM, Device->Framebuffer + r * Device->Width * 3, Height * Device->Width * 3 ); Device->WriteData( Device, Private->iRAM, Height * Device->Width * 3 ); } else { Device->WriteData( Device, Device->Framebuffer + r * Device->Width * 3, Height * Device->Width * 3 ); } } #endif } static void SetLayout( struct GDS_Device* Device, struct GDS_Layout *Layout ) { struct PrivateSpace *Private = (struct PrivateSpace*) Device->Private; Private->ReMap = Layout->HFlip ? (Private->ReMap & ~(1 << 1)) : (Private->ReMap | (1 << 1)); Private->ReMap = Layout->VFlip ? (Private->ReMap | (1 << 4)) : (Private->ReMap & ~(1 << 4)); Device->WriteCommand( Device, 0xA0 ); WriteByte( Device, Private->ReMap ); Device->WriteCommand( Device, Layout->Invert ? 0xA7 : 0xA6 ); } static void DisplayOn( struct GDS_Device* Device ) { Device->WriteCommand( Device, 0xAF ); } static void DisplayOff( struct GDS_Device* Device ) { Device->WriteCommand( Device, 0xAE ); } static void SetContrast( struct GDS_Device* Device, uint8_t Contrast ) { Device->WriteCommand( Device, 0xC7 ); WriteByte( Device, Contrast >> 4); } static bool Init( struct GDS_Device* Device ) { struct PrivateSpace *Private = (struct PrivateSpace*) Device->Private; int Depth = (Device->Depth + 8 - 1) / 8; Private->PageSize = min(8, PAGE_BLOCK / (Device->Width * Depth)); #ifdef SHADOW_BUFFER Private->Shadowbuffer = malloc( Device->FramebufferSize ); memset(Private->Shadowbuffer, 0xFF, Device->FramebufferSize); #endif #ifdef USE_IRAM Private->iRAM = heap_caps_malloc( (Private->PageSize + 1) * Device->Width * Depth, MALLOC_CAP_INTERNAL | MALLOC_CAP_DMA ); #endif ESP_LOGI(TAG, "SSD1351 with bit depth %u, page %u, iRAM %p", Device->Depth, Private->PageSize, Private->iRAM); // unlock (specially 0xA2) Device->WriteCommand( Device, 0xFD); WriteByte(Device, 0xB1); // set clocks /* Device->WriteCommand( Device, 0xB3 ); WriteByte( Device, ( 0x08 << 4 ) | 0x00 ); */ // need to be off and disable display RAM Device->DisplayOff( Device ); // need COM split (5) Private->ReMap = (1 << 5); // Display Offset Device->WriteCommand( Device, 0xA2 ); WriteByte( Device, 0x00 ); // Display Start Line Device->WriteCommand( Device, 0xA1 ); WriteByte( Device, 0x00 ); // set flip modes & contrast Device->SetContrast( Device, 0x7F ); struct GDS_Layout Layout = { }; Device->SetLayout( Device, &Layout ); // set Adressing Mode Horizontal Private->ReMap |= (0 << 2); // set screen depth (16/18) if (Device->Depth == 24) Private->ReMap |= (0x02 << 6); // write ReMap byte Device->WriteCommand( Device, 0xA0 ); WriteByte( Device, Private->ReMap ); // no Display Inversion Device->WriteCommand( Device, 0xA6 ); // gone with the wind Device->DisplayOn( Device ); Device->Update( Device ); return true; } static const struct GDS_Device SSD1351 = { .DisplayOn = DisplayOn, .DisplayOff = DisplayOff, .SetContrast = SetContrast, .SetLayout = SetLayout, .Update = Update16, .Init = Init, .Mode = GDS_RGB565, .Depth = 16, }; struct GDS_Device* SSD1351_Detect(char *Driver, struct GDS_Device* Device) { int Depth; if (!strcasestr(Driver, "SSD1351")) return NULL; if (!Device) Device = calloc(1, sizeof(struct GDS_Device)); *Device = SSD1351; sscanf(Driver, "%*[^:]:%u", &Depth); if (Depth == 18) { Device->Mode = GDS_RGB666; Device->Depth = 24; Device->Update = Update24; } return Device; }