xref: /OK3568_Linux_fs/kernel/Documentation/devicetree/bindings/ata/ahci-ceva.txt (revision 4882a59341e53eb6f0b4789bf948001014eff981)
1*4882a593SmuzhiyunBinding for CEVA AHCI SATA Controller
2*4882a593Smuzhiyun
3*4882a593SmuzhiyunRequired properties:
4*4882a593Smuzhiyun  - reg: Physical base address and size of the controller's register area.
5*4882a593Smuzhiyun  - compatible: Compatibility string. Must be 'ceva,ahci-1v84'.
6*4882a593Smuzhiyun  - clocks: Input clock specifier. Refer to common clock bindings.
7*4882a593Smuzhiyun  - interrupts: Interrupt specifier. Refer to interrupt binding.
8*4882a593Smuzhiyun  - ceva,p0-cominit-params: OOB timing value for COMINIT parameter for port 0.
9*4882a593Smuzhiyun  - ceva,p1-cominit-params: OOB timing value for COMINIT parameter for port 1.
10*4882a593Smuzhiyun			The fields for the above parameter must be as shown below:
11*4882a593Smuzhiyun			ceva,pN-cominit-params = /bits/ 8 <CIBGMN CIBGMX CIBGN CINMP>;
12*4882a593Smuzhiyun			CINMP : COMINIT Negate Minimum Period.
13*4882a593Smuzhiyun			CIBGN : COMINIT Burst Gap Nominal.
14*4882a593Smuzhiyun			CIBGMX: COMINIT Burst Gap Maximum.
15*4882a593Smuzhiyun			CIBGMN: COMINIT Burst Gap Minimum.
16*4882a593Smuzhiyun  - ceva,p0-comwake-params: OOB timing value for COMWAKE parameter for port 0.
17*4882a593Smuzhiyun  - ceva,p1-comwake-params: OOB timing value for COMWAKE parameter for port 1.
18*4882a593Smuzhiyun			The fields for the above parameter must be as shown below:
19*4882a593Smuzhiyun			ceva,pN-comwake-params = /bits/ 8 <CWBGMN CWBGMX CWBGN CWNMP>;
20*4882a593Smuzhiyun			CWBGMN: COMWAKE Burst Gap Minimum.
21*4882a593Smuzhiyun			CWBGMX: COMWAKE Burst Gap Maximum.
22*4882a593Smuzhiyun			CWBGN: COMWAKE Burst Gap Nominal.
23*4882a593Smuzhiyun			CWNMP: COMWAKE Negate Minimum Period.
24*4882a593Smuzhiyun  - ceva,p0-burst-params: Burst timing value for COM parameter for port 0.
25*4882a593Smuzhiyun  - ceva,p1-burst-params: Burst timing value for COM parameter for port 1.
26*4882a593Smuzhiyun			The fields for the above parameter must be as shown below:
27*4882a593Smuzhiyun			ceva,pN-burst-params = /bits/ 8 <BMX BNM SFD PTST>;
28*4882a593Smuzhiyun			BMX: COM Burst Maximum.
29*4882a593Smuzhiyun			BNM: COM Burst Nominal.
30*4882a593Smuzhiyun			SFD: Signal Failure Detection value.
31*4882a593Smuzhiyun			PTST: Partial to Slumber timer value.
32*4882a593Smuzhiyun  - ceva,p0-retry-params: Retry interval timing value for port 0.
33*4882a593Smuzhiyun  - ceva,p1-retry-params: Retry interval timing value for port 1.
34*4882a593Smuzhiyun			The fields for the above parameter must be as shown below:
35*4882a593Smuzhiyun			ceva,pN-retry-params = /bits/ 16 <RIT RCT>;
36*4882a593Smuzhiyun			RIT:  Retry Interval Timer.
37*4882a593Smuzhiyun			RCT:  Rate Change Timer.
38*4882a593Smuzhiyun
39*4882a593SmuzhiyunOptional properties:
40*4882a593Smuzhiyun  - ceva,broken-gen2: limit to gen1 speed instead of gen2.
41*4882a593Smuzhiyun
42*4882a593SmuzhiyunExamples:
43*4882a593Smuzhiyun	ahci@fd0c0000 {
44*4882a593Smuzhiyun		compatible = "ceva,ahci-1v84";
45*4882a593Smuzhiyun		reg = <0xfd0c0000 0x200>;
46*4882a593Smuzhiyun		interrupt-parent = <&gic>;
47*4882a593Smuzhiyun		interrupts = <0 133 4>;
48*4882a593Smuzhiyun		clocks = <&clkc SATA_CLK_ID>;
49*4882a593Smuzhiyun		ceva,p0-cominit-params = /bits/ 8 <0x0F 0x25 0x18 0x29>;
50*4882a593Smuzhiyun		ceva,p0-comwake-params = /bits/ 8 <0x04 0x0B 0x08 0x0F>;
51*4882a593Smuzhiyun		ceva,p0-burst-params = /bits/ 8 <0x0A 0x08 0x4A 0x06>;
52*4882a593Smuzhiyun		ceva,p0-retry-params = /bits/ 16 <0x0216 0x7F06>;
53*4882a593Smuzhiyun
54*4882a593Smuzhiyun		ceva,p1-cominit-params = /bits/ 8 <0x0F 0x25 0x18 0x29>;
55*4882a593Smuzhiyun		ceva,p1-comwake-params = /bits/ 8 <0x04 0x0B 0x08 0x0F>;
56*4882a593Smuzhiyun		ceva,p1-burst-params = /bits/ 8 <0x0A 0x08 0x4A 0x06>;
57*4882a593Smuzhiyun		ceva,p1-retry-params = /bits/ 16 <0x0216 0x7F06>;
58*4882a593Smuzhiyun		ceva,broken-gen2;
59*4882a593Smuzhiyun	};
60