18c2ecf20Sopenharmony_ciBinding for CEVA AHCI SATA Controller
28c2ecf20Sopenharmony_ci
38c2ecf20Sopenharmony_ciRequired properties:
48c2ecf20Sopenharmony_ci  - reg: Physical base address and size of the controller's register area.
58c2ecf20Sopenharmony_ci  - compatible: Compatibility string. Must be 'ceva,ahci-1v84'.
68c2ecf20Sopenharmony_ci  - clocks: Input clock specifier. Refer to common clock bindings.
78c2ecf20Sopenharmony_ci  - interrupts: Interrupt specifier. Refer to interrupt binding.
88c2ecf20Sopenharmony_ci  - ceva,p0-cominit-params: OOB timing value for COMINIT parameter for port 0.
98c2ecf20Sopenharmony_ci  - ceva,p1-cominit-params: OOB timing value for COMINIT parameter for port 1.
108c2ecf20Sopenharmony_ci			The fields for the above parameter must be as shown below:
118c2ecf20Sopenharmony_ci			ceva,pN-cominit-params = /bits/ 8 <CIBGMN CIBGMX CIBGN CINMP>;
128c2ecf20Sopenharmony_ci			CINMP : COMINIT Negate Minimum Period.
138c2ecf20Sopenharmony_ci			CIBGN : COMINIT Burst Gap Nominal.
148c2ecf20Sopenharmony_ci			CIBGMX: COMINIT Burst Gap Maximum.
158c2ecf20Sopenharmony_ci			CIBGMN: COMINIT Burst Gap Minimum.
168c2ecf20Sopenharmony_ci  - ceva,p0-comwake-params: OOB timing value for COMWAKE parameter for port 0.
178c2ecf20Sopenharmony_ci  - ceva,p1-comwake-params: OOB timing value for COMWAKE parameter for port 1.
188c2ecf20Sopenharmony_ci			The fields for the above parameter must be as shown below:
198c2ecf20Sopenharmony_ci			ceva,pN-comwake-params = /bits/ 8 <CWBGMN CWBGMX CWBGN CWNMP>;
208c2ecf20Sopenharmony_ci			CWBGMN: COMWAKE Burst Gap Minimum.
218c2ecf20Sopenharmony_ci			CWBGMX: COMWAKE Burst Gap Maximum.
228c2ecf20Sopenharmony_ci			CWBGN: COMWAKE Burst Gap Nominal.
238c2ecf20Sopenharmony_ci			CWNMP: COMWAKE Negate Minimum Period.
248c2ecf20Sopenharmony_ci  - ceva,p0-burst-params: Burst timing value for COM parameter for port 0.
258c2ecf20Sopenharmony_ci  - ceva,p1-burst-params: Burst timing value for COM parameter for port 1.
268c2ecf20Sopenharmony_ci			The fields for the above parameter must be as shown below:
278c2ecf20Sopenharmony_ci			ceva,pN-burst-params = /bits/ 8 <BMX BNM SFD PTST>;
288c2ecf20Sopenharmony_ci			BMX: COM Burst Maximum.
298c2ecf20Sopenharmony_ci			BNM: COM Burst Nominal.
308c2ecf20Sopenharmony_ci			SFD: Signal Failure Detection value.
318c2ecf20Sopenharmony_ci			PTST: Partial to Slumber timer value.
328c2ecf20Sopenharmony_ci  - ceva,p0-retry-params: Retry interval timing value for port 0.
338c2ecf20Sopenharmony_ci  - ceva,p1-retry-params: Retry interval timing value for port 1.
348c2ecf20Sopenharmony_ci			The fields for the above parameter must be as shown below:
358c2ecf20Sopenharmony_ci			ceva,pN-retry-params = /bits/ 16 <RIT RCT>;
368c2ecf20Sopenharmony_ci			RIT:  Retry Interval Timer.
378c2ecf20Sopenharmony_ci			RCT:  Rate Change Timer.
388c2ecf20Sopenharmony_ci
398c2ecf20Sopenharmony_ciOptional properties:
408c2ecf20Sopenharmony_ci  - ceva,broken-gen2: limit to gen1 speed instead of gen2.
418c2ecf20Sopenharmony_ci
428c2ecf20Sopenharmony_ciExamples:
438c2ecf20Sopenharmony_ci	ahci@fd0c0000 {
448c2ecf20Sopenharmony_ci		compatible = "ceva,ahci-1v84";
458c2ecf20Sopenharmony_ci		reg = <0xfd0c0000 0x200>;
468c2ecf20Sopenharmony_ci		interrupt-parent = <&gic>;
478c2ecf20Sopenharmony_ci		interrupts = <0 133 4>;
488c2ecf20Sopenharmony_ci		clocks = <&clkc SATA_CLK_ID>;
498c2ecf20Sopenharmony_ci		ceva,p0-cominit-params = /bits/ 8 <0x0F 0x25 0x18 0x29>;
508c2ecf20Sopenharmony_ci		ceva,p0-comwake-params = /bits/ 8 <0x04 0x0B 0x08 0x0F>;
518c2ecf20Sopenharmony_ci		ceva,p0-burst-params = /bits/ 8 <0x0A 0x08 0x4A 0x06>;
528c2ecf20Sopenharmony_ci		ceva,p0-retry-params = /bits/ 16 <0x0216 0x7F06>;
538c2ecf20Sopenharmony_ci
548c2ecf20Sopenharmony_ci		ceva,p1-cominit-params = /bits/ 8 <0x0F 0x25 0x18 0x29>;
558c2ecf20Sopenharmony_ci		ceva,p1-comwake-params = /bits/ 8 <0x04 0x0B 0x08 0x0F>;
568c2ecf20Sopenharmony_ci		ceva,p1-burst-params = /bits/ 8 <0x0A 0x08 0x4A 0x06>;
578c2ecf20Sopenharmony_ci		ceva,p1-retry-params = /bits/ 16 <0x0216 0x7F06>;
588c2ecf20Sopenharmony_ci		ceva,broken-gen2;
598c2ecf20Sopenharmony_ci	};
60