"complete" dt-bindings for new SoC

From: Chris Packham
Date: Wed Aug 13 2025 - 00:59:41 EST


Hi Devicetree Enthusiasts,

A few times now I've been told that things would have been easier had I
submitted a complete binding in the first place. I find myself looking
at another new SoC (a Realtek Switch with and integrated ARM64 core this
time). I'm also waiting on hardware so I figured I could probably get
the ball rolling on a devicetree and I wanted to do a better job of
writing the binding.

Which brings be to the question. What does a "complete" binding mean to
the devicetree maintainers? Are we talking about an overall binding for
the chip that calls out peripherals (some which already exist) with a
ref: ? Or a full binding in one document that covers everything in the
chip? Does it need to be accompanied by an actual dts(i) for the chip?

Thanks,
Chris