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