Thanks Rob, now that the code side is merged, I'm back to docs. > > + interrupt-controller: > > + description: see interrupt-controller/interrupts.txt > > Don't need generic descriptions. Just 'true' here is fine. Do you really mean quoted true, like in "description: 'true' "? Without quotes it will fail > > > + > > + interrupts: > > + description: TODO > > You have to define how many interrupts and what they are. I didn't write the interruption code and Linus and Alvin might help here. The switch has a single interrupt pin that signals an interruption happened. The code reads a register to multiplex to these interruptions: INT_TYPE_LINK_STATUS = 0, INT_TYPE_METER_EXCEED, INT_TYPE_LEARN_LIMIT, INT_TYPE_LINK_SPEED, INT_TYPE_CONGEST, INT_TYPE_GREEN_FEATURE, INT_TYPE_LOOP_DETECT, INT_TYPE_8051, INT_TYPE_CABLE_DIAG, INT_TYPE_ACL, INT_TYPE_RESERVED, /* Unused */ INT_TYPE_SLIENT, And most of them, but not all, multiplex again to each port. However, the linux driver today does not care about any of these interruptions but INT_TYPE_LINK_STATUS. So it simply multiplex only this the interruption to each port, in a n-cell map (n being number of ports). I don't know what to describe here as device-tree should be something independent of a particular OS or driver. Anyway, I doubt someone might want to plug one of these interruptions outside the switch driver. Could it be simple as this: interrupts: minItems: 3 maxItems: 10 description: interrupt mapping one per switch port Once realtek-smi.yaml settles, I'll also send the realtek-mdio.yaml. Regards, Luiz