Chinese translated version of linux/Documentation/devicetree/bindings/media/samsung-fimc.txt
If you have any comment or update to the content, please contact the
original document maintainer directly. However, if you have a problem
communicating in English you can also ask the Chinese maintainer for
help. Contact the Chinese maintainer if this translation is outdated
or if there is a problem with the translation.
Chinese maintainer: 梁茜 <236507324@qq.com>
---------------------------------------------------------------------
linux/Documentation/devicetree/bindings/media/samsung-fimc.txt的中文翻译
如果想评论或更新本文的内容,请直接联系原文档的维护者。如果你使用英文
交流有困难的话,也可以向中文版维护者求助。如果本翻译更新不及时或者翻
译存在问题,请联系中文版维护者。
中文版维护者: 梁茜 <236507324@qq.com>
中文版翻译者: 梁茜< 236507324@qq.com>
中文版校译者: 梁茜 236507324@qq.com
以下为正文
___________________________________________________________________
1Samsung S5P/EXYNOS SoC Camera Subsystem (FIMC)
三星的S5P / Exynos SOC照相机子系统(FIMC)
2----------------------------------------------
3
4The S5P/Exynos SoC Camera subsystem comprises of multiple sub-devices
5represented by separate device tree nodes. Currently this includes: FIMC (in
6the S5P SoCs series known as CAMIF), MIPI CSIS, FIMC-LITE and FIMC-IS (ISP).
S5P / Exynos SOC照相机子系统包括由单独的设备树节点代表的子设备。目前,这包括:FIMC(在S5P SOCS系列被称为camif),MIPI CSIS,fimc-lite和fimc-is(ISP)。
7
8The sub-subdevices are defined as child nodes of the common 'camera' node which
9also includes common properties of the whole subsystem not really specific to
10any single sub-device, like common camera port pins or the CAMCLK clock outputs
11for external image sensors attached to an SoC.
子子设备定义为普通的相机节点还包括整个系统不特定于任何单一的子设备的共同属性的子节点,像普通的相机端口引脚或外部图像传感器连接到一个SoC camclk时钟输出。
12
13Common 'camera' node
普通的相机节点
14--------------------
15
16Required properties:
性能要求:
17
18- compatible : must be "samsung,fimc", "simple-bus"
兼容:必须是“三星,fimC”,“简单的总线”
19- clocks : list of clock specifiers, corresponding to entries in
20 the clock-names property;
时钟:时钟说明符的列表,在时钟的名称属性对应的条目;
21- clock-names : must contain "sclk_cam0", "sclk_cam1", "pxl_async0",
22 "pxl_async1" entries, matching entries in the clocks property.
时钟名称:必须包含“点- sclk_cam0”、“sclk_cam1”、“pxl_async0”、“pxl_async1”条目,以匹配时钟特性中的条目。
23
24The pinctrl bindings defined in ../pinctrl/pinctrl-bindings.txt must be used
25to define a required pinctrl state named "default" and optional pinctrl states:
26"idle", "active-a", active-b".
该pinctrl绑定定义/ pinctrl / pinctrl-bindings.txt必须被用来定义所需的pinctrl国家命名的“默认”和可选的pinctrl状态:"idle", "active-a", active-b"。
These optional states can be used to switch the
27camera port pinmux at runtime.
这些可选的状态可以用于在运行时切换相机端口pinmux。
The "idle" state should configure both the camera
28ports A and B into high impedance state, especially the CAMCLK clock output
29should be inactive.
“空闲”状态应配置两相机端口A和B到高阻抗状态,尤其是camclk时钟输出应该是无效的。
For the "active-a" state the camera port A must be activated
30and the port B deactivated and for the state "active-b" it should be the other
31way around.
对于“ACTIVE-A”状态的相机端口必须被激活,B端口必须被失活,对于状态”active-b”是不同的。
32
33The 'camera' node must include at least one 'fimc' child node.
“照相机”节点必须包含至少一个“fimc”的子节点。
34
35'fimc' device nodes
“fimc”的设备节点
36-------------------
37
38Required properties:
性能要求:
39
40- compatible: "samsung,s5pv210-fimc" for S5PV210, "samsung,exynos4210-fimc"
41 for Exynos4210 and "samsung,exynos4212-fimc" for Exynos4x12 SoCs;
兼容:“三星,S5PV210 S5PV210 fimC”,“三星,Exynos4210 fimC”和“三星Exynos4210,exynos4212 fimC”exynos4x12 SOCS;
42- reg: physical base address and length of the registers set for the device;
注册:机组设备的寄存器地址和长度的物理基础;
43- interrupts: should contain FIMC interrupt;
中断:应包含fimC中断;
44- clocks: list of clock specifiers, must contain an entry for each required
45 entry in clock-names;
时钟:时钟说明符的列表,必须为每个所需的输入时钟的名字一个条目;
46- clock-names: must contain "fimc", "sclk_fimc" entries.
时钟的名字:必须包含“fimc”,“sclk_fimc”条目。
47- samsung,pix-limits: an array of maximum supported image sizes in pixels, for
48 details refer to Table 2-1 in the S5PV210 SoC User Manual; The meaning of
49 each cell is as follows:
三星,PIX限制:最大支持像素的图像大小的数组,详见表2-1 S5PV210 SOC用户手册;每个细胞的含义如下:
50 0 - scaler input horizontal size,
0-分频器输入的水平尺寸,
51 1 - input horizontal size for the scaler bypassed,
1-对于计数器输入的水平尺寸,
52 2 - REAL_WIDTH without input rotation,
2-没有输入旋转实现real_width,
53 3 - REAL_HEIGHT with input rotation,
3-没有输入旋转实现REAL_HEIGHT,
54- samsung,sysreg: a phandle to the SYSREG node.
三星,sysreg:一phandle到sysreg节点。
55
56Each FIMC device should have an alias in the aliases node, in the form of
57fimc<n>, where <n> is an integer specifying the IP block instance.
58
每个fimC装置应具备的别名,别名节点,在fimC <n>的形式,其中<n>是指定的IP块实例一个整数。
59Optional properties:
可选的属性:
60
61- clock-frequency: maximum FIMC local clock (LCLK) frequency;
62- samsung,min-pix-sizes: an array specyfing minimum image size in pixels at
63 the FIMC input and output DMA, in the first and second cell respectively.
时钟频率:最大fimC本地时钟频率(LCLK);
-三星,最小像素大小:数组specyfing最小图像像素大小在性的输入和输出的DMA,在第一和第二单元分别。
64 Default value when this property is not present is <16 16>;
65- samsung,min-pix-alignment: minimum supported image height alignment (first
66 cell) and the horizontal image offset (second cell).
默认值时,此属性不存在是< 16 > 16;
-三星,最小像素对齐:最小支持图像高度对齐(第一个细胞)和水平的图像偏移(第二单元)。
The values are in pixels
67 and default to <2 1> when this property is not present;
68- samsung,mainscaler-ext: a boolean property indicating whether the FIMC IP
69 supports extended image size and has CIEXTEN register;
70- samsung,rotators: a bitmask specifying whether this IP has the input and
71 the output rotator.
该值的像素,默认为<2 1 >时,此属性是不存在的;-三星,mainscaler分机:布尔属性指示是否fimC IP支持扩展的图像的大小和有ciexten寄存器;-:三星,转子的位掩码指定是否该IP具有输入和输出的旋转器。
Bits 4 and 0 correspond to input and output rotator
72 respectively.
位4和0对应的输入和输出的旋转分别。
If a rotator is present its corresponding bit should be set.
如果转子存在相应的比特应设置。
73 Default value when this property is not specified is 0x11.
默认值时,不指定此属性是0x11。
74- samsung,cam-if: a bolean property indicating whether the IP block includes
75 the camera input interface.
-三星,如:一个bolean凸轮属性表示是否IP块包括摄像机输入接口。
76- samsung,isp-wb: this property must be present if the IP block has the ISP
77 writeback input.
三星,ISP WB:这个属性必须存在,如果IP块写回输入ISP。
78- samsung,lcd-wb: this property must be present if the IP block has the LCD
79 writeback input.
-三星,LCD WB:这个属性必须存在如果IP块LCD写回输入。
80
81
82'parallel-ports' node
并行端口的节点
83---------------------
84
85This node should contain child 'port' nodes specifying active parallel video
86input ports. It includes camera A and camera B inputs. 'reg' property in the
87port nodes specifies data input - 0, 1 indicates input A, B respectively.
这个节点应该包含子端口节点指定活动并行视频输入端口。它包括摄像机和照相机B的投入。”注册的财产在港口节点指定数据输入0,1表示分别输入A,B。
88
89Optional properties
可选的属性
90
91- samsung,camclk-out : specifies clock output for remote sensor,
92 0 - CAM_A_CLKOUT, 1 - CAM_B_CLKOUT;
-三星,camclk时钟输出:指定的远程传感器,0 - 1 - cam_b_clkout cam_a_clkout;
93
94Image sensor nodes
图像传感器节点
95------------------
96
97The sensor device nodes should be added to their control bus controller (e.g.
98I2C0) nodes and linked to a port node in the csis or the parallel-ports node,
99using the common video interfaces bindings, defined in video-interfaces.txt.
100The implementation of this bindings requires clock-frequency property to be
101present in the sensor device nodes.
传感器节点应该被加入到他们的控制总线控制器(e.g.i2c0)的节点和链接到该中心或并行端口的端口节点的节点,使用常见的视频接口绑定,绑定在这video-interfaces.txt.此绑定的实现要求时钟频率特性传感器节点是存在的。
102
103Example:
104
105 aliases {
106 fimc0 = &fimc_0;
107 };
108
109 /* Parallel bus IF sensor */
110 i2c_0: i2c@13860000 {
111 s5k6aa: sensor@3c {
112 compatible = "samsung,s5k6aafx";
113 reg = <0x3c>;
114 vddio-supply = <...>;
115
116 clock-frequency = <24000000>;
117 clocks = <...>;
118 clock-names = "mclk";
119
120 port {
121 s5k6aa_ep: endpoint {
122 remote-endpoint = <&fimc0_ep>;
123 bus-width = <8>;
124 hsync-active = <0>;
125 vsync-active = <1>;
126 pclk-sample = <1>;
127 };
128 };
129 };
130
131 /* MIPI CSI-2 bus IF sensor */
132 s5c73m3: sensor@0x1a {
133 compatible = "samsung,s5c73m3";
134 reg = <0x1a>;
135 vddio-supply = <...>;
136
137 clock-frequency = <24000000>;
138 clocks = <...>;
139 clock-names = "mclk";
140
141 port {
142 s5c73m3_1: endpoint {
143 data-lanes = <1 2 3 4>;
144 remote-endpoint = <&csis0_ep>;
145 };
146 };
147 };
148 };
149
150 camera {
151 compatible = "samsung,fimc", "simple-bus";
152 #address-cells = <1>;
153 #size-cells = <1>;
154 status = "okay";
155
156 pinctrl-names = "default";
157 pinctrl-0 = <&cam_port_a_clk_active>;
158
159 /* parallel camera ports */
160 parallel-ports {
161 /* camera A input */
162 port@0 {
163 reg = <0>;
164 fimc0_ep: endpoint {
165 remote-endpoint = <&s5k6aa_ep>;
166 bus-width = <8>;
167 hsync-active = <0>;
168 vsync-active = <1>;
169 pclk-sample = <1>;
170 };
171 };
172 };
173
174 fimc_0: fimc@11800000 {
175 compatible = "samsung,exynos4210-fimc";
176 reg = <0x11800000 0x1000>;
177 interrupts = <0 85 0>;
178 status = "okay";
179 };
180
181 csis_0: csis@11880000 {
182 compatible = "samsung,exynos4210-csis";
183 reg = <0x11880000 0x1000>;
184 interrupts = <0 78 0>;
185 /* camera C input */
186 port@3 {
187 reg = <3>;
188 csis0_ep: endpoint {
189 remote-endpoint = <&s5c73m3_ep>;
190 data-lanes = <1 2 3 4>;
191 samsung,csis-hs-settle = <12>;
192 };
193 };
194 };
195 };
196
197The MIPI-CSIS device binding is defined in samsung-mipi-csis.txt.
该mipi-csis设备绑定定义在samsung-mipi-csis.txt上。
链接:linux/Documentation/devicetree/bindings/media/samsung-fimc.txt
198