Commit 69f2970a authored by Linus Torvalds's avatar Linus Torvalds
Browse files

Merge tag 'devicetree-for-6.17' of git://git.kernel.org/pub/scm/linux/kernel/git/robh/linux 

Pull devicetree updates from Rob Herring:

 - Add bindings for arm,armv7m-nvic, fsl,icoll, fsl,imx23-digctl, Xilinx
   INTC, Analog Devices ADT7411, and a bunch of trivial hwmon devices

 - Convert fsl,vf610-mscm-ir, fsl,dsu, via,vt8500-timer, nxp,isp1301,
   Marvell Armada NETA and BM, apm,xgene1-msi, fsl,mpic-msi,
   himax,hx8357d, and sitronix,st7586 bindings to DT schema format

 - Fixes for some display bindings

 - More indentation clean-ups in examples

 - Add more guidelines and clarifications on writing bindings

* tag 'devicetree-for-6.17' of git://git.kernel.org/pub/scm/linux/kernel/git/robh/linux: (31 commits)
  dt-bindings: Correct indentation and style in DTS example
  dt-bindings: display: mediatek,dp: Allow DisplayPort AUX bus
  dt-bindings: fsl: convert fsl,vf610-mscm-ir.txt to yaml format
  dt-bindings: interrupt-controller: Add fsl,icoll.yaml
  dt-bindings: interrupt-controller: Add missing Xilinx INTC binding
  dt-bindings: display: sprd,sharkl3-dsi-host: Fix missing clocks constraints
  dt-bindings: display: sprd,sharkl3-dpu: Fix missing clocks constraints
  dt-bindings: display: imx: convert fsl,dcu.txt to yaml format
  dt-bindings: timer: via,vt8500-timer: Convert to YAML
  dt-bindings: net: Convert Marvell Armada NETA and BM to DT schema
  dt-bindings: trivial-devices: Add undocumented hwmon devices
  dt-bindings: interrupt-controller: Convert apm,xgene1-msi to DT schema
  dt-bindings: gpu: mali-bifrost: Add Allwinner A523 compatible
  docs: dt: writing-schema: Document preferred order of properties
  docs: dt: writing-bindings: Document discouraged instance IDs
  docs: dt: writing-bindings: Document compatible and filename naming
  docs: dt: submitting-patches: Avoid 'YAML' in the subject and add an example
  MAINTAINERS: adjust file entry in INTEL STRATIX10 FIRMWARE DRIVERS
  docs: dt: writing-bindings: Consistently use single-whitespace
  docs: dt: writing-bindings: Express better expectations of "specific"
  ...
parents 137177af 0121898e

Documentation/devicetree/bindings/arm/freescale/fsl,vf610-mscm-ir.txt

deleted100644 → 0
+0 −30
Original line number Diff line number Diff line 
Freescale Vybrid Miscellaneous System Control - Interrupt Router



The MSCM IP contains multiple sub modules, this binding describes the second

block of registers which control the interrupt router. The interrupt router

allows to configure the recipient of each peripheral interrupt. Furthermore

it controls the directed processor interrupts. The module is available in all

Vybrid SoC's but is only really useful in dual core configurations (VF6xx

which comes with a Cortex-A5/Cortex-M4 combination).



Required properties:

- compatible:		"fsl,vf610-mscm-ir"

- reg:			the register range of the MSCM Interrupt Router

- fsl,cpucfg:		The handle to the MSCM CPU configuration node, required

			to get the current CPU ID

- interrupt-controller:	Identifies the node as an interrupt controller

- #interrupt-cells:	Two cells, interrupt number and cells.

			The hardware interrupt number according to interrupt

			assignment of the interrupt router is required.

			Flags get passed only when using GIC as parent. Flags

			encoding as documented by the GIC bindings.



Example:

	mscm_ir: interrupt-controller@40001800 {

		compatible = "fsl,vf610-mscm-ir";

		reg = <0x40001800 0x400>;

		fsl,cpucfg = <&mscm_cpucfg>;

		interrupt-controller;

		#interrupt-cells = <2>;

		interrupt-parent = <&intc>;

	}

Documentation/devicetree/bindings/display/arm,pl11x.yaml

+3 −0
Original line number Diff line number Diff line
@@ -78,6 +78,9 @@ properties: 
      If not present, the memory interface is fast enough to handle all

      possible video modes.



  resets:

    maxItems: 1



  port:

    $ref: /schemas/graph.yaml#/$defs/port-base

    additionalProperties: false

Documentation/devicetree/bindings/display/fsl,dcu.txt

deleted100644 → 0
+0 −34
Original line number Diff line number Diff line 
Device Tree bindings for Freescale DCU DRM Driver



Required properties:

- compatible:		Should be one of

	* "fsl,ls1021a-dcu".

	* "fsl,vf610-dcu".



- reg:			Address and length of the register set for dcu.

- clocks:		Handle to "dcu" and "pix" clock (in the order below)

			This can be the same clock (e.g. LS1021a)

			See ../clocks/clock-bindings.txt for details.

- clock-names:		Should be "dcu" and "pix"

			See ../clocks/clock-bindings.txt for details.

- big-endian		Boolean property, LS1021A DCU registers are big-endian.

- port			Video port for the panel output



Optional properties:

- fsl,tcon:		The phandle to the timing controller node.



Examples:

dcu: dcu@2ce0000 {

	compatible = "fsl,ls1021a-dcu";

	reg = <0x0 0x2ce0000 0x0 0x10000>;

	clocks = <&platform_clk 0>, <&platform_clk 0>;

	clock-names = "dcu", "pix";

	big-endian;

	fsl,tcon = <&tcon>;



	port {

		dcu_out: endpoint {

			remote-endpoint = <&panel_out>;

	     };

	};

};

Documentation/devicetree/bindings/display/fsl,lcdif.yaml

+18 −1
Original line number Diff line number Diff line
@@ -71,12 +71,23 @@ properties: 
    $ref: /schemas/graph.yaml#/properties/port

    description: The LCDIF output port



  display:

    $ref: /schemas/types.yaml#/definitions/phandle

    description: phandle to display panel

    deprecated: true



  display0:

    $ref: panel/panel-common.yaml#

    deprecated: true



  lcd-supply:

    deprecated: true



required:

  - compatible

  - reg

  - clocks

  - interrupts

  - port



additionalProperties: false
@@ -175,6 +186,12 @@ allOf: 
      properties:

        dmas: false

        dma-names: false

        display: false

        display0: false

        lcd-supply: false



      required:

        - port



examples:

  - |

Documentation/devicetree/bindings/display/fsl,ls1021a-dcu.yaml

0 → 100644
+71 −0
Original line number Diff line number Diff line 
# SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause)

%YAML 1.2

---

$id: http://devicetree.org/schemas/display/fsl,ls1021a-dcu.yaml#

$schema: http://devicetree.org/meta-schemas/core.yaml#



title: Freescale DCU DRM Driver



maintainers:

  - Frank Li <Frank.Li@nxp.com>



properties:

  compatible:

    enum:

      - fsl,ls1021a-dcu

      - fsl,vf610-dcu



  reg:

    maxItems: 1



  interrupts:

    maxItems: 1



  clocks:

    maxItems: 2



  clock-names:

    items:

      - const: dcu

      - const: pix



  big-endian: true



  port:

    $ref: /schemas/graph.yaml#/$defs/port-base

    unevaluatedProperties: false

    description: Video port for the panel output



    properties:

      endpoint:

        $ref: /schemas/media/video-interfaces.yaml#

        unevaluatedProperties: false



  fsl,tcon:

    $ref: /schemas/types.yaml#/definitions/phandle

    description: The phandle to the timing controller node.



required:

  - compatible

  - reg

  - clocks

  - clock-names



additionalProperties: false



examples:

  - |

    display-controller@2ce0000 {

        compatible = "fsl,ls1021a-dcu";

        reg = <0x2ce0000 0x10000>;

        clocks = <&platform_clk 0>, <&platform_clk 0>;

        clock-names = "dcu", "pix";

        big-endian;

        fsl,tcon = <&tcon>;



        port {

            endpoint {

                remote-endpoint = <&panel_out>;

            };

        };

    };