SH1106.c 5.0 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164
  1. /**
  2. * Copyright (c) 2017-2018 Tara Keeling
  3. * 2020 Philippe G.
  4. *
  5. * This software is released under the MIT License.
  6. * https://opensource.org/licenses/MIT
  7. */
  8. #include <stdio.h>
  9. #include <string.h>
  10. #include <stdint.h>
  11. #include <stdbool.h>
  12. #include <esp_heap_caps.h>
  13. #include <esp_log.h>
  14. #include "gds.h"
  15. #include "gds_private.h"
  16. #define SHADOW_BUFFER
  17. #define USE_IRAM
  18. static char TAG[] = "SH1106";
  19. struct PrivateSpace {
  20. uint8_t *Shadowbuffer;
  21. };
  22. // Functions are not declared to minimize # of lines
  23. static void SetColumnAddress( struct GDS_Device* Device, uint8_t Start, uint8_t End ) {
  24. // well, unfortunately this driver is 132 colums but most displays are 128...
  25. if (Device->Width != 132) Start += 2;
  26. Device->WriteCommand( Device, 0x10 | (Start >> 4) );
  27. Device->WriteCommand( Device, 0x00 | (Start & 0x0f) );
  28. }
  29. static void SetPageAddress( struct GDS_Device* Device, uint8_t Start, uint8_t End ) {
  30. Device->WriteCommand( Device, 0xB0 | Start );
  31. }
  32. static void Update( struct GDS_Device* Device ) {
  33. #ifdef SHADOW_BUFFER
  34. struct PrivateSpace *Private = (struct PrivateSpace*) Device->Private;
  35. // not sure the compiler does not have to redo all calculation in for loops, so local it is
  36. int width = Device->Width, rows = Device->Height / 8;
  37. uint8_t *optr = Private->Shadowbuffer, *iptr = Device->Framebuffer;
  38. // by row, find first and last columns that have been updated
  39. for (int r = 0; r < rows; r++) {
  40. uint8_t first = 0, last;
  41. for (int c = 0; c < width; c++) {
  42. if (*iptr != *optr) {
  43. if (!first) first = c + 1;
  44. last = c ;
  45. }
  46. *optr++ = *iptr++;
  47. }
  48. // now update the display by "byte rows"
  49. if (first--) {
  50. SetColumnAddress( Device, first, last );
  51. SetPageAddress( Device, r, r);
  52. Device->WriteData( Device, Private->Shadowbuffer + r*width + first, last - first + 1);
  53. }
  54. }
  55. #else
  56. // SH1106 requires a page-by-page update and has no end Page/Column
  57. for (int i = 0; i < Device->Height / 8 ; i++) {
  58. SH1106_SetPageAddress( Device, i, 0);
  59. SH1106_SetColumnAddress( Device, 0, 0);
  60. SH1106_WriteData( Device, Device->Framebuffer + i*Device->Width, Device->Width );
  61. }
  62. #endif
  63. }
  64. static void SetLayout( struct GDS_Device* Device, struct GDS_Layout *Layout ) {
  65. Device->WriteCommand( Device, Layout->HFlip ? 0xA1 : 0xA0 );
  66. Device->WriteCommand( Device, Layout->VFlip ? 0xC8 : 0xC0 );
  67. Device->WriteCommand( Device, Layout->Invert ? 0xA7 : 0xA6 );
  68. }
  69. static void DisplayOn( struct GDS_Device* Device ) { Device->WriteCommand( Device, 0xAF ); }
  70. static void DisplayOff( struct GDS_Device* Device ) { Device->WriteCommand( Device, 0xAE ); }
  71. static void SetContrast( struct GDS_Device* Device, uint8_t Contrast ) {
  72. Device->WriteCommand( Device, 0x81 );
  73. Device->WriteCommand( Device, Contrast );
  74. }
  75. static void SPIParams(int Speed, uint8_t *mode, uint16_t *CS_pre, uint8_t *CS_post) {
  76. *CS_post = Speed / (8*1000*1000);
  77. }
  78. static bool Init( struct GDS_Device* Device ) {
  79. #ifdef SHADOW_BUFFER
  80. struct PrivateSpace *Private = (struct PrivateSpace*) Device->Private;
  81. #ifdef USE_IRAM
  82. if (Device->IF == GDS_IF_SPI) Private->Shadowbuffer = heap_caps_malloc( Device->FramebufferSize, MALLOC_CAP_INTERNAL | MALLOC_CAP_DMA );
  83. else
  84. #endif
  85. Private->Shadowbuffer = malloc( Device->FramebufferSize );
  86. NullCheck( Private->Shadowbuffer, return false );
  87. memset(Private->Shadowbuffer, 0xFF, Device->FramebufferSize);
  88. #endif
  89. // need to be off and disable display RAM
  90. Device->DisplayOff( Device );
  91. Device->WriteCommand( Device, 0xA5 );
  92. // charge pump regulator, do direct init
  93. Device->WriteCommand( Device, 0xAD );
  94. Device->WriteCommand( Device, 0x8B );
  95. // COM pins HW config (alternative:EN) - some display might need something difference
  96. Device->WriteCommand( Device, 0xDA );
  97. Device->WriteCommand( Device, 1 << 4);
  98. // MUX Ratio
  99. Device->WriteCommand( Device, 0xA8 );
  100. Device->WriteCommand( Device, Device->Height - 1);
  101. // Display Offset
  102. Device->WriteCommand( Device, 0xD3 );
  103. Device->WriteCommand( Device, 0 );
  104. // Display Start Line
  105. Device->WriteCommand( Device, 0x40 + 0x00 );
  106. Device->SetContrast( Device, 0x7F );
  107. // set flip modes
  108. struct GDS_Layout Layout = { };
  109. Device->SetLayout( Device, &Layout );
  110. // no Display Inversion
  111. Device->WriteCommand( Device, 0xA6 );
  112. // set Clocks
  113. Device->WriteCommand( Device, 0xD5 );
  114. Device->WriteCommand( Device, ( 0x08 << 4 ) | 0x00 );
  115. // gone with the wind
  116. Device->WriteCommand( Device, 0xA4 );
  117. Device->DisplayOn( Device );
  118. Device->Update( Device );
  119. return true;
  120. }
  121. static const struct GDS_Device SH1106 = {
  122. .DisplayOn = DisplayOn, .DisplayOff = DisplayOff, .SetContrast = SetContrast,
  123. .SetLayout = SetLayout,
  124. .Update = Update, .Init = Init,
  125. .Depth = 1,
  126. .SPIParams = SPIParams,
  127. #if !defined SHADOW_BUFFER && defined USE_IRAM
  128. .Alloc = GDS_ALLOC_IRAM_SPI;
  129. #endif
  130. };
  131. struct GDS_Device* SH1106_Detect(char *Driver, struct GDS_Device* Device) {
  132. if (!strcasestr(Driver, "SH1106")) return NULL;
  133. if (!Device) Device = calloc(1, sizeof(struct GDS_Device));
  134. *Device = SH1106;
  135. ESP_LOGI(TAG, "SH1106 driver");
  136. return Device;
  137. }