Documentation/devicetree/bindings/ata/ahci-ceva.txt

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