From mboxrd@z Thu Jan  1 00:00:00 1970
From: Stephen Warren <swarren@wwwdotorg.org>
Subject: Re: [RFC] Device Tree Overlays Proposal (Was Re: capebus moving omap_devices
 to mach-omap2)
Date: Mon, 12 Nov 2012 22:22:07 -0700
Message-ID: <50A1D8FF.7060104@wwwdotorg.org>
References: <CACxGe6vu8ek7-K-yDDMXyg9x-oKiFt_cSz+Pz-yZf5U5vwe=0g@mail.gmail.com> <20121109022624.GI23553@truffula.fritz.box> <CACxGe6vQ50aS0Fe7QvTHKfV=EDpsZoLC7SOxXLGc0pkMvyk5DQ@mail.gmail.com> <20121113010505.GR4696@truffula.fritz.box>
Mime-Version: 1.0
Content-Type: text/plain; charset=ISO-8859-1
Content-Transfer-Encoding: 7bit
Return-path: <linux-omap-owner@vger.kernel.org>
In-Reply-To: <20121113010505.GR4696@truffula.fritz.box>
Sender: linux-omap-owner@vger.kernel.org
To: David Gibson <david@gibson.dropbear.id.au>
Cc: Grant Likely <grant.likely@secretlab.ca>, Kevin Hilman <khilman@ti.com>, Matt Porter <mporter@ti.com>, Koen Kooi <koen@dominion.thruhere.net>, Pantelis Antoniou <panto@antoniou-consulting.com>, linux-kernel <linux-kernel@vger.kernel.org>, Felipe Balbi <balbi@ti.com>, Deepak Saxena <dsaxena@linaro.org>, Scott Wood <scottwood@freescale.com>, Russ Dill <Russ.Dill@ti.com>, linux-omap@vger.kernel.org, devicetree-discuss@lists.ozlabs.org
List-Id: devicetree@vger.kernel.org

On 11/12/2012 06:05 PM, David Gibson wrote:
> On Fri, Nov 09, 2012 at 09:42:37PM +0000, Grant Likely wrote:
...
> 2) graft bundle
> 
> The base tree has something like this:
> 
> 	...
> 	i2c@XXX {
> 		...
> 		cape-socket {
> 			compatible = "vendor,cape-socket";
> 			id = "Socket-A";
> 			piece-id = "i2c";
> 			ranges = < ... >;
> 		};
> 	};
> 	...
> 	spi@YYY {
> 		...
> 		cape-socket {
> 			compatible = "vendor,cape-socket";
> 			id = "Socket-A";
> 			piece-id = "spi";
> 			ranges = < ... >;
> 		};
> 	};
> 	...
> 	cape-socket {
> 		compatible = "vendor,cape-socket";
> 		id = "Socket-A";
> 		piece-id = "misc";
> 		interrupt-map = < ... >;
> 		interrupt-map-mask = < ... >;
> 		gpio-map = < ... >;
> 		gpio-map-mask = < ... >;
> 	};
> 
> Then instead of grafting a single subtree for the socket, we install a
> "bundle" of subtrees, one each for each of the pieces within the
> socket.  That bundle could either be an actual set of multiple fdts,
> or they could be placed into one fdt with a dummy root node, something like:
>
> 	/ {
> 		plugin-bundle;
> 		compatible = "vendor,cape-plugin";
> 		version = ...;
> 		i2c-piece = {
> 			piece-id = "i2c";
> 			...
> 		};
> 		misc-piece = {
> 			piece-id = "misc";
> 			...
> 		};
> 	};

I do like this approach; it's the kind of thing I proposed at:

> http://www.mail-archive.com/devicetree-discuss@lists.ozlabs.org/msg20414.html

One question though: Perhaps the base board has two instances of the
same type of connector vendor,cape-socket, allowing 2 independent capes
to be plugged in. When overlaying/grafting the child board's .dts, we'd
need some way to specify the socket ID that was being plugged into. Is
that the intent of the "id" property in your base board example above?