drivers: ssd16xx: Update DT bindings for multiple profiles

andysan · andysan · commit f6fa2efc4451 · 2022-11-23T20:22:55.000Z
Update the device tree bindings for the SSD16xx driver to make it
possible to specify multiple refresh profiles.

The only profile currently supported is the 'full' profile.

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
@@ -65,18 +65,22 @@
 		reset-gpios = <&gpio0 15 GPIO_ACTIVE_LOW>;
 		dc-gpios = <&gpio0 16 GPIO_ACTIVE_LOW>;
 		busy-gpios = <&gpio0 14 GPIO_ACTIVE_HIGH>;
-		gdv = [10 0a];
-		sdv = [19];
-		vcom = <0xa8>;
-		border-waveform = <0x71>;
-		dummy-line = <0x1a>;
-		gate-line-width = <0x08>;
-		lut-initial = [
-			22 55 AA 55 AA 55 AA 11
-			00 00 00 00 00 00 00 00
-			1E 1E 1E 1E 1E 1E 1E 1E
-			01 00 00 00 00
-		];
+
+		full {
+			gdv = [10 0a];
+			sdv = [19];
+			vcom = <0xa8>;
+			border-waveform = <0x71>;
+			dummy-line = <0x1a>;
+			gate-line-width = <0x08>;
+			lut = [
+				22 55 AA 55 AA 55 AA 11
+				00 00 00 00 00 00 00 00
+				1E 1E 1E 1E 1E 1E 1E 1E
+				01 00 00 00 00
+			];
+		};
+
 		lut-default = [
 			18 00 00 00 00 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
@@ -48,47 +48,50 @@
 		reset-gpios = <&gpio0 15 GPIO_ACTIVE_LOW>;
 		dc-gpios = <&gpio0 16 GPIO_ACTIVE_LOW>;
 		busy-gpios = <&gpio0 14 GPIO_ACTIVE_HIGH>;
-		gdv = [15];
-		sdv = [41 a8 32];
-		vcom = <0x26>;
-		border-waveform = <0x03>;
-		dummy-line = <0x30>;
-		gate-line-width = <0x0a>;
-		lut-initial = [
-			/*
-			 * Waveform Composition
-			 *
-			 * There are 7 Voltage Source (VS) Level groups
-			 * n = {0,1,2...6}, each group contains
-			 * 4 phases x = {A,B,C,D}.
-			 * 2 bits represent the voltage in a phase:
-			 * 00 – VSS, 01 – VSH1, 10 – VSL, 11 - VSH2
-			 *
-			 * For example 0x80 represents sequence VSL-VSS-VSS-VSS,
-			 */
-			80 60 40 00 00 00 00 /* LUT0: BB: VS 0..6 */
-			10 60 20 00 00 00 00 /* LUT1: BW: VS 0..6 */
-			80 60 40 00 00 00 00 /* LUT2: WB: VS 0..6 */
-			10 60 20 00 00 00 00 /* LUT3: WW: VS 0..6 */
-			00 00 00 00 00 00 00 /* LUT4: VCOM: VS 0..6 */
-			/*
-			 * TPnx determines the length of each phase,
-			 * and RPn repeat count of a sequence.
-			 * TPnA, TPnB, TPnC, TPnD, RPn
-			 *
-			 * For example TP0A=3, TP0B=3, and RP0=2:
-			 * VS sequence                    : VSL-VSS-VSS-VSS
-			 * number of Gate Pulses (length) :  3   3   0   0
-			 * repeat count                   :        2
-			 */
-			03 03 00 00 02 /* TP0A TP0B TP0C TP0D RP0 */
-			09 09 00 00 02 /* TP1A TP1B TP1C TP1D RP1 */
-			03 03 00 00 02 /* 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 */
-		];
+
+		full {
+			gdv = [15];
+			sdv = [41 a8 32];
+			vcom = <0x26>;
+			border-waveform = <0x03>;
+			dummy-line = <0x30>;
+			gate-line-width = <0x0a>;
+			lut = [
+				/*
+				 * Waveform Composition
+				 *
+				 * There are 7 Voltage Source (VS) Level groups
+				 * n = {0,1,2...6}, each group contains
+				 * 4 phases x = {A,B,C,D}.
+				 * 2 bits represent the voltage in a phase:
+				 * 00 – VSS, 01 – VSH1, 10 – VSL, 11 - VSH2
+				 *
+				 * For example 0x80 represents sequence VSL-VSS-VSS-VSS,
+				 */
+				80 60 40 00 00 00 00 /* LUT0: BB: VS 0..6 */
+				10 60 20 00 00 00 00 /* LUT1: BW: VS 0..6 */
+				80 60 40 00 00 00 00 /* LUT2: WB: VS 0..6 */
+				10 60 20 00 00 00 00 /* LUT3: WW: VS 0..6 */
+				00 00 00 00 00 00 00 /* LUT4: VCOM: VS 0..6 */
+				/*
+				 * TPnx determines the length of each phase,
+				 * and RPn repeat count of a sequence.
+				 * TPnA, TPnB, TPnC, TPnD, RPn
+				 *
+				 * For example TP0A=3, TP0B=3, and RP0=2:
+				 * VS sequence                    : VSL-VSS-VSS-VSS
+				 * number of Gate Pulses (length) :  3   3   0   0
+				 * repeat count                   :        2
+				 */
+				03 03 00 00 02 /* TP0A TP0B TP0C TP0D RP0 */
+				09 09 00 00 02 /* TP1A TP1B TP1C TP1D RP1 */
+				03 03 00 00 02 /* 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 */
+			];
+		};
 
 		lut-default = [
 			00 00 00 00 00 00 00 /* LUT0: BB: VS0..6 */
diff --git a/boards/shields/waveshare_epaper/waveshare_epaper_gdeh0154a07.overlay b/boards/shields/waveshare_epaper/waveshare_epaper_gdeh0154a07.overlay
@@ -22,7 +22,11 @@
 		dc-gpios = <&arduino_header 15 GPIO_ACTIVE_LOW>;	/* D9 */
 		reset-gpios = <&arduino_header 14 GPIO_ACTIVE_LOW>;	/* D8 */
 		busy-gpios = <&arduino_header 13 GPIO_ACTIVE_HIGH>;	/* D7 */
-		border-waveform = <0x3c>;
+
 		tssv = <0x80>;
+
+		full {
+			border-waveform = <0x3c>;
+		};
 	};
 };
diff --git a/boards/shields/waveshare_epaper/waveshare_epaper_gdeh0213b1.overlay b/boards/shields/waveshare_epaper/waveshare_epaper_gdeh0213b1.overlay
@@ -22,18 +22,22 @@
 		dc-gpios = <&arduino_header 15 GPIO_ACTIVE_LOW>;	/* D9 */
 		reset-gpios = <&arduino_header 14 GPIO_ACTIVE_LOW>;	/* D8 */
 		busy-gpios = <&arduino_header 13 GPIO_ACTIVE_HIGH>;	/* D7 */
-		gdv = [10 0a];
-		sdv = [19];
-		vcom = <0xa8>;
-		border-waveform = <0x71>;
-		dummy-line = <0x1a>;
-		gate-line-width = <0x08>;
-		lut-initial = [
-			22 55 AA 55 AA 55 AA 11
-			00 00 00 00 00 00 00 00
-			1E 1E 1E 1E 1E 1E 1E 1E
-			01 00 00 00 00
-		];
+
+		full {
+			gdv = [10 0a];
+			sdv = [19];
+			vcom = <0xa8>;
+			border-waveform = <0x71>;
+			dummy-line = <0x1a>;
+			gate-line-width = <0x08>;
+			lut = [
+				22 55 AA 55 AA 55 AA 11
+				00 00 00 00 00 00 00 00
+				1E 1E 1E 1E 1E 1E 1E 1E
+				01 00 00 00 00
+			];
+		};
+
 		lut-default = [
 			18 00 00 00 00 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
@@ -22,26 +22,29 @@
 		dc-gpios = <&arduino_header 15 GPIO_ACTIVE_LOW>;	/* D9 */
 		reset-gpios = <&arduino_header 14 GPIO_ACTIVE_LOW>;	/* D8 */
 		busy-gpios = <&arduino_header 13 GPIO_ACTIVE_HIGH>;	/* D7 */
-		gdv = [15];
-		sdv = [41 a8 32];
-		vcom = <0x26>;
-		border-waveform = <0x03>;
-		dummy-line = <0x30>;
-		gate-line-width = <0x0a>;
-		lut-initial = [
-			80 60 40 00 00 00 00
-			10 60 20 00 00 00 00
-			80 60 40 00 00 00 00
-			10 60 20 00 00 00 00
-			00 00 00 00 00 00 00
-			03 03 00 00 02
-			09 09 00 00 02
-			03 03 00 00 02
-			00 00 00 00 00
-			00 00 00 00 00
-			00 00 00 00 00
-			00 00 00 00 00
-		];
+
+		full {
+			gdv = [15];
+			sdv = [41 a8 32];
+			vcom = <0x26>;
+			border-waveform = <0x03>;
+			dummy-line = <0x30>;
+			gate-line-width = <0x0a>;
+			lut = [
+				80 60 40 00 00 00 00
+				10 60 20 00 00 00 00
+				80 60 40 00 00 00 00
+				10 60 20 00 00 00 00
+				00 00 00 00 00 00 00
+				03 03 00 00 02
+				09 09 00 00 02
+				03 03 00 00 02
+				00 00 00 00 00
+				00 00 00 00 00
+				00 00 00 00 00
+				00 00 00 00 00
+			];
+		};
 
 		lut-default = [
 			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
@@ -22,19 +22,24 @@
 		dc-gpios = <&arduino_header 15 GPIO_ACTIVE_LOW>;	/* D9 */
 		reset-gpios = <&arduino_header 14 GPIO_ACTIVE_LOW>;	/* D8 */
 		busy-gpios = <&arduino_header 13 GPIO_ACTIVE_HIGH>;	/* D7 */
-		gdv = [16];
-		sdv = [0a];
-		vcom = <0xa8>;
-		border-waveform = <0x33>;
+
 		softstart = [d7 d6 9d];
-		dummy-line = <0x1a>;
-		gate-line-width = <0x08>;
-		lut-initial = [
-			50 AA 55 AA 11 00 00 00
-			00 00 00 00 00 00 00 00
-			00 00 00 00 FF FF 1F 00
-			00 00 00 00 00 00
-		];
+
+		full {
+			gdv = [16];
+			sdv = [0a];
+			vcom = <0xa8>;
+			border-waveform = <0x33>;
+			dummy-line = <0x1a>;
+			gate-line-width = <0x08>;
+			lut = [
+				50 AA 55 AA 11 00 00 00
+				00 00 00 00 00 00 00 00
+				00 00 00 00 FF FF 1F 00
+				00 00 00 00 00 00
+			];
+		};
+
 		lut-default = [
 			10 18 18 08 18 18 08 00
 			00 00 00 00 00 00 00 00
diff --git a/drivers/display/ssd16xx.c b/drivers/display/ssd16xx.c
diff --git a/dts/bindings/display/solomon,ssd16xx-common.yaml b/dts/bindings/display/solomon,ssd16xx-common.yaml
