Groups | Search | Server Info | Keyboard shortcuts | Login | Register [http] [https] [nntp] [nntps]

Groups > linux.kernel > #1604686

Re: [PATCH v2 4/5] dt-bindings: auxdisplay: Add bindings for Hitachi HD44780

Show all headers | View raw

On Fri, Mar 10, 2017 at 03:15:20PM +0100, Geert Uytterhoeven wrote:
> Add DT bindings for an Hitachi HD44780 Character LCD Controller where
> its M6800 bus interface is connected to GPIOs.
> 
> Memory-mapped configurations are not yet supported.
> 
> Signed-off-by: Geert Uytterhoeven <geert@linux-m68k.org>
> ---
> Memory-mapped configurations can be supported by amending the binding to
> make mandatory either the {data,enable,rs}-gpios properties, or a "reg"
> (and optional "reg-names") property.
> 
> As the driver doesn't support this yet, and there are different ways to
> organize the register map (some wirings use different addresses for
> reading and writing, to simplify bus glue logic), this is left for a
> future improvement.
> 
> v2:
>   - Added rationale below "---".
> ---
>  .../devicetree/bindings/auxdisplay/hit,hd44780.txt | 44 ++++++++++++++++++++++
>  1 file changed, 44 insertions(+)
>  create mode 100644 Documentation/devicetree/bindings/auxdisplay/hit,hd44780.txt
> 
> diff --git a/Documentation/devicetree/bindings/auxdisplay/hit,hd44780.txt b/Documentation/devicetree/bindings/auxdisplay/hit,hd44780.txt
> new file mode 100644
> index 0000000000000000..ee4054da458d412f
> --- /dev/null
> +++ b/Documentation/devicetree/bindings/auxdisplay/hit,hd44780.txt
> @@ -0,0 +1,44 @@
> +DT bindings for the Hitachi HD44780 Character LCD Controller
> +
> +The Hitachi HD44780 Character LCD Controller is commonly used on character LCDs
> +that can display one or more lines of text. It exposes an M6800 bus interface,
> +which can be used in either 4-bit or 8-bit mode.
> +
> +Required properties:
> +  - compatible: Must contain "hit,hd44780",
> +  - data-gpios: Must contain an array of either 4 or 8 GPIO specifiers,
> +    referring to the GPIO pins connected to the data signal lines DB0-DB7
> +    (8-bit mode) or DB4-DB7 (4-bit mode) of the LCD Controller's bus interface,
> +  - enable-gpios: Must contain a GPIO specifier, referring to the GPIO pin
> +    connected to the "E" (Enable) signal line of the LCD Controller's bus
> +    interface,
> +  - rs-gpios: Must contain a GPIO specifier, referring to the GPIO pin
> +    connected to the "RS" (Register Select) signal line of the LCD Controller's
> +    bus interface,
> +  - display-height: Height of the display, in character cells,
> +  - display-width: Width of the display, in character cells.

display-{width,height}-chars

> +
> +Optional properties:
> +  - rw-gpios: Must contain a GPIO specifier, referring to the GPIO pin
> +    connected to the "RW" (Read/Write) signal line of the LCD Controller's bus
> +    interface,
> +  - backlight-gpios: Must contain a GPIO specifier, referring to the GPIO pin
> +    used for enabling the LCD's backlight,

Active state?

> +  - internal-buffer-width: Internal buffer width (default is 40 for displays
> +    with 1 or 2 lines, and display-width for displays with more than 2 lines).
> +
> +Example:
> +
> +	auxdisplay {
> +		compatible = "hit,hd44780";
> +
> +		data-gpios = <&hc595 0 GPIO_ACTIVE_HIGH>,
> +			     <&hc595 1 GPIO_ACTIVE_HIGH>,
> +			     <&hc595 2 GPIO_ACTIVE_HIGH>,
> +			     <&hc595 3 GPIO_ACTIVE_HIGH>;
> +		enable-gpios = <&hc595 4 GPIO_ACTIVE_HIGH>;
> +		rs-gpios = <&hc595 5 GPIO_ACTIVE_HIGH>;
> +
> +		display-height = <2>;
> +		display-width = <16>;
> +	};
> -- 
> 2.7.4
> 

Back to linux.kernel | Previous | Next — Next in thread | Find similar | Unroll thread

Thread

Re: [PATCH v2 4/5] dt-bindings: auxdisplay: Add bindings for Hitachi  HD44780 Rob Herring <robh@kernel.org> - 2017-03-20 16:30 +0100
  Re: [PATCH v2 4/5] dt-bindings: auxdisplay: Add bindings for Hitachi HD44780 Geert Uytterhoeven <geert@linux-m68k.org> - 2017-03-20 16:40 +0100
    Re: [PATCH v2 4/5] dt-bindings: auxdisplay: Add bindings for Hitachi  HD44780 Greg Kroah-Hartman <gregkh@linuxfoundation.org> - 2017-03-20 17:20 +0100
    Re: [PATCH v2 4/5] dt-bindings: auxdisplay: Add bindings for Hitachi HD44780 Rob Herring <robh@kernel.org> - 2017-03-20 18:10 +0100
      Re: [PATCH v2 4/5] dt-bindings: auxdisplay: Add bindings for Hitachi HD44780 Geert Uytterhoeven <geert@linux-m68k.org> - 2017-03-21 09:10 +0100

csiph-web