From mboxrd@z Thu Jan 1 00:00:00 1970 From: make at marvell.com Date: Thu, 23 Mar 2017 17:29:04 +0800 Subject: [U-Boot] [PATCH 4/7] scsi: dt-bindings: add scsi device tree bindings In-Reply-To: <1490261347-11896-1-git-send-email-make@marvell.com> References: <1490261347-11896-1-git-send-email-make@marvell.com> Message-ID: <1490261347-11896-5-git-send-email-make@marvell.com> List-Id: MIME-Version: 1.0 Content-Type: text/plain; charset="us-ascii" Content-Transfer-Encoding: 7bit To: u-boot@lists.denx.de From: Ken Ma - 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 Cc: Simon Glass Cc: Stefan Roese Cc: Michal Simek Reviewed-on: http://vgitil04.il.marvell.com:8080/35427 Tested-by: iSoC Platform CI Reviewed-by: Omri Itach Reviewed-by: Kostya Porotchkin --- .../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 = ; + }; + }; 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