xref: /OK3568_Linux_fs/kernel/Documentation/devicetree/bindings/media/i2c/cn3927v.txt (revision 4882a59341e53eb6f0b4789bf948001014eff981)
1*4882a593Smuzhiyun* CN3927V vcm driver support
2*4882a593Smuzhiyun
3*4882a593SmuzhiyunRequired Properties:
4*4882a593Smuzhiyun- compatible: Must contain "chipnext,cn3927v"
5*4882a593Smuzhiyun- reg: I2C slave address
6*4882a593Smuzhiyun
7*4882a593SmuzhiyunCommon Optional Properties:
8*4882a593Smuzhiyun- rockchip,vcm-max-current: max output current, default 120, unit: mA.
9*4882a593Smuzhiyun- rockchip,vcm-start-current: starting current.
10*4882a593Smuzhiyun- rockchip,vcm-rated-current: rate current.
11*4882a593Smuzhiyun
12*4882a593SmuzhiyunNormal Mode Optional Properties:
13*4882a593Smuzhiyun- rockchip,vcm-step-mode: S[3:2]: Codes per step, S[1:0]: Step period, default 0xd.
14*4882a593Smuzhiyun- rockchip,vcm-edlc-enable: Enhanced Dual Level Control Mode enable, default 0.
15*4882a593Smuzhiyun- rockchip,vcm-dlc-enable: Dual level control enable, default 0.
16*4882a593Smuzhiyun- rockchip,vcm-mclk: MCLK[1:0], default 0.
17*4882a593Smuzhiyun- rockchip,vcm-t-src: T_SRC[4:0], default 0.
18*4882a593Smuzhiyun
19*4882a593SmuzhiyunAdvanced Mode Optional Properties:
20*4882a593Smuzhiyun- rockchip,vcm-adcanced-mode: Enable Advanced mode, 0: Normal mode; 1: Advanced mode.
21*4882a593Smuzhiyun- rockchip,vcm-sac-mode: SAC_MODE[3:0]: 0x0~0xe, other reserved.
22*4882a593Smuzhiyun- rockchip,vcm-sac-time: SACT[6:0]: SAC time selection.
23*4882a593Smuzhiyun- rockchip,vcm-prescl: PRESC[1:0]: Prescaler (SAC Period Divider).
24*4882a593Smuzhiyun  : SAC setting time = tVIB = (3.81ms+(SACT [6:0]) x 0.03ms)) x (PRESC[1:0]).
25*4882a593Smuzhiyun
26*4882a593SmuzhiyunNRC(Noise Reduction Control) mode Properties:
27*4882a593SmuzhiyunCurrent not used, for future use
28*4882a593Smuzhiyun- rockchip,vcm-nrc-en: NRC EN: 0:Direct mode, 1:NRC mode.
29*4882a593Smuzhiyun- rockchip,vcm-nrc-mode: NRC_MODE: 0: NRC start, 1: NRC landing.
30*4882a593Smuzhiyun- rockchip,vcm-nrc-preset: PRESET[7:0]: NRC Current Setting.
31*4882a593Smuzhiyun- rockchip,vcm-nrc-infl: NRC_INF[1:0]: NRC inflection point.
32*4882a593Smuzhiyun- rockchip,vcm-nrc-time: NRC Operation Time: 0: 32ms, 1: 64ms.
33*4882a593Smuzhiyun
34*4882a593SmuzhiyunRequired Special properties:
35*4882a593Smuzhiyun- rockchip,camera-module-index : indicate which camera the vcm belongs to.
36*4882a593Smuzhiyun- rockchip,camera-module-facing : indicate the camera facing.
37*4882a593Smuzhiyun
38*4882a593SmuzhiyunExample:
39*4882a593Smuzhiyun
40*4882a593Smuzhiyun&i2c1 {
41*4882a593Smuzhiyun	...
42*4882a593Smuzhiyun	cn3927v: cn3927v@c {
43*4882a593Smuzhiyun		compatible = "chipnext,cn3927v";
44*4882a593Smuzhiyun		status = "okay";
45*4882a593Smuzhiyun		reg = <0x0c>;
46*4882a593Smuzhiyun		rockchip,vcm-max-current = <120>;
47*4882a593Smuzhiyun		rockchip,vcm-start-current = <30>;
48*4882a593Smuzhiyun		rockchip,vcm-rated-current = <80>;
49*4882a593Smuzhiyun		rockchip,vcm-step-mode = <0x8>;
50*4882a593Smuzhiyun		rockchip,vcm-edlc-enable = <0>;
51*4882a593Smuzhiyun		rockchip,vcm-dlc-enable = <0>;
52*4882a593Smuzhiyun		rockchip,vcm-mclk = <1>;
53*4882a593Smuzhiyun		rockchip,vcm-t-src = <0>;
54*4882a593Smuzhiyun		rockchip,vcm-adcanced-mode = <1>;
55*4882a593Smuzhiyun		rockchip,vcm-sac-mode = <0x03>;
56*4882a593Smuzhiyun		rockchip,vcm-sac-time = <0x28>;
57*4882a593Smuzhiyun		rockchip,vcm-prescl = <0x02>;
58*4882a593Smuzhiyun		rockchip,vcm-nrc-en = <0>;
59*4882a593Smuzhiyun		rockchip,vcm-nrc-mode = <1>;
60*4882a593Smuzhiyun		rockchip,vcm-nrc-preset = <0x11110000>;
61*4882a593Smuzhiyun		rockchip,vcm-nrc-infl = <0x01>;
62*4882a593Smuzhiyun		rockchip,vcm-nrc-time = <0>;
63*4882a593Smuzhiyun		rockchip,camera-module-index = <0>;
64*4882a593Smuzhiyun		rockchip,camera-module-facing = "back";
65*4882a593Smuzhiyun	};
66*4882a593Smuzhiyun
67*4882a593Smuzhiyun	...
68*4882a593Smuzhiyun	s5kjn1: s5kjn1@10 {
69*4882a593Smuzhiyun		...
70*4882a593Smuzhiyun		lens-focus = <&cn3927v>;
71*4882a593Smuzhiyun		...
72*4882a593Smuzhiyun	};
73*4882a593Smuzhiyun	...
74*4882a593Smuzhiyun}
75