Himax HX8837 is a secondary display controller used to drive the panel on OLPC platforms.
Signed-off-by: Lubomir Rintel <lkund...@v3.sk> Reviewed-by: Rob Herring <r...@kernel.org> --- Changes since v6: (All based on feedback from Laurent Pinchart) - Add power supplies - Make load/stat-gpios optional - Fix whitespace errors - Use decimal constants instead of hex in example where appropriate - Terminate the bindings with "..." end-of-document marker Changes since v4: - Rob's Reviewed-by Changes since v3: - Moved to bindings/display/ - Added the ports - Converted to YAML - Removed Pavel's Ack, because the changes are substantial Changes since v2: - s/betweend/between/ Changes since v1: - s/load-gpio/load-gpios/ - Use interrupt bindings instead of gpio for the IRQ .../bindings/display/bridge/himax,hx8837.yaml | 108 ++++++++++++++++++ 1 file changed, 108 insertions(+) create mode 100644 Documentation/devicetree/bindings/display/bridge/himax,hx8837.yaml diff --git a/Documentation/devicetree/bindings/display/bridge/himax,hx8837.yaml b/Documentation/devicetree/bindings/display/bridge/himax,hx8837.yaml new file mode 100644 index 0000000000000..e9e21a3447088 --- /dev/null +++ b/Documentation/devicetree/bindings/display/bridge/himax,hx8837.yaml @@ -0,0 +1,108 @@ +# SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause) +# Copyright (C) 2018,2019,2020,2021 Lubomir Rintel <lkund...@v3.sk> +%YAML 1.2 +--- +$id: http://devicetree.org/schemas/display/bridge/himax,hx8837.yaml# +$schema: http://devicetree.org/meta-schemas/core.yaml# + +title: HX8837 Display Controller Device Tree Bindings + +maintainers: + - Lubomir Rintel <lkund...@v3.sk> + +properties: + compatible: + const: himax,hx8837 + + reg: + const: 0xd + + load-gpios: + maxItems: 1 + description: GPIO specifier of DCON_LOAD pin (active high) + + stat-gpios: + minItems: 2 + description: GPIO specifier of DCON_STAT0 and DCON_STAT1 pins (active high) + + interrupts: + maxItems: 1 + description: Interrupt specifier of DCON_IRQ pin (edge falling) + + vddp18-supply: + description: Regulator for 1.8V display interface I/O power. + + vddm25-supply: + description: Regulator for 2.5V SDRAM I/O power. + + vdd33-supply: + description: Regulator for 3.3V digital I/O power. + + vddk18-supply: + description: Regulator for 1.8V internal core power. + + ports: + type: object + + properties: + port@0: + type: object + description: | + Video port for RGB input. + + port@1: + type: object + description: | + Video port connected to the panel. + + required: + - port@0 + - port@1 + +required: + - compatible + - reg + - interrupts + - ports + +additionalProperties: false + +examples: + - | + #include <dt-bindings/gpio/gpio.h> + #include <dt-bindings/interrupt-controller/irq.h> + + i2c { + #address-cells = <1>; + #size-cells = <0>; + + lcd-controller@d { + compatible = "himax,hx8837"; + reg = <0x0d>; + stat-gpios = <&gpio 100 GPIO_ACTIVE_HIGH>, + <&gpio 101 GPIO_ACTIVE_HIGH>; + load-gpios = <&gpio 142 GPIO_ACTIVE_HIGH>; + interrupts = <&gpio 124 IRQ_TYPE_EDGE_FALLING>; + + ports { + #address-cells = <1>; + #size-cells = <0>; + + port@0 { + reg = <0>; + dcon_rgb_in: endpoint { + remote-endpoint = <&lcd0_rgb_out>; + }; + }; + + port@1 { + reg = <1>; + dcon_gettl_out: endpoint { + remote-endpoint = <&panel_dettl_in>; + }; + }; + }; + }; + }; + +... -- 2.29.2
