On Sat, Dec 05, 2015 at 11:38:37AM +0100, Geert Uytterhoeven wrote: > Hi Bjorn, > > On Fri, Dec 4, 2015 at 10:26 PM, Bjorn Helgaas <helgaas@xxxxxxxxxx> wrote: > > On Tue, Dec 01, 2015 at 04:24:30PM +0900, Simon Horman wrote: > >> Simply document new compat strings. > >> There appears to be no need for a driver updates. > >> > >> Signed-off-by: Simon Horman <horms+renesas@xxxxxxxxxxxx> > >> --- > >> Documentation/devicetree/bindings/pci/pci-rcar-gen2.txt | 1 + > >> 1 file changed, 1 insertion(+) > >> > >> diff --git a/Documentation/devicetree/bindings/pci/pci-rcar-gen2.txt b/Documentation/devicetree/bindings/pci/pci-rcar-gen2.txt > >> index b19be08a8113..7c231b3e5872 100644 > >> --- a/Documentation/devicetree/bindings/pci/pci-rcar-gen2.txt > >> +++ b/Documentation/devicetree/bindings/pci/pci-rcar-gen2.txt > >> @@ -8,6 +8,7 @@ OHCI and EHCI controllers. > >> Required properties: > >> - compatible: "renesas,pci-r8a7790" for the R8A7790 SoC; > >> "renesas,pci-r8a7791" for the R8A7791 SoC; > >> + "renesas,pci-r8a7793" for the R8A7793 SoC; > > > > What's the benefit of adding a string here if the driver doesn't check > > for it? Since the driver doesn't look for it, there's no way to test > > anything. > > If we ever discover a difference between PCI on r8a7793 compared to PCI on > other SoCs of the R-Car Gen2 family, we can handle that difference in the > driver. > > > It doesn't seem like this file is an authoritative source of names, so > > Yes it is. When adding compatible values to a DTS, checkpatch.pl will check > for their existence in the binding documentation. Hence we always add the > compatible values to the DT binding docs, before we start using them. > > > if we add it here, there's the possibility the r8a7793 will be > > canceled or renamed, and then we'd have to update this if the driver > > ever did need an r8a7793-specific quirk. If we waited until the > > I don't understand what you mean here. > > > driver actually needs a quirk, then we'd know exactly what name to > > look for and we could update the driver, DT, and doc all together. > > If we update driver, DT, and doc only after we discover the need for a quirk, > it's already too late, due to stable DT rules. Hence we always document and > use SoC-specific compatible values, sometimes combined with family-specific > compatible values. The driver only matches to the as least specific value as > possible. The stable DT rules seem to be the key here, but I don't know what they are. I found Documentation/devicetree/bindings/ABI.txt, but it doesn't clear it up for me. I was assuming vendors could ship a DT in a platform ROM, in the same way platforms ship with an ACPI system description. For ACPI, the _HID/_CID in the ROM in the field is authoritative in the sense that we have to regard it as a fixed, unchangeable feature of the platform. If we want a driver to recognize that device, we have to build the ID from the ROM into the driver, and it doesn't matter what is documented in the spec or in the kernel source. If we had a one-sentence description of why adding the doc update when we actually need it is too late, that would probably be enough. I'm perfectly happy with the PCI changes, so if somebody else wants to just merge all these via a DT tree, I'm happy to ack the PCI ones. Bjorn -- To unsubscribe from this list: send the line "unsubscribe devicetree" in the body of a message to majordomo@xxxxxxxxxxxxxxx More majordomo info at http://vger.kernel.org/majordomo-info.html
