2019-06-25 19:43:35

by Guido Günther

[permalink] [raw]
Subject: [PATCH 0/4] drm/panel: jh057n0090: Add regulators and drop magic value in init

Fix the omission of regulators for the recently added panel and make
sure all dsi commands start with a command instead of one having a magic
constant (which already caused confusion).

Also adds a mail alias to the panel's MAINTAINER entry to reduce the bus
factor.

To: Thierry Reding <[email protected]>,Sam Ravnborg <[email protected]>,David Airlie <[email protected]>,Daniel Vetter <[email protected]>,Rob Herring <[email protected]>,Mark Rutland <[email protected]>,Mauro Carvalho Chehab <[email protected]>,"David S. Miller" <[email protected]>,Greg Kroah-Hartman <[email protected]>,Nicolas Ferre <[email protected]>,"Paul E. McKenney" <[email protected]>,[email protected],[email protected],[email protected],Purism Kernel Team <[email protected]>


Guido Günther (4):
MAINTAINERS: Add Purism mail alias as reviewer for their devkit's
panel
drm/panel: jh057n0090: Don't use magic constant
dt-bindings: display/panel: jh057n0090: Document power supply
properties
drm/panel: jh057n0090: Add regulator support

.../display/panel/rocktech,jh057n00900.txt | 5 +++++
MAINTAINERS | 1 +
.../drm/panel/panel-rocktech-jh057n00900.c | 22 ++++++++++++++++++-
3 files changed, 27 insertions(+), 1 deletion(-)

--
2.20.1


2019-06-25 19:43:40

by Guido Günther

[permalink] [raw]
Subject: [PATCH 3/4] dt-bindings: display/panel: jh057n0090: Document power supply properties

Document the vcc-supply and iovcc-supply propertes of the Rocktech
jh057n0090 panel.

Signed-off-by: Guido Günther <[email protected]>
---
.../bindings/display/panel/rocktech,jh057n00900.txt | 5 +++++
1 file changed, 5 insertions(+)

diff --git a/Documentation/devicetree/bindings/display/panel/rocktech,jh057n00900.txt b/Documentation/devicetree/bindings/display/panel/rocktech,jh057n00900.txt
index 1b5763200cf6..a372c5d84695 100644
--- a/Documentation/devicetree/bindings/display/panel/rocktech,jh057n00900.txt
+++ b/Documentation/devicetree/bindings/display/panel/rocktech,jh057n00900.txt
@@ -5,6 +5,9 @@ Required properties:
- reg: DSI virtual channel of the peripheral
- reset-gpios: panel reset gpio
- backlight: phandle of the backlight device attached to the panel
+- vcc-supply: phandle of the regulator that provides the vcc supply voltage.
+- iovcc-supply: phandle of the regulator that provides the iovcc supply
+ voltage.

Example:

@@ -14,5 +17,7 @@ Example:
reg = <0>;
backlight = <&backlight>;
reset-gpios = <&gpio3 13 GPIO_ACTIVE_LOW>;
+ vcc-supply = <&reg_2v8_p>;
+ iovcc-supply = <&reg_1v8_p>;
};
};
--
2.20.1

2019-06-25 19:43:44

by Guido Günther

[permalink] [raw]
Subject: [PATCH 4/4] drm/panel: jh057n0090: Add regulator support

Allow to specify regulators for vcc and iovcc. According to the data
sheet the panel wants vcc (2.8V) and iovcc (1.8V) and there's no startup
dependency between the two.

Signed-off-by: Guido Günther <[email protected]>
---
.../drm/panel/panel-rocktech-jh057n00900.c | 19 +++++++++++++++++++
1 file changed, 19 insertions(+)

diff --git a/drivers/gpu/drm/panel/panel-rocktech-jh057n00900.c b/drivers/gpu/drm/panel/panel-rocktech-jh057n00900.c
index b8a069055fbc..f8f6f087b9bc 100644
--- a/drivers/gpu/drm/panel/panel-rocktech-jh057n00900.c
+++ b/drivers/gpu/drm/panel/panel-rocktech-jh057n00900.c
@@ -15,6 +15,7 @@
#include <linux/gpio/consumer.h>
#include <linux/media-bus-format.h>
#include <linux/module.h>
+#include <linux/regulator/consumer.h>
#include <video/display_timing.h>
#include <video/mipi_display.h>

