On Wed, 26 Jun 2019 13:36:27 +0800 Qii Wang <qii.wang@xxxxxxxxxxxx> wrote: > Document MediaTek I3C master DT bindings. > You forgot to Cc the DT maintainers/ML. > Signed-off-by: Qii Wang <qii.wang@xxxxxxxxxxxx> > --- > .../devicetree/bindings/i3c/mtk,i3c-master.txt | 47 ++++++++++++++++++++ > 1 file changed, 47 insertions(+) > create mode 100644 Documentation/devicetree/bindings/i3c/mtk,i3c-master.txt > > diff --git a/Documentation/devicetree/bindings/i3c/mtk,i3c-master.txt b/Documentation/devicetree/bindings/i3c/mtk,i3c-master.txt > new file mode 100644 > index 0000000..3fd4f17 > --- /dev/null > +++ b/Documentation/devicetree/bindings/i3c/mtk,i3c-master.txt > @@ -0,0 +1,47 @@ > +Bindings for MediaTek I3C master block > +===================================== > + > +Required properties: > +-------------------- > +- compatible: shall be "mediatek,i3c-master" > +- reg: physical base address of the controller and apdma base, length of > + memory mapped region. > +- reg-names: should be "main" for controller and "dma" for apdma. > +- interrupts: interrupt number to the cpu. > +- clocks: clock name from clock manager. > +- clock-names: must include "main" and "dma". > + > +Mandatory properties defined by the generic binding (see > +Documentation/devicetree/bindings/i3c/i3c.txt for more details): > + > +- #address-cells: shall be set to 3 > +- #size-cells: shall be set to 0 > + > +Optional properties defined by the generic binding (see > +Documentation/devicetree/bindings/i3c/i3c.txt for more details): > + > +- i2c-scl-hz > +- i3c-scl-hz > + > +I3C device connected on the bus follow the generic description (see > +Documentation/devicetree/bindings/i3c/i3c.txt for more details). > + > +Example: > + > + i3c0: i3c@1100d000 { > + compatible = "mediatek,i3c-master"; > + reg = <0x1100d000 0x100>, > + <0x11000300 0x80>; > + reg-names = "main", "dma"; > + interrupts = <GIC_SPI 44 IRQ_TYPE_LEVEL_LOW>; > + clocks = <&i3c0_ck>, <&ap_dma_ck>; > + clock-names = "main", "dma"; > + #address-cells = <1>; > + #size-cells = <0>; > + i2c-scl-hz = <100000>; > + > + nunchuk: nunchuk@52 { > + compatible = "nintendo,nunchuk"; > + reg = <0x52 0x80000010 0>; > + }; > + };