cachepc-linux

Fork of AMDESE/linux with modifications for CachePC side-channel attack
git clone https://git.sinitax.com/sinitax/cachepc-linux
Log | Files | Refs | README | LICENSE | sfeed.txt

qcom,pm8018-adc.yaml (4786B)

      1# SPDX-License-Identifier: (GPL-2.0 OR BSD-2-Clause)
      2%YAML 1.2
      3---
      4$id: http://devicetree.org/schemas/iio/adc/qcom,pm8018-adc.yaml#
      5$schema: http://devicetree.org/meta-schemas/core.yaml#
      6
      7title: Qualcomm's PM8xxx voltage XOADC
      8
      9maintainers:
     10  - Linus Walleij <linus.walleij@linaro.org>
     11
     12description: |
     13  The Qualcomm PM8xxx PMICs contain a HK/XO ADC (Housekeeping/Crystal
     14  oscillator ADC) encompassing PM8018, PM8038, PM8058 and PM8921.
     15
     16properties:
     17  compatible:
     18    enum:
     19      - qcom,pm8018-adc
     20      - qcom,pm8038-adc
     21      - qcom,pm8058-adc
     22      - qcom,pm8921-adc
     23
     24  reg:
     25    maxItems: 1
     26    description:
     27      ADC base address in the PMIC, typically 0x197.
     28
     29  xoadc-ref-supply:
     30    description:
     31      The reference voltage may vary with PMIC variant but is typically
     32      something like 2.2 or 1.8V.
     33
     34  interrupts:
     35    maxItems: 1
     36
     37  "#address-cells":
     38    const: 2
     39    description:
     40      The first cell is the prescaler (on PM8058) or premux (on PM8921)
     41      with two valid bits  so legal values are 0x00, 0x01 or 0x02.
     42      The second cell is the main analog mux setting (0x00..0x0f).
     43      The combination of prescaler/premux and analog mux uniquely addresses
     44      a hardware channel on all systems.
     45
     46  "#size-cells":
     47    const: 0
     48
     49  "#io-channel-cells":
     50    const: 2
     51    description:
     52      The cells are precaler or premux followed by the analog muxing line.
     53
     54additionalProperties: false
     55
     56required:
     57  - compatible
     58  - reg
     59  - "#io-channel-cells"
     60  - "#address-cells"
     61  - "#size-cells"
     62  - adc-channel@c
     63  - adc-channel@d
     64  - adc-channel@f
     65
     66patternProperties:
     67  "^(adc-channel@)[0-9a-f]$":
     68    type: object
     69    description: |
     70      ADC channel specific configuration.
     71      Note that channels c, d and f must be present for calibration.
     72      These three nodes are used for absolute and ratiometric calibration
     73      and only need to have these reg values: they are by hardware definition
     74      1:1 ratio converters that sample 625, 1250 and 0 milliV and create
     75      an interpolation calibration for all other ADCs.
     76
     77    properties:
     78      reg:
     79        maxItems: 1
     80
     81      qcom,decimation:
     82        $ref: /schemas/types.yaml#/definitions/uint32
     83        description: |
     84          This parameter is used to decrease the ADC sampling rate.
     85          Quicker measurements can be made by reducing the decimation ratio.
     86          Valid values are 512, 1024, 2048, 4096.
     87          If the property is not found, a default value of 512 will be used.
     88
     89      qcom,ratiometric:
     90        $ref: /schemas/types.yaml#/definitions/uint32
     91        description: |
     92          Channel calibration type. If this property is specified
     93          VADC will use a special voltage references for channel
     94          calibration. The available references are specified in the
     95          as a u32 value setting (see below) and it is compulsory
     96          to also specify this reference if ratiometric calibration
     97          is selected.
     98
     99          If the property is not found, the channel will be
    100          calibrated with the 0.625V and 1.25V reference channels, also
    101          known as an absolute calibration.
    102
    103          The reference voltage pairs when using ratiometric calibration:
    104          0 = XO_IN/XOADC_GND
    105          1 = PMIC_IN/XOADC_GND
    106          2 = PMIC_IN/BMS_CSP
    107          3 (invalid)
    108          4 = XOADC_GND/XOADC_GND
    109          5 = XOADC_VREF/XOADC_GND
    110
    111    additionalProperties: false
    112
    113    required:
    114      - reg
    115
    116examples:
    117  - |
    118    #include <dt-bindings/interrupt-controller/irq.h>
    119    pmic {
    120        #address-cells = <1>;
    121        #size-cells = <0>;
    122
    123        adc@197 {
    124            compatible = "qcom,pm8058-adc";
    125            reg = <0x197>;
    126            interrupts-extended = <&pm8058 76 IRQ_TYPE_EDGE_RISING>;
    127            #address-cells = <2>;
    128            #size-cells = <0>;
    129            #io-channel-cells = <2>;
    130
    131            vcoin: adc-channel@0 {
    132                reg = <0x00 0x00>;
    133            };
    134            vbat: adc-channel@1 {
    135                reg = <0x00 0x01>;
    136            };
    137            dcin: adc-channel@2 {
    138                reg = <0x00 0x02>;
    139            };
    140            ichg: adc-channel@3 {
    141                reg = <0x00 0x03>;
    142            };
    143            vph_pwr: adc-channel@4 {
    144                reg = <0x00 0x04>;
    145            };
    146            usb_vbus: adc-channel@a {
    147                reg = <0x00 0x0a>;
    148            };
    149            die_temp: adc-channel@b {
    150                reg = <0x00 0x0b>;
    151            };
    152            ref_625mv: adc-channel@c {
    153                reg = <0x00 0x0c>;
    154            };
    155            ref_1250mv: adc-channel@d {
    156                reg = <0x00 0x0d>;
    157            };
    158            ref_325mv: adc-channel@e {
    159                reg = <0x00 0x0e>;
    160            };
    161            ref_muxoff: adc-channel@f {
    162                reg = <0x00 0x0f>;
    163           };
    164        };
    165    };
    166...