Hi, On Friday, December 16, 2016 03:14:36 PM Marek Szyprowski wrote: > Samsung Exynos SoCs and boards related bindings evolved since the initial > introduction, but initially the bindings were minimal and a bit incomplete > (they never described all the hardware modules available in the SoCs). > Since then some significant (not fully compatible) changes have been > already committed a few times (like gpio replaced by pinctrl, display ddc, > mfc reserved memory, some core clocks added to various hardware modules, > added more required nodes). > > On the other side there are no boards which have device tree embedded in > the bootloader. Device tree blob is always compiled from the kernel tree > and updated together with the kernel image. > > Thus to avoid further adding a bunch of workarounds for old/missing > bindings and allow to make cleanup of the existing code and device tree > files, lets mark Samsung Exynos SoC platform bindings as unstable. This > means that bindings can may change at any time and users should use the > dtb file compiled from the same kernel source tree as the kernel image. > > Signed-off-by: Marek Szyprowski <m.szyprowski@xxxxxxxxxxx> This change is long overdue.. Acked-by: Bartlomiej Zolnierkiewicz <b.zolnierkie@xxxxxxxxxxx> > --- > Documentation/devicetree/bindings/arm/samsung/exynos.txt | 12 ++++++++++++ > 1 file changed, 12 insertions(+) > create mode 100644 Documentation/devicetree/bindings/arm/samsung/exynos.txt > > diff --git a/Documentation/devicetree/bindings/arm/samsung/exynos.txt b/Documentation/devicetree/bindings/arm/samsung/exynos.txt > new file mode 100644 > index 000000000000..0c606f4c6e85 > --- /dev/null > +++ b/Documentation/devicetree/bindings/arm/samsung/exynos.txt > @@ -0,0 +1,12 @@ > +Samsung Exynos SoC Family Device Tree Bindings > +--------------------------------------------------------------- > + > +Work in progress statement: > + > +Device tree files and bindings applying to Samsung Exynos SoCs and boards are > +considered "unstable". Any Samsung Exynos device tree binding may change at any > +time. Be sure to use a device tree binary and a kernel image generated from the > +same source tree. > + > +Please refer to Documentation/devicetree/bindings/ABI.txt for a definition of a > +stable binding/ABI. Best regards, -- Bartlomiej Zolnierkiewicz Samsung R&D Institute Poland Samsung Electronics -- 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