@@ -47,6 +48,8 @@ struct jh057n {
struct drm_panel panel;
struct gpio_desc *reset_gpio;
struct backlight_device *backlight;
+ struct regulator *vcc;
+ struct regulator *iovcc;
bool prepared;

struct dentry *debugfs;
@@ -160,6 +163,8 @@ static int jh057n_unprepare(struct drm_panel *panel)
return 0;

mipi_dsi_dcs_set_display_off(dsi);
+ regulator_disable(ctx->iovcc);
+ regulator_disable(ctx->vcc);
ctx->prepared = false;

return 0;
@@ -174,6 +179,13 @@ static int jh057n_prepare(struct drm_panel *panel)
return 0;

DRM_DEV_DEBUG_DRIVER(ctx->dev, "Resetting the panel\n");
+ ret = regulator_enable(ctx->vcc);
+ if (ret < 0)
+ return ret;
+ ret = regulator_enable(ctx->iovcc);
+ if (ret < 0)
+ return ret;
+
gpiod_set_value_cansleep(ctx->reset_gpio, 1);
usleep_range(20, 40);
gpiod_set_value_cansleep(ctx->reset_gpio, 0);
@@ -301,6 +313,13 @@ static int jh057n_probe(struct mipi_dsi_device *dsi)
if (IS_ERR(ctx->backlight))
return PTR_ERR(ctx->backlight);

+ ctx->vcc = devm_regulator_get(dev, "vcc");
+ if (IS_ERR(ctx->vcc))
+ return PTR_ERR(ctx->vcc);
+ ctx->iovcc = devm_regulator_get(dev, "iovcc");
+ if (IS_ERR(ctx->iovcc))
+ return PTR_ERR(ctx->iovcc);
+
drm_panel_init(&ctx->panel);
ctx->panel.dev = dev;
ctx->panel.funcs = &jh057n_drm_funcs;
--
2.20.1

2019-06-25 19:44:57

by Guido Günther

[permalink] [raw]
Subject: [PATCH 2/4] drm/panel: jh057n0090: Don't use magic constant

0xBF isn't in any ST7703 data sheet so mark it as unknown. This avoids
confusion on whether there is a missing command in that
dsi_generic_write_seq() call.

Signed-off-by: Guido Günther <[email protected]>
---
drivers/gpu/drm/panel/panel-rocktech-jh057n00900.c | 3 ++-
1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/drivers/gpu/drm/panel/panel-rocktech-jh057n00900.c b/drivers/gpu/drm/panel/panel-rocktech-jh057n00900.c
index 6dcb692c4701..b8a069055fbc 100644
--- a/drivers/gpu/drm/panel/panel-rocktech-jh057n00900.c
+++ b/drivers/gpu/drm/panel/panel-rocktech-jh057n00900.c
@@ -33,6 +33,7 @@
#define ST7703_CMD_SETEXTC 0xB9
#define ST7703_CMD_SETMIPI 0xBA
#define ST7703_CMD_SETVDC 0xBC
+#define ST7703_CMD_UNKNOWN0 0xBF
#define ST7703_CMD_SETSCR 0xC0
#define ST7703_CMD_SETPOWER 0xC1
#define ST7703_CMD_SETPANEL 0xCC
@@ -94,7 +95,7 @@ static int jh057n_init_sequence(struct jh057n *ctx)
msleep(20);

dsi_generic_write_seq(dsi, ST7703_CMD_SETVCOM, 0x3F, 0x3F);
- dsi_generic_write_seq(dsi, 0xBF, 0x02, 0x11, 0x00);
+ dsi_generic_write_seq(dsi, ST7703_CMD_UNKNOWN0, 0x02, 0x11, 0x00);
dsi_generic_write_seq(dsi, ST7703_CMD_SETGIP1,
0x82, 0x10, 0x06, 0x05, 0x9E, 0x0A, 0xA5, 0x12,
0x31, 0x23, 0x37, 0x83, 0x04, 0xBC, 0x27, 0x38,
--
2.20.1

2019-06-25 21:19:15

by Sam Ravnborg

[permalink] [raw]
Subject: Re: [PATCH 3/4] dt-bindings: display/panel: jh057n0090: Document power supply properties

On Tue, Jun 25, 2019 at 07:05:18PM +0200, Guido G?nther wrote:
> Document the vcc-supply and iovcc-supply propertes of the Rocktech
> jh057n0090 panel.
s/propertes/properties
s/jh057n0090/jh057n00900

With these fixed:
Reviewed-by: Sam Ravnborg <[email protected]>
>
> Signed-off-by: Guido G?nther <[email protected]>
> ---
> .../bindings/display/panel/rocktech,jh057n00900.txt | 5 +++++
> 1 file changed, 5 insertions(+)
>
> diff --git a/Documentation/devicetree/bindings/display/panel/rocktech,jh057n00900.txt b/Documentation/devicetree/bindings/display/panel/rocktech,jh057n00900.txt
> index 1b5763200cf6..a372c5d84695 100644
> --- a/Documentation/devicetree/bindings/display/panel/rocktech,jh057n00900.txt
> +++ b/Documentation/devicetree/bindings/display/panel/rocktech,jh057n00900.txt
> @@ -5,6 +5,9 @@ Required properties:
> - reg: DSI virtual channel of the peripheral
> - reset-gpios: panel reset gpio
> - backlight: phandle of the backlight device attached to the panel
> +- vcc-supply: phandle of the regulator that provides the vcc supply voltage.
> +- iovcc-supply: phandle of the regulator that provides the iovcc supply
> + voltage.
>
> Example:
>
> @@ -14,5 +17,7 @@ Example:
> reg = <0>;
> backlight = <&backlight>;
> reset-gpios = <&gpio3 13 GPIO_ACTIVE_LOW>;
> + vcc-supply = <&reg_2v8_p>;
> + iovcc-supply = <&reg_1v8_p>;
> };
> };
> --
> 2.20.1

2019-06-25 21:25:42

by Sam Ravnborg

[permalink] [raw]
Subject: Re: [PATCH 4/4] drm/panel: jh057n0090: Add regulator support

On Tue, Jun 25, 2019 at 07:05:19PM +0200, Guido G?nther wrote:
> Allow to specify regulators for vcc and iovcc. According to the data
> sheet the panel wants vcc (2.8V) and iovcc (1.8V) and there's no startup
> dependency between the two.
s/jh057n0090/jh057n00900

>
> Signed-off-by: Guido G?nther <[email protected]>
> ---
> .../drm/panel/panel-rocktech-jh057n00900.c | 19 +++++++++++++++++++
> 1 file changed, 19 insertions(+)
>
> diff --git a/drivers/gpu/drm/panel/panel-rocktech-jh057n00900.c b/drivers/gpu/drm/panel/panel-rocktech-jh057n00900.c
> index b8a069055fbc..f8f6f087b9bc 100644
> --- a/drivers/gpu/drm/panel/panel-rocktech-jh057n00900.c
> +++ b/drivers/gpu/drm/panel/panel-rocktech-jh057n00900.c
> @@ -15,6 +15,7 @@
> #include <linux/gpio/consumer.h>
> #include <linux/media-bus-format.h>
> #include <linux/module.h>
> +#include <linux/regulator/consumer.h>
> #include <video/display_timing.h>
> #include <video/mipi_display.h>
>
> @@ -47,6 +48,8 @@ struct jh057n {
> struct drm_panel panel;
> struct gpio_desc *reset_gpio;
> struct backlight_device *backlight;
> + struct regulator *vcc;
> + struct regulator *iovcc;
> bool prepared;
>
> struct dentry *debugfs;
> @@ -160,6 +163,8 @@ static int jh057n_unprepare(struct drm_panel *panel)
> return 0;
>
> mipi_dsi_dcs_set_display_off(dsi);
> + regulator_disable(ctx->iovcc);
> + regulator_disable(ctx->vcc);
> ctx->prepared = false;
>
> return 0;
> @@ -174,6 +179,13 @@ static int jh057n_prepare(struct drm_panel *panel)
> return 0;
>
> DRM_DEV_DEBUG_DRIVER(ctx->dev, "Resetting the panel\n");
> + ret = regulator_enable(ctx->vcc);
> + if (ret < 0)
> + return ret;
> + ret = regulator_enable(ctx->iovcc);
> + if (ret < 0)
> + return ret;
> +
> gpiod_set_value_cansleep(ctx->reset_gpio, 1);
> usleep_range(20, 40);
> gpiod_set_value_cansleep(ctx->reset_gpio, 0);
> @@ -301,6 +313,13 @@ static int jh057n_probe(struct mipi_dsi_device *dsi)
> if (IS_ERR(ctx->backlight))
> return PTR_ERR(ctx->backlight);
>
> + ctx->vcc = devm_regulator_get(dev, "vcc");
> + if (IS_ERR(ctx->vcc))
> + return PTR_ERR(ctx->vcc);
> + ctx->iovcc = devm_regulator_get(dev, "iovcc");
> + if (IS_ERR(ctx->iovcc))
> + return PTR_ERR(ctx->iovcc);
> +
Consider to write an error message.
The regulators are now mandatory, but they be missing in some device
trees. So it would be good to help them to understand why it fails.

With this considered:
Reviewed-by: Sam Ravnborg <[email protected]>

Sam

2019-06-25 21:26:00

by Sam Ravnborg

[permalink] [raw]
Subject: Re: [PATCH 2/4] drm/panel: jh057n0090: Don't use magic constant

On Tue, Jun 25, 2019 at 07:05:17PM +0200, Guido G?nther wrote:
> 0xBF isn't in any ST7703 data sheet so mark it as unknown. This avoids
> confusion on whether there is a missing command in that
> dsi_generic_write_seq() call.
>
> Signed-off-by: Guido G?nther <[email protected]>
Reviewed-by: Sam Ravnborg <[email protected]>
> ---
> drivers/gpu/drm/panel/panel-rocktech-jh057n00900.c | 3 ++-
> 1 file changed, 2 insertions(+), 1 deletion(-)
>
> diff --git a/drivers/gpu/drm/panel/panel-rocktech-jh057n00900.c b/drivers/gpu/drm/panel/panel-rocktech-jh057n00900.c
> index 6dcb692c4701..b8a069055fbc 100644
> --- a/drivers/gpu/drm/panel/panel-rocktech-jh057n00900.c
> +++ b/drivers/gpu/drm/panel/panel-rocktech-jh057n00900.c
> @@ -33,6 +33,7 @@
> #define ST7703_CMD_SETEXTC 0xB9
> #define ST7703_CMD_SETMIPI 0xBA
> #define ST7703_CMD_SETVDC 0xBC
> +#define ST7703_CMD_UNKNOWN0 0xBF
> #define ST7703_CMD_SETSCR 0xC0
> #define ST7703_CMD_SETPOWER 0xC1
> #define ST7703_CMD_SETPANEL 0xCC
> @@ -94,7 +95,7 @@ static int jh057n_init_sequence(struct jh057n *ctx)
> msleep(20);
>
> dsi_generic_write_seq(dsi, ST7703_CMD_SETVCOM, 0x3F, 0x3F);
> - dsi_generic_write_seq(dsi, 0xBF, 0x02, 0x11, 0x00);
> + dsi_generic_write_seq(dsi, ST7703_CMD_UNKNOWN0, 0x02, 0x11, 0x00);
> dsi_generic_write_seq(dsi, ST7703_CMD_SETGIP1,
> 0x82, 0x10, 0x06, 0x05, 0x9E, 0x0A, 0xA5, 0x12,
> 0x31, 0x23, 0x37, 0x83, 0x04, 0xBC, 0x27, 0x38,
> --
> 2.20.1

2019-06-26 10:40:55

by Guido Günther

[permalink] [raw]
Subject: Re: [PATCH 4/4] drm/panel: jh057n0090: Add regulator support

Hi Sam,
On Tue, Jun 25, 2019 at 11:24:19PM +0200, Sam Ravnborg wrote:
> On Tue, Jun 25, 2019 at 07:05:19PM +0200, Guido G?nther wrote:
> > Allow to specify regulators for vcc and iovcc. According to the data
> > sheet the panel wants vcc (2.8V) and iovcc (1.8V) and there's no startup
> > dependency between the two.
> s/jh057n0090/jh057n00900
>
> >
> > Signed-off-by: Guido G?nther <[email protected]>
> > ---
> > .../drm/panel/panel-rocktech-jh057n00900.c | 19 +++++++++++++++++++
> > 1 file changed, 19 insertions(+)
> >
> > diff --git a/drivers/gpu/drm/panel/panel-rocktech-jh057n00900.c b/drivers/gpu/drm/panel/panel-rocktech-jh057n00900.c
> > index b8a069055fbc..f8f6f087b9bc 100644
> > --- a/drivers/gpu/drm/panel/panel-rocktech-jh057n00900.c
> > +++ b/drivers/gpu/drm/panel/panel-rocktech-jh057n00900.c
> > @@ -15,6 +15,7 @@
> > #include <linux/gpio/consumer.h>
> > #include <linux/media-bus-format.h>
> > #include <linux/module.h>
> > +#include <linux/regulator/consumer.h>
> > #include <video/display_timing.h>
> > #include <video/mipi_display.h>
> >
> > @@ -47,6 +48,8 @@ struct jh057n {
> > struct drm_panel panel;
> > struct gpio_desc *reset_gpio;
> > struct backlight_device *backlight;
> > + struct regulator *vcc;
> > + struct regulator *iovcc;
> > bool prepared;
> >
> > struct dentry *debugfs;
> > @@ -160,6 +163,8 @@ static int jh057n_unprepare(struct drm_panel *panel)
> > return 0;
> >
> > mipi_dsi_dcs_set_display_off(dsi);
> > + regulator_disable(ctx->iovcc);
> > + regulator_disable(ctx->vcc);
> > ctx->prepared = false;
> >
> > return 0;
> > @@ -174,6 +179,13 @@ static int jh057n_prepare(struct drm_panel *panel)
> > return 0;
> >
> > DRM_DEV_DEBUG_DRIVER(ctx->dev, "Resetting the panel\n");
> > + ret = regulator_enable(ctx->vcc);
> > + if (ret < 0)
> > + return ret;
> > + ret = regulator_enable(ctx->iovcc);
> > + if (ret < 0)
> > + return ret;
> > +
> > gpiod_set_value_cansleep(ctx->reset_gpio, 1);
> > usleep_range(20, 40);
> > gpiod_set_value_cansleep(ctx->reset_gpio, 0);
> > @@ -301,6 +313,13 @@ static int jh057n_probe(struct mipi_dsi_device *dsi)
> > if (IS_ERR(ctx->backlight))
> > return PTR_ERR(ctx->backlight);
> >
> > + ctx->vcc = devm_regulator_get(dev, "vcc");
> > + if (IS_ERR(ctx->vcc))
> > + return PTR_ERR(ctx->vcc);
> > + ctx->iovcc = devm_regulator_get(dev, "iovcc");
> > + if (IS_ERR(ctx->iovcc))
> > + return PTR_ERR(ctx->iovcc);
> > +
> Consider to write an error message.
> The regulators are now mandatory, but they be missing in some device
> trees. So it would be good to help them to understand why it fails.

I've fixed this and your other comments in v2.
>
> With this considered:
> Reviewed-by: Sam Ravnborg <[email protected]>

Thanks! I've not added this yet since I made two more changes:

- also print an error when regulator_enable() fails
- disable vcc if enabling iovcc fails afterwards

Hope this looks sane now.

Cheers,
-- Guido

>
> Sam
>