Re: [PATCH v7 1/7] spi: dt-bindings: Add spi-device-addr peripheral property
Jonathan Cameron <[email protected]> Wed, 29 Jul 2026 23:47:33 +0100
| Newsgroups | org.kernel.vger.linux-spi,org.kernel.vger.linux-devicetree,org.kernel.vger.linux-doc,org.kernel.vger.linux-iio,org.kernel.vger.linux-kernel |
|---|---|
| Message-ID | <20260729234733.6b092a00@jic23-huawei> |
On Tue, 28 Jul 2026 16:46:26 -0500 David Lechner <[email protected]> wrote: > On 7/28/26 4:05 PM, Jonathan Cameron wrote: > > On Tue, 28 Jul 2026 13:39:20 -0500 > > David Lechner <[email protected]> wrote: > > > >> On 7/28/26 11:10 AM, Conor Dooley wrote: > >>> On Sat, Jul 25, 2026 at 11:04:45PM +0100, Jonathan Cameron wrote: > >>>> On Sat, 25 Jul 2026 15:55:01 -0500 > >>>> David Lechner <[email protected]> wrote: > >>>> > >>>>> On 7/22/26 2:54 AM, Janani Sunil wrote: > >>>>>> Some SPI devices support sharing a single chip select across multiple > >>>>>> physical chips by encoding a device address in the SPI frame itself. > >>>>>> Add the generic spi-device-addr property for describing these hardware > >>>>>> addresses. The property is placed on the SPI peripheral node and may > >>>>>> contain multiple addresses. > >>>>>> > >>>>>> Signed-off-by: Janani Sunil <[email protected]> > >>>>>> --- > >>>>>> Documentation/devicetree/bindings/spi/spi-peripheral-props.yaml | 7 +++++++ > >>>>>> 1 file changed, 7 insertions(+) > >>>>>> > >>>>>> diff --git a/Documentation/devicetree/bindings/spi/spi-peripheral-props.yaml b/Documentation/devicetree/bindings/spi/spi-peripheral-props.yaml > >>>>>> index 880a9f624566..b59d047cf117 100644 > >>>>>> --- a/Documentation/devicetree/bindings/spi/spi-peripheral-props.yaml > >>>>>> +++ b/Documentation/devicetree/bindings/spi/spi-peripheral-props.yaml > >>>>>> @@ -142,6 +142,13 @@ properties: > >>>>>> minItems: 2 > >>>>>> maxItems: 4 > >>>>>> > >>>>>> + spi-device-addr: > >>>>>> + $ref: /schemas/types.yaml#/definitions/uint32-array > >>>>>> + description: > >>>>>> + Device addresses used when multiple peripherals share a single chip > >>>>>> + select. The array allows one logical peripheral to comprise multiple > >>>>>> + physical devices, with one address per device. > >>>>> > >>>>> "per physical device" for clarity. > >>>>> > >>>> > >>>> We may end up relaxing that again if multichip packages start doing this. > >>>> Fine to add that clarification for now. We can revisit when / if it ever > >>>> needs that relaxing. > >>>> > >>>>>> + > >>>>>> st,spi-midi-ns: > >>>>>> deprecated: true > >>>>>> description: | > >>>>>> > >>>>> > >>>>> If there is nothing useful the SPI core code can do with this information, > >>>>> I'm not entirely convinced that this needs to be a common property. > >>>> > >>>> I think being common does make some sense from a standarization point of > >>>> view and it isn't obvious where to put it other than under spi. > >>>> > >>>>> > >>>>> And this only allows for one logical device. If we wanted to treat each > >>>>> address as a logical device (all with same CS), we would need #address-cells = <2>; > >>>>> instead where the DT "address" is two values, the CS and the device address. > >>>> > >>>> Ah. Good point for the adc@address or similar needing to match a combination > >>>> of CS and spi-device-addr. Conor any thoughts on how this would be done? > >>> > >>> I'm sorry, I don't quite understand. Why do you want to support both of > >>> these representations? Hardware wise both of these things would be > >>> describing the same setup, so allowing this alternate "multiple logical > >>> device" typically is not permitted. What even is the use case of it? > > > > The microchip parts. They are entirely independent. The device address is > > just a way to save pins. That is contrasting those with the one in this > > series where the design assumes you want to treat them as a large logical > > device in a similar way to spi device chaining. > > > > > >>> Does it matter at all if you have one or more logical devices from a > >>> consumer perspective? > >>> > >>> I do have an idea of how to solve the adc@address problem (you can do > >>> adc@address,spi-device-address like some other devices) but as I said I > >>> don't get why it would be needed. > > > > I think we should often do this because there are some confusing cases > > otherwise. See below. > > > >> > >> I would expect that if such a device was intended to be used as individual > >> logical devices that they would just be wired up each with their own chip > >> select rather than sharing one. > >> > >> The only reason I can think of actually needing adc@address,spi-device-address > >> would be on a system that was really short on pins on the MCU. > >> > >> So not saying that we need it right now. Just wanted to make sure we were > >> intentional about saying we don't need it if we don't. > > > > To enumerate the cases: > > > > 1. One CS has multiple spi-device-address and needs to be a combined device. > > Given this ADC does some fun stuff to include messages with no > > spi-device-address that are meant to be received by all such > > devices we pretty much have to map any that share a CS to one > > logical device - we have to bind one driver. This is kind of > > similar to SPI device chaining. > > address == cs. spi-device-address property not used for that. > > - This one can be normal SPI style. > > > > 2. One CS has multiple spi-device-address but logically separate otherwise. > > This is the microchip devices I think. For those the device-address > > is just a pin saving exercise. > > address == spi-device-address. CS not needed as there is only one. > > We would still need CS to tell the SPI controller which one is wired. So > we should never have adc@spi-device-address, only adc@cs,spi-device-address. > > (There currently isn't any binding for SPI_NO_CS, so the controller would > still need a CS line even if it isn't wired/muxed and CS on the peripheral > is hardwired.) Sure - it needs to provided today because the reg entry must match the adc@reg bit. That 'could' be relaxed. I don't think it's a good idea but I thought this was what Conor was proposing. > > > > > 2b. Same as 2, but there is another normal ADC with a chip select. > > How do we know adc@spi-device-address vs adc@cs given they could > > easily take same address value by coincidence? > > As above. > > > > > 2c. Basically Case as 2 but * N CS all on same SPI bus. > > As David calls out this is the pin count minimization case. > > E.g. I want 8 devices each of which has 2 pin straps to set the > > device address. So I have to use at least 2 CS. > > For this I need both cs and device-address and Conor's suggestion works. > > > > There is a case of 1 + 2 with different device types but result is same > > as 2c. > > > > Now, to me the question is whether we say that if spi-device-address is > > present you always do adc@cs,spi-device-address or do we allow for not > > doing so for the composite devices where nothing else is sharing the CS > > (like this driver). > > > > My inclination is standardize on always doing it for these devices. > > > > Jonathan > > > >> > >> > > >