* [PATCH V2 0/2] drm/panel: Add Samsung AMS495QA01 Panel @ 2022-09-20 17:09 Chris Morgan 2022-09-20 17:09 ` [PATCH V2 1/2] dt-bindings: display: panel: Add Samsung AMS495QA01 bindings Chris Morgan 2022-09-20 17:09 ` [PATCH V2 2/2] drm/panel: Add Samsung AMS495QA01 MIPI-DSI LCD panel Chris Morgan 0 siblings, 2 replies; 7+ messages in thread From: Chris Morgan @ 2022-09-20 17:09 UTC (permalink / raw) To: dri-devel Cc: devicetree, krzysztof.kozlowski+dt, robh+dt, daniel, airlied, sam, thierry.reding, Chris Morgan From: Chris Morgan <macromorgan@hotmail.com> Add the Samsung AMS495QA01 panel as found on the Anbernic RG503. This panel uses DSI to receive video signals, but 3-wire SPI to receive command signals. Changes since V1: - Removed errant reference to backlight in documentation. This is an OLED panel. - Made elvss regulator optional. In my case its hard wired and not controllable. - Added "prepared" enum to track panel status to prevent unbalanced regulator enable/disable. Chris Morgan (2): dt-bindings: display: panel: Add Samsung AMS495QA01 bindings drm/panel: Add Samsung AMS495QA01 MIPI-DSI LCD panel .../display/panel/samsung,ams495qa01.yaml | 46 ++ drivers/gpu/drm/panel/Kconfig | 10 + drivers/gpu/drm/panel/Makefile | 1 + .../gpu/drm/panel/panel-samsung-ams495qa01.c | 505 ++++++++++++++++++ 4 files changed, 562 insertions(+) create mode 100644 Documentation/devicetree/bindings/display/panel/samsung,ams495qa01.yaml create mode 100644 drivers/gpu/drm/panel/panel-samsung-ams495qa01.c -- 2.25.1 ^ permalink raw reply [flat|nested] 7+ messages in thread
* [PATCH V2 1/2] dt-bindings: display: panel: Add Samsung AMS495QA01 bindings 2022-09-20 17:09 [PATCH V2 0/2] drm/panel: Add Samsung AMS495QA01 Panel Chris Morgan @ 2022-09-20 17:09 ` Chris Morgan 2022-09-20 17:38 ` Maya Matuszczyk 2022-09-21 7:23 ` Krzysztof Kozlowski 2022-09-20 17:09 ` [PATCH V2 2/2] drm/panel: Add Samsung AMS495QA01 MIPI-DSI LCD panel Chris Morgan 1 sibling, 2 replies; 7+ messages in thread From: Chris Morgan @ 2022-09-20 17:09 UTC (permalink / raw) To: dri-devel Cc: devicetree, krzysztof.kozlowski+dt, robh+dt, daniel, airlied, sam, thierry.reding, Chris Morgan From: Chris Morgan <macromorgan@hotmail.com> Add documentation for the Samsung AMS495QA01 panel. Signed-off-by: Chris Morgan <macromorgan@hotmail.com> --- .../display/panel/samsung,ams495qa01.yaml | 46 +++++++++++++++++++ 1 file changed, 46 insertions(+) create mode 100644 Documentation/devicetree/bindings/display/panel/samsung,ams495qa01.yaml diff --git a/Documentation/devicetree/bindings/display/panel/samsung,ams495qa01.yaml b/Documentation/devicetree/bindings/display/panel/samsung,ams495qa01.yaml new file mode 100644 index 000000000000..08358cdad19c --- /dev/null +++ b/Documentation/devicetree/bindings/display/panel/samsung,ams495qa01.yaml @@ -0,0 +1,46 @@ +# SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause) +%YAML 1.2 +--- +$id: http://devicetree.org/schemas/display/panel/samsung,ams495qa01.yaml# +$schema: http://devicetree.org/meta-schemas/core.yaml# + +title: Samsung AMS495QA01 4.95in 960x544 DSI/SPI panel + +maintainers: + - Chris Morgan <macromorgan@hotmail.com> + +allOf: + - $ref: panel-common.yaml# + +properties: + compatible: + const: samsung,ams495qa01 + reg: true + reset-gpios: true + elvdd-supply: + description: regulator that supplies voltage to the panel display + enable-gpios: true + port: true + vdd-supply: + description: regulator that supplies voltage to panel logic + +required: + - compatible + - reg + - vdd-supply + +additionalProperties: false + +examples: + - | + spi { + #address-cells = <1>; + #size-cells = <0>; + panel@0 { + compatible = "samsung,ams495qa01"; + reg = <0>; + vdd-supply = <&vcc3v3_lcd0_n>; + }; + }; + +... -- 2.25.1 ^ permalink raw reply related [flat|nested] 7+ messages in thread
* Re: [PATCH V2 1/2] dt-bindings: display: panel: Add Samsung AMS495QA01 bindings 2022-09-20 17:09 ` [PATCH V2 1/2] dt-bindings: display: panel: Add Samsung AMS495QA01 bindings Chris Morgan @ 2022-09-20 17:38 ` Maya Matuszczyk 2022-09-21 7:23 ` Krzysztof Kozlowski 1 sibling, 0 replies; 7+ messages in thread From: Maya Matuszczyk @ 2022-09-20 17:38 UTC (permalink / raw) To: Chris Morgan Cc: dri-devel, devicetree, krzysztof.kozlowski+dt, airlied, Chris Morgan, robh+dt, thierry.reding, sam Hello, Thanks for the patch, It's so nice seeing more pieces of RG503 being upstreamed. wt., 20 wrz 2022 o 19:10 Chris Morgan <macroalpha82@gmail.com> napisał(a): > > From: Chris Morgan <macromorgan@hotmail.com> > > Add documentation for the Samsung AMS495QA01 panel. > > Signed-off-by: Chris Morgan <macromorgan@hotmail.com> > --- > .../display/panel/samsung,ams495qa01.yaml | 46 +++++++++++++++++++ > 1 file changed, 46 insertions(+) > create mode 100644 Documentation/devicetree/bindings/display/panel/samsung,ams495qa01.yaml > > diff --git a/Documentation/devicetree/bindings/display/panel/samsung,ams495qa01.yaml b/Documentation/devicetree/bindings/display/panel/samsung,ams495qa01.yaml > new file mode 100644 > index 000000000000..08358cdad19c > --- /dev/null > +++ b/Documentation/devicetree/bindings/display/panel/samsung,ams495qa01.yaml > @@ -0,0 +1,46 @@ > +# SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause) > +%YAML 1.2 > +--- > +$id: http://devicetree.org/schemas/display/panel/samsung,ams495qa01.yaml# > +$schema: http://devicetree.org/meta-schemas/core.yaml# > + > +title: Samsung AMS495QA01 4.95in 960x544 DSI/SPI panel > + > +maintainers: > + - Chris Morgan <macromorgan@hotmail.com> > + > +allOf: > + - $ref: panel-common.yaml# > + > +properties: > + compatible: > + const: samsung,ams495qa01 > + reg: true > + reset-gpios: true > + elvdd-supply: > + description: regulator that supplies voltage to the panel display Datasheet says about that pin: "Power pin for module analog", maybe in description that could be accounted for? > + enable-gpios: true > + port: true > + vdd-supply: > + description: regulator that supplies voltage to panel logic Maybe change that to "panel's logic"? > + > +required: > + - compatible > + - reg > + - vdd-supply > + > +additionalProperties: false > + > +examples: > + - | > + spi { > + #address-cells = <1>; > + #size-cells = <0>; > + panel@0 { > + compatible = "samsung,ams495qa01"; > + reg = <0>; > + vdd-supply = <&vcc3v3_lcd0_n>; > + }; Where's the node of DSI controller the panel's attached to? > + }; > + > +... > -- > 2.25.1 > Best Regards, Maya Matuszczyk ^ permalink raw reply [flat|nested] 7+ messages in thread
* Re: [PATCH V2 1/2] dt-bindings: display: panel: Add Samsung AMS495QA01 bindings 2022-09-20 17:09 ` [PATCH V2 1/2] dt-bindings: display: panel: Add Samsung AMS495QA01 bindings Chris Morgan 2022-09-20 17:38 ` Maya Matuszczyk @ 2022-09-21 7:23 ` Krzysztof Kozlowski 1 sibling, 0 replies; 7+ messages in thread From: Krzysztof Kozlowski @ 2022-09-21 7:23 UTC (permalink / raw) To: Chris Morgan, dri-devel Cc: devicetree, krzysztof.kozlowski+dt, robh+dt, daniel, airlied, sam, thierry.reding, Chris Morgan On 20/09/2022 19:09, Chris Morgan wrote: > From: Chris Morgan <macromorgan@hotmail.com> > > Add documentation for the Samsung AMS495QA01 panel. > > Signed-off-by: Chris Morgan <macromorgan@hotmail.com> > --- > .../display/panel/samsung,ams495qa01.yaml | 46 +++++++++++++++++++ > 1 file changed, 46 insertions(+) > create mode 100644 Documentation/devicetree/bindings/display/panel/samsung,ams495qa01.yaml > > diff --git a/Documentation/devicetree/bindings/display/panel/samsung,ams495qa01.yaml b/Documentation/devicetree/bindings/display/panel/samsung,ams495qa01.yaml > new file mode 100644 > index 000000000000..08358cdad19c > --- /dev/null > +++ b/Documentation/devicetree/bindings/display/panel/samsung,ams495qa01.yaml > @@ -0,0 +1,46 @@ > +# SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause) > +%YAML 1.2 > +--- > +$id: http://devicetree.org/schemas/display/panel/samsung,ams495qa01.yaml# > +$schema: http://devicetree.org/meta-schemas/core.yaml# > + > +title: Samsung AMS495QA01 4.95in 960x544 DSI/SPI panel > + > +maintainers: > + - Chris Morgan <macromorgan@hotmail.com> > + > +allOf: > + - $ref: panel-common.yaml# > + > +properties: > + compatible: > + const: samsung,ams495qa01 Blank line. > + reg: true > + reset-gpios: true > + elvdd-supply: > + description: regulator that supplies voltage to the panel display > + enable-gpios: true > + port: true > + vdd-supply: > + description: regulator that supplies voltage to panel logic Best regards, Krzysztof ^ permalink raw reply [flat|nested] 7+ messages in thread
* [PATCH V2 2/2] drm/panel: Add Samsung AMS495QA01 MIPI-DSI LCD panel 2022-09-20 17:09 [PATCH V2 0/2] drm/panel: Add Samsung AMS495QA01 Panel Chris Morgan 2022-09-20 17:09 ` [PATCH V2 1/2] dt-bindings: display: panel: Add Samsung AMS495QA01 bindings Chris Morgan @ 2022-09-20 17:09 ` Chris Morgan 2022-09-20 17:33 ` Maya Matuszczyk 1 sibling, 1 reply; 7+ messages in thread From: Chris Morgan @ 2022-09-20 17:09 UTC (permalink / raw) To: dri-devel Cc: devicetree, krzysztof.kozlowski+dt, robh+dt, daniel, airlied, sam, thierry.reding, Chris Morgan From: Chris Morgan <macromorgan@hotmail.com> Support Samsung AMS495QA01 panel as found on the Anbernic RG503. Note This panel receives video signals via DSI, however it receives commands via 3-wire SPI. Signed-off-by: Chris Morgan <macromorgan@hotmail.com> --- drivers/gpu/drm/panel/Kconfig | 10 + drivers/gpu/drm/panel/Makefile | 1 + .../gpu/drm/panel/panel-samsung-ams495qa01.c | 505 ++++++++++++++++++ 3 files changed, 516 insertions(+) create mode 100644 drivers/gpu/drm/panel/panel-samsung-ams495qa01.c diff --git a/drivers/gpu/drm/panel/Kconfig b/drivers/gpu/drm/panel/Kconfig index a9043eacce97..954b66a2adee 100644 --- a/drivers/gpu/drm/panel/Kconfig +++ b/drivers/gpu/drm/panel/Kconfig @@ -444,6 +444,16 @@ config DRM_PANEL_RONBO_RB070D30 Say Y here if you want to enable support for Ronbo Electronics RB070D30 1024x600 DSI panel. +config DRM_PANEL_SAMSUNG_AMS495QA01 + tristate "Samsung AMS495QA01 DSI panel" + depends on OF && SPI + depends on DRM_MIPI_DSI + select DRM_MIPI_DBI + help + DRM panel driver for the Samsung AMS495QA01 panel. This panel + receives video data via DSI but commands via 3-Wire 9-bit + SPI. + config DRM_PANEL_SAMSUNG_ATNA33XC20 tristate "Samsung ATNA33XC20 eDP panel" depends on OF diff --git a/drivers/gpu/drm/panel/Makefile b/drivers/gpu/drm/panel/Makefile index 34e717382dbb..de0b57baf851 100644 --- a/drivers/gpu/drm/panel/Makefile +++ b/drivers/gpu/drm/panel/Makefile @@ -42,6 +42,7 @@ obj-$(CONFIG_DRM_PANEL_RASPBERRYPI_TOUCHSCREEN) += panel-raspberrypi-touchscreen obj-$(CONFIG_DRM_PANEL_RAYDIUM_RM67191) += panel-raydium-rm67191.o obj-$(CONFIG_DRM_PANEL_RAYDIUM_RM68200) += panel-raydium-rm68200.o obj-$(CONFIG_DRM_PANEL_RONBO_RB070D30) += panel-ronbo-rb070d30.o +obj-$(CONFIG_DRM_PANEL_SAMSUNG_AMS495QA01) += panel-samsung-ams495qa01.o obj-$(CONFIG_DRM_PANEL_SAMSUNG_ATNA33XC20) += panel-samsung-atna33xc20.o obj-$(CONFIG_DRM_PANEL_SAMSUNG_DB7430) += panel-samsung-db7430.o obj-$(CONFIG_DRM_PANEL_SAMSUNG_LD9040) += panel-samsung-ld9040.o diff --git a/drivers/gpu/drm/panel/panel-samsung-ams495qa01.c b/drivers/gpu/drm/panel/panel-samsung-ams495qa01.c new file mode 100644 index 000000000000..d693ba5f20c9 --- /dev/null +++ b/drivers/gpu/drm/panel/panel-samsung-ams495qa01.c @@ -0,0 +1,505 @@ +// SPDX-License-Identifier: GPL-2.0 +/* + * Samsung ams495qa01 MIPI-DSI panel driver + * Copyright (C) 2022 Chris Morgan + */ + +#include <drm/drm_mipi_dbi.h> +#include <drm/drm_mipi_dsi.h> +#include <drm/drm_modes.h> +#include <drm/drm_panel.h> + +#include <linux/backlight.h> +#include <linux/delay.h> +#include <linux/gpio/consumer.h> +#include <linux/init.h> +#include <linux/kernel.h> +#include <linux/media-bus-format.h> +#include <linux/module.h> +#include <linux/of.h> +#include <linux/of_graph.h> +#include <linux/regulator/consumer.h> +#include <linux/spi/spi.h> + +#include <video/mipi_display.h> + +struct ams495qa01 { + /** @dev: the container device */ + struct device *dev; + /** @dbi: the DBI bus abstraction handle */ + struct mipi_dbi dbi; + /** @panel: the DRM panel instance for this device */ + struct drm_panel panel; + /** @reset: reset GPIO line */ + struct gpio_desc *reset; + /** @enable: enable GPIO line */ + struct gpio_desc *enable; + /** @reg_vdd: VDD supply regulator for panel logic */ + struct regulator *reg_vdd; + /** @reg_elvdd: ELVDD supply regulator for panel display */ + struct regulator *reg_elvdd; + /** @dsi_dev: DSI child device (panel) */ + struct mipi_dsi_device *dsi_dev; + /** @bl_dev: pseudo-backlight device for oled panel */ + struct backlight_device *bl_dev; + /** @prepared: value tracking panel prepare status */ + bool prepared; +}; + +static const struct drm_display_mode ams495qa01_mode = { + .clock = 33500, + .hdisplay = 960, + .hsync_start = 960 + 10, + .hsync_end = 960 + 10 + 2, + .htotal = 960 + 10 + 2 + 10, + .vdisplay = 544, + .vsync_start = 544 + 10, + .vsync_end = 544 + 10 + 2, + .vtotal = 544 + 10 + 2 + 10, + .width_mm = 117, + .height_mm = 74, + .flags = DRM_MODE_FLAG_NHSYNC | DRM_MODE_FLAG_NVSYNC, +}; + +#define NUM_GAMMA_LEVELS 16 +#define GAMMA_TABLE_COUNT 23 +#define MAX_BRIGHTNESS (NUM_GAMMA_LEVELS - 1) + +/* Table of gamma values provided in datasheet */ +static u8 ams495qa01_gamma[NUM_GAMMA_LEVELS][GAMMA_TABLE_COUNT] = { + {0x01, 0x79, 0x78, 0x8d, 0xd9, 0xdf, 0xd5, 0xcb, 0xcf, 0xc5, + 0xe5, 0xe0, 0xe4, 0xdc, 0xb8, 0xd4, 0xfa, 0xed, 0xe6, 0x2f, + 0x00, 0x2f}, + {0x01, 0x7d, 0x7c, 0x92, 0xd7, 0xdd, 0xd2, 0xcb, 0xd0, 0xc6, + 0xe5, 0xe1, 0xe3, 0xda, 0xbd, 0xd3, 0xfa, 0xed, 0xe6, 0x2f, + 0x00, 0x2f}, + {0x01, 0x7f, 0x7e, 0x95, 0xd7, 0xde, 0xd2, 0xcb, 0xcf, 0xc5, + 0xe5, 0xe3, 0xe3, 0xda, 0xbf, 0xd3, 0xfa, 0xed, 0xe6, 0x2f, + 0x00, 0x2f}, + {0x01, 0x82, 0x81, 0x99, 0xd6, 0xdd, 0xd1, 0xca, 0xcf, 0xc3, + 0xe4, 0xe3, 0xe3, 0xda, 0xc2, 0xd3, 0xfa, 0xed, 0xe6, 0x2f, + 0x00, 0x2f}, + {0x01, 0x84, 0x83, 0x9b, 0xd7, 0xde, 0xd2, 0xc8, 0xce, 0xc2, + 0xe4, 0xe3, 0xe2, 0xd9, 0xc3, 0xd3, 0xfa, 0xed, 0xe6, 0x2f, + 0x00, 0x2f}, + {0x01, 0x87, 0x86, 0x9f, 0xd6, 0xdd, 0xd1, 0xc7, 0xce, 0xc1, + 0xe4, 0xe3, 0xe2, 0xd9, 0xc6, 0xd3, 0xfa, 0xed, 0xe6, 0x2f, + 0x00, 0x2f}, + {0x01, 0x89, 0x89, 0xa2, 0xd5, 0xdb, 0xcf, 0xc8, 0xcf, 0xc2, + 0xe3, 0xe3, 0xe1, 0xd9, 0xc7, 0xd3, 0xfa, 0xed, 0xe6, 0x2f, + 0x00, 0x2f}, + {0x01, 0x8b, 0x8b, 0xa5, 0xd5, 0xdb, 0xcf, 0xc7, 0xce, 0xc0, + 0xe3, 0xe3, 0xe1, 0xd8, 0xc7, 0xd3, 0xfa, 0xed, 0xe6, 0x2f, + 0x00, 0x2f}, + {0x01, 0x8d, 0x8d, 0xa7, 0xd5, 0xdb, 0xcf, 0xc6, 0xce, 0xc0, + 0xe4, 0xe4, 0xe1, 0xd7, 0xc8, 0xd3, 0xfa, 0xed, 0xe6, 0x2f, + 0x00, 0x2f}, + {0x01, 0x8f, 0x8f, 0xaa, 0xd4, 0xdb, 0xce, 0xc6, 0xcd, 0xbf, + 0xe3, 0xe3, 0xe1, 0xd7, 0xca, 0xd3, 0xfa, 0xed, 0xe6, 0x2f, + 0x00, 0x2f}, + {0x01, 0x91, 0x91, 0xac, 0xd3, 0xda, 0xce, 0xc5, 0xcd, 0xbe, + 0xe3, 0xe3, 0xe0, 0xd7, 0xca, 0xd3, 0xfa, 0xed, 0xe6, 0x2f, + 0x00, 0x2f}, + {0x01, 0x93, 0x93, 0xaf, 0xd3, 0xda, 0xcd, 0xc5, 0xcd, 0xbe, + 0xe2, 0xe3, 0xdf, 0xd6, 0xca, 0xd3, 0xfa, 0xed, 0xe6, 0x2f, + 0x00, 0x2f}, + {0x01, 0x95, 0x95, 0xb1, 0xd2, 0xd9, 0xcc, 0xc4, 0xcd, 0xbe, + 0xe2, 0xe3, 0xdf, 0xd7, 0xcc, 0xd3, 0xfa, 0xed, 0xe6, 0x2f, + 0x00, 0x2f}, + {0x01, 0x99, 0x99, 0xb6, 0xd1, 0xd9, 0xcc, 0xc3, 0xcb, 0xbc, + 0xe2, 0xe4, 0xdf, 0xd6, 0xcc, 0xd3, 0xfa, 0xed, 0xe6, 0x2f, + 0x00, 0x2f}, + {0x01, 0x9c, 0x9c, 0xba, 0xd0, 0xd8, 0xcb, 0xc3, 0xcb, 0xbb, + 0xe2, 0xe4, 0xdf, 0xd6, 0xce, 0xd3, 0xfa, 0xed, 0xe6, 0x2f, + 0x00, 0x2f}, + {0x01, 0x9f, 0x9f, 0xbe, 0xcf, 0xd7, 0xc9, 0xc2, 0xcb, 0xbb, + 0xe1, 0xe3, 0xde, 0xd6, 0xd0, 0xd3, 0xfa, 0xed, 0xe6, 0x2f, + 0x00, 0x2f}, +}; + +/* + * Table of elvss values provided in datasheet and corresponds to + * gamma values. + */ +static u8 ams495qa01_elvss[NUM_GAMMA_LEVELS] = { + 0x15, 0x15, 0x15, 0x15, 0x15, 0x15, 0x15, 0x15, 0x15, 0x15, + 0x15, 0x15, 0x14, 0x14, 0x13, 0x12, +}; + +static inline struct ams495qa01 *to_ams495qa01(struct drm_panel *panel) +{ + return container_of(panel, struct ams495qa01, panel); +} + +static int ams495qa01_update_gamma(struct mipi_dbi *dbi, u32 brightness) +{ + u32 tmp = brightness; + + if (brightness > MAX_BRIGHTNESS) + tmp = MAX_BRIGHTNESS; + + /* Set gamma values */ + mipi_dbi_command_buf(dbi, 0xf9, ams495qa01_gamma[tmp], + ARRAY_SIZE(ams495qa01_gamma[tmp])); + /* Set gamma change */ + mipi_dbi_command(dbi, 0xf9, 0x00); + /* Undocumented command */ + mipi_dbi_command(dbi, 0x26, 0x00); + /* Set ELVSS value */ + mipi_dbi_command(dbi, 0xb2, ams495qa01_elvss[tmp]); + + return 0; +} + +static int ams495qa01_prepare(struct drm_panel *panel) +{ + struct ams495qa01 *db = to_ams495qa01(panel); + struct mipi_dbi *dbi = &db->dbi; + int ret; + + if (db->prepared) + return 0; + + /* Power up */ + ret = regulator_enable(db->reg_vdd); + if (ret) { + dev_err(db->dev, "failed to enable vdd regulator: %d\n", ret); + return ret; + } + if (db->reg_elvdd) { + ret = regulator_enable(db->reg_elvdd); + if (ret) { + dev_err(db->dev, + "failed to enable elvdd regulator: %d\n", ret); + regulator_disable(db->reg_vdd); + return ret; + } + } + + /* Enable */ + if (db->enable) + gpiod_set_value_cansleep(db->enable, 1); + + msleep(50); + + /* Reset */ + gpiod_set_value_cansleep(db->reset, 1); + usleep_range(1000, 5000); + gpiod_set_value_cansleep(db->reset, 0); + msleep(20); + + /* Panel Init Sequence */ + + /* Password to start command sequence */ + mipi_dbi_command(dbi, 0xf0, 0x5a, 0x5a); + mipi_dbi_command(dbi, 0xf1, 0x5a, 0x5a); + + /* Undocumented commands */ + mipi_dbi_command(dbi, 0xb0, 0x02); + mipi_dbi_command(dbi, 0xf3, 0x3b); + + /* Analog Power condition set */ + mipi_dbi_command(dbi, 0xf4, 0x33, 0x42, 0x00, 0x08); + mipi_dbi_command(dbi, 0xf5, 0x00, 0x06, 0x26, 0x35, 0x03); + + /* Undocumented commands */ + mipi_dbi_command(dbi, 0xf6, 0x02); + mipi_dbi_command(dbi, 0xc6, 0x0b, 0x00, 0x00, 0x3c, 0x00, 0x22, + 0x00, 0x00, 0x00, 0x00); + + /* GTCON set */ + mipi_dbi_command(dbi, 0xf7, 0x20); + + /* TEMP_SWIRE set */ + mipi_dbi_command(dbi, 0xb2, 0x06, 0x06, 0x06, 0x06); + + /* ELVSS_CON set */ + mipi_dbi_command(dbi, 0xb1, 0x07, 0x00, 0x10); + + /* Gateless signal set */ + mipi_dbi_command(dbi, 0xf8, 0x7f, 0x7a, 0x89, 0x67, 0x26, 0x38, + 0x00, 0x00, 0x09, 0x67, 0x70, 0x88, 0x7a, + 0x76, 0x05, 0x09, 0x23, 0x23, 0x23); + + /* Undocumented commands */ + mipi_dbi_command(dbi, 0xb5, 0xff, 0xef, 0x35, 0x42, 0x0d, 0xd7, + 0xff, 0x07, 0xff, 0xff, 0xfd, 0x00, 0x01, + 0xff, 0x05, 0x12, 0x0f, 0xff, 0xff, 0xff, + 0xff); + mipi_dbi_command(dbi, 0xb4, 0x15); + mipi_dbi_command(dbi, 0xb3, 0x00); + + ams495qa01_update_gamma(dbi, MAX_BRIGHTNESS); + + mipi_dbi_command(dbi, MIPI_DCS_EXIT_SLEEP_MODE); + msleep(200); + mipi_dbi_command(dbi, MIPI_DCS_SET_DISPLAY_ON); + usleep_range(10000, 15000); + + db->prepared = true; + + return 0; +} + +static int ams495qa01_unprepare(struct drm_panel *panel) +{ + struct ams495qa01 *db = to_ams495qa01(panel); + struct mipi_dbi *dbi = &db->dbi; + + if (!db->prepared) + return 0; + + /* Panel Exit Sequence */ + mipi_dbi_command(dbi, MIPI_DCS_SET_DISPLAY_OFF); + msleep(20); + mipi_dbi_command(dbi, MIPI_DCS_ENTER_SLEEP_MODE); + usleep_range(10000, 15000); + + if (db->enable) + gpiod_set_value_cansleep(db->enable, 0); + if (db->reg_elvdd) + regulator_disable(db->reg_elvdd); + regulator_disable(db->reg_vdd); + msleep(20); + + db->prepared = false; + + return 0; +} + +static int ams495qa01_get_modes(struct drm_panel *panel, + struct drm_connector *connector) +{ + struct ams495qa01 *db = to_ams495qa01(panel); + struct drm_display_mode *mode; + static const u32 bus_format = MEDIA_BUS_FMT_RGB888_1X24; + + mode = drm_mode_duplicate(connector->dev, &ams495qa01_mode); + if (!mode) { + dev_err(db->dev, "failed to add mode\n"); + return -ENOMEM; + } + + connector->display_info.bpc = 8; + connector->display_info.width_mm = mode->width_mm; + connector->display_info.height_mm = mode->height_mm; + connector->display_info.bus_flags = + DRM_BUS_FLAG_PIXDATA_DRIVE_NEGEDGE | + DRM_BUS_FLAG_DE_LOW; + drm_display_info_set_bus_formats(&connector->display_info, + &bus_format, 1); + + drm_mode_set_name(mode); + mode->type = DRM_MODE_TYPE_DRIVER | DRM_MODE_TYPE_PREFERRED; + + drm_mode_probed_add(connector, mode); + + return 1; +} + +static const struct drm_panel_funcs ams495qa01_drm_funcs = { + .unprepare = ams495qa01_unprepare, + .prepare = ams495qa01_prepare, + .get_modes = ams495qa01_get_modes, +}; + +static int ams495qa01_set_brightness(struct backlight_device *bd) +{ + struct ams495qa01 *db = bl_get_data(bd); + struct mipi_dbi *dbi = &db->dbi; + int brightness = bd->props.brightness; + + ams495qa01_update_gamma(dbi, brightness); + + return 0; +} + +static const struct backlight_ops ams495qa01_backlight_ops = { + .update_status = ams495qa01_set_brightness, +}; + +static int ams495qa01_backlight_register(struct ams495qa01 *db) +{ + struct backlight_properties props = { + .type = BACKLIGHT_RAW, + .brightness = MAX_BRIGHTNESS, + .max_brightness = MAX_BRIGHTNESS, + }; + struct device *dev = db->dev; + int ret = 0; + + db->bl_dev = devm_backlight_device_register(dev, "panel", dev, db, + &ams495qa01_backlight_ops, + &props); + if (IS_ERR(db->bl_dev)) { + ret = PTR_ERR(db->bl_dev); + dev_err(dev, "error registering backlight device (%d)\n", ret); + } + + return ret; +} + +static int ams495qa01_probe(struct spi_device *spi) +{ + struct device *dev = &spi->dev; + struct device_node *endpoint, *dsi_host_node; + struct mipi_dsi_host *dsi_host; + struct ams495qa01 *db; + int ret; + struct mipi_dsi_device_info info = { + .type = "dupa", + .channel = 0, + .node = NULL, + }; + + db = devm_kzalloc(dev, sizeof(*db), GFP_KERNEL); + if (!db) + return -ENOMEM; + + spi_set_drvdata(spi, db); + + db->dev = dev; + + db->reg_vdd = devm_regulator_get(dev, "vdd"); + if (IS_ERR(db->reg_vdd)) + return dev_err_probe(dev, PTR_ERR(db->reg_vdd), + "Failed to get vdd supply\n"); + + db->reg_elvdd = devm_regulator_get_optional(dev, "elvdd"); + if (IS_ERR(db->reg_elvdd)) + db->reg_elvdd = NULL; + + db->reset = devm_gpiod_get(dev, "reset", GPIOD_OUT_LOW); + if (IS_ERR(db->reset)) { + ret = PTR_ERR(db->reset); + return dev_err_probe(dev, ret, "no RESET GPIO\n"); + } + + db->enable = devm_gpiod_get_optional(dev, "enable", GPIOD_OUT_HIGH); + if (IS_ERR(db->enable)) { + ret = PTR_ERR(db->enable); + return dev_err_probe(dev, ret, "cannot get ENABLE GPIO\n"); + } + + ret = mipi_dbi_spi_init(spi, &db->dbi, NULL); + if (ret) + return dev_err_probe(dev, ret, "MIPI DBI init failed\n"); + + /* + * Get the DSI controller that is supplying data for this display + * which is controlled via SPI 3-wire. + */ + endpoint = of_graph_get_next_endpoint(dev->of_node, NULL); + if (!endpoint) { + dev_err(dev, "failed to get endpoint\n"); + return -ENODEV; + } + dsi_host_node = of_graph_get_remote_port_parent(endpoint); + if (!dsi_host_node) { + dev_err(dev, "failed to get remote port parent\n"); + goto put_endpoint; + } + dsi_host = of_find_mipi_dsi_host_by_node(dsi_host_node); + if (!dsi_host) { + dev_err(dev, "failed to find dsi host\n"); + goto put_host; + } + info.node = of_graph_get_remote_port(endpoint); + if (!info.node) { + dev_err(dev, "failed to get remote port node\n"); + ret = -ENODEV; + goto put_host; + } + + db->dsi_dev = devm_mipi_dsi_device_register_full(dev, dsi_host, &info); + if (IS_ERR(db->dsi_dev)) { + dev_err(dev, "failed to register dsi device: %ld\n", + PTR_ERR(db->dsi_dev)); + ret = PTR_ERR(db->dsi_dev); + goto put_host; + } + + db->dsi_dev->lanes = 2; + db->dsi_dev->format = MIPI_DSI_FMT_RGB888; + db->dsi_dev->mode_flags = MIPI_DSI_MODE_VIDEO | MIPI_DSI_MODE_VIDEO_BURST | + MIPI_DSI_MODE_LPM | MIPI_DSI_MODE_NO_EOT_PACKET; + + drm_panel_init(&db->panel, dev, &ams495qa01_drm_funcs, + DRM_MODE_CONNECTOR_DSI); + + ret = ams495qa01_backlight_register(db); + if (ret < 0) + return ret; + + drm_panel_add(&db->panel); + + ret = devm_mipi_dsi_attach(dev, db->dsi_dev); + if (ret < 0) { + dev_err(dev, "mipi_dsi_attach failed: %d\n", ret); + drm_panel_remove(&db->panel); + return ret; + } + + of_node_put(dsi_host_node); + of_node_put(endpoint); + + return 0; + +put_host: + of_node_put(dsi_host_node); + +put_endpoint: + of_node_put(endpoint); + return -ENODEV; +} + +static void ams495qa01_shutdown(struct spi_device *spi) +{ + struct ams495qa01 *db = spi_get_drvdata(spi); + int ret; + + ret = drm_panel_unprepare(&db->panel); + if (ret < 0) + dev_err(&spi->dev, "Failed to unprepare panel: %d\n", ret); + + ret = drm_panel_disable(&db->panel); + if (ret < 0) + dev_err(&spi->dev, "Failed to disable panel: %d\n", ret); +} + +static void ams495qa01_remove(struct spi_device *spi) +{ + struct ams495qa01 *db = spi_get_drvdata(spi); + + ams495qa01_shutdown(spi); + + drm_panel_remove(&db->panel); +} + +static const struct of_device_id ams495qa01_match[] = { + { .compatible = "samsung,ams495qa01", }, + {}, +}; +MODULE_DEVICE_TABLE(of, ams495qa01_match); + +static const struct spi_device_id ams495qa01_ids[] = { + { "ams495qa01", 0 }, + {}, +}; +MODULE_DEVICE_TABLE(spi, ams495qa01_ids); + +static struct spi_driver ams495qa01_driver = { + .driver = { + .name = "ams495qa01-panel", + .of_match_table = ams495qa01_match, + }, + .id_table = ams495qa01_ids, + .probe = ams495qa01_probe, + .remove = ams495qa01_remove, + .shutdown = ams495qa01_shutdown, +}; +module_spi_driver(ams495qa01_driver); + +MODULE_AUTHOR("Chris Morgan <macromorgan@hotmail.com>"); +MODULE_DESCRIPTION("Samsung ams495qa01 panel driver"); +MODULE_LICENSE("GPL"); -- 2.25.1 ^ permalink raw reply related [flat|nested] 7+ messages in thread
* Re: [PATCH V2 2/2] drm/panel: Add Samsung AMS495QA01 MIPI-DSI LCD panel 2022-09-20 17:09 ` [PATCH V2 2/2] drm/panel: Add Samsung AMS495QA01 MIPI-DSI LCD panel Chris Morgan @ 2022-09-20 17:33 ` Maya Matuszczyk 2022-09-20 21:03 ` Chris Morgan 0 siblings, 1 reply; 7+ messages in thread From: Maya Matuszczyk @ 2022-09-20 17:33 UTC (permalink / raw) To: Chris Morgan Cc: dri-devel, devicetree, krzysztof.kozlowski+dt, airlied, Chris Morgan, robh+dt, thierry.reding, sam Hi Chris, Thanks for this patch, wt., 20 wrz 2022 o 19:10 Chris Morgan <macroalpha82@gmail.com> napisał(a): > > From: Chris Morgan <macromorgan@hotmail.com> > > Support Samsung AMS495QA01 panel as found on the Anbernic RG503. Note > This panel receives video signals via DSI, however it receives > commands via 3-wire SPI. > > Signed-off-by: Chris Morgan <macromorgan@hotmail.com> > --- > drivers/gpu/drm/panel/Kconfig | 10 + > drivers/gpu/drm/panel/Makefile | 1 + > .../gpu/drm/panel/panel-samsung-ams495qa01.c | 505 ++++++++++++++++++ > 3 files changed, 516 insertions(+) > create mode 100644 drivers/gpu/drm/panel/panel-samsung-ams495qa01.c > > diff --git a/drivers/gpu/drm/panel/Kconfig b/drivers/gpu/drm/panel/Kconfig > index a9043eacce97..954b66a2adee 100644 > --- a/drivers/gpu/drm/panel/Kconfig > +++ b/drivers/gpu/drm/panel/Kconfig > @@ -444,6 +444,16 @@ config DRM_PANEL_RONBO_RB070D30 > Say Y here if you want to enable support for Ronbo Electronics > RB070D30 1024x600 DSI panel. > > +config DRM_PANEL_SAMSUNG_AMS495QA01 > + tristate "Samsung AMS495QA01 DSI panel" > + depends on OF && SPI > + depends on DRM_MIPI_DSI > + select DRM_MIPI_DBI > + help > + DRM panel driver for the Samsung AMS495QA01 panel. This panel > + receives video data via DSI but commands via 3-Wire 9-bit > + SPI. > + > config DRM_PANEL_SAMSUNG_ATNA33XC20 > tristate "Samsung ATNA33XC20 eDP panel" > depends on OF > diff --git a/drivers/gpu/drm/panel/Makefile b/drivers/gpu/drm/panel/Makefile > index 34e717382dbb..de0b57baf851 100644 > --- a/drivers/gpu/drm/panel/Makefile > +++ b/drivers/gpu/drm/panel/Makefile > @@ -42,6 +42,7 @@ obj-$(CONFIG_DRM_PANEL_RASPBERRYPI_TOUCHSCREEN) += panel-raspberrypi-touchscreen > obj-$(CONFIG_DRM_PANEL_RAYDIUM_RM67191) += panel-raydium-rm67191.o > obj-$(CONFIG_DRM_PANEL_RAYDIUM_RM68200) += panel-raydium-rm68200.o > obj-$(CONFIG_DRM_PANEL_RONBO_RB070D30) += panel-ronbo-rb070d30.o > +obj-$(CONFIG_DRM_PANEL_SAMSUNG_AMS495QA01) += panel-samsung-ams495qa01.o > obj-$(CONFIG_DRM_PANEL_SAMSUNG_ATNA33XC20) += panel-samsung-atna33xc20.o > obj-$(CONFIG_DRM_PANEL_SAMSUNG_DB7430) += panel-samsung-db7430.o > obj-$(CONFIG_DRM_PANEL_SAMSUNG_LD9040) += panel-samsung-ld9040.o > diff --git a/drivers/gpu/drm/panel/panel-samsung-ams495qa01.c b/drivers/gpu/drm/panel/panel-samsung-ams495qa01.c > new file mode 100644 > index 000000000000..d693ba5f20c9 > --- /dev/null > +++ b/drivers/gpu/drm/panel/panel-samsung-ams495qa01.c > @@ -0,0 +1,505 @@ > +// SPDX-License-Identifier: GPL-2.0 > +/* > + * Samsung ams495qa01 MIPI-DSI panel driver > + * Copyright (C) 2022 Chris Morgan > + */ > + > +#include <drm/drm_mipi_dbi.h> > +#include <drm/drm_mipi_dsi.h> > +#include <drm/drm_modes.h> > +#include <drm/drm_panel.h> > + > +#include <linux/backlight.h> > +#include <linux/delay.h> > +#include <linux/gpio/consumer.h> > +#include <linux/init.h> > +#include <linux/kernel.h> > +#include <linux/media-bus-format.h> > +#include <linux/module.h> > +#include <linux/of.h> > +#include <linux/of_graph.h> > +#include <linux/regulator/consumer.h> > +#include <linux/spi/spi.h> > + > +#include <video/mipi_display.h> > + > +struct ams495qa01 { > + /** @dev: the container device */ > + struct device *dev; > + /** @dbi: the DBI bus abstraction handle */ > + struct mipi_dbi dbi; > + /** @panel: the DRM panel instance for this device */ > + struct drm_panel panel; > + /** @reset: reset GPIO line */ > + struct gpio_desc *reset; > + /** @enable: enable GPIO line */ > + struct gpio_desc *enable; > + /** @reg_vdd: VDD supply regulator for panel logic */ > + struct regulator *reg_vdd; > + /** @reg_elvdd: ELVDD supply regulator for panel display */ > + struct regulator *reg_elvdd; > + /** @dsi_dev: DSI child device (panel) */ > + struct mipi_dsi_device *dsi_dev; > + /** @bl_dev: pseudo-backlight device for oled panel */ > + struct backlight_device *bl_dev; > + /** @prepared: value tracking panel prepare status */ > + bool prepared; > +}; > + > +static const struct drm_display_mode ams495qa01_mode = { > + .clock = 33500, > + .hdisplay = 960, > + .hsync_start = 960 + 10, > + .hsync_end = 960 + 10 + 2, > + .htotal = 960 + 10 + 2 + 10, > + .vdisplay = 544, > + .vsync_start = 544 + 10, > + .vsync_end = 544 + 10 + 2, > + .vtotal = 544 + 10 + 2 + 10, > + .width_mm = 117, > + .height_mm = 74, > + .flags = DRM_MODE_FLAG_NHSYNC | DRM_MODE_FLAG_NVSYNC, > +}; > + > +#define NUM_GAMMA_LEVELS 16 > +#define GAMMA_TABLE_COUNT 23 > +#define MAX_BRIGHTNESS (NUM_GAMMA_LEVELS - 1) > + > +/* Table of gamma values provided in datasheet */ > +static u8 ams495qa01_gamma[NUM_GAMMA_LEVELS][GAMMA_TABLE_COUNT] = { > + {0x01, 0x79, 0x78, 0x8d, 0xd9, 0xdf, 0xd5, 0xcb, 0xcf, 0xc5, > + 0xe5, 0xe0, 0xe4, 0xdc, 0xb8, 0xd4, 0xfa, 0xed, 0xe6, 0x2f, > + 0x00, 0x2f}, > + {0x01, 0x7d, 0x7c, 0x92, 0xd7, 0xdd, 0xd2, 0xcb, 0xd0, 0xc6, > + 0xe5, 0xe1, 0xe3, 0xda, 0xbd, 0xd3, 0xfa, 0xed, 0xe6, 0x2f, > + 0x00, 0x2f}, > + {0x01, 0x7f, 0x7e, 0x95, 0xd7, 0xde, 0xd2, 0xcb, 0xcf, 0xc5, > + 0xe5, 0xe3, 0xe3, 0xda, 0xbf, 0xd3, 0xfa, 0xed, 0xe6, 0x2f, > + 0x00, 0x2f}, > + {0x01, 0x82, 0x81, 0x99, 0xd6, 0xdd, 0xd1, 0xca, 0xcf, 0xc3, > + 0xe4, 0xe3, 0xe3, 0xda, 0xc2, 0xd3, 0xfa, 0xed, 0xe6, 0x2f, > + 0x00, 0x2f}, > + {0x01, 0x84, 0x83, 0x9b, 0xd7, 0xde, 0xd2, 0xc8, 0xce, 0xc2, > + 0xe4, 0xe3, 0xe2, 0xd9, 0xc3, 0xd3, 0xfa, 0xed, 0xe6, 0x2f, > + 0x00, 0x2f}, > + {0x01, 0x87, 0x86, 0x9f, 0xd6, 0xdd, 0xd1, 0xc7, 0xce, 0xc1, > + 0xe4, 0xe3, 0xe2, 0xd9, 0xc6, 0xd3, 0xfa, 0xed, 0xe6, 0x2f, > + 0x00, 0x2f}, > + {0x01, 0x89, 0x89, 0xa2, 0xd5, 0xdb, 0xcf, 0xc8, 0xcf, 0xc2, > + 0xe3, 0xe3, 0xe1, 0xd9, 0xc7, 0xd3, 0xfa, 0xed, 0xe6, 0x2f, > + 0x00, 0x2f}, > + {0x01, 0x8b, 0x8b, 0xa5, 0xd5, 0xdb, 0xcf, 0xc7, 0xce, 0xc0, > + 0xe3, 0xe3, 0xe1, 0xd8, 0xc7, 0xd3, 0xfa, 0xed, 0xe6, 0x2f, > + 0x00, 0x2f}, > + {0x01, 0x8d, 0x8d, 0xa7, 0xd5, 0xdb, 0xcf, 0xc6, 0xce, 0xc0, > + 0xe4, 0xe4, 0xe1, 0xd7, 0xc8, 0xd3, 0xfa, 0xed, 0xe6, 0x2f, > + 0x00, 0x2f}, > + {0x01, 0x8f, 0x8f, 0xaa, 0xd4, 0xdb, 0xce, 0xc6, 0xcd, 0xbf, > + 0xe3, 0xe3, 0xe1, 0xd7, 0xca, 0xd3, 0xfa, 0xed, 0xe6, 0x2f, > + 0x00, 0x2f}, > + {0x01, 0x91, 0x91, 0xac, 0xd3, 0xda, 0xce, 0xc5, 0xcd, 0xbe, > + 0xe3, 0xe3, 0xe0, 0xd7, 0xca, 0xd3, 0xfa, 0xed, 0xe6, 0x2f, > + 0x00, 0x2f}, > + {0x01, 0x93, 0x93, 0xaf, 0xd3, 0xda, 0xcd, 0xc5, 0xcd, 0xbe, > + 0xe2, 0xe3, 0xdf, 0xd6, 0xca, 0xd3, 0xfa, 0xed, 0xe6, 0x2f, > + 0x00, 0x2f}, > + {0x01, 0x95, 0x95, 0xb1, 0xd2, 0xd9, 0xcc, 0xc4, 0xcd, 0xbe, > + 0xe2, 0xe3, 0xdf, 0xd7, 0xcc, 0xd3, 0xfa, 0xed, 0xe6, 0x2f, > + 0x00, 0x2f}, > + {0x01, 0x99, 0x99, 0xb6, 0xd1, 0xd9, 0xcc, 0xc3, 0xcb, 0xbc, > + 0xe2, 0xe4, 0xdf, 0xd6, 0xcc, 0xd3, 0xfa, 0xed, 0xe6, 0x2f, > + 0x00, 0x2f}, > + {0x01, 0x9c, 0x9c, 0xba, 0xd0, 0xd8, 0xcb, 0xc3, 0xcb, 0xbb, > + 0xe2, 0xe4, 0xdf, 0xd6, 0xce, 0xd3, 0xfa, 0xed, 0xe6, 0x2f, > + 0x00, 0x2f}, > + {0x01, 0x9f, 0x9f, 0xbe, 0xcf, 0xd7, 0xc9, 0xc2, 0xcb, 0xbb, > + 0xe1, 0xe3, 0xde, 0xd6, 0xd0, 0xd3, 0xfa, 0xed, 0xe6, 0x2f, > + 0x00, 0x2f}, There might be some use in adding unofficial gamma values, for higher and lower brightness values than officially supported, For example, vitabright repository of devnoname120 contains gamma lookup tables that should be compatible with this display. Perhaps it's worth checking out, for low-light and outdoors use case, as the display is meant to be used in handheld gaming devices: https://github.com/devnoname120/vitabright > +}; > + > +/* > + * Table of elvss values provided in datasheet and corresponds to > + * gamma values. > + */ > +static u8 ams495qa01_elvss[NUM_GAMMA_LEVELS] = { > + 0x15, 0x15, 0x15, 0x15, 0x15, 0x15, 0x15, 0x15, 0x15, 0x15, > + 0x15, 0x15, 0x14, 0x14, 0x13, 0x12, > +}; > + > +static inline struct ams495qa01 *to_ams495qa01(struct drm_panel *panel) > +{ > + return container_of(panel, struct ams495qa01, panel); > +} > + > +static int ams495qa01_update_gamma(struct mipi_dbi *dbi, u32 brightness) > +{ > + u32 tmp = brightness; > + > + if (brightness > MAX_BRIGHTNESS) > + tmp = MAX_BRIGHTNESS; Shouldn't we return -EINVAL in this case? > + > + /* Set gamma values */ > + mipi_dbi_command_buf(dbi, 0xf9, ams495qa01_gamma[tmp], > + ARRAY_SIZE(ams495qa01_gamma[tmp])); > + /* Set gamma change */ > + mipi_dbi_command(dbi, 0xf9, 0x00); > + /* Undocumented command */ > + mipi_dbi_command(dbi, 0x26, 0x00); > + /* Set ELVSS value */ > + mipi_dbi_command(dbi, 0xb2, ams495qa01_elvss[tmp]); > + > + return 0; > +} > + > +static int ams495qa01_prepare(struct drm_panel *panel) > +{ > + struct ams495qa01 *db = to_ams495qa01(panel); > + struct mipi_dbi *dbi = &db->dbi; > + int ret; > + > + if (db->prepared) > + return 0; > + > + /* Power up */ > + ret = regulator_enable(db->reg_vdd); > + if (ret) { > + dev_err(db->dev, "failed to enable vdd regulator: %d\n", ret); > + return ret; > + } > + if (db->reg_elvdd) { > + ret = regulator_enable(db->reg_elvdd); > + if (ret) { > + dev_err(db->dev, > + "failed to enable elvdd regulator: %d\n", ret); > + regulator_disable(db->reg_vdd); > + return ret; > + } > + } Maybe ret could be initialized with 0 value, and couple gotos like with some other drivers? > + > + /* Enable */ > + if (db->enable) > + gpiod_set_value_cansleep(db->enable, 1); > + > + msleep(50); > + > + /* Reset */ > + gpiod_set_value_cansleep(db->reset, 1); > + usleep_range(1000, 5000); > + gpiod_set_value_cansleep(db->reset, 0); > + msleep(20); > + > + /* Panel Init Sequence */ > + > + /* Password to start command sequence */ > + mipi_dbi_command(dbi, 0xf0, 0x5a, 0x5a); > + mipi_dbi_command(dbi, 0xf1, 0x5a, 0x5a); > + > + /* Undocumented commands */ > + mipi_dbi_command(dbi, 0xb0, 0x02); > + mipi_dbi_command(dbi, 0xf3, 0x3b); > + > + /* Analog Power condition set */ > + mipi_dbi_command(dbi, 0xf4, 0x33, 0x42, 0x00, 0x08); > + mipi_dbi_command(dbi, 0xf5, 0x00, 0x06, 0x26, 0x35, 0x03); > + > + /* Undocumented commands */ > + mipi_dbi_command(dbi, 0xf6, 0x02); > + mipi_dbi_command(dbi, 0xc6, 0x0b, 0x00, 0x00, 0x3c, 0x00, 0x22, > + 0x00, 0x00, 0x00, 0x00); > + > + /* GTCON set */ > + mipi_dbi_command(dbi, 0xf7, 0x20); > + > + /* TEMP_SWIRE set */ > + mipi_dbi_command(dbi, 0xb2, 0x06, 0x06, 0x06, 0x06); > + > + /* ELVSS_CON set */ > + mipi_dbi_command(dbi, 0xb1, 0x07, 0x00, 0x10); > + > + /* Gateless signal set */ > + mipi_dbi_command(dbi, 0xf8, 0x7f, 0x7a, 0x89, 0x67, 0x26, 0x38, > + 0x00, 0x00, 0x09, 0x67, 0x70, 0x88, 0x7a, > + 0x76, 0x05, 0x09, 0x23, 0x23, 0x23); > + > + /* Undocumented commands */ > + mipi_dbi_command(dbi, 0xb5, 0xff, 0xef, 0x35, 0x42, 0x0d, 0xd7, > + 0xff, 0x07, 0xff, 0xff, 0xfd, 0x00, 0x01, > + 0xff, 0x05, 0x12, 0x0f, 0xff, 0xff, 0xff, > + 0xff); > + mipi_dbi_command(dbi, 0xb4, 0x15); > + mipi_dbi_command(dbi, 0xb3, 0x00); > + > + ams495qa01_update_gamma(dbi, MAX_BRIGHTNESS); > + > + mipi_dbi_command(dbi, MIPI_DCS_EXIT_SLEEP_MODE); > + msleep(200); > + mipi_dbi_command(dbi, MIPI_DCS_SET_DISPLAY_ON); > + usleep_range(10000, 15000); > + > + db->prepared = true; > + > + return 0; > +} > + > +static int ams495qa01_unprepare(struct drm_panel *panel) > +{ > + struct ams495qa01 *db = to_ams495qa01(panel); > + struct mipi_dbi *dbi = &db->dbi; > + > + if (!db->prepared) > + return 0; > + > + /* Panel Exit Sequence */ > + mipi_dbi_command(dbi, MIPI_DCS_SET_DISPLAY_OFF); > + msleep(20); > + mipi_dbi_command(dbi, MIPI_DCS_ENTER_SLEEP_MODE); > + usleep_range(10000, 15000); > + > + if (db->enable) > + gpiod_set_value_cansleep(db->enable, 0); > + if (db->reg_elvdd) > + regulator_disable(db->reg_elvdd); > + regulator_disable(db->reg_vdd); > + msleep(20); > + > + db->prepared = false; > + > + return 0; > +} > + > +static int ams495qa01_get_modes(struct drm_panel *panel, > + struct drm_connector *connector) > +{ > + struct ams495qa01 *db = to_ams495qa01(panel); > + struct drm_display_mode *mode; > + static const u32 bus_format = MEDIA_BUS_FMT_RGB888_1X24; > + > + mode = drm_mode_duplicate(connector->dev, &ams495qa01_mode); > + if (!mode) { > + dev_err(db->dev, "failed to add mode\n"); > + return -ENOMEM; > + } > + > + connector->display_info.bpc = 8; > + connector->display_info.width_mm = mode->width_mm; > + connector->display_info.height_mm = mode->height_mm; > + connector->display_info.bus_flags = > + DRM_BUS_FLAG_PIXDATA_DRIVE_NEGEDGE | > + DRM_BUS_FLAG_DE_LOW; > + drm_display_info_set_bus_formats(&connector->display_info, > + &bus_format, 1); > + > + drm_mode_set_name(mode); > + mode->type = DRM_MODE_TYPE_DRIVER | DRM_MODE_TYPE_PREFERRED; > + > + drm_mode_probed_add(connector, mode); > + > + return 1; > +} > + > +static const struct drm_panel_funcs ams495qa01_drm_funcs = { > + .unprepare = ams495qa01_unprepare, > + .prepare = ams495qa01_prepare, > + .get_modes = ams495qa01_get_modes, > +}; > + > +static int ams495qa01_set_brightness(struct backlight_device *bd) > +{ > + struct ams495qa01 *db = bl_get_data(bd); > + struct mipi_dbi *dbi = &db->dbi; > + int brightness = bd->props.brightness; > + > + ams495qa01_update_gamma(dbi, brightness); > + > + return 0; > +} > + > +static const struct backlight_ops ams495qa01_backlight_ops = { > + .update_status = ams495qa01_set_brightness, > +}; > + > +static int ams495qa01_backlight_register(struct ams495qa01 *db) > +{ > + struct backlight_properties props = { > + .type = BACKLIGHT_RAW, > + .brightness = MAX_BRIGHTNESS, > + .max_brightness = MAX_BRIGHTNESS, > + }; > + struct device *dev = db->dev; > + int ret = 0; > + > + db->bl_dev = devm_backlight_device_register(dev, "panel", dev, db, > + &ams495qa01_backlight_ops, > + &props); > + if (IS_ERR(db->bl_dev)) { > + ret = PTR_ERR(db->bl_dev); > + dev_err(dev, "error registering backlight device (%d)\n", ret); > + } > + > + return ret; > +} > + > +static int ams495qa01_probe(struct spi_device *spi) > +{ > + struct device *dev = &spi->dev; > + struct device_node *endpoint, *dsi_host_node; > + struct mipi_dsi_host *dsi_host; > + struct ams495qa01 *db; > + int ret; > + struct mipi_dsi_device_info info = { > + .type = "dupa", You might want to change this to something more appropiate for Linux. I see this was left from a prototype driver that I wrote, which you might have based this one on. > + .channel = 0, > + .node = NULL, > + }; > + > + db = devm_kzalloc(dev, sizeof(*db), GFP_KERNEL); > + if (!db) > + return -ENOMEM; > + > + spi_set_drvdata(spi, db); > + > + db->dev = dev; > + > + db->reg_vdd = devm_regulator_get(dev, "vdd"); > + if (IS_ERR(db->reg_vdd)) > + return dev_err_probe(dev, PTR_ERR(db->reg_vdd), > + "Failed to get vdd supply\n"); > + > + db->reg_elvdd = devm_regulator_get_optional(dev, "elvdd"); > + if (IS_ERR(db->reg_elvdd)) > + db->reg_elvdd = NULL; > + > + db->reset = devm_gpiod_get(dev, "reset", GPIOD_OUT_LOW); > + if (IS_ERR(db->reset)) { > + ret = PTR_ERR(db->reset); > + return dev_err_probe(dev, ret, "no RESET GPIO\n"); I think this can be shortened into: return dev_err_probe(dev, PTR_ERR(db->reset), "cannot get reset gpio\n"); > + } > + > + db->enable = devm_gpiod_get_optional(dev, "enable", GPIOD_OUT_HIGH); > + if (IS_ERR(db->enable)) { > + ret = PTR_ERR(db->enable); > + return dev_err_probe(dev, ret, "cannot get ENABLE GPIO\n"); > + } > + > + ret = mipi_dbi_spi_init(spi, &db->dbi, NULL); It's not always controlled via SPI, sometimes(based on a strap pin) it's controlled via MIPI-DSI commands. Maybe let's either have another DT compatible for that? I'm really not sure > + if (ret) > + return dev_err_probe(dev, ret, "MIPI DBI init failed\n"); > + > + /* > + * Get the DSI controller that is supplying data for this display > + * which is controlled via SPI 3-wire. Same as above > + */ > + endpoint = of_graph_get_next_endpoint(dev->of_node, NULL); > + if (!endpoint) { > + dev_err(dev, "failed to get endpoint\n"); > + return -ENODEV; > + } > + dsi_host_node = of_graph_get_remote_port_parent(endpoint); > + if (!dsi_host_node) { > + dev_err(dev, "failed to get remote port parent\n"); > + goto put_endpoint; > + } > + dsi_host = of_find_mipi_dsi_host_by_node(dsi_host_node); > + if (!dsi_host) { > + dev_err(dev, "failed to find dsi host\n"); > + goto put_host; > + } > + info.node = of_graph_get_remote_port(endpoint); > + if (!info.node) { > + dev_err(dev, "failed to get remote port node\n"); > + ret = -ENODEV; > + goto put_host; > + } > + > + db->dsi_dev = devm_mipi_dsi_device_register_full(dev, dsi_host, &info); > + if (IS_ERR(db->dsi_dev)) { > + dev_err(dev, "failed to register dsi device: %ld\n", > + PTR_ERR(db->dsi_dev)); > + ret = PTR_ERR(db->dsi_dev); > + goto put_host; > + } > + > + db->dsi_dev->lanes = 2; > + db->dsi_dev->format = MIPI_DSI_FMT_RGB888; > + db->dsi_dev->mode_flags = MIPI_DSI_MODE_VIDEO | MIPI_DSI_MODE_VIDEO_BURST | > + MIPI_DSI_MODE_LPM | MIPI_DSI_MODE_NO_EOT_PACKET; > + > + drm_panel_init(&db->panel, dev, &ams495qa01_drm_funcs, > + DRM_MODE_CONNECTOR_DSI); > + > + ret = ams495qa01_backlight_register(db); > + if (ret < 0) > + return ret; > + > + drm_panel_add(&db->panel); > + > + ret = devm_mipi_dsi_attach(dev, db->dsi_dev); > + if (ret < 0) { > + dev_err(dev, "mipi_dsi_attach failed: %d\n", ret); > + drm_panel_remove(&db->panel); > + return ret; > + } > + > + of_node_put(dsi_host_node); > + of_node_put(endpoint); > + > + return 0; > + > +put_host: > + of_node_put(dsi_host_node); > + > +put_endpoint: > + of_node_put(endpoint); > + return -ENODEV; > +} > + > +static void ams495qa01_shutdown(struct spi_device *spi) > +{ > + struct ams495qa01 *db = spi_get_drvdata(spi); > + int ret; > + > + ret = drm_panel_unprepare(&db->panel); > + if (ret < 0) > + dev_err(&spi->dev, "Failed to unprepare panel: %d\n", ret); > + > + ret = drm_panel_disable(&db->panel); > + if (ret < 0) > + dev_err(&spi->dev, "Failed to disable panel: %d\n", ret); > +} > + > +static void ams495qa01_remove(struct spi_device *spi) > +{ > + struct ams495qa01 *db = spi_get_drvdata(spi); > + > + ams495qa01_shutdown(spi); > + > + drm_panel_remove(&db->panel); > +} > + > +static const struct of_device_id ams495qa01_match[] = { > + { .compatible = "samsung,ams495qa01", }, > + {}, > +}; > +MODULE_DEVICE_TABLE(of, ams495qa01_match); > + > +static const struct spi_device_id ams495qa01_ids[] = { > + { "ams495qa01", 0 }, > + {}, > +}; > +MODULE_DEVICE_TABLE(spi, ams495qa01_ids); > + > +static struct spi_driver ams495qa01_driver = { > + .driver = { > + .name = "ams495qa01-panel", > + .of_match_table = ams495qa01_match, > + }, > + .id_table = ams495qa01_ids, > + .probe = ams495qa01_probe, > + .remove = ams495qa01_remove, > + .shutdown = ams495qa01_shutdown, > +}; > +module_spi_driver(ams495qa01_driver); > + > +MODULE_AUTHOR("Chris Morgan <macromorgan@hotmail.com>"); > +MODULE_DESCRIPTION("Samsung ams495qa01 panel driver"); > +MODULE_LICENSE("GPL"); > -- > 2.25.1 > Best Regards, Maya Matuszczyk ^ permalink raw reply [flat|nested] 7+ messages in thread
* Re: [PATCH V2 2/2] drm/panel: Add Samsung AMS495QA01 MIPI-DSI LCD panel 2022-09-20 17:33 ` Maya Matuszczyk @ 2022-09-20 21:03 ` Chris Morgan 0 siblings, 0 replies; 7+ messages in thread From: Chris Morgan @ 2022-09-20 21:03 UTC (permalink / raw) To: Maya Matuszczyk Cc: Chris Morgan, dri-devel, devicetree, krzysztof.kozlowski+dt, airlied, robh+dt, thierry.reding, sam On Tue, Sep 20, 2022 at 07:33:00PM +0200, Maya Matuszczyk wrote: > Hi Chris, > Thanks for this patch, > > wt., 20 wrz 2022 o 19:10 Chris Morgan <macroalpha82@gmail.com> napisał(a): > > > > From: Chris Morgan <macromorgan@hotmail.com> > > > > Support Samsung AMS495QA01 panel as found on the Anbernic RG503. Note > > This panel receives video signals via DSI, however it receives > > commands via 3-wire SPI. > > > > Signed-off-by: Chris Morgan <macromorgan@hotmail.com> > > --- > > drivers/gpu/drm/panel/Kconfig | 10 + > > drivers/gpu/drm/panel/Makefile | 1 + > > .../gpu/drm/panel/panel-samsung-ams495qa01.c | 505 ++++++++++++++++++ > > 3 files changed, 516 insertions(+) > > create mode 100644 drivers/gpu/drm/panel/panel-samsung-ams495qa01.c > > > > diff --git a/drivers/gpu/drm/panel/Kconfig b/drivers/gpu/drm/panel/Kconfig > > index a9043eacce97..954b66a2adee 100644 > > --- a/drivers/gpu/drm/panel/Kconfig > > +++ b/drivers/gpu/drm/panel/Kconfig > > @@ -444,6 +444,16 @@ config DRM_PANEL_RONBO_RB070D30 > > Say Y here if you want to enable support for Ronbo Electronics > > RB070D30 1024x600 DSI panel. > > > > +config DRM_PANEL_SAMSUNG_AMS495QA01 > > + tristate "Samsung AMS495QA01 DSI panel" > > + depends on OF && SPI > > + depends on DRM_MIPI_DSI > > + select DRM_MIPI_DBI > > + help > > + DRM panel driver for the Samsung AMS495QA01 panel. This panel > > + receives video data via DSI but commands via 3-Wire 9-bit > > + SPI. > > + > > config DRM_PANEL_SAMSUNG_ATNA33XC20 > > tristate "Samsung ATNA33XC20 eDP panel" > > depends on OF > > diff --git a/drivers/gpu/drm/panel/Makefile b/drivers/gpu/drm/panel/Makefile > > index 34e717382dbb..de0b57baf851 100644 > > --- a/drivers/gpu/drm/panel/Makefile > > +++ b/drivers/gpu/drm/panel/Makefile > > @@ -42,6 +42,7 @@ obj-$(CONFIG_DRM_PANEL_RASPBERRYPI_TOUCHSCREEN) += panel-raspberrypi-touchscreen > > obj-$(CONFIG_DRM_PANEL_RAYDIUM_RM67191) += panel-raydium-rm67191.o > > obj-$(CONFIG_DRM_PANEL_RAYDIUM_RM68200) += panel-raydium-rm68200.o > > obj-$(CONFIG_DRM_PANEL_RONBO_RB070D30) += panel-ronbo-rb070d30.o > > +obj-$(CONFIG_DRM_PANEL_SAMSUNG_AMS495QA01) += panel-samsung-ams495qa01.o > > obj-$(CONFIG_DRM_PANEL_SAMSUNG_ATNA33XC20) += panel-samsung-atna33xc20.o > > obj-$(CONFIG_DRM_PANEL_SAMSUNG_DB7430) += panel-samsung-db7430.o > > obj-$(CONFIG_DRM_PANEL_SAMSUNG_LD9040) += panel-samsung-ld9040.o > > diff --git a/drivers/gpu/drm/panel/panel-samsung-ams495qa01.c b/drivers/gpu/drm/panel/panel-samsung-ams495qa01.c > > new file mode 100644 > > index 000000000000..d693ba5f20c9 > > --- /dev/null > > +++ b/drivers/gpu/drm/panel/panel-samsung-ams495qa01.c > > @@ -0,0 +1,505 @@ > > +// SPDX-License-Identifier: GPL-2.0 > > +/* > > + * Samsung ams495qa01 MIPI-DSI panel driver > > + * Copyright (C) 2022 Chris Morgan > > + */ > > + > > +#include <drm/drm_mipi_dbi.h> > > +#include <drm/drm_mipi_dsi.h> > > +#include <drm/drm_modes.h> > > +#include <drm/drm_panel.h> > > + > > +#include <linux/backlight.h> > > +#include <linux/delay.h> > > +#include <linux/gpio/consumer.h> > > +#include <linux/init.h> > > +#include <linux/kernel.h> > > +#include <linux/media-bus-format.h> > > +#include <linux/module.h> > > +#include <linux/of.h> > > +#include <linux/of_graph.h> > > +#include <linux/regulator/consumer.h> > > +#include <linux/spi/spi.h> > > + > > +#include <video/mipi_display.h> > > + > > +struct ams495qa01 { > > + /** @dev: the container device */ > > + struct device *dev; > > + /** @dbi: the DBI bus abstraction handle */ > > + struct mipi_dbi dbi; > > + /** @panel: the DRM panel instance for this device */ > > + struct drm_panel panel; > > + /** @reset: reset GPIO line */ > > + struct gpio_desc *reset; > > + /** @enable: enable GPIO line */ > > + struct gpio_desc *enable; > > + /** @reg_vdd: VDD supply regulator for panel logic */ > > + struct regulator *reg_vdd; > > + /** @reg_elvdd: ELVDD supply regulator for panel display */ > > + struct regulator *reg_elvdd; > > + /** @dsi_dev: DSI child device (panel) */ > > + struct mipi_dsi_device *dsi_dev; > > + /** @bl_dev: pseudo-backlight device for oled panel */ > > + struct backlight_device *bl_dev; > > + /** @prepared: value tracking panel prepare status */ > > + bool prepared; > > +}; > > + > > +static const struct drm_display_mode ams495qa01_mode = { > > + .clock = 33500, > > + .hdisplay = 960, > > + .hsync_start = 960 + 10, > > + .hsync_end = 960 + 10 + 2, > > + .htotal = 960 + 10 + 2 + 10, > > + .vdisplay = 544, > > + .vsync_start = 544 + 10, > > + .vsync_end = 544 + 10 + 2, > > + .vtotal = 544 + 10 + 2 + 10, > > + .width_mm = 117, > > + .height_mm = 74, > > + .flags = DRM_MODE_FLAG_NHSYNC | DRM_MODE_FLAG_NVSYNC, > > +}; > > + > > +#define NUM_GAMMA_LEVELS 16 > > +#define GAMMA_TABLE_COUNT 23 > > +#define MAX_BRIGHTNESS (NUM_GAMMA_LEVELS - 1) > > + > > +/* Table of gamma values provided in datasheet */ > > +static u8 ams495qa01_gamma[NUM_GAMMA_LEVELS][GAMMA_TABLE_COUNT] = { > > + {0x01, 0x79, 0x78, 0x8d, 0xd9, 0xdf, 0xd5, 0xcb, 0xcf, 0xc5, > > + 0xe5, 0xe0, 0xe4, 0xdc, 0xb8, 0xd4, 0xfa, 0xed, 0xe6, 0x2f, > > + 0x00, 0x2f}, > > + {0x01, 0x7d, 0x7c, 0x92, 0xd7, 0xdd, 0xd2, 0xcb, 0xd0, 0xc6, > > + 0xe5, 0xe1, 0xe3, 0xda, 0xbd, 0xd3, 0xfa, 0xed, 0xe6, 0x2f, > > + 0x00, 0x2f}, > > + {0x01, 0x7f, 0x7e, 0x95, 0xd7, 0xde, 0xd2, 0xcb, 0xcf, 0xc5, > > + 0xe5, 0xe3, 0xe3, 0xda, 0xbf, 0xd3, 0xfa, 0xed, 0xe6, 0x2f, > > + 0x00, 0x2f}, > > + {0x01, 0x82, 0x81, 0x99, 0xd6, 0xdd, 0xd1, 0xca, 0xcf, 0xc3, > > + 0xe4, 0xe3, 0xe3, 0xda, 0xc2, 0xd3, 0xfa, 0xed, 0xe6, 0x2f, > > + 0x00, 0x2f}, > > + {0x01, 0x84, 0x83, 0x9b, 0xd7, 0xde, 0xd2, 0xc8, 0xce, 0xc2, > > + 0xe4, 0xe3, 0xe2, 0xd9, 0xc3, 0xd3, 0xfa, 0xed, 0xe6, 0x2f, > > + 0x00, 0x2f}, > > + {0x01, 0x87, 0x86, 0x9f, 0xd6, 0xdd, 0xd1, 0xc7, 0xce, 0xc1, > > + 0xe4, 0xe3, 0xe2, 0xd9, 0xc6, 0xd3, 0xfa, 0xed, 0xe6, 0x2f, > > + 0x00, 0x2f}, > > + {0x01, 0x89, 0x89, 0xa2, 0xd5, 0xdb, 0xcf, 0xc8, 0xcf, 0xc2, > > + 0xe3, 0xe3, 0xe1, 0xd9, 0xc7, 0xd3, 0xfa, 0xed, 0xe6, 0x2f, > > + 0x00, 0x2f}, > > + {0x01, 0x8b, 0x8b, 0xa5, 0xd5, 0xdb, 0xcf, 0xc7, 0xce, 0xc0, > > + 0xe3, 0xe3, 0xe1, 0xd8, 0xc7, 0xd3, 0xfa, 0xed, 0xe6, 0x2f, > > + 0x00, 0x2f}, > > + {0x01, 0x8d, 0x8d, 0xa7, 0xd5, 0xdb, 0xcf, 0xc6, 0xce, 0xc0, > > + 0xe4, 0xe4, 0xe1, 0xd7, 0xc8, 0xd3, 0xfa, 0xed, 0xe6, 0x2f, > > + 0x00, 0x2f}, > > + {0x01, 0x8f, 0x8f, 0xaa, 0xd4, 0xdb, 0xce, 0xc6, 0xcd, 0xbf, > > + 0xe3, 0xe3, 0xe1, 0xd7, 0xca, 0xd3, 0xfa, 0xed, 0xe6, 0x2f, > > + 0x00, 0x2f}, > > + {0x01, 0x91, 0x91, 0xac, 0xd3, 0xda, 0xce, 0xc5, 0xcd, 0xbe, > > + 0xe3, 0xe3, 0xe0, 0xd7, 0xca, 0xd3, 0xfa, 0xed, 0xe6, 0x2f, > > + 0x00, 0x2f}, > > + {0x01, 0x93, 0x93, 0xaf, 0xd3, 0xda, 0xcd, 0xc5, 0xcd, 0xbe, > > + 0xe2, 0xe3, 0xdf, 0xd6, 0xca, 0xd3, 0xfa, 0xed, 0xe6, 0x2f, > > + 0x00, 0x2f}, > > + {0x01, 0x95, 0x95, 0xb1, 0xd2, 0xd9, 0xcc, 0xc4, 0xcd, 0xbe, > > + 0xe2, 0xe3, 0xdf, 0xd7, 0xcc, 0xd3, 0xfa, 0xed, 0xe6, 0x2f, > > + 0x00, 0x2f}, > > + {0x01, 0x99, 0x99, 0xb6, 0xd1, 0xd9, 0xcc, 0xc3, 0xcb, 0xbc, > > + 0xe2, 0xe4, 0xdf, 0xd6, 0xcc, 0xd3, 0xfa, 0xed, 0xe6, 0x2f, > > + 0x00, 0x2f}, > > + {0x01, 0x9c, 0x9c, 0xba, 0xd0, 0xd8, 0xcb, 0xc3, 0xcb, 0xbb, > > + 0xe2, 0xe4, 0xdf, 0xd6, 0xce, 0xd3, 0xfa, 0xed, 0xe6, 0x2f, > > + 0x00, 0x2f}, > > + {0x01, 0x9f, 0x9f, 0xbe, 0xcf, 0xd7, 0xc9, 0xc2, 0xcb, 0xbb, > > + 0xe1, 0xe3, 0xde, 0xd6, 0xd0, 0xd3, 0xfa, 0xed, 0xe6, 0x2f, > > + 0x00, 0x2f}, > There might be some use in adding unofficial gamma values, > for higher and lower brightness values than officially supported, > For example, vitabright repository of devnoname120 contains > gamma lookup tables that should be compatible with this > display. > Perhaps it's worth checking out, for low-light and outdoors > use case, as the display is meant to be used in handheld > gaming devices: > https://nam12.safelinks.protection.outlook.com/?url=https%3A%2F%2Fgithub.com%2Fdevnoname120%2Fvitabright&data=05%7C01%7C%7Cb6531a6abc1940709ccd08da9b2e3fbc%7C84df9e7fe9f640afb435aaaaaaaaaaaa%7C1%7C0%7C637992920188081853%7CUnknown%7CTWFpbGZsb3d8eyJWIjoiMC4wLjAwMDAiLCJQIjoiV2luMzIiLCJBTiI6Ik1haWwiLCJXVCI6Mn0%3D%7C3000%7C%7C%7C&sdata=KColbBBN2hg6c3L%2F7XuXkIBWQxoxoaHE9WxcEXP%2BoKw%3D&reserved=0 Personally I'm against adding additional gamma values, since the values listed in here come directly from the panel's datasheet. I'll let the drm folks chime in though. Maybe worst case we could have a module parameter for additional gamma values. > > > +}; > > + > > +/* > > + * Table of elvss values provided in datasheet and corresponds to > > + * gamma values. > > + */ > > +static u8 ams495qa01_elvss[NUM_GAMMA_LEVELS] = { > > + 0x15, 0x15, 0x15, 0x15, 0x15, 0x15, 0x15, 0x15, 0x15, 0x15, > > + 0x15, 0x15, 0x14, 0x14, 0x13, 0x12, > > +}; > > + > > +static inline struct ams495qa01 *to_ams495qa01(struct drm_panel *panel) > > +{ > > + return container_of(panel, struct ams495qa01, panel); > > +} > > + > > +static int ams495qa01_update_gamma(struct mipi_dbi *dbi, u32 brightness) > > +{ > > + u32 tmp = brightness; > > + > > + if (brightness > MAX_BRIGHTNESS) > > + tmp = MAX_BRIGHTNESS; > Shouldn't we return -EINVAL in this case? > I looked at a few example drivers that had built-in backlights (this being an oled panel it has a "backlight") but actually didn't find any examples on how it handled values larger than it can support. I'm open to either dropping it to the max or returning -EINVAL, I guess it just depends on what DRM maintainers prefer. > > + > > + /* Set gamma values */ > > + mipi_dbi_command_buf(dbi, 0xf9, ams495qa01_gamma[tmp], > > + ARRAY_SIZE(ams495qa01_gamma[tmp])); > > + /* Set gamma change */ > > + mipi_dbi_command(dbi, 0xf9, 0x00); > > + /* Undocumented command */ > > + mipi_dbi_command(dbi, 0x26, 0x00); > > + /* Set ELVSS value */ > > + mipi_dbi_command(dbi, 0xb2, ams495qa01_elvss[tmp]); > > + > > + return 0; > > +} > > + > > +static int ams495qa01_prepare(struct drm_panel *panel) > > +{ > > + struct ams495qa01 *db = to_ams495qa01(panel); > > + struct mipi_dbi *dbi = &db->dbi; > > + int ret; > > + > > + if (db->prepared) > > + return 0; > > + > > + /* Power up */ > > + ret = regulator_enable(db->reg_vdd); > > + if (ret) { > > + dev_err(db->dev, "failed to enable vdd regulator: %d\n", ret); > > + return ret; > > + } > > + if (db->reg_elvdd) { > > + ret = regulator_enable(db->reg_elvdd); > > + if (ret) { > > + dev_err(db->dev, > > + "failed to enable elvdd regulator: %d\n", ret); > > + regulator_disable(db->reg_vdd); > > + return ret; > > + } > > + } > Maybe ret could be initialized with 0 value, and couple gotos like > with some other drivers? > Since this is the only point where we return after one or more regulators are enabled a goto isn't necessary here... yet. If more error checking is required than one might be necessary. > > + > > + /* Enable */ > > + if (db->enable) > > + gpiod_set_value_cansleep(db->enable, 1); > > + > > + msleep(50); > > + > > + /* Reset */ > > + gpiod_set_value_cansleep(db->reset, 1); > > + usleep_range(1000, 5000); > > + gpiod_set_value_cansleep(db->reset, 0); > > + msleep(20); > > + > > + /* Panel Init Sequence */ > > + > > + /* Password to start command sequence */ > > + mipi_dbi_command(dbi, 0xf0, 0x5a, 0x5a); > > + mipi_dbi_command(dbi, 0xf1, 0x5a, 0x5a); > > + > > + /* Undocumented commands */ > > + mipi_dbi_command(dbi, 0xb0, 0x02); > > + mipi_dbi_command(dbi, 0xf3, 0x3b); > > + > > + /* Analog Power condition set */ > > + mipi_dbi_command(dbi, 0xf4, 0x33, 0x42, 0x00, 0x08); > > + mipi_dbi_command(dbi, 0xf5, 0x00, 0x06, 0x26, 0x35, 0x03); > > + > > + /* Undocumented commands */ > > + mipi_dbi_command(dbi, 0xf6, 0x02); > > + mipi_dbi_command(dbi, 0xc6, 0x0b, 0x00, 0x00, 0x3c, 0x00, 0x22, > > + 0x00, 0x00, 0x00, 0x00); > > + > > + /* GTCON set */ > > + mipi_dbi_command(dbi, 0xf7, 0x20); > > + > > + /* TEMP_SWIRE set */ > > + mipi_dbi_command(dbi, 0xb2, 0x06, 0x06, 0x06, 0x06); > > + > > + /* ELVSS_CON set */ > > + mipi_dbi_command(dbi, 0xb1, 0x07, 0x00, 0x10); > > + > > + /* Gateless signal set */ > > + mipi_dbi_command(dbi, 0xf8, 0x7f, 0x7a, 0x89, 0x67, 0x26, 0x38, > > + 0x00, 0x00, 0x09, 0x67, 0x70, 0x88, 0x7a, > > + 0x76, 0x05, 0x09, 0x23, 0x23, 0x23); > > + > > + /* Undocumented commands */ > > + mipi_dbi_command(dbi, 0xb5, 0xff, 0xef, 0x35, 0x42, 0x0d, 0xd7, > > + 0xff, 0x07, 0xff, 0xff, 0xfd, 0x00, 0x01, > > + 0xff, 0x05, 0x12, 0x0f, 0xff, 0xff, 0xff, > > + 0xff); > > + mipi_dbi_command(dbi, 0xb4, 0x15); > > + mipi_dbi_command(dbi, 0xb3, 0x00); > > + > > + ams495qa01_update_gamma(dbi, MAX_BRIGHTNESS); > > + > > + mipi_dbi_command(dbi, MIPI_DCS_EXIT_SLEEP_MODE); > > + msleep(200); > > + mipi_dbi_command(dbi, MIPI_DCS_SET_DISPLAY_ON); > > + usleep_range(10000, 15000); > > + > > + db->prepared = true; > > + > > + return 0; > > +} > > + > > +static int ams495qa01_unprepare(struct drm_panel *panel) > > +{ > > + struct ams495qa01 *db = to_ams495qa01(panel); > > + struct mipi_dbi *dbi = &db->dbi; > > + > > + if (!db->prepared) > > + return 0; > > + > > + /* Panel Exit Sequence */ > > + mipi_dbi_command(dbi, MIPI_DCS_SET_DISPLAY_OFF); > > + msleep(20); > > + mipi_dbi_command(dbi, MIPI_DCS_ENTER_SLEEP_MODE); > > + usleep_range(10000, 15000); > > + > > + if (db->enable) > > + gpiod_set_value_cansleep(db->enable, 0); > > + if (db->reg_elvdd) > > + regulator_disable(db->reg_elvdd); > > + regulator_disable(db->reg_vdd); > > + msleep(20); > > + > > + db->prepared = false; > > + > > + return 0; > > +} > > + > > +static int ams495qa01_get_modes(struct drm_panel *panel, > > + struct drm_connector *connector) > > +{ > > + struct ams495qa01 *db = to_ams495qa01(panel); > > + struct drm_display_mode *mode; > > + static const u32 bus_format = MEDIA_BUS_FMT_RGB888_1X24; > > + > > + mode = drm_mode_duplicate(connector->dev, &ams495qa01_mode); > > + if (!mode) { > > + dev_err(db->dev, "failed to add mode\n"); > > + return -ENOMEM; > > + } > > + > > + connector->display_info.bpc = 8; > > + connector->display_info.width_mm = mode->width_mm; > > + connector->display_info.height_mm = mode->height_mm; > > + connector->display_info.bus_flags = > > + DRM_BUS_FLAG_PIXDATA_DRIVE_NEGEDGE | > > + DRM_BUS_FLAG_DE_LOW; > > + drm_display_info_set_bus_formats(&connector->display_info, > > + &bus_format, 1); > > + > > + drm_mode_set_name(mode); > > + mode->type = DRM_MODE_TYPE_DRIVER | DRM_MODE_TYPE_PREFERRED; > > + > > + drm_mode_probed_add(connector, mode); > > + > > + return 1; > > +} > > + > > +static const struct drm_panel_funcs ams495qa01_drm_funcs = { > > + .unprepare = ams495qa01_unprepare, > > + .prepare = ams495qa01_prepare, > > + .get_modes = ams495qa01_get_modes, > > +}; > > + > > +static int ams495qa01_set_brightness(struct backlight_device *bd) > > +{ > > + struct ams495qa01 *db = bl_get_data(bd); > > + struct mipi_dbi *dbi = &db->dbi; > > + int brightness = bd->props.brightness; > > + > > + ams495qa01_update_gamma(dbi, brightness); > > + > > + return 0; > > +} > > + > > +static const struct backlight_ops ams495qa01_backlight_ops = { > > + .update_status = ams495qa01_set_brightness, > > +}; > > + > > +static int ams495qa01_backlight_register(struct ams495qa01 *db) > > +{ > > + struct backlight_properties props = { > > + .type = BACKLIGHT_RAW, > > + .brightness = MAX_BRIGHTNESS, > > + .max_brightness = MAX_BRIGHTNESS, > > + }; > > + struct device *dev = db->dev; > > + int ret = 0; > > + > > + db->bl_dev = devm_backlight_device_register(dev, "panel", dev, db, > > + &ams495qa01_backlight_ops, > > + &props); > > + if (IS_ERR(db->bl_dev)) { > > + ret = PTR_ERR(db->bl_dev); > > + dev_err(dev, "error registering backlight device (%d)\n", ret); > > + } > > + > > + return ret; > > +} > > + > > +static int ams495qa01_probe(struct spi_device *spi) > > +{ > > + struct device *dev = &spi->dev; > > + struct device_node *endpoint, *dsi_host_node; > > + struct mipi_dsi_host *dsi_host; > > + struct ams495qa01 *db; > > + int ret; > > + struct mipi_dsi_device_info info = { > > + .type = "dupa", > You might want to change this to something more appropiate for Linux. > > I see this was left from a prototype driver that I wrote, which you might > have based this one on. Yep, guilty as charged. As said on Discord this driver is about 20% you, 25% me, and 55% copied and pasted from other drivers. I'll change this so it's not a swear word in Polish. My swearing ability is limited to English and Spanish which is why I didn't catch it. :-p I'll make sure to include you on the signed-off for v3 since this is somewhat of a joint project. > > > + .channel = 0, > > + .node = NULL, > > + }; > > + > > + db = devm_kzalloc(dev, sizeof(*db), GFP_KERNEL); > > + if (!db) > > + return -ENOMEM; > > + > > + spi_set_drvdata(spi, db); > > + > > + db->dev = dev; > > + > > + db->reg_vdd = devm_regulator_get(dev, "vdd"); > > + if (IS_ERR(db->reg_vdd)) > > + return dev_err_probe(dev, PTR_ERR(db->reg_vdd), > > + "Failed to get vdd supply\n"); > > + > > + db->reg_elvdd = devm_regulator_get_optional(dev, "elvdd"); > > + if (IS_ERR(db->reg_elvdd)) > > + db->reg_elvdd = NULL; > > + > > + db->reset = devm_gpiod_get(dev, "reset", GPIOD_OUT_LOW); > > + if (IS_ERR(db->reset)) { > > + ret = PTR_ERR(db->reset); > > + return dev_err_probe(dev, ret, "no RESET GPIO\n"); > I think this can be shortened into: > return dev_err_probe(dev, PTR_ERR(db->reset), "cannot get reset gpio\n"); > It can, but I think it boils down to preference. To me it's easier to read as it's written, but I'll let the subsystem maintainers chime in. > > + } > > + > > + db->enable = devm_gpiod_get_optional(dev, "enable", GPIOD_OUT_HIGH); > > + if (IS_ERR(db->enable)) { > > + ret = PTR_ERR(db->enable); > > + return dev_err_probe(dev, ret, "cannot get ENABLE GPIO\n"); > > + } > > + > > + ret = mipi_dbi_spi_init(spi, &db->dbi, NULL); > It's not always controlled via SPI, sometimes(based on a strap pin) > it's controlled via MIPI-DSI commands. > > Maybe let's either have another DT compatible for that? > I'm really not sure The panel-samsung-s6e63m0 driver is probably a good example here on how to handle an SPI/DSI display maybe? I'm not aware of any other devices with this panel used in pure DSI mode though and have no such device on which to test. For my device the strap is hard-wired to force SPI only command mode. What differs here is that the s6e63m0 driver is either SPI 3-Wire + DPI or DSI, this one is either SPI 3-Wire + DSI or DSI. I don't know if that means we can simplify into a single driver or have to split it like the s6e63m0. Either way, I'm not comfortable commiting code I have no way to test. > > > + if (ret) > > + return dev_err_probe(dev, ret, "MIPI DBI init failed\n"); > > + > > + /* > > + * Get the DSI controller that is supplying data for this display > > + * which is controlled via SPI 3-wire. > Same as above > > > + */ > > + endpoint = of_graph_get_next_endpoint(dev->of_node, NULL); > > + if (!endpoint) { > > + dev_err(dev, "failed to get endpoint\n"); > > + return -ENODEV; > > + } > > + dsi_host_node = of_graph_get_remote_port_parent(endpoint); > > + if (!dsi_host_node) { > > + dev_err(dev, "failed to get remote port parent\n"); > > + goto put_endpoint; > > + } > > + dsi_host = of_find_mipi_dsi_host_by_node(dsi_host_node); > > + if (!dsi_host) { > > + dev_err(dev, "failed to find dsi host\n"); > > + goto put_host; > > + } > > + info.node = of_graph_get_remote_port(endpoint); > > + if (!info.node) { > > + dev_err(dev, "failed to get remote port node\n"); > > + ret = -ENODEV; > > + goto put_host; > > + } > > + > > + db->dsi_dev = devm_mipi_dsi_device_register_full(dev, dsi_host, &info); > > + if (IS_ERR(db->dsi_dev)) { > > + dev_err(dev, "failed to register dsi device: %ld\n", > > + PTR_ERR(db->dsi_dev)); > > + ret = PTR_ERR(db->dsi_dev); > > + goto put_host; > > + } > > + > > + db->dsi_dev->lanes = 2; > > + db->dsi_dev->format = MIPI_DSI_FMT_RGB888; > > + db->dsi_dev->mode_flags = MIPI_DSI_MODE_VIDEO | MIPI_DSI_MODE_VIDEO_BURST | > > + MIPI_DSI_MODE_LPM | MIPI_DSI_MODE_NO_EOT_PACKET; > > + > > + drm_panel_init(&db->panel, dev, &ams495qa01_drm_funcs, > > + DRM_MODE_CONNECTOR_DSI); > > + > > + ret = ams495qa01_backlight_register(db); > > + if (ret < 0) > > + return ret; > > + > > + drm_panel_add(&db->panel); > > + > > + ret = devm_mipi_dsi_attach(dev, db->dsi_dev); > > + if (ret < 0) { > > + dev_err(dev, "mipi_dsi_attach failed: %d\n", ret); > > + drm_panel_remove(&db->panel); > > + return ret; > > + } > > + > > + of_node_put(dsi_host_node); > > + of_node_put(endpoint); > > + > > + return 0; > > + > > +put_host: > > + of_node_put(dsi_host_node); > > + > > +put_endpoint: > > + of_node_put(endpoint); > > + return -ENODEV; > > +} > > + > > +static void ams495qa01_shutdown(struct spi_device *spi) > > +{ > > + struct ams495qa01 *db = spi_get_drvdata(spi); > > + int ret; > > + > > + ret = drm_panel_unprepare(&db->panel); > > + if (ret < 0) > > + dev_err(&spi->dev, "Failed to unprepare panel: %d\n", ret); > > + > > + ret = drm_panel_disable(&db->panel); > > + if (ret < 0) > > + dev_err(&spi->dev, "Failed to disable panel: %d\n", ret); > > +} > > + > > +static void ams495qa01_remove(struct spi_device *spi) > > +{ > > + struct ams495qa01 *db = spi_get_drvdata(spi); > > + > > + ams495qa01_shutdown(spi); > > + > > + drm_panel_remove(&db->panel); > > +} > > + > > +static const struct of_device_id ams495qa01_match[] = { > > + { .compatible = "samsung,ams495qa01", }, > > + {}, > > +}; > > +MODULE_DEVICE_TABLE(of, ams495qa01_match); > > + > > +static const struct spi_device_id ams495qa01_ids[] = { > > + { "ams495qa01", 0 }, > > + {}, > > +}; > > +MODULE_DEVICE_TABLE(spi, ams495qa01_ids); > > + > > +static struct spi_driver ams495qa01_driver = { > > + .driver = { > > + .name = "ams495qa01-panel", > > + .of_match_table = ams495qa01_match, > > + }, > > + .id_table = ams495qa01_ids, > > + .probe = ams495qa01_probe, > > + .remove = ams495qa01_remove, > > + .shutdown = ams495qa01_shutdown, > > +}; > > +module_spi_driver(ams495qa01_driver); > > + > > +MODULE_AUTHOR("Chris Morgan <macromorgan@hotmail.com>"); > > +MODULE_DESCRIPTION("Samsung ams495qa01 panel driver"); > > +MODULE_LICENSE("GPL"); > > -- > > 2.25.1 > > > > Best Regards, > Maya Matuszczyk As always appreciate the feedback and enjoy working with you. ^ permalink raw reply [flat|nested] 7+ messages in thread
end of thread, other threads:[~2022-09-21 7:23 UTC | newest] Thread overview: 7+ messages (download: mbox.gz follow: Atom feed -- links below jump to the message on this page -- 2022-09-20 17:09 [PATCH V2 0/2] drm/panel: Add Samsung AMS495QA01 Panel Chris Morgan 2022-09-20 17:09 ` [PATCH V2 1/2] dt-bindings: display: panel: Add Samsung AMS495QA01 bindings Chris Morgan 2022-09-20 17:38 ` Maya Matuszczyk 2022-09-21 7:23 ` Krzysztof Kozlowski 2022-09-20 17:09 ` [PATCH V2 2/2] drm/panel: Add Samsung AMS495QA01 MIPI-DSI LCD panel Chris Morgan 2022-09-20 17:33 ` Maya Matuszczyk 2022-09-20 21:03 ` Chris Morgan
This is a public inbox, see mirroring instructions for how to clone and mirror all data and code used for this inbox; as well as URLs for NNTP newsgroup(s).