[PATCH v2 9/9] docs: document WID DT properties

[Yu-Chien Peter Lin]

Hi Krzysztof,

On Mon, Sep 28, 2026 at 01:30:28PM +0200, Krzysztof Kozlowski wrote:
> On 17/08/2026 11:05, Yu-Chien Peter Lin wrote:
> > Add "wid" and "widdeleg" properties to domain instance node
> > documentation and example DT. Add a "Root Domain Node" section
> > describing the "root" subnode under the domain configuration
> > node for root domain WID configuration
> > 
> > Signed-off-by: Yu-Chien Peter Lin <peter.lin at sifive.com>
> > ---
> >  docs/domain_support.md | 36 ++++++++++++++++++++++++++++++++++++
> >  1 file changed, 36 insertions(+)
> > 
> > diff --git a/docs/domain_support.md b/docs/domain_support.md
> > index e267a9f7..c35a1d9a 100644
> > --- a/docs/domain_support.md
> > +++ b/docs/domain_support.md
> > @@ -93,6 +93,8 @@ following manner:
> >    is the next mode for the ROOT domain
> >  * **system_reset_allowed** - The ROOT domain is allowed to reset the system
> >  * **system_suspend_allowed** - The ROOT domain is allowed to suspend the system
> > +* **wid** - Configurable World ID for the ROOT domain
> > +* **widdeleg** - Configurable World ID delegation bitmask for the ROOT domain
> 
> Why are you documenting DT in some random docts?
> 
> >  
> >  Domain Effects
> >  --------------
> > @@ -126,6 +128,23 @@ The DT properties of a domain configuration DT node are as follows:
> >  * **compatible** (Mandatory) - The compatible string of the domain
> >    configuration. This DT property should have value *"opensbi,domain,config"*
> >  
> > +### Root Domain Node
> > +
> > +The root domain WID configuration is described in a **root** subnode under
> > +the domain configuration DT node. This subnode does not have a compatible
> > +string.
> > +
> > +The DT properties of the root domain node are as follows:
> 
> NAK, please read writing bindings and both documents for submitting patches.

I agree that it should be validated by kernel's
dt_binding_check/dtbs_check tooling.

To support Worlds-based supervisor domain and the
upcoming OP-TEE (and possibly StandaloneMM) trusted
domain use cases, this raises an open question for
Anup and the OpenSBI community: should we start
upstreaming the OpenSBI domain DT bindings
to linux/Documentation/devicetree/bindings?

I can send an RFC if there is consensus.

Thanks,
Peter Lin

> 
> 
> Best regards,
> Krzysztof