bindings/media/samsung-mipi-csis.txt

0001 Samsung S5P/Exynos SoC series MIPI CSI-2 receiver (MIPI CSIS)
0002 -------------------------------------------------------------
0003
0004 Required properties:
0005
0006 - compatible      : "samsung,s5pv210-csis" for S5PV210 (S5PC110),
0007                     "samsung,exynos4210-csis" for Exynos4210 (S5PC210),
0008                     "samsung,exynos4212-csis" for Exynos4212/Exynos4412,
0009                     "samsung,exynos5250-csis" for Exynos5250;
0010 - reg             : offset and length of the register set for the device;
0011 - interrupts      : should contain MIPI CSIS interrupt; the format of the
0012                     interrupt specifier depends on the interrupt controller;
0013 - bus-width       : maximum number of data lanes supported (SoC specific);
0014 - vddio-supply    : MIPI CSIS I/O and PLL voltage supply (e.g. 1.8V);
0015 - vddcore-supply  : MIPI CSIS Core voltage supply (e.g. 1.1V);
0016 - clocks          : list of clock specifiers, corresponding to entries in
0017                     clock-names property;
0018 - clock-names     : must contain "csis", "sclk_csis" entries, matching entries
0019                     in the clocks property.
0020
0021 Optional properties:
0022
0023 - clock-frequency : The IP's main (system bus) clock frequency in Hz, default
0024                     value when this property is not specified is 166 MHz;
0025 - samsung,csis-wclk : CSI-2 wrapper clock selection. If this property is present
0026                     external clock from CMU will be used, or the bus clock if
0027                     if it's not specified.
0028
0029 The device node should contain one 'port' child node with one child 'endpoint'
0030 node, according to the bindings defined in Documentation/devicetree/bindings/
0031 media/video-interfaces.txt. The following are properties specific to those nodes.
0032
0033 port node
0034 ---------
0035
0036 - reg             : (required) must be 3 for camera C input (CSIS0) or 4 for
0037                     camera D input (CSIS1);
0038
0039 endpoint node
0040 -------------
0041
0042 - data-lanes      : (required) an array specifying active physical MIPI-CSI2
0043                     data input lanes and their mapping to logical lanes; the
0044                     array's content is unused, only its length is meaningful;
0045
0046 - samsung,csis-hs-settle : (optional) differential receiver (HS-RX) settle time;
0047
0048
0049 Example:
0050
0051         reg0: regulator@0 {
0052         };
0053
0054         reg1: regulator@1 {
0055         };
0056
0057 /* SoC properties */
0058
0059         csis_0: csis@11880000 {
0060                 compatible = "samsung,exynos4210-csis";
0061                 reg = <0x11880000 0x1000>;
0062                 interrupts = <0 78 0>;
0063                 #address-cells = <1>;
0064                 #size-cells = <0>;
0065         };
0066
0067 /* Board properties */
0068
0069         csis_0: csis@11880000 {
0070                 clock-frequency = <166000000>;
0071                 vddio-supply = <&reg0>;
0072                 vddcore-supply = <&reg1>;
0073                 port {
0074                         reg = <3>; /* 3 - CSIS0, 4 - CSIS1 */
0075                         csis0_ep: endpoint {
0076                                 remote-endpoint = <...>;
0077                                 data-lanes = <1>, <2>;
0078                                 samsung,csis-hs-settle = <12>;
0079                         };
0080                 };
0081         };