On Fri, Aug 30, 2024 at 05:00:40PM +0100, Conor Dooley wrote: > From: Conor Dooley <conor.dooley@xxxxxxxxxxxxx> > > This is a pretty rough document I conjured up in 5 minutes, to document > my expectations for compatible strings for both our FPGA IP blocks and > reference designs that we ship, a la the one that exists for SiFive IPs. > There's been some internal conversations lately about this naming etc, > so good to have something written down. > > Signed-off-by: Conor Dooley <conor.dooley@xxxxxxxxxxxxx> > --- > cc: cyril.jean@xxxxxxxxxxxxx > CC: valentina.fernandezalanis@xxxxxxxxxxxxx > CC: nitin.deshpande@xxxxxxxxxxxxx > CC: Rob Herring <robh@xxxxxxxxxx> > CC: Krzysztof Kozlowski <krzk+dt@xxxxxxxxxx> > CC: Conor Dooley <conor+dt@xxxxxxxxxx> > CC: devicetree@xxxxxxxxxxxxxxx > CC: linux-kernel@xxxxxxxxxxxxxxx > --- > .../bindings/microchip/ip-versioning.txt | 34 +++++++++++++++++++ > 1 file changed, 34 insertions(+) > create mode 100644 Documentation/devicetree/bindings/microchip/ip-versioning.txt > > diff --git a/Documentation/devicetree/bindings/microchip/ip-versioning.txt b/Documentation/devicetree/bindings/microchip/ip-versioning.txt > new file mode 100644 > index 000000000000..4a4e0e74c4e6 > --- /dev/null > +++ b/Documentation/devicetree/bindings/microchip/ip-versioning.txt > @@ -0,0 +1,34 @@ > +Devicetree compatible string versioning for Microchip FPGA IP blocks and reference designs > + > +This document describes the versioning guidelines for compatible strings > +used on Microchip FPGA IP blocks and reference designs. > + > +IP block-specific compatible strings are in the form: > +"microchip,<ip-block-name>-rtl-v<major version number>" > +or optionally: > +"microchip,<ip-block-name>-rtl-v<major version number>.<minor version number>" > + > +<ip-block-name> should be the name of the IP in Libero's IP catalog. > +In most cases a major version should be sufficient, as breaking changes are > +intended to be accompanied by a version update, but if not, the optional minor > +version should be used, Please cover where do version numbers come from? Rob
