163-dt-bindings-qcom_nandc-Add-DT-bindings.patch 2.7 KB

12345678910111213141516171819202122232425262728293031323334353637383940414243444546474849505152535455565758596061626364656667686970717273747576777879808182
  1. Content-Type: text/plain; charset="utf-8"
  2. MIME-Version: 1.0
  3. Content-Transfer-Encoding: 7bit
  4. Subject: [v3,3/5] dt/bindings: qcom_nandc: Add DT bindings
  5. From: Archit Taneja <architt@codeaurora.org>
  6. X-Patchwork-Id: 6927141
  7. Message-Id: <1438578498-32254-4-git-send-email-architt@codeaurora.org>
  8. To: linux-mtd@lists.infradead.org, dehrenberg@google.com,
  9. cernekee@gmail.com, computersforpeace@gmail.com
  10. Cc: linux-arm-msm@vger.kernel.org, agross@codeaurora.org,
  11. sboyd@codeaurora.org, linux-kernel@vger.kernel.org,
  12. Archit Taneja <architt@codeaurora.org>, devicetree@vger.kernel.org
  13. Date: Mon, 3 Aug 2015 10:38:16 +0530
  14. Add DT bindings document for the Qualcomm NAND controller driver.
  15. Cc: devicetree@vger.kernel.org
  16. v3:
  17. - Don't use '0x' when specifying nand controller address space
  18. - Add optional property for on-flash bbt usage
  19. Acked-by: Andy Gross <agross@codeaurora.org>
  20. Signed-off-by: Archit Taneja <architt@codeaurora.org>
  21. ---
  22. .../devicetree/bindings/mtd/qcom_nandc.txt | 49 ++++++++++++++++++++++
  23. 1 file changed, 49 insertions(+)
  24. create mode 100644 Documentation/devicetree/bindings/mtd/qcom_nandc.txt
  25. --- /dev/null
  26. +++ b/Documentation/devicetree/bindings/mtd/qcom_nandc.txt
  27. @@ -0,0 +1,49 @@
  28. +* Qualcomm NAND controller
  29. +
  30. +Required properties:
  31. +- compatible: should be "qcom,ebi2-nand" for IPQ806x
  32. +- reg: MMIO address range
  33. +- clocks: must contain core clock and always on clock
  34. +- clock-names: must contain "core" for the core clock and "aon" for the
  35. + always on clock
  36. +- dmas: DMA specifier, consisting of a phandle to the ADM DMA
  37. + controller node and the channel number to be used for
  38. + NAND. Refer to dma.txt and qcom_adm.txt for more details
  39. +- dma-names: must be "rxtx"
  40. +- qcom,cmd-crci: must contain the ADM command type CRCI block instance
  41. + number specified for the NAND controller on the given
  42. + platform
  43. +- qcom,data-crci: must contain the ADM data type CRCI block instance
  44. + number specified for the NAND controller on the given
  45. + platform
  46. +
  47. +Optional properties:
  48. +- nand-bus-width: bus width. Must be 8 or 16. If not present, 8 is chosen
  49. + as default
  50. +
  51. +- nand-ecc-strength: number of bits to correct per ECC step. Must be 4 or 8
  52. + bits. If not present, 4 is chosen as default
  53. +- nand-on-flash-bbt: Create/use on-flash bad block table
  54. +
  55. +The device tree may optionally contain sub-nodes describing partitions of the
  56. +address space. See partition.txt for more detail.
  57. +
  58. +Example:
  59. +
  60. +nand@1ac00000 {
  61. + compatible = "qcom,ebi2-nandc";
  62. + reg = <0x1ac00000 0x800>;
  63. +
  64. + clocks = <&gcc EBI2_CLK>,
  65. + <&gcc EBI2_AON_CLK>;
  66. + clock-names = "core", "aon";
  67. +
  68. + dmas = <&adm_dma 3>;
  69. + dma-names = "rxtx";
  70. + qcom,cmd-crci = <15>;
  71. + qcom,data-crci = <3>;
  72. +
  73. + partition@0 {
  74. + ...
  75. + };
  76. +};