mirror of
https://mirrors.bfsu.edu.cn/git/linux.git
synced 2024-11-29 07:04:10 +08:00
42839dcafd
In order to ensure only documented properties are present, node schemas must have unevaluatedProperties or additionalProperties set to false (typically). Signed-off-by: Rob Herring <robh@kernel.org> Acked-by: Heiko Stuebner <heiko@sntech.de> Acked-by: Alistair Francis <alistair@alistair23.me> Reviewed-by: Jernej Skrabec <jernej.skrabec@gmail.com> Reviewed-by: Krzysztof Kozlowski <krzysztof.kozlowski@linaro.org> Acked-by: Charles Keepax <ckeepax@opensource.cirrus.com> Acked-by: Linus Walleij <linus.walleij@linaro.org> Signed-off-by: Lee Jones <lee@kernel.org> Link: https://lore.kernel.org/r/20220823145649.3118479-4-robh@kernel.org
523 lines
13 KiB
YAML
523 lines
13 KiB
YAML
# SPDX-License-Identifier: (GPL-2.0 OR BSD-2-Clause)
|
|
%YAML 1.2
|
|
---
|
|
$id: http://devicetree.org/schemas/mfd/stericsson,ab8500.yaml#
|
|
$schema: http://devicetree.org/meta-schemas/core.yaml#
|
|
|
|
title: ST-Ericsson Analog Baseband AB8500 and AB8505
|
|
|
|
maintainers:
|
|
- Linus Walleij <linus.walleij@linaro.org>
|
|
|
|
description:
|
|
the AB8500 "Analog Baseband" is the mixed-signals integrated circuit
|
|
handling power management (regulators), analog-to-digital conversion
|
|
(ADC), battery charging, fuel gauging of the battery, battery-backed
|
|
RTC, PWM, USB PHY and some GPIO lines in the ST-Ericsson U8500 platforms
|
|
in connection with the DB8500 digital baseband. The DB8500 PRCMU
|
|
communicates directly and autonomously with the AB8500 and thus it
|
|
appears as a subnode of the DB8500 PRCMU. An altered version called
|
|
AB8505 also exist, the difference in AB8505 is that some of the USB and
|
|
USB charging handling has changed, and it has an embedded USB-to-serial
|
|
converter. Most subblocks takes their interrupts directly from the
|
|
AB8500 embedded interrupt controller.
|
|
|
|
properties:
|
|
$nodename:
|
|
pattern: '^ab850[05]$'
|
|
|
|
compatible:
|
|
enum:
|
|
- stericsson,ab8500
|
|
- stericsson,ab8505
|
|
|
|
interrupts:
|
|
maxItems: 1
|
|
|
|
interrupt-controller: true
|
|
|
|
'#interrupt-cells':
|
|
const: 2
|
|
|
|
# Some subnodes use a reg, some don't. Those that do use a single cell.
|
|
'#address-cells':
|
|
const: 1
|
|
|
|
'#size-cells':
|
|
const: 0
|
|
|
|
clock-controller:
|
|
description: Node describing the AB8500 clock controller. This
|
|
provides the reference clock for the entire U8500 system and
|
|
the DB8500 counterpart.
|
|
type: object
|
|
additionalProperties: false
|
|
|
|
properties:
|
|
compatible:
|
|
const: stericsson,ab8500-clk
|
|
|
|
'#clock-cells':
|
|
const: 1
|
|
|
|
gpio:
|
|
description: Node describing the AB8500 GPIO controller. A few
|
|
GPIO pins available for misc usage.
|
|
type: object
|
|
additionalProperties: false
|
|
|
|
properties:
|
|
compatible:
|
|
enum:
|
|
- stericsson,ab8500-gpio
|
|
- stericsson,ab8505-gpio
|
|
|
|
gpio-controller: true
|
|
|
|
'#gpio-cells':
|
|
const: 2
|
|
|
|
rtc:
|
|
description: Node describing the AB8500 battery-backed RTC.
|
|
type: object
|
|
additionalProperties: false
|
|
|
|
properties:
|
|
compatible:
|
|
const: stericsson,ab8500-rtc
|
|
|
|
interrupts:
|
|
items:
|
|
- description: 60 second interval alarm interrupt
|
|
- description: RTC alarm
|
|
|
|
interrupt-names:
|
|
items:
|
|
- const: 60S
|
|
- const: ALARM
|
|
|
|
adc:
|
|
description: Node describing the AB8500 general purpose analog to digital
|
|
converter, GPADC.
|
|
type: object
|
|
|
|
properties:
|
|
compatible:
|
|
const: stericsson,ab8500-gpadc
|
|
|
|
# AB8505 only supports one (software) EOC interrupt
|
|
interrupts:
|
|
minItems: 1
|
|
maxItems: 2
|
|
|
|
interrupt-names: true
|
|
|
|
vddadc-supply: true
|
|
|
|
'#address-cells':
|
|
const: 1
|
|
|
|
'#size-cells':
|
|
const: 0
|
|
|
|
'#io-channel-cells':
|
|
const: 1
|
|
|
|
patternProperties:
|
|
"^channel@[0-9a-f]+$":
|
|
type: object
|
|
$ref: ../iio/adc/adc.yaml#
|
|
description: Represents each of the external channels which are
|
|
connected to the ADC.
|
|
|
|
properties:
|
|
reg:
|
|
items:
|
|
minimum: 1
|
|
maximum: 31
|
|
|
|
required:
|
|
- reg
|
|
|
|
additionalProperties: false
|
|
|
|
required:
|
|
- compatible
|
|
- interrupts
|
|
- interrupt-names
|
|
- vddadc-supply
|
|
- '#address-cells'
|
|
- '#size-cells'
|
|
- '#io-channel-cells'
|
|
|
|
additionalProperties: false
|
|
|
|
thermal:
|
|
description: Node describing the AB8500 thermal control block. All this block
|
|
really does is to fire an interrupt when the die becomes 130 degrees Celsius
|
|
in temperature.
|
|
type: object
|
|
|
|
properties:
|
|
compatible:
|
|
const: stericsson,abx500-temp
|
|
|
|
interrupts:
|
|
items:
|
|
- description: Thermal warm warning interrupt
|
|
|
|
interrupt-names:
|
|
items:
|
|
- const: ABX500_TEMP_WARM
|
|
|
|
required:
|
|
- compatible
|
|
- interrupts
|
|
- interrupt-names
|
|
|
|
additionalProperties: false
|
|
|
|
ab8500_fg:
|
|
description: Node describing the AB8500 fuel gauge control block.
|
|
type: object
|
|
$ref: ../power/supply/stericsson,ab8500-fg.yaml
|
|
|
|
ab8500_btemp:
|
|
description: Node describing the AB8500 battery temperature control block.
|
|
type: object
|
|
$ref: ../power/supply/stericsson,ab8500-btemp.yaml
|
|
|
|
ab8500_charger:
|
|
description: Node describing the AB8500 battery charger control block.
|
|
type: object
|
|
$ref: ../power/supply/stericsson,ab8500-charger.yaml
|
|
|
|
ab8500_chargalg:
|
|
description: Node describing the AB8500 battery charger algorithm.
|
|
type: object
|
|
$ref: ../power/supply/stericsson,ab8500-chargalg.yaml
|
|
|
|
phy:
|
|
description: Node describing the AB8500 USB PHY control block.
|
|
type: object
|
|
|
|
properties:
|
|
compatible:
|
|
const: stericsson,ab8500-usb
|
|
|
|
interrupts:
|
|
items:
|
|
- description: ID wakeup rising IRQ
|
|
- description: ID wakeup falling IRQ
|
|
- description: VBUS detection falling IRQ
|
|
- description: VBUS detection rising IRQ
|
|
- description: USB link status change IRQ
|
|
- description: ADP probe plug IRQ
|
|
- description: ADP probe unplug IRQ
|
|
|
|
interrupt-names:
|
|
items:
|
|
- const: ID_WAKEUP_R
|
|
- const: ID_WAKEUP_F
|
|
- const: VBUS_DET_F
|
|
- const: VBUS_DET_R
|
|
- const: USB_LINK_STATUS
|
|
- const: USB_ADP_PROBE_PLUG
|
|
- const: USB_ADP_PROBE_UNPLUG
|
|
|
|
vddulpivio18-supply: true
|
|
v-ape-supply: true
|
|
musb_1v8-supply: true
|
|
|
|
clocks:
|
|
items:
|
|
- description: PRCMY system clock
|
|
|
|
clock-names:
|
|
items:
|
|
- const: sysclk
|
|
|
|
'#phy-cells':
|
|
const: 0
|
|
|
|
required:
|
|
- compatible
|
|
- interrupts
|
|
- interrupt-names
|
|
- vddulpivio18-supply
|
|
- v-ape-supply
|
|
- musb_1v8-supply
|
|
- clocks
|
|
- clock-names
|
|
- '#phy-cells'
|
|
|
|
additionalProperties: false
|
|
|
|
key:
|
|
description: Node describing the AB8500 power-on key control block.
|
|
type: object
|
|
|
|
properties:
|
|
compatible:
|
|
const: stericsson,ab8500-poweron-key
|
|
|
|
interrupts:
|
|
items:
|
|
- description: ON key falling IRQ
|
|
- description: ON key rising IRQ
|
|
|
|
interrupt-names:
|
|
items:
|
|
- const: ONKEY_DBF
|
|
- const: ONKEY_DBR
|
|
|
|
required:
|
|
- compatible
|
|
- interrupts
|
|
- interrupt-names
|
|
|
|
additionalProperties: false
|
|
|
|
ab8500-sysctrl:
|
|
description: Node describing the AB8500 system control block.
|
|
type: object
|
|
|
|
properties:
|
|
compatible:
|
|
const: stericsson,ab8500-sysctrl
|
|
|
|
required:
|
|
- compatible
|
|
|
|
additionalProperties: false
|
|
|
|
codec:
|
|
description: Node describing the AB8500 audio codec block.
|
|
type: object
|
|
|
|
properties:
|
|
compatible:
|
|
const: stericsson,ab8500-codec
|
|
|
|
V-AUD-supply: true
|
|
V-AMIC1-supply: true
|
|
V-AMIC2-supply: true
|
|
V-DMIC-supply: true
|
|
|
|
clocks:
|
|
items:
|
|
- description: Audio system clock
|
|
|
|
clock-names:
|
|
items:
|
|
- const: audioclk
|
|
|
|
stericsson,earpeice-cmv:
|
|
description: Earpeice voltage
|
|
$ref: /schemas/types.yaml#/definitions/uint32
|
|
enum: [ 950, 1100, 1270, 1580 ]
|
|
|
|
required:
|
|
- compatible
|
|
|
|
additionalProperties: false
|
|
|
|
regulator:
|
|
description: Node describing the AB8500 internal regulators.
|
|
type: object
|
|
|
|
properties:
|
|
compatible:
|
|
enum:
|
|
- stericsson,ab8500-regulator
|
|
- stericsson,ab8505-regulator
|
|
|
|
vin-supply:
|
|
description: The regulator supplying all of the internal regulators
|
|
with power.
|
|
|
|
ab8500_ldo_aux1:
|
|
description: The voltage for the auxilary LDO regulator 1
|
|
type: object
|
|
$ref: ../regulator/regulator.yaml#
|
|
unevaluatedProperties: false
|
|
|
|
ab8500_ldo_aux2:
|
|
description: The voltage for the auxilary LDO regulator 2
|
|
type: object
|
|
$ref: ../regulator/regulator.yaml#
|
|
unevaluatedProperties: false
|
|
|
|
ab8500_ldo_aux3:
|
|
description: The voltage for the auxilary LDO regulator 3
|
|
type: object
|
|
$ref: ../regulator/regulator.yaml#
|
|
unevaluatedProperties: false
|
|
|
|
ab8500_ldo_aux4:
|
|
description: The voltage for the auxilary LDO regulator 4
|
|
only present on AB8505
|
|
type: object
|
|
$ref: ../regulator/regulator.yaml#
|
|
unevaluatedProperties: false
|
|
|
|
ab8500_ldo_aux5:
|
|
description: The voltage for the auxilary LDO regulator 5
|
|
only present on AB8505
|
|
type: object
|
|
$ref: ../regulator/regulator.yaml#
|
|
unevaluatedProperties: false
|
|
|
|
ab8500_ldo_aux6:
|
|
description: The voltage for the auxilary LDO regulator 6
|
|
only present on AB8505
|
|
type: object
|
|
$ref: ../regulator/regulator.yaml#
|
|
unevaluatedProperties: false
|
|
|
|
# There is never any AUX7 regulator which is confusing
|
|
|
|
ab8500_ldo_aux8:
|
|
description: The voltage for the auxilary LDO regulator 8
|
|
only present on AB8505
|
|
type: object
|
|
$ref: ../regulator/regulator.yaml#
|
|
unevaluatedProperties: false
|
|
|
|
ab8500_ldo_intcore:
|
|
description: The LDO regulator for the internal core voltage
|
|
of the AB8500
|
|
type: object
|
|
$ref: ../regulator/regulator.yaml#
|
|
unevaluatedProperties: false
|
|
|
|
ab8500_ldo_adc:
|
|
description: Analog power regulator for the analog to digital converter
|
|
ADC, only present on AB8505
|
|
type: object
|
|
$ref: ../regulator/regulator.yaml#
|
|
unevaluatedProperties: false
|
|
|
|
ab8500_ldo_tvout:
|
|
description: The voltage for the TV output regulator, incidentally
|
|
this voltage is also used for other purposes such as measuring
|
|
the temperature of the NTC thermistor on the battery.
|
|
Only present on AB8500.
|
|
type: object
|
|
$ref: ../regulator/regulator.yaml#
|
|
unevaluatedProperties: false
|
|
|
|
ab8500_ldo_audio:
|
|
description: The LDO regulator for the audio codec output
|
|
type: object
|
|
$ref: ../regulator/regulator.yaml#
|
|
unevaluatedProperties: false
|
|
|
|
ab8500_ldo_anamic1:
|
|
description: The LDO regulator for the analog microphone 1
|
|
type: object
|
|
$ref: ../regulator/regulator.yaml#
|
|
unevaluatedProperties: false
|
|
|
|
ab8500_ldo_anamic2:
|
|
description: The LDO regulator for the analog microphone 2
|
|
type: object
|
|
$ref: ../regulator/regulator.yaml#
|
|
unevaluatedProperties: false
|
|
|
|
ab8500_ldo_dmic:
|
|
description: The LDO regulator for the digital microphone
|
|
only present on AB8500
|
|
type: object
|
|
$ref: ../regulator/regulator.yaml#
|
|
unevaluatedProperties: false
|
|
|
|
ab8500_ldo_ana:
|
|
description: Analog power regulator for CSI and DSI interfaces,
|
|
Camera Serial Interface CSI and Display Serial Interface DSI.
|
|
type: object
|
|
$ref: ../regulator/regulator.yaml#
|
|
unevaluatedProperties: false
|
|
|
|
required:
|
|
- compatible
|
|
|
|
additionalProperties: false
|
|
|
|
|
|
regulator-external:
|
|
description: Node describing the AB8500 external regulators. This
|
|
concerns the autonomous regulators VSMPS1, VSMPS2 and VSMPS3
|
|
that are normally controlled by external electronics but also
|
|
sometimes need to be explicitly controlled by software.
|
|
type: object
|
|
|
|
properties:
|
|
compatible:
|
|
const: stericsson,ab8500-ext-regulator
|
|
|
|
ab8500_ext1:
|
|
description: The voltage for the VSMPS1 external regulator
|
|
type: object
|
|
$ref: ../regulator/regulator.yaml#
|
|
unevaluatedProperties: false
|
|
|
|
ab8500_ext2:
|
|
description: The voltage for the VSMPS2 external regulator
|
|
type: object
|
|
$ref: ../regulator/regulator.yaml#
|
|
unevaluatedProperties: false
|
|
|
|
ab8500_ext3:
|
|
description: The voltage for the VSMPS3 external regulator
|
|
type: object
|
|
$ref: ../regulator/regulator.yaml#
|
|
unevaluatedProperties: false
|
|
|
|
required:
|
|
- compatible
|
|
|
|
additionalProperties: false
|
|
|
|
patternProperties:
|
|
"^pwm@[1-9]+?$":
|
|
type: object
|
|
$ref: ../pwm/pwm.yaml#
|
|
unevaluatedProperties: false
|
|
description: Represents each of the PWM blocks in the AB8500
|
|
|
|
properties:
|
|
compatible:
|
|
const: stericsson,ab8500-pwm
|
|
|
|
reg: true
|
|
|
|
clocks:
|
|
items:
|
|
- description: internal clock
|
|
|
|
clock-names:
|
|
items:
|
|
- const: intclk
|
|
|
|
required:
|
|
- compatible
|
|
- reg
|
|
|
|
required:
|
|
- compatible
|
|
- clock-controller
|
|
- gpio
|
|
- rtc
|
|
- adc
|
|
- thermal
|
|
- ab8500_fg
|
|
- ab8500_btemp
|
|
- ab8500_charger
|
|
- ab8500_chargalg
|
|
- phy
|
|
- key
|
|
- regulator
|
|
|
|
additionalProperties: false
|