[U-Boot] [PATCH 4/7] scsi: dt-bindings: add scsi device tree bindings

[make at marvell.com <make@marvell.com>]

From: Ken Ma <make@marvell.com>

- Add generic scsi device tree bindings doc, the doc includes:
  - Brief introduction for scsi;
  - Scsi's properties' introduction;
- Add marvell mvebu scsi binding doc with the example of armada3700
  SCSI controller.

Signed-off-by: Ken Ma <make@marvell.com>
Cc: Simon Glass <sjg@chromium.org>
Cc: Stefan Roese <sr@denx.de>
Cc: Michal Simek <michal.simek@xilinx.com>
Reviewed-on: http://vgitil04.il.marvell.com:8080/35427
Tested-by: iSoC Platform CI <ykjenk@marvell.com>
Reviewed-by: Omri Itach <omrii@marvell.com>
Reviewed-by: Kostya Porotchkin <kostap@marvell.com>
---
 .../scsi/marvell,mvebu-scsi.txt                    | 29 ++++++++++++++++++++++
 doc/device-tree-bindings/scsi/scsi-bus.txt         | 22 ++++++++++++++++
 2 files changed, 51 insertions(+)
 create mode 100644 doc/device-tree-bindings/scsi/marvell,mvebu-scsi.txt
 create mode 100644 doc/device-tree-bindings/scsi/scsi-bus.txt

diff --git a/doc/device-tree-bindings/scsi/marvell,mvebu-scsi.txt b/doc/device-tree-bindings/scsi/marvell,mvebu-scsi.txt
new file mode 100644
index 0000000..b3d06af
--- /dev/null
+++ b/doc/device-tree-bindings/scsi/marvell,mvebu-scsi.txt
@@ -0,0 +1,29 @@
+Binding for marvell mvebu SCSI controller
+
+Required properties:
+- #address-cells  - the number of cells used to represent physical base addresses
+- #size-cells     - the number of cells used to represent the size of an address
+- compatible      - the name of mvebu SCSI bus controller, supported value "marvell,mvebu-scsi",
+                    covers the following Marvell SoC families: armada3700, armada70x0 and armada80x0
+
+Optional property:
+- max-id          - maximum number of scsi target ids, the default value is CONFIG_SYS_SCSI_MAX_SCSI_ID
+- max-lun         - maximum number of scsi logical units, the default value is CONFIG_SYS_SCSI_MAX_LUN
+
+Example for armada3700 SCSI controller which is SAS and acts as an add-on host bus adapter without the
+base register:
+- Armada3700 has only 1 SATA interface, so the property "max-id" is 1;
+- Armada3700 max logical units number is 1, so the property "max-lun" is 1.
+
+	scsi: scsi {
+		compatible = "marvell,mvebu-scsi";
+		#address-cells = <1>;
+		#size-cells = <1>;
+		max-id = <1>;
+		max-lun = <1>;
+		sata: sata at e0000 {
+			compatible = "marvell,armada-3700-ahci";
+			reg = <0xe0000 0x2000>;
+			interrupts = <GIC_SPI 27 IRQ_TYPE_LEVEL_HIGH>;
+		};
+	};
diff --git a/doc/device-tree-bindings/scsi/scsi-bus.txt b/doc/device-tree-bindings/scsi/scsi-bus.txt
new file mode 100644
index 0000000..01aee06
--- /dev/null
+++ b/doc/device-tree-bindings/scsi/scsi-bus.txt
@@ -0,0 +1,22 @@
+SCSI (Small Computer System Interface) busses
+
+SCSI busses can be described with a node for the SCSI controller device
+and a set of child nodes for each SCSI devices on the bus. An SCSI controller
+node can also be a Serial Attached SCSI (SAS) controller, which can act as an
+add-on host bus adapter or work as a pure controller as an on-board component
+on the motherboard, to offer compatibility with SATA devices.
+
+The SCSI controller node requires the following properties:
+- #address-cells  - the number of cells used to represent physical base addresses
+- #size-cells     - the number of cells used to represent the size of an address
+- compatible      - the name of SCSI bus controller following generic names recommended practice
+
+No other properties are required in the SCSI bus node.  It is assumed
+that a driver for an SCSI bus device will understand that it is an SCSI bus.
+
+Optional property:
+- base            - scsi register base address
+- max-id          - maximum number of scsi target ids, the default value is CONFIG_SYS_SCSI_MAX_SCSI_ID
+- max-lun         - maximum number of scsi logical units, the default value is CONFIG_SYS_SCSI_MAX_LUN
+
+SCSI device nodes must be children of the SCSI controller node.
\ No newline at end of file
-- 
1.9.1