drivers: ssd16xx: Add support for partial refresh profiles

andysan · andysan · commit 8ebc47ef0bbe · 2023-04-18T21:58:40.000+01:00
Add support for partial refresh profiles. This makes it possible to
use partial refresh on generation 2 devices which are able to store
partial refresh LUTs in OTP.

Partial refresh is only enabled if a partial profile has been
provided. The display will use the full refresh profile if in this
case.

Devices that need custom LUTs and voltages can specify them separately
for the full and partial profiles. The controller will be reset when
changing profiles which means that profiles always override the
default reset values. This means that it is, for example, possible to
use default values and LUTs from OTP for a full refresh and a custom
profile for partial refreshes.

For example, to use a GoodDisplay GDEY027T91 with partial refresh
simply use the following device tree fragment:

display: ssd1680@0 {
	compatible = "solomon,ssd1680";

	spi-max-frequency = &lt;4000000&gt;;
	duplex = &lt;SPI_HALF_DUPLEX&gt;;
	reg = &lt;0&gt;;

	dc-gpios = &lt;&amp;arduino_header 15 GPIO_ACTIVE_LOW&gt;;
	reset-gpios = &lt;&amp;arduino_header 14 GPIO_ACTIVE_LOW&gt;;
	busy-gpios = &lt;&amp;arduino_header 13 GPIO_ACTIVE_HIGH&gt;;

	/* Enable the built-in temperature sensor */
	tssv = &lt;0x80&gt;;

	width = &lt;264&gt;;
	height = &lt;176&gt;;

        /* Enable partial refresh using built-in LUT */
	partial {
	};
};

Signed-off-by: Andreas Sandberg &lt;andreas@sandberg.uk&gt;
diff --git a/boards/arm/reel_board/reel_board.dts b/boards/arm/reel_board/reel_board.dts
@@ -81,11 +81,19 @@
 			];
 		};
 
-		lut-default = [
-			18 00 00 00 00 00 00 00
-			00 00 00 00 00 00 00 00
-			0F 01 00 00 00 00 00 00
-			00 00 00 00 00
-		];
+		partial {
+			gdv = [10 0a];
+			sdv = [19];
+			vcom = <0xa8>;
+			border-waveform = <0x71>;
+			dummy-line = <0x1a>;
+			gate-line-width = <0x08>;
+			lut = [
+				18 00 00 00 00 00 00 00
+				00 00 00 00 00 00 00 00
+				0F 01 00 00 00 00 00 00
+				00 00 00 00 00
+			];
+		};
 	};
 };
diff --git a/boards/arm/reel_board/reel_board_v2.dts b/boards/arm/reel_board/reel_board_v2.dts
@@ -93,19 +93,27 @@
 			];
 		};
 
-		lut-default = [
-			00 00 00 00 00 00 00 /* LUT0: BB: VS0..6 */
-			80 00 00 00 00 00 00 /* LUT1: BW: VS0..6 */
-			40 00 00 00 00 00 00 /* LUT2: WB: VS0..6 */
-			80 00 00 00 00 00 00 /* LUT3: WW: VS0..6 */
-			00 00 00 00 00 00 00 /* LUT4: VCOM: VS0..6 */
-			0A 00 00 00 04 /* TP0A TP0B TP0C TP0D RP0 */
-			00 00 00 00 00 /* TP1A TP1B TP1C TP1D RP1 */
-			00 00 00 00 00 /* TP2A TP2B TP2C TP2D RP2 */
-			00 00 00 00 00 /* TP3A TP3B TP3C TP3D RP3 */
-			00 00 00 00 00 /* TP4A TP4B TP4C TP4D RP4 */
-			00 00 00 00 00 /* TP5A TP5B TP5C TP5D RP5 */
-			00 00 00 00 00 /* TP6A TP6B TP6C TP6D RP6 */
-		];
+		partial {
+			gdv = [15];
+			sdv = [41 a8 32];
+			vcom = <0x26>;
+			border-waveform = <0x01>;
+			dummy-line = <0x30>;
+			gate-line-width = <0x0a>;
+			lut = [
+				00 00 00 00 00 00 00 /* LUT0: BB: VS0..6 */
+				80 00 00 00 00 00 00 /* LUT1: BW: VS0..6 */
+				40 00 00 00 00 00 00 /* LUT2: WB: VS0..6 */
+				80 00 00 00 00 00 00 /* LUT3: WW: VS0..6 */
+				00 00 00 00 00 00 00 /* LUT4: VCOM: VS0..6 */
+				0A 00 00 00 04 /* TP0A TP0B TP0C TP0D RP0 */
+				00 00 00 00 00 /* TP1A TP1B TP1C TP1D RP1 */
+				00 00 00 00 00 /* TP2A TP2B TP2C TP2D RP2 */
+				00 00 00 00 00 /* TP3A TP3B TP3C TP3D RP3 */
+				00 00 00 00 00 /* TP4A TP4B TP4C TP4D RP4 */
+				00 00 00 00 00 /* TP5A TP5B TP5C TP5D RP5 */
+				00 00 00 00 00 /* TP6A TP6B TP6C TP6D RP6 */
+			];
+		};
 	};
 };
diff --git a/boards/shields/waveshare_epaper/waveshare_epaper_gdeh0154a07.overlay b/boards/shields/waveshare_epaper/waveshare_epaper_gdeh0154a07.overlay
@@ -26,6 +26,10 @@
 		tssv = <0x80>;
 
 		full {
+			border-waveform = <0x05>;
+		};
+
+		partial {
 			border-waveform = <0x3c>;
 		};
 	};
diff --git a/boards/shields/waveshare_epaper/waveshare_epaper_gdeh0213b1.overlay b/boards/shields/waveshare_epaper/waveshare_epaper_gdeh0213b1.overlay
@@ -38,11 +38,19 @@
 			];
 		};
 
-		lut-default = [
-			18 00 00 00 00 00 00 00
-			00 00 00 00 00 00 00 00
-			0F 01 00 00 00 00 00 00
-			00 00 00 00 00
-		];
+		partial {
+			gdv = [10 0a];
+			sdv = [19];
+			vcom = <0xa8>;
+			border-waveform = <0x71>;
+			dummy-line = <0x1a>;
+			gate-line-width = <0x08>;
+			lut = [
+				18 00 00 00 00 00 00 00
+				00 00 00 00 00 00 00 00
+				0F 01 00 00 00 00 00 00
+				00 00 00 00 00
+			];
+		};
 	};
 };
diff --git a/boards/shields/waveshare_epaper/waveshare_epaper_gdeh0213b72.overlay b/boards/shields/waveshare_epaper/waveshare_epaper_gdeh0213b72.overlay
@@ -26,7 +26,7 @@
 		full {
 			gdv = [15];
 			sdv = [41 a8 32];
-			vcom = <0x26>;
+			vcom = <0x55>;
 			border-waveform = <0x03>;
 			dummy-line = <0x30>;
 			gate-line-width = <0x0a>;
@@ -46,19 +46,27 @@
 			];
 		};
 
-		lut-default = [
-			00 00 00 00 00 00 00
-			80 00 00 00 00 00 00
-			40 00 00 00 00 00 00
-			80 00 00 00 00 00 00
-			00 00 00 00 00 00 00
-			0A 00 00 00 04
-			00 00 00 00 00
-			00 00 00 00 00
-			00 00 00 00 00
-			00 00 00 00 00
-			00 00 00 00 00
-			00 00 00 00 00
-		];
+		partial {
+			gdv = [15];
+			sdv = [41 a8 32];
+			vcom = <0x26>;
+			border-waveform = <0x01>;
+			dummy-line = <0x30>;
+			gate-line-width = <0x0a>;
+			lut = [
+				00 00 00 00 00 00 00
+				80 00 00 00 00 00 00
+				40 00 00 00 00 00 00
+				80 00 00 00 00 00 00
+				00 00 00 00 00 00 00
+				0A 00 00 00 04
+				00 00 00 00 00
+				00 00 00 00 00
+				00 00 00 00 00
+				00 00 00 00 00
+				00 00 00 00 00
+				00 00 00 00 00
+			];
+		};
 	};
 };
diff --git a/boards/shields/waveshare_epaper/waveshare_epaper_gdeh029a1.overlay b/boards/shields/waveshare_epaper/waveshare_epaper_gdeh029a1.overlay
@@ -26,9 +26,7 @@
 		softstart = [d7 d6 9d];
 
 		full {
-			gdv = [16];
-			sdv = [0a];
-			vcom = <0xa8>;
+			vcom = <0x9a>;
 			border-waveform = <0x33>;
 			dummy-line = <0x1a>;
 			gate-line-width = <0x08>;
@@ -40,11 +38,17 @@
 			];
 		};
 
-		lut-default = [
-			10 18 18 08 18 18 08 00
-			00 00 00 00 00 00 00 00
-			00 00 00 00 13 14 44 12
-			00 00 00 00 00 00
-		];
+		partial {
+			vcom = <0xa8>;
+			border-waveform = <0x01>;
+			dummy-line = <0x1a>;
+			gate-line-width = <0x08>;
+			lut = [
+				10 18 18 08 18 18 08 00
+				00 00 00 00 00 00 00 00
+				00 00 00 00 13 14 44 12
+				00 00 00 00 00 00
+			];
+		};
 	};
 };
diff --git a/drivers/display/ssd16xx.c b/drivers/display/ssd16xx.c
diff --git a/drivers/display/ssd16xx_regs.h b/drivers/display/ssd16xx_regs.h
diff --git a/dts/bindings/display/solomon,ssd16xx-common.yaml b/dts/bindings/display/solomon,ssd16xx-common.yaml
