msm: cvp: Add CVP DT bindings documentation

* Qualcomm Technologies, Inc. MSM CVP

[Root level node]

cvp

=====

Required properties:

- compatible : one of:

	- "qcom,msm-cvp"

	- "qcom,kona-cvp" : Invokes driver specific data for Kona.

Optional properties:

- reg : offset and length of the CSR register set for the device.

- interrupts : should contain the cvp interrupt.

- qcom,reg-presets : list of offset-value pairs for registers to be written.

  The offsets are from the base offset specified in 'reg'. This is mainly

  used for QoS, VBIF, etc. presets for video.

- qcom,qdss-presets : list of physical address and memory allocation size pairs.

  when fw_debug_mode is set as HFI_DEBUG_MODE_QDSS, all firmware messages will be

  written to QDSS memory.

- *-supply: A phandle pointing to the appropriate regulator. Number of

  regulators vary across targets.

- clock-names: an array of clocks that the driver is supposed to be

  manipulating. The clocks names here correspond to the clock names used in

  clk_get(<name>).

- qcom,clock-configs = an array of bitmaps of clocks' configurations. The index

  of the bitmap corresponds to the clock at the same index in qcom,clock-names.

  The bitmaps describes the actions that the device needs to take regarding the

  clock (i.e. scale it based on load).

  The bitmap is defined as:

  scalable = 0x1 (if the driver should vary the clock's frequency based on load)

- qcom,allowed-clock-rates = an array of supported clock rates by the chipset.

- qcom,use-non-secure-pil = A bool indicating which type of pil to use to load

  the fw.

- qcom,fw-bias = The address at which cvp fw is loaded (manually).

[Second level nodes]

Context Banks

=============

Required properties:

- compatible : one of:

	- "qcom,msm-cvp,context-bank"

- iommus : A phandle parsed by smmu driver. Number of entries will vary

  across targets.

Optional properties:

- label - string describing iommu domain usage.

- buffer-types : bitmap of buffer types that can be mapped into the current

	IOMMU domain.

        - Buffer types are defined as the following:

          input = 0x1

          output = 0x2

          output2 = 0x4

          extradata input = 0x8

          extradata output = 0x10

          extradata output2 = 0x20

          internal scratch = 0x40

          internal scratch1 = 0x80

          internal scratch2 = 0x100

          internal persist = 0x200

          internal persist1 = 0x400

          internal cmd queue = 0x800

- virtual-addr-pool : offset and length of virtual address pool.

- qcom,fw-context-bank : bool indicating firmware context bank.

- qcom,secure-context-bank : bool indicating secure context bank.

Buses

=====

Required properties:

- compatible : one of:

	- "qcom,msm-cvp,bus"

- label : an arbitrary name

- qcom,bus-master : an integer descriptor of the bus master. Refer to arch/arm/\

  boot/dts/include/dt-bindings/msm/msm-bus-ids.h for list of acceptable masters

- qcom,bus-slave : an integer descriptor of the bus slave. Refer to arch/arm/\

  boot/dts/include/dt-bindings/msm/msm-bus-ids.h for list of acceptable slaves

Optional properties:

- qcom,bus-governor : governor to use when scaling bus, generally any commonly

  found devfreq governor might be used.  In addition to those governors, the

  custom Venus governors, "msm-vidc-ddr" or "msm-vidc-llcc" are also

  acceptable values.

  In the absence of this property the "performance" governor is used.

- qcom,bus-rage-kbps : an array of two items (<min max>) that indicate the

  minimum and maximum acceptable votes for the bus.

  In the absence of this property <0 INT_MAX> is used.

- qcom,ubwc-10bit : UBWC 10 bit content has different bus requirements,

  this tag will be used to pick the appropriate bus as per the session profile

  as shown below in example.

Memory Heaps

============

Required properties:

- compatible : one of:

	- "qcom,msm-vidc,mem-cdsp"

- memory-region : phandle to the memory heap/region.

Example:

	msm_cvp: qcom,cvp@ab00000 {

		 compatible = "qcom,msm-cvp", "qcom,kona-cvp";

		 status = "ok";

		 reg = <0xab00000 0x100000>;

		 interrupts = <GIC_SPI 234 IRQ_TYPE_LEVEL_HIGH>;

		 /* FIXME: LLCC Info */

		 /* cache-slice-names = "vidsc0", "vidsc1"; */

		 /* cache-slices = <&llcc 2>, <&llcc 3>; */

		 /* Supply */

		 cvp-supply = <&mvs1_gdsc>;

		 /* Clocks */

		 clock-names =  "gcc_video_axi0",

			 "gcc_video_axi1", "cvp_clk";

		 clocks = <&clock_gcc GCC_VIDEO_AXI0_CLK>,

			<&clock_gcc GCC_VIDEO_AXI1_CLK>,

			<&clock_videocc VIDEO_CC_MVS1_CLK>;

		 qcom,proxy-clock-names = "gcc_video_axi0", "gcc_video_axi1",

			 "cvp_clk";

		 qcom,clock-configs = <0x0 0x0 0x1>;

		 qcom,allowed-clock-rates = <403000000 520000000

			 549000000 666000000 800000000>;

		 /* Buses */

		 bus_cnoc {

			 compatible = "qcom,msm-cvp,bus";

			 label = "cnoc";

			 qcom,bus-master = <MSM_BUS_MASTER_AMPSS_M0>;

			 qcom,bus-slave = <MSM_BUS_SLAVE_VENUS_CFG>;

			 qcom,bus-governor = "performance";

			 qcom,bus-range-kbps = <1000 1000>;

		 };

		 /* MMUs */

		 non_secure_cb {

			 compatible = "qcom,msm-cvp,context-bank";

			 label = "cvp_hlos";

			 iommus =

				 <&apps_smmu 0x2120 0x400>;

			 qcom,iommu-dma = "disabled";

			 buffer-types = <0xfff>;

			 virtual-addr-pool = <0x4b000000 0xe0000000>;

		 };

		 /* Memory Heaps */

		 qcom,msm-cvp,mem_cdsp {

			 compatible = "qcom,msm-cvp,mem-cdsp";

			 memory-region = <&cdsp_mem>;

		 };

	};