wlf,arizona.yaml

  1# SPDX-License-Identifier: GPL-2.0-only OR BSD-2-Clause
  2%YAML 1.2
  3---
  4$id: http://devicetree.org/schemas/extcon/wlf,arizona.yaml#
  5$schema: http://devicetree.org/meta-schemas/core.yaml#
  6
  7title: Cirrus Logic/Wolfson Microelectronics Arizona class audio SoCs
  8
  9maintainers:
 10  - patches@opensource.cirrus.com
 11
 12description: |
 13  These devices are audio SoCs with extensive digital capabilities and a
 14  range of analogue I/O.
 15
 16  This document lists Extcon specific bindings, see the primary binding
 17  document ../mfd/arizona.yaml
 18
 19properties:
 20  wlf,hpdet-channel:
 21    description:
 22      Headphone detection channel.  ARIZONA_ACCDET_MODE_HPL/1 sets the
 23      headphone detect mode to HPDETL, ARIZONA_ACCDET_MODE_HPR/2 sets it
 24      to HPDETR.  If this node is not included or if the value is unknown,
 25      then headphone detection mode is set to HPDETL.
 26    $ref: /schemas/types.yaml#/definitions/uint32
 27    minimum: 1
 28    maximum: 2
 29
 30  wlf,use-jd2:
 31    description:
 32      Use the additional JD input along with JD1 for dual pin jack detection.
 33    type: boolean
 34
 35  wlf,use-jd2-nopull:
 36    description:
 37      Internal pull on JD2 is disabled when used for jack detection.
 38    type: boolean
 39
 40  wlf,jd-invert:
 41    description:
 42      Invert the polarity of the jack detection switch.
 43    type: boolean
 44
 45  wlf,micd-software-compare:
 46    description:
 47      Use a software comparison to determine mic presence.
 48    type: boolean
 49
 50  wlf,micd-detect-debounce:
 51    description:
 52      Additional software microphone detection debounce specified in
 53      milliseconds.
 54    $ref: /schemas/types.yaml#/definitions/uint32
 55
 56  wlf,micd-pol-gpio:
 57    description:
 58      GPIO specifier for the GPIO controlling the headset polarity if one
 59      exists.
 60    maxItems: 1
 61
 62  wlf,micd-bias-start-time:
 63    description:
 64      Time allowed for MICBIAS to startup prior to performing microphone
 65      detection, specified as per the ARIZONA_MICD_TIME_XXX defines.
 66    $ref: /schemas/types.yaml#/definitions/uint32
 67    minimum: 0
 68    maximum: 12
 69
 70  wlf,micd-rate:
 71    description:
 72      Delay between successive microphone detection measurements, specified
 73      as per the ARIZONA_MICD_TIME_XXX defines.
 74    $ref: /schemas/types.yaml#/definitions/uint32
 75    minimum: 0
 76    maximum: 12
 77
 78  wlf,micd-dbtime:
 79    description:
 80      Microphone detection hardware debounces specified as the number of
 81      measurements to take.
 82    $ref: /schemas/types.yaml#/definitions/uint32
 83    enum: [2, 4]
 84
 85  wlf,micd-timeout-ms:
 86    description:
 87      Timeout for microphone detection, specified in milliseconds.
 88
 89  wlf,micd-force-micbias:
 90    description:
 91      Force MICBIAS continuously on during microphone detection.
 92    type: boolean
 93
 94  wlf,micd-configs:
 95    description:
 96      Headset polarity configurations (generally used for detection of
 97      CTIA / OMTP headsets), the field can be of variable length but
 98      should always be a multiple of 3 cells long, each three cell group
 99      represents one polarity configuration.
100    $ref: /schemas/types.yaml#/definitions/uint32-matrix
101    items:
102      items:
103        - description:
104            The first cell defines the accessory detection pin, zero
105            will use MICDET1 and 0x2000 will use MICDET2.
106          enum: [ 0, 0x2000 ]
107        - description:
108            The second cell represents the MICBIAS to be used. Zero
109            will use MICVDD, 1-3 will use MICBIASx.
110          minimum: 0
111          maximum: 3
112        - description:
113            The third cell represents the value of the micd-pol-gpio
114            pin.
115          minimum: 0
116          maximum: 1
117
118  wlf,gpsw:
119    description:
120      Settings for the general purpose switch, set as one of the
121      ARIZONA_GPSW_XXX defines.
122    $ref: /schemas/types.yaml#/definitions/uint32
123    minimum: 0
124    maximum: 3
125
126additionalProperties: true