Device Bus support for Marvell EBU SoC
Subsystems (3)
cover Device Bus support for Marvell EBU SoC
Now that the mbus driver has been introduced to allocate address decoding windows it's possible to introduce the Device Bus driver. This driver allows to access several memories and I/O devices such as NOR, NAND, SRAM and FPGAs.
Currently the SoCs that include this Device Bus controller are:
* Discovery: mv78100, mv78200 * Armada XP: mv78230, mv78260, mv78460 * Armada 370: 88f6710. 88f6707, 88f6w11 * Orion 5x: 88f5182, 88f5181, 88f5281
Please note that this patchset adds proper support for Discovery, Armada XP and Armada 370 SoC only.
Although these SoC allow to dynamically choose a base address for the child device within the entire address space (because of flexible and dynamic address decoding windows) this feature is still not implemented and it's required to specify such a base address in each child's device tree node.
This applies on top of Thomas Petazzoni series for Marvell EBU mbus driver. (see http://comments.gmane.org/gmane.linux.ports.arm.kernel/221198)
In fact this patchset is not entirely dependent on the mbus implementation, but only in the mbus public API:
int mvebu_mbus_add_window(const char *devname, phys_addr_t base, size_t size); int mvebu_mbus_del_window(phys_addr_t base, size_t size);
Given there has been some discussions regarding the mbus driver DT binding and the way to describe address windows, it's worth mentioning that this patchset proposes a way to easily handle address decoding windows for the devices controlled by the Device Bus (NOR, NAND, etc.).
The windows are created based in the 'ranges' property present in the device bus node:
device-bus at d0010400 {
ranges = <0 0 0xf0000000 0x8000000>;
/* ... */
}For instance, in the above example, when the device bus driver finds a child node for chip select '0', he will request the mbus driver to allocate a window as described by the 'ranges' property, starting at address 0xf0000000.
If we want to upgrade this behavior and support dynamically allocated windows, we can simply fix the device bus driver to find a suitable address when there is no 'ranges' property for that chip select.
Therefore we see that the current bindings (both mbus and device bus) are perfectly suitable to handle both static and dynamic windows for devices such as NOR, NAND, etc.
Tested on an Armada XP GP board and Plathome Openblocks AX3. Any further testing and feedback will be greatly appreciated!
Ezequiel Garcia (5):
drivers: memory: Introduce Marvell EBU Device Bus driver
ARM: mvebu: Add Device Bus support for Armada 370/XP SoC
ARM: mvebu: Add support for NOR flash device on Armada XP-GP board
ARM: mvebu: Add support for NOR flash device on Openblocks AX3 board
ARM: mvebu: Update defconfig to select Device Bus (memory-controller)
support
.../bindings/memory-controllers/orion-devbus.txt | 150 ++++++++++ arch/arm/boot/dts/armada-370.dtsi | 7 + arch/arm/boot/dts/armada-xp-gp.dts | 12 + arch/arm/boot/dts/armada-xp-openblocks-ax3-4.dts | 12 + arch/arm/boot/dts/armada-xp.dtsi | 7 + arch/arm/configs/mvebu_defconfig | 2 + drivers/memory/Kconfig | 11 + drivers/memory/Makefile | 1 + drivers/memory/mvebu-devbus.c | 296 ++++++++++++++++++++ 9 files changed, 498 insertions(+), 0 deletions(-) create mode 100644 Documentation/devicetree/bindings/memory-controllers/orion-devbus.txt create mode 100644 drivers/memory/mvebu-devbus.c
Signature · 1 line
1.7.8.6
PATCH 1/5 drivers: memory: Introduce Marvell EBU Device Bus driver
Marvell EBU SoCs such as Armada 370/XP, Orion5x (88f5xxx) and Discovery (mv78xx0) supports a Device Bus controller to access several kinds of memories and I/O devices (NOR, NAND, SRAM, FPGA).
This commit adds a driver to handle this controller. So far only Armada 370, Armada XP and Discovery SoCs are supported.
The driver must be registered through a device tree node; as explained in the binding document.
This driver is in charge of setting timing parameters for each device, create the address decoding window for it and register the child device.
--- .../bindings/memory-controllers/orion-devbus.txt | 150 ++++++++++ drivers/memory/Kconfig | 11 + drivers/memory/Makefile | 1 + drivers/memory/mvebu-devbus.c | 296 ++++++++++++++++++++ 4 files changed, 458 insertions(+), 0 deletions(-) create mode 100644 Documentation/devicetree/bindings/memory-controllers/orion-devbus.txt create mode 100644 drivers/memory/mvebu-devbus.c
Documentation/devicetree/bindings/memory-controllers/orion-devbus.txt new file +150 -0
@@ -0,0 +1,150 @@ +Device tree bindings for MVEBU Device Bus controllers + +The Device Bus controller available in some Marvell's SoC allows to control +different types of standard memory and I/O devices such as NOR, NAND, and FPGA. +The actual devices are instantiated from the child nodes of a Device Bus node. + +Required properties: + + - compatible: Should be set to one of the following: + + marvell,armada370-devbus + marvell,armadaxp-devbus + marvell,mv78xx0-devbus + + - reg: A resource specifier for the register space + (see the example below) + - #address-cells: Must be set to 2 to allow memory address translation + - #size-cells: Must be set to 1 to allow CS address passing + - ranges: Must be set up to reflect the memory layout with four + integer values for each chip-select line in use: + <cs-number> 0 <physical address of mapping> <size> + +Optional timing properties for child nodes: +(these are all optional and default to the SoC initial value) + +Read parameters: + + - devbus,turn-off: Defines the number of TCLK cycles that the SoC does not + drive the AD bus after the completion of a device read. + This prevents contentions on the Device Bus after a read + cycle from a slow device. + The minimum setting of this parameter is 0x2. + + - devbus,dev-width: 0x0 = 8-bit + 0x1 = 16-bit + 0x2 = 32-bit + 0x3 = Reserved + + - devbus,badr-skew: Defines the number of TCLK cycles from A[2:0] toggle, + to read data sample. This parameter is useful for + synchronous pipelined devices, where the address + precedes the read data by one or two cycles. + + - devbus,acc-first: Defines the number of TCLK cycles from the negation of + ALE[0] to the cycle that the first read data is sampled + by the SoC. The number of TCLK cycles is this + parameter's setting minus three (<acc-first> - 3). + The minimum setting of this parameter is 0x6. + + - devbus,acc-next: Defines the number of TCLK cycles between the cycle that + samples data N to the cycle that samples data N+1 + (in burst accesses). + The minimum setting for this parameter is 0x2. + + - devbus,rd-setup: Defines the number of TCLK cycles between DEV_CSn + assertion to DEV_OEn assertion. If set to 0 (default), + DEV_OEn and DEV_CSn are asserted at the same cycle. + This parameter has no affect on <acc-first> parameter + (no affect on first data sample). Set <rd-setup> + to a value smaller than <acc-first>. + + - devbus,rd-hold: Defines the number of TCLK cycles between the last data + sample to the de-assertion of DEV_CSn. + If set to 0 (default), DEV_OEn and DEV_CSn are + de-asserted at the same cycle (the cycle of the + last data sample). + This parameter has no affect on DEV_OEn de-assertion. + DEV_OEn is always de-asserted the next cycle after + last data sampled. Also this parameter has no + affect on <turn-off> parameter. + Set <rd-hold> to a value smaller than <turn-off>. + +Write parameters: + + - devbus,ale-wr: Defines the number of TCLK cycles from the ALE[0] + negation cycle to the DEV_WEn assertion. The number of + cycles is <ale-wr> - 3. + The minimum setting of this parameter is 0x4. + + - devbus,wr-low: Defines the number of TCLKs that DEV_WEn is active. + A[2:0] and Data are kept valid as long as DEV_WEn + is active. This parameter defines the setup time of + address and data to DEV_WEn rise. + The minimum setting of this parameter is 0x1. + + - devbus,wr-high: Defines the number of TCLK cycles that DEV_WEn is kept + inactive (high) between data beats of a burst write. + DEV_A[2:0] and Data are kept valid (do not toggle) for + <wr-high> - 1 periods. This parameter defines the hold + time of address and data after DEV_WEn rise. + The minimum setting of this parameter is 0x1. + + - devbus,sync-enable: Synchronous device enable. + 1: True + 0: False + +An example for an Armada XP GP board, with a 16 MiB NOR device as child +is showed below. Note that the Device Bus driver is in charge of allocating +the mbus address decoding window for each of its child devices. +The window is created using the chip select specified in the child +device node together with the base address and size specified in the ranges +property. For instance, in the example below the allocated decoding window +will start at base address 0xf0000000, with a size 0x1000000 (16 MiB) +for chip select 0 (a.k.a DEV_BOOTCS). + +The reg property must specify the chip select as: + + 0: DEV_BOOTCS + 1: DEV_CS0 + 2: DEV_CS1 + 3: DEV_CS2 + 4: DEV_CS3 + +Example: + + device-bus at d0010400 { + status = "okay"; + ranges = <0 0 0xf0000000 0x1000000>; /* CS0 @addr 0xf0000000, size 0x1000000 */ + + nor at 0 { + compatible = "cfi-flash"; + + /* CS0, 16 MiB */ + reg = <0 0 0x1000000>; + bank-width = <2>; + #address-cells = <1>; + #size-cells = <1>; + + /* Read parameters */ + devbus,turn-off = <0x3f>; + devbus,acc-first = <0x1f>; + devbus,acc-next = <0x1f>; + devbus,rd-setup = <0x1f>; + devbus,rd-hold = <0x3e>; + + /* + * We split the 16 MiB in two partitions, + * just as an example. + */ + partition at 0 { + label = "First"; + reg = <0 0x800000>; + }; + + partition at 800000 { + label = "Second"; + reg = <0x800000 0x800000>; + }; + }; + };
drivers/memory/Kconfig +11 -0
@@ -40,4 +40,15 @@ config TEGRA30_MC analysis, especially for IOMMU/SMMU(System Memory Management Unit) module. +config MVEBU_DEVBUS + tristate "Marvell EBU Device Bus Controller" + default y + depends on PLAT_ORION && OF + help + This driver is for the Device Bus controller available in some + Marvell EBU SoCs such as Discovery (mv78xx0), Orion (88f5xxx) and + Armada 370 and Armada XP. This controller allows to handle flash + devices such as NOR, NAND, SRAM, and FPGA. + + endif
drivers/memory/Makefile +1 -0
@@ -8,3 +8,4 @@ endif obj-$(CONFIG_TI_EMIF) += emif.o obj-$(CONFIG_TEGRA20_MC) += tegra20-mc.o obj-$(CONFIG_TEGRA30_MC) += tegra30-mc.o +obj-$(CONFIG_MVEBU_DEVBUS) += mvebu-devbus.o
drivers/memory/mvebu-devbus.c new file +296 -0
296 lines not on this page · raw message
Signature · 1 line
1.7.8.6
PATCH 1/5 drivers: memory: Introduce Marvell EBU Device Bus driver
Dear Ezequiel Garcia,
Quoted 9 lines · Ezequiel Garcia
drivers/memory/Kconfig +1
-0@@ -40,4 +40,15 @@ config TEGRA30_MC analysis, especially for IOMMU/SMMU(System Memory Management Unit) module. +config MVEBU_DEVBUS
drivers/memory/Kconfig config TEGRA30_MC · line 53
Quoted 10 lines
drivers/memory/Kconfig +10
-0+ tristate "Marvell EBU Device Bus Controller" + default y + depends on PLAT_ORION && OF + help + This driver is for the Device Bus controller available in some + Marvell EBU SoCs such as Discovery (mv78xx0), Orion (88f5xxx) and + Armada 370 and Armada XP. This controller allows to handle flash + devices such as NOR, NAND, SRAM, and FPGA. + +
Entries should be sorted alphabetically (MVEBU_DEVBUS is before TEGRA30_MC).
drivers/memory/Makefile endif · line 11
Quoted 10 lines
drivers/memory/Kconfig +0
-0endifdrivers/memory/Makefile +1
-0@@ -8,3 +8,4 @@ endif obj-$(CONFIG_TI_EMIF) += emif.o obj-$(CONFIG_TEGRA20_MC) += tegra20-mc.o obj-$(CONFIG_TEGRA30_MC) += tegra30-mc.o +obj-$(CONFIG_MVEBU_DEVBUS) += mvebu-devbus.o
Same comment.
drivers/memory/Makefile
Quoted 2 lines
drivers/memory/Makefile +2
-0+static inline void +devbus_get_read_params(int cs, struct devbus_read_params *r)
I don't think it's necessary to mark such functions as "inline". Just let gcc do whatever it thinks is necessary in terms of inlining.
Quoted 29 lines
drivers/memory/Makefile +29
-0+static int devbus_probe_nor_child(struct platform_device *pdev, + struct device_node *node) +{ + struct platform_device *child; + struct device *dev = &pdev->dev; + struct resource mem_res; + struct devbus_read_params read_params; + struct devbus_write_params write_params; + int err; + int bank_width; + u32 cs; + + /* Read chip select and size */ + if (of_property_read_u32(node, "reg", &cs) < 0) { + dev_err(dev, "%s has no 'reg' property\n", node->full_name); + return -ENODEV; + } + + if (of_address_to_resource(node, 0, &mem_res)) { + dev_err(dev, "%s has malformed 'reg' property\n", + node->full_name); + return -ENODEV; + } + + err = of_property_read_u32(node, "bank-width", &bank_width); + if (err) { + dev_err(dev, "error %d reading bank-width property\n", err); + return err; + }
drivers/memory/Makefile
Quoted 10 lines
drivers/memory/Makefile +10
-0+ + /* + * Allocate an address window for this device. + * If the device probing fails, then we won't be able to + * remove the allocated address decoding window. + */ + err = mvebu_mbus_add_window(devbus_wins[cs], mem_res.start, + resource_size(&mem_res)); + if (err < 0) + return -EBUSY;
Why not return 'err' here?
Quoted 56 lines
drivers/memory/Makefile +56
-0+ /* + * First we read current parameter value, in order to have + * a default value for each parameter in case it's not defined + * by the device tree file. + */ + devbus_get_read_params(cs, &read_params); + devbus_get_write_params(cs, &write_params); + + /* Read the device tree child node and set the new parameters */ + devbus_get_params_dt(node, &read_params, &write_params); + devbus_set_read_params(dev, cs, &read_params); + devbus_set_write_params(dev, cs, &write_params); + + /* + * If we manage to set 'simple-bus' compatible string + * to device-bus node, then we don't really need this. + */ + child = of_platform_device_create(node, NULL, &pdev->dev); + if (!child) { + dev_warn(dev, "cannot create child device %s\n", node->name); + /* Remove the allocated window */ + mvebu_mbus_del_window(mem_res.start, resource_size(&mem_res)); + } + + return 0; +} + +static int mvebu_devbus_probe(struct platform_device *pdev) +{ + struct device_node *child; + struct resource *res; + int err; + + res = platform_get_resource(pdev, IORESOURCE_MEM, 0); + devbus_base = devm_ioremap_resource(&pdev->dev, res); + if (IS_ERR(devbus_base)) + return PTR_ERR(devbus_base); + + /* + * We probe NOR/NAND with different functions, because + * we expect them to have some different parameters. + * If this turns out not to be the case, we'll be able + * to use any name for the child, and rename to devbus_probe_child(). + */ + for_each_node_by_name(child, "nor") { + err = devbus_probe_nor_child(pdev, child); + if (err < 0) { + of_node_put(child); + return err; + } + } + + return 0; +} + +static const struct of_device_id mvebu_devbus_of_match[] = {
drivers/memory/Makefile
Quoted 10 lines
drivers/memory/Makefile +10
-0+ { .compatible = "marvell,armada370-devbus" }, + { .compatible = "marvell,armadaxp-devbus" }, + { .compatible = "marvell,mv78xx0-devbus" }, + {}, +}; +MODULE_DEVICE_TABLE(of, mvebu_devbus_of_match); + +static struct platform_driver mvebu_devbus_driver = { + .probe = mvebu_devbus_probe, + .remove = NULL, /* Thanks to managed functions! */
Are you sure this is true? In your ->probe() function, you're creating address decoding windows, and instantiating devices. If mvebu-mbus is compiled as a module, we want all the child devices to disappear, no?
Best regards,
Thomas
Signature · 4 lines
Thomas Petazzoni, Free Electrons Kernel, drivers, real-time and embedded Linux development, consulting, training and support. http://free-electrons.com
PATCH 1/5 drivers: memory: Introduce Marvell EBU Device Bus driver
Thomas,
On Thu, Mar 07, 2013 at 05:50:16PM +0100, Thomas Petazzoni wrote:
[...]
Quoted 5 lines
Are you sure this is true? In your ->probe() function, you're creating address decoding windows, and instantiating devices. If mvebu-mbus is compiled as a module, we want all the child devices to disappear, no?
Thanks for the review. I'll address all your comments in v2.
Signature · 3 lines
Ezequiel Garc?a, Free Electrons Embedded Linux, Kernel and Android Engineering http://free-electrons.com
PATCH 1/5 drivers: memory: Introduce Marvell EBU Device Bus driver
In reply to Ezequiel GarciaDocumentation/devicetree/bindings/memory-controllers/orion-devbus.txt line 118
Quoted 5 lines · Ezequiel Garcia
Documentation/devicetree/bindings/memory-controllers/orion-devbus.txt new file +5
-0+Example: + + device-bus at d0010400 { + status = "okay"; + ranges = <0 0 0xf0000000 0x1000000>; /* CS0 @addr 0xf0000000, size 0x1000000 */
The actual usage is fine, but the example is missing #address-cells/#size-cells..
Jason
PATCH 2/5 ARM: mvebu: Add Device Bus support for Armada 370/XP SoC
In reply to Ezequiel GarciaArmada 370 and Armada XP SoC have a Device Bus controller to handle NOR, NAND, SRAM and FPGA devices.
This patch adds the device tree node to enable the controller.
--- arch/arm/boot/dts/armada-370.dtsi | 7 +++++++ arch/arm/boot/dts/armada-xp.dtsi | 7 +++++++ 2 files changed, 14 insertions(+), 0 deletions(-)
arch/arm/boot/dts/armada-370.dtsi +7 -0
@@ -156,5 +156,12 @@ clocks = <&coreclk 0>; }; + device-bus at d0010400 { + compatible = "marvell,armada370-devbus"; + reg = <0xd0010400 0xe0>; + #address-cells = <2>; + #size-cells = <1>; + status = "disabled"; + }; }; };
arch/arm/boot/dts/armada-xp.dtsi +7 -0
@@ -154,5 +154,12 @@ status = "disabled"; }; + device-bus at d0010400 { + compatible = "marvell,armadaxp-devbus"; + reg = <0xd0010400 0xe0>; + #address-cells = <2>; + #size-cells = <1>; + status = "disabled"; + }; }; };
Signature · 1 line
1.7.8.6
PATCH 3/5 ARM: mvebu: Add support for NOR flash device on Armada XP-GP board
In reply to Ezequiel GarciaThe Armada XP Development Board DB-MV784MP-GP has a NOR flash device connected to the Device Bus. This commit adds the device tree node to support this device.
This SoC supports a flexible and dynamic decoding window allocation scheme; but since this feature is still not implemented we need to specify the window base address in the device tree node itself.
This base address has been selected in a completely arbitrary fashion.
--- arch/arm/boot/dts/armada-xp-gp.dts | 12 ++++++++++++ 1 files changed, 12 insertions(+), 0 deletions(-)
arch/arm/boot/dts/armada-xp-gp.dts +12 -0
@@ -109,5 +109,17 @@ spi-max-frequency = <108000000>; }; }; + + device-bus at d0010400 { + status = "okay"; + ranges = <0 0 0xf0000000 0x01000000>; /* CS0 @addr 0xf000000, size 0x1000000 */ + + /* CS0, 16 MiB */ + nor at 0 { + compatible = "cfi-flash"; + reg = <0 0 0x01000000>; + bank-width = <2>; + }; + }; }; };
Signature · 1 line
1.7.8.6
PATCH 4/5 ARM: mvebu: Add support for NOR flash device on Openblocks AX3 board
In reply to Ezequiel GarciaThe Plat'home Openblocks AX3 has a 128 MiB NOR flash device connected to the Device Bus. This commit adds the device tree node to support this device.
The SoC supports a flexible and dynamic decoding window allocation scheme; but since this feature is still not implemented we need to specify the window base address in the device tree node itself.
This base address has been selected in a completely arbitrary fashion.
--- arch/arm/boot/dts/armada-xp-openblocks-ax3-4.dts | 12 ++++++++++++ 1 files changed, 12 insertions(+), 0 deletions(-)
arch/arm/boot/dts/armada-xp-openblocks-ax3-4.dts +12 -0
@@ -139,5 +139,17 @@ usb at d0051000 { status = "okay"; }; + + device-bus at d0010400 { + status = "okay"; + ranges = <0 0 0xf0000000 0x8000000>; /* CS0 @addr 0xf000000, size 0x8000000 */ + + /* CS0, 128 MiB */ + nor at 0 { + compatible = "cfi-flash"; + reg = <0 0 0x8000000>; + bank-width = <2>; + }; + }; }; };
Signature · 1 line
1.7.8.6
PATCH 5/5 ARM: mvebu: Update defconfig to select Device Bus (memory-controller) support
In reply to Ezequiel Garcia--- arch/arm/configs/mvebu_defconfig | 2 ++ 1 files changed, 2 insertions(+), 0 deletions(-)
arch/arm/configs/mvebu_defconfig +2 -0
@@ -65,6 +65,8 @@ CONFIG_RTC_DRV_S35390A=y CONFIG_RTC_DRV_MV=y CONFIG_DMADEVICES=y CONFIG_MV_XOR=y +CONFIG_MEMORY=y +CONFIG_MVEBU_DEVBUS=y # CONFIG_IOMMU_SUPPORT is not set CONFIG_EXT2_FS=y CONFIG_EXT3_FS=y
Signature · 1 line
1.7.8.6
PATCH 5/5 ARM: mvebu: Update defconfig to select Device Bus (memory-controller) support
Dear Ezequiel Garcia,
Quoted 10 lines · Ezequiel Garcia
Signed-off-by Ezequiel Garcia <[email protected]>--- arch/arm/configs/mvebu_defconfig | 2 ++ 1 files changed, 2 insertions(+), 0 deletions(-)arch/arm/configs/mvebu_defconfig +0
-0
arch/arm/configs/mvebu_defconfig CONFIG_RTC_DRV_S35390A=y · line 72
Quoted 8 lines
arch/arm/configs/mvebu_defconfig +2
-0@@ -65,6 +65,8 @@ CONFIG_RTC_DRV_S35390A=y CONFIG_RTC_DRV_MV=y CONFIG_DMADEVICES=y CONFIG_MV_XOR=y +CONFIG_MEMORY=y +CONFIG_MVEBU_DEVBUS=y # CONFIG_IOMMU_SUPPORT is not set CONFIG_EXT2_FS=y CONFIG_EXT3_FS=y
I think it would be great if you also selected the relevant MTD drivers to enable access to the NOR flashes available in the Armada XP GP and PlatHome OpenBlocks AX3 boards.
Best regards,
Thomas
Signature · 4 lines
Thomas Petazzoni, Free Electrons Kernel, drivers, real-time and embedded Linux development, consulting, training and support. http://free-electrons.com
cover Device Bus support for Marvell EBU SoC
In reply to Ezequiel GarciaDear Ezequiel Garcia,
Quoted 8 lines · Ezequiel Garcia
Ezequiel Garcia (5):
drivers: memory: Introduce Marvell EBU Device Bus driver
ARM: mvebu: Add Device Bus support for Armada 370/XP SoC
ARM: mvebu: Add support for NOR flash device on Armada XP-GP board
ARM: mvebu: Add support for NOR flash device on Openblocks AX3 board
ARM: mvebu: Update defconfig to select Device Bus (memory-controller)
support
Quoted 12 lines
.../bindings/memory-controllers/orion-devbus.txt | 150 ++++++++++ arch/arm/boot/dts/armada-370.dtsi | 7 + arch/arm/boot/dts/armada-xp-gp.dts | 12 + arch/arm/boot/dts/armada-xp-openblocks-ax3-4.dts | 12 + arch/arm/boot/dts/armada-xp.dtsi | 7 + arch/arm/configs/mvebu_defconfig | 2 + drivers/memory/Kconfig | 11 + drivers/memory/Makefile | 1 + drivers/memory/mvebu-devbus.c | 296 ++++++++++++++++++++ 9 files changed, 498 insertions(+), 0 deletions(-) create mode 100644 Documentation/devicetree/bindings/memory-controllers/orion-devbus.txt create mode 100644 drivers/memory/mvebu-devbus.c
(on Armada XP GP board)
Thomas
Signature · 4 lines
Thomas Petazzoni, Free Electrons Kernel, drivers, real-time and embedded Linux development, consulting, training and support. http://free-electrons.com