1. Article purpose[edit | edit source]
The purpose of this article is to:
- List the display panel hardware components that might be integrated in the different boards.
- Link these components to the corresponding software framework(s).
- Point to the appropriate component datasheets.
- Explain, when necessary, how to configure these components.
Information |
Some of these hardware components are part of the accessories for STM32 boards like the B-LVDS7-WSVGA and the B-LCDAD-RPI1 for instance. |
2. Software frameworks[edit | edit source]
Domain | Peripheral | Software components | Comment | ||
---|---|---|---|---|---|
OP-TEE | Linux | STM32Cube | |||
Visual | Raydium RM68200 (MIPI® DSI) | DRM/KMS framework | MIPI® DSI panel driver | ||
Visual | Orise Tech OTM8009a (MIPI® DSI) | DRM/KMS framework | MIPI® DSI panel driver | ||
Visual | EDT ETML0700Z9NDHA (LVDS) | DRM/KMS framework | LVDS panel driver | ||
Visual | Raspberry Pi 7" Touch (MIPI® DSI) | DRM/KMS framework | MIPI® DSI panel driver | ||
Visual | Rocktech rk043fn48h (Parallel RGB DPI) | DRM/KMS framework | Parallel RGB (DPI) panel driver |
3. Raydium RM68200 (MIPI® DSI)[edit | edit source]
The Raydium RM68200 is a single-chip solution for a-Si TFT LCD that incorporates gate drivers and is capable of driving different panel resolutions. It supports MIPI® DSI Interface.
For details and the datasheet please contact the RM68200 driver provider.
Information |
This panel driver can be found on some STM32MP15 Evaluation boards. |
3.1. Linux driver[edit | edit source]
Bindings: Documentation/devicetree/bindings/display/panel/raydium,rm68200.yaml
Sources: drivers/gpu/drm/panel/panel-raydium-rm68200.c
Configuration: DRM_PANEL_RAYDIUM_RM68200
Devicetree example: arch/arm/boot/dts/st/stm32mp157d-ev1.dts
/ {
...
panel_backlight: panel-backlight {
compatible = "gpio-backlight";
gpios = <&gpiod 13 GPIO_ACTIVE_LOW>;
default-on;
status = "okay";
};
};
&dsi {
#address-cells = <1>;
#size-cells = <0>;
status = "okay";
ports {
#address-cells = <1>;
#size-cells = <0>;
port@0 {
reg = <0>;
dsi_in: endpoint {
remote-endpoint = <<dc_ep0_out>;
};
};
port@1 {
reg = <1>;
dsi_out: endpoint {
remote-endpoint = <&dsi_panel_in>;
};
};
};
panel_dsi: panel-dsi@0 {
compatible = "raydium,rm68200";
reg = <0>;
reset-gpios = <&gpiof 15 GPIO_ACTIVE_LOW>;
backlight = <&panel_backlight>;
power-supply = <&v3v3>;
status = "okay";
port {
dsi_panel_in: endpoint {
remote-endpoint = <&dsi_out>;
};
};
};
};
&i2c2 {
gt9147: goodix_ts@5d {
compatible = "goodix,gt9147";
reg = <0x5d>;
panel = <&panel_dsi>;
pinctrl-0 = <&goodix_pins>;
pinctrl-names = "default";
status = "okay";
interrupts = <14 IRQ_TYPE_EDGE_RISING>;
interrupt-parent = <&stmfx_pinctrl>;
};
};
<dc {
status = "okay";
port {
ltdc_ep0_out: endpoint@0 {
reg = <0>;
remote-endpoint = <&dsi_in>;
};
};
};
3.2. U-Boot driver[edit | edit source]
Sources: drivers/video/raydium-rm68200.c
4. Orise Tech OTM8009a (MIPI® DSI)[edit | edit source]
The Orise Tech OTM8009a is a MIPI® DSI panel driver.
For details and the datasheet please contact the OTM8009a driver provider.
Information |
This panel driver can be found on some STM32MP15 Discovery kits and in the B-LCD40-DSI1 STM32 accessory. |
4.1. Linux driver[edit | edit source]
Bindings: Documentation/devicetree/bindings/display/panel/orisetech,otm8009a.yaml
Sources: drivers/gpu/drm/panel/panel-orisetech-otm8009a.c
Configuration: DRM_PANEL_ORISETECH_OTM8009A
Devicetree example: arch/arm/boot/dts/st/stm32mp157f-dk2.dts
&dsi {
status = "okay";
ports {
port@0 {
reg = <0>;
dsi_in: endpoint {
remote-endpoint = <<dc_ep1_out>;
};
};
port@1 {
reg = <1>;
dsi_out: endpoint {
remote-endpoint = <&panel_in>;
};
};
};
panel_otm8009a: panel-otm8009a@0 {
compatible = "orisetech,otm8009a";
reg = <0>;
reset-gpios = <&gpioe 4 GPIO_ACTIVE_LOW>;
power-supply = <&v3v3>;
status = "okay";
port {
panel_in: endpoint {
remote-endpoint = <&dsi_out>;
};
};
};
};
&i2c1 {
touchscreen@2a {
compatible = "focaltech,ft6236";
reg = <0x2a>;
interrupts = <2 2>;
interrupt-parent = <&gpiof>;
interrupt-controller;
touchscreen-size-x = <480>;
touchscreen-size-y = <800>;
panel = <&panel_otm8009a>;
vcc-supply = <&v3v3>;
iovcc-supply = <&v3v3>;
status = "okay";
};
touchscreen@38 {
compatible = "focaltech,ft6236";
reg = <0x38>;
interrupts = <2 2>;
interrupt-parent = <&gpiof>;
interrupt-controller;
touchscreen-size-x = <480>;
touchscreen-size-y = <800>;
panel = <&panel_otm8009a>;
vcc-supply = <&v3v3>;
iovcc-supply = <&v3v3>;
status = "okay";
};
};
<dc {
status = "okay";
port {
ltdc_ep1_out: endpoint@1 {
reg = <1>;
remote-endpoint = <&dsi_in>;
};
};
};
4.2. U-Boot driver[edit | edit source]
Sources: drivers/video/orisetech_otm8009a.c
5. EDT ETML0700Z9NDHA (LVDS)[edit | edit source]
The EDT ETML0700Z9NDHA is a LVDS panel.
For details and the datasheet please contact the ETML0700Z9NDHA panel provider.
Information |
This panel can be found on some STM32MP257F EV1 Evaluation boards and in the B-LVDS7-WSVGA STM32 accessory. |
5.1. Linux driver[edit | edit source]
Bindings: Documentation/devicetree/bindings/display/lvds.yaml
Sources: drivers/gpu/drm/panel/panel-lvds.c
Devicetree example: arch/arm64/boot/dts/st/stm32mp257f-ev1.dts
5.2. U-Boot driver[edit | edit source]
There is no software driver dedicated to this LVDS panel. This panel configuration is directly described in the Device tree and the related LVDS internal peripheral software driver is in charge of loading it.
Sources: drivers/video/stm32/stm32_lvds.c (Related LVDS internal peripheral software driver)
6. Raspberry Pi 7" Touch (MIPI® DSI)[edit | edit source]
The Raspberry Pi 7" Touch Display is an integrated module including:
- a DSI to DPI bridge Toshiba TC358762;
- a DPI panel 800x480 7 inches with touchscreen;
- a power controller;
- a touchscreen controller.
For details and datasheet please contact the display provider [1].
The display can be plugged in the DSI connector CN4 of the board STM32MP157F-DK2 through the ribbon cable provided with the display.
Pay attention that the connector CN4 is wider than the ribbon cable; the proper connection requires the pin 1 of the ribbon cable to be plugged at the pin 1 of CN4. This requires the ribbon cable to touch only the edge of the connector CN4 that is closer to the ethernet plug, thus having empty space between the ribbon cable and the other edge of the connector CN4.
Two additional wires for 5V supply and GND are required between STM32MP157F-DK2 board and the display. Don't use a USB cable to power the display from the board because the board's USB plugs would be enabled too late for the display to operate. Use instead two of the spare wires provided with the display and connect:
- STM32MP157F-DK2 connector CN2 pin 2 to display connector GPIO pin 5V;
- STM32MP157F-DK2 connector CN2 pin 6 to display connector GPIO pin GND.
Information |
This panel can be found in the B-LCDAD-RPI1 STM32 accessory. |
6.1. Linux driver[edit | edit source]
Bindings:
- Documentation/devicetree/bindings/display/bridge/toshiba,tc358762.yaml
- Documentation/devicetree/bindings/display/panel/panel-simple.yaml
- Documentation/devicetree/bindings/regulator/raspberrypi,7inch-touchscreen-panel-regulator.yaml
Sources:
- drivers/gpu/drm/bridge/tc358762.c
- drivers/gpu/drm/panel/panel-simple.c
- drivers/regulator/rpi-panel-attiny-regulator.c
Configuration:
- DRM_TOSHIBA_TC358762
- DRM_PANEL_SIMPLE
- REGULATOR_RASPBERRYPI_TOUCHSCREEN_ATTINY
Information |
Different versions of the panel use different touchscreen controllers. The touchscreen is not further described here. |
Information |
Don't use the old driver Documentation/devicetree/bindings/display/panel/raspberrypi,7inch-touchscreen.yaml . It has been replaced by the new driver since kernel v5.10. |
Devicetree example:
&dsi {
status = "okay";
ports {
port@0 {
reg = <0>;
dsi_in: endpoint {
remote-endpoint = <<dc_ep1_out>;
};
};
port@1 {
reg = <1>;
dsi_out: endpoint {
remote-endpoint = <&bridge_in>;
};
};
};
bridge@0 {
compatible = "toshiba,tc358762";
reg = <0>;
vddc-supply = <®_rpi>;
status = "okay";
ports {
#address-cells = <1>;
#size-cells = <0>;
port@0 {
reg = <0>;
bridge_in: endpoint {
remote-endpoint = <&dsi_out>;
};
};
port@1 {
reg = <1>;
bridge_out: endpoint {
remote-endpoint = <&panel_in>;
};
};
};
};
};
/ {
panel-rgb {
/* Unknown; use a reasonably similar one */
compatible = "powertip,ph800480t013-idf02";
power-supply = <®_rpi>;
status = "okay";
port {
panel_in: endpoint {
remote-endpoint = <&bridge_out>;
};
};
};
};
&i2c1 {
reg_rpi: regulator@45 {
compatible = "raspberrypi,7inch-touchscreen-panel-regulator";
reg = <0x45>;
vin-supply = <&v3v3>;
status = "okay";
};
};
6.2. U-Boot driver[edit | edit source]
Not available.
7. Rocktech rk043fn48h (Parallel RGB DPI)[edit | edit source]
The Rocktech rk043fn48h is a parallel RGB panel driver.
For details and the datasheet please contact the rk043fn48h driver provider.
Information |
This panel driver can be found on some STM32MP13 Discovery kits. |
7.1. Linux driver[edit | edit source]
Bindings: Documentation/devicetree/bindings/display/panel/panel-dpi.yaml
Sources: drivers/gpu/drm/panel/panel-simple.c
Configuration: DRM_PANEL_SIMPLE
Devicetree example: arch/arm/boot/dts/st/stm32mp135f-dk.dts
/ {
...
panel_backlight: panel-backlight {
compatible = "gpio-backlight";
gpios = <&gpioe 12 GPIO_ACTIVE_HIGH>;
default-on;
default-brightness-level = <0>;
status = "okay";
};
panel_rgb: panel-rgb {
compatible = "rocktech,rk043fn48h", "panel-dpi";
enable-gpios = <&gpioi 7 GPIO_ACTIVE_HIGH>;
backlight = <&panel_backlight>;
power-supply = <&scmi_v3v3_sw>;
status = "okay";
width-mm = <105>;
height-mm = <67>;
port {
panel_in_rgb: endpoint {
remote-endpoint = <<dc_out_rgb>;
};
};
panel-timing {
clock-frequency = <10000000>;
hactive = <480>;
vactive = <272>;
hsync-len = <52>;
hfront-porch = <10>;
hback-porch = <10>;
vsync-len = <10>;
vfront-porch = <10>;
vback-porch = <10>;
};
};
...
};
&i2c5 {
...
goodix: goodix_ts@5d {
compatible = "goodix,gt911";
reg = <0x5d>;
pinctrl-names = "default";
pinctrl-0 = <&goodix_pins_a>;
interrupt-parent = <&gpiof>;
interrupts = <5 IRQ_TYPE_EDGE_FALLING>;
reset-gpios = <&gpioh 2 GPIO_ACTIVE_LOW>;
AVDD28-supply = <&scmi_v3v3_sw>;
VDDIO-supply = <&scmi_v3v3_sw>;
touchscreen-size-x = <480>;
touchscreen-size-y = <272>;
status = "okay" ;
};
};
<dc {
pinctrl-names = "default", "sleep";
pinctrl-0 = <<dc_pins_a>;
pinctrl-1 = <<dc_sleep_pins_a>;
status = "okay";
port {
#address-cells = <1>;
#size-cells = <0>;
ltdc_out_rgb: endpoint@0 {
reg = <0>;
remote-endpoint = <&panel_in_rgb>;
};
};
};
Devicetree pin control bindings example: arch/arm/boot/dts/st/stm32mp13-pinctrl.dtsi
&pinctrl {
...
ltdc_pins_a: ltdc-0 {
pins {
pinmux = <STM32_PINMUX('D', 9, AF13)>, /* LCD_CLK */
<STM32_PINMUX('C', 6, AF14)>, /* LCD_HSYNC */
<STM32_PINMUX('G', 4, AF11)>, /* LCD_VSYNC */
<STM32_PINMUX('H', 9, AF11)>, /* LCD_DE */
<STM32_PINMUX('G', 7, AF14)>, /* LCD_R2 */
<STM32_PINMUX('B', 12, AF13)>, /* LCD_R3 */
<STM32_PINMUX('D', 14, AF14)>, /* LCD_R4 */
<STM32_PINMUX('E', 7, AF14)>, /* LCD_R5 */
<STM32_PINMUX('E', 13, AF14)>, /* LCD_R6 */
<STM32_PINMUX('E', 9, AF14)>, /* LCD_R7 */
<STM32_PINMUX('H', 13, AF14)>, /* LCD_G2 */
<STM32_PINMUX('F', 3, AF14)>, /* LCD_G3 */
<STM32_PINMUX('D', 5, AF14)>, /* LCD_G4 */
<STM32_PINMUX('G', 0, AF14)>, /* LCD_G5 */
<STM32_PINMUX('C', 7, AF14)>, /* LCD_G6 */
<STM32_PINMUX('A', 15, AF11)>, /* LCD_G7 */
<STM32_PINMUX('D', 10, AF14)>, /* LCD_B2 */
<STM32_PINMUX('F', 2, AF14)>, /* LCD_B3 */
<STM32_PINMUX('H', 14, AF11)>, /* LCD_B4 */
<STM32_PINMUX('E', 0, AF14)>, /* LCD_B5 */
<STM32_PINMUX('B', 6, AF7)>, /* LCD_B6 */
<STM32_PINMUX('F', 1, AF13)>; /* LCD_B7 */
bias-disable;
drive-push-pull;
slew-rate = <0>;
};
};
ltdc_sleep_pins_a: ltdc-sleep-0 {
pins {
pinmux = <STM32_PINMUX('D', 9, ANALOG)>, /* LCD_CLK */
<STM32_PINMUX('C', 6, ANALOG)>, /* LCD_HSYNC */
<STM32_PINMUX('G', 4, ANALOG)>, /* LCD_VSYNC */
<STM32_PINMUX('H', 9, ANALOG)>, /* LCD_DE */
<STM32_PINMUX('G', 7, ANALOG)>, /* LCD_R2 */
<STM32_PINMUX('B', 12, ANALOG)>, /* LCD_R3 */
<STM32_PINMUX('D', 14, ANALOG)>, /* LCD_R4 */
<STM32_PINMUX('E', 7, ANALOG)>, /* LCD_R5 */
<STM32_PINMUX('E', 13, ANALOG)>, /* LCD_R6 */
<STM32_PINMUX('E', 9, ANALOG)>, /* LCD_R7 */
<STM32_PINMUX('H', 13, ANALOG)>, /* LCD_G2 */
<STM32_PINMUX('F', 3, ANALOG)>, /* LCD_G3 */
<STM32_PINMUX('D', 5, ANALOG)>, /* LCD_G4 */
<STM32_PINMUX('G', 0, ANALOG)>, /* LCD_G5 */
<STM32_PINMUX('C', 7, ANALOG)>, /* LCD_G6 */
<STM32_PINMUX('A', 15, ANALOG)>, /* LCD_G7 */
<STM32_PINMUX('D', 10, ANALOG)>, /* LCD_B2 */
<STM32_PINMUX('F', 2, ANALOG)>, /* LCD_B3 */
<STM32_PINMUX('H', 14, ANALOG)>, /* LCD_B4 */
<STM32_PINMUX('E', 0, ANALOG)>, /* LCD_B5 */
<STM32_PINMUX('B', 6, ANALOG)>, /* LCD_B6 */
<STM32_PINMUX('F', 1, ANALOG)>; /* LCD_B7 */
};
};
};
7.2. U-Boot driver[edit | edit source]
There is no software driver dedicated to this panel. This panel configuration is directly described in the Device tree and the related U-Boot panel simple software driver is in charge of loading it.
Sources: drivers/video/simple_panel.c (Related panel simple software driver)
8. References[edit | edit source]