samsung,exynos4210-fimc.yaml

  1# SPDX-License-Identifier: GPL-2.0-only OR BSD-2-Clause
  2%YAML 1.2
  3---
  4$id: http://devicetree.org/schemas/media/samsung,exynos4210-fimc.yaml#
  5$schema: http://devicetree.org/meta-schemas/core.yaml#
  6
  7title: Samsung S5P/Exynos SoC Fully Integrated Mobile Camera
  8
  9maintainers:
 10  - Krzysztof Kozlowski <krzk@kernel.org>
 11  - Sylwester Nawrocki <s.nawrocki@samsung.com>
 12
 13description:
 14  Each FIMC device should have an alias in the aliases node, in the form of
 15  fimc<n>, where <n> is an integer specifying the IP block instance.
 16
 17properties:
 18  compatible:
 19    enum:
 20      - samsung,exynos4210-fimc
 21      - samsung,exynos4212-fimc
 22      - samsung,s5pv210-fimc
 23
 24  reg:
 25    maxItems: 1
 26
 27  clocks:
 28    maxItems: 2
 29
 30  clock-names:
 31    items:
 32      - const: fimc
 33      - const: sclk_fimc
 34
 35  clock-frequency:
 36    description:
 37      Maximum FIMC local clock (LCLK) frequency.
 38
 39  interrupts:
 40    maxItems: 1
 41
 42  iommus:
 43    maxItems: 1
 44
 45  power-domains:
 46    maxItems: 1
 47
 48  samsung,cam-if:
 49    type: boolean
 50    description:
 51      The FIMC IP block includes the camera input interface.
 52
 53  samsung,isp-wb:
 54    type: boolean
 55    description: |
 56      The FIMC IP block has the ISP writeback input.
 57
 58  samsung,lcd-wb:
 59    type: boolean
 60    description: |
 61      The FIMC IP block has the LCD writeback input.
 62
 63  samsung,mainscaler-ext:
 64    type: boolean
 65    description:
 66      FIMC IP supports extended image size and has CIEXTEN register.
 67
 68  samsung,min-pix-alignment:
 69    $ref: /schemas/types.yaml#/definitions/uint32-array
 70    items:
 71      - description: Minimum supported image height alignment.
 72      - description: Horizontal image offset.
 73    description:
 74      The values are in pixels and default is <2 1>.
 75
 76  samsung,min-pix-sizes:
 77    $ref: /schemas/types.yaml#/definitions/uint32-array
 78    maxItems: 2
 79    description: |
 80      An array specifying minimum image size in pixels at the FIMC input and
 81      output DMA, in the first and second cell respectively.  Default value
 82      is <16 16>.
 83
 84  samsung,pix-limits:
 85    $ref: /schemas/types.yaml#/definitions/uint32-array
 86    maxItems: 4
 87    description: |
 88      An array of maximum supported image sizes in pixels, for details refer to
 89      Table 2-1 in the S5PV210 SoC User Manual. The meaning of each cell is as
 90      follows:
 91       0 - scaler input horizontal size
 92       1 - input horizontal size for the scaler bypassed
 93       2 - REAL_WIDTH without input rotation
 94       3 - REAL_HEIGHT with input rotation
 95
 96  samsung,rotators:
 97    $ref: /schemas/types.yaml#/definitions/uint32
 98    default: 0x11
 99    description: |
100      A bitmask specifying whether this IP has the input and the output
101      rotator. Bits 4 and 0 correspond to input and output rotator
102      respectively. If a rotator is present its corresponding bit should be
103      set.
104
105  samsung,sysreg:
106    $ref: /schemas/types.yaml#/definitions/phandle
107    description:
108      System Registers (SYSREG) node.
109
110required:
111  - compatible
112  - reg
113  - clocks
114  - clock-names
115  - samsung,pix-limits
116
117allOf:
118  - if:
119      required:
120        - samsung,isp-wb
121    then:
122      required:
123        - samsung,sysreg
124
125additionalProperties: false
126
127examples:
128  - |
129    #include <dt-bindings/clock/exynos4.h>
130    #include <dt-bindings/interrupt-controller/arm-gic.h>
131
132    fimc@11800000 {
133        compatible = "samsung,exynos4212-fimc";
134        reg = <0x11800000 0x1000>;
135        clocks = <&clock CLK_FIMC0>,
136                 <&clock CLK_SCLK_FIMC0>;
137        clock-names = "fimc", "sclk_fimc";
138        interrupts = <GIC_SPI 84 IRQ_TYPE_LEVEL_HIGH>;
139        iommus = <&sysmmu_fimc0>;
140        power-domains = <&pd_cam>;
141        samsung,sysreg = <&sys_reg>;
142
143        samsung,pix-limits = <4224 8192 1920 4224>;
144        samsung,mainscaler-ext;
145        samsung,isp-wb;
146        samsung,cam-if;
147
148        assigned-clocks = <&clock CLK_MOUT_FIMC0>,
149                          <&clock CLK_SCLK_FIMC0>;
150        assigned-clock-parents = <&clock CLK_MOUT_MPLL_USER_T>;
151        assigned-clock-rates = <0>, <176000000>;
152    };