linux/Documentation/devicetree/bindings/media/samsung-mipi-csis.txt
<<
>>
Prefs
   1Samsung S5P/EXYNOS SoC series MIPI CSI-2 receiver (MIPI CSIS)
   2-------------------------------------------------------------
   3
   4Required properties:
   5
   6- compatible      : "samsung,s5pv210-csis" for S5PV210 (S5PC110),
   7                    "samsung,exynos4210-csis" for Exynos4210 (S5PC210),
   8                    "samsung,exynos4212-csis" for Exynos4212/Exynos4412,
   9                    "samsung,exynos5250-csis" for Exynos5250;
  10- reg             : offset and length of the register set for the device;
  11- interrupts      : should contain MIPI CSIS interrupt; the format of the
  12                    interrupt specifier depends on the interrupt controller;
  13- bus-width       : maximum number of data lanes supported (SoC specific);
  14- vddio-supply    : MIPI CSIS I/O and PLL voltage supply (e.g. 1.8V);
  15- vddcore-supply  : MIPI CSIS Core voltage supply (e.g. 1.1V);
  16- clocks          : list of clock specifiers, corresponding to entries in
  17                    clock-names property;
  18- clock-names     : must contain "csis", "sclk_csis" entries, matching entries
  19                    in the clocks property.
  20
  21Optional properties:
  22
  23- clock-frequency : The IP's main (system bus) clock frequency in Hz, default
  24                    value when this property is not specified is 166 MHz;
  25- samsung,csis-wclk : CSI-2 wrapper clock selection. If this property is present
  26                    external clock from CMU will be used, or the bus clock if
  27                    if it's not specified.
  28
  29The device node should contain one 'port' child node with one child 'endpoint'
  30node, according to the bindings defined in Documentation/devicetree/bindings/
  31media/video-interfaces.txt. The following are properties specific to those nodes.
  32
  33port node
  34---------
  35
  36- reg             : (required) must be 3 for camera C input (CSIS0) or 4 for
  37                    camera D input (CSIS1);
  38
  39endpoint node
  40-------------
  41
  42- data-lanes      : (required) an array specifying active physical MIPI-CSI2
  43                    data input lanes and their mapping to logical lanes; the
  44                    array's content is unused, only its length is meaningful;
  45
  46- samsung,csis-hs-settle : (optional) differential receiver (HS-RX) settle time;
  47
  48
  49Example:
  50
  51        reg0: regulator@0 {
  52        };
  53
  54        reg1: regulator@1 {
  55        };
  56
  57/* SoC properties */
  58
  59        csis_0: csis@11880000 {
  60                compatible = "samsung,exynos4210-csis";
  61                reg = <0x11880000 0x1000>;
  62                interrupts = <0 78 0>;
  63                #address-cells = <1>;
  64                #size-cells = <0>;
  65        };
  66
  67/* Board properties */
  68
  69        csis_0: csis@11880000 {
  70                clock-frequency = <166000000>;
  71                vddio-supply = <&reg0>;
  72                vddcore-supply = <&reg1>;
  73                port {
  74                        reg = <3>; /* 3 - CSIS0, 4 - CSIS1 */
  75                        csis0_ep: endpoint {
  76                                remote-endpoint = <...>;
  77                                data-lanes = <1>, <2>;
  78                                samsung,csis-hs-settle = <12>;
  79                        };
  80                };
  81        };
  82