Documentation/devicetree/bindings/mfd/arizona.txt

   1 Wolfson Arizona class audio SoCs
   2
   3 These devices are audio SoCs with extensive digital capabilites and a range
   4 of analogue I/O.
   5
   6 Required properties:
   7
   8   - compatible : One of the following chip-specific strings:
   9         "wlf,wm5102"
  10         "wlf,wm5110"
  11         "wlf,wm8997"
  12   - reg : I2C slave address when connected using I2C, chip select number when
  13     using SPI.
  14
  15   - interrupts : The interrupt line the /IRQ signal for the device is
  16     connected to.
  17   - interrupt-controller : Arizona class devices contain interrupt controllers
  18     and may provide interrupt services to other devices.
  19   - interrupt-parent : The parent interrupt controller.
  20   - #interrupt-cells: the number of cells to describe an IRQ, this should be 2.
  21     The first cell is the IRQ number.
  22     The second cell is the flags, encoded as the trigger masks from
  23     Documentation/devicetree/bindings/interrupts.txt
  24
  25   - gpio-controller : Indicates this device is a GPIO controller.
  26   - #gpio-cells : Must be 2. The first cell is the pin number and the
  27     second cell is used to specify optional parameters (currently unused).
  28
  29   - AVDD-supply, DBVDD1-supply, DBVDD2-supply, DBVDD3-supply (wm5102, wm5110),
  30     CPVDD-supply, SPKVDDL-supply (wm5102, wm5110), SPKVDDR-supply (wm5102,
  31     wm5110), SPKVDD-supply (wm8997) : Power supplies for the device, as covered
  32     in Documentation/devicetree/bindings/regulator/regulator.txt
  33
  34 Optional properties:
  35
  36   - wlf,reset : GPIO specifier for the GPIO controlling /RESET
  37   - wlf,ldoena : GPIO specifier for the GPIO controlling LDOENA
  38
  39   - wlf,gpio-defaults : A list of GPIO configuration register values. If
  40     absent, no configuration of these registers is performed. If any
  41     entry has a value that is out of range for a 16 bit register then
  42     the chip default will be used.  If present exactly five values must
  43     be specified.
  44
  45   - DCVDD-supply, MICVDD-supply : Power supplies, only need to be specified if
  46     they are being externally supplied. As covered in
  47     Documentation/devicetree/bindings/regulator/regulator.txt
  48
  49 Optional subnodes:
  50   - ldo1 : Initial data for the LDO1 regulator, as covered in
  51     Documentation/devicetree/bindings/regulator/regulator.txt
  52   - micvdd : Initial data for the MICVDD regulator, as covered in
  53     Documentation/devicetree/bindings/regulator/regulator.txt
  54
  55 Example:
  56
  57 codec: wm5102@1a {
  58         compatible = "wlf,wm5102";
  59         reg = <0x1a>;
  60         interrupts = <347>;
  61         interrupt-controller;
  62         #interrupt-cells = <2>;
  63         interrupt-parent = <&gic>;
  64
  65         gpio-controller;
  66         #gpio-cells = <2>;
  67
  68         wlf,gpio-defaults = <
  69                 0x00000000 /* AIF1TXLRCLK */
  70                 0xffffffff
  71                 0xffffffff
  72                 0xffffffff
  73                 0xffffffff
  74         >;
  75 };