dts: bindings: gpio: Add dtb bindings for MAX14916
Industrial 8 channel input GPIO expander with diagnostics Per channel diagnostics from dtb Signed-off-by: Stoyan Bogdanov <sbogdanov@baylibre.com>
This commit is contained in:
Stoyan Bogdanov
Carles Cufí
parent
3ca5cf50fe
commit
7b2da4e191
190
dts/bindings/gpio/adi,max14916-gpio.yaml
Normal file
190
dts/bindings/gpio/adi,max14916-gpio.yaml
Normal file
@ -0,0 +1,190 @@
|
||||
# Copyright (c) 2024 Analog Devices Inc.
|
||||
# Copyright (c) 2024 BayLibre SAS
|
||||
# SPDX-License-Identifier: Apache-2.0
|
||||
|
||||
description: ADI MAX14916 is octal industrial output with advanced diagnostics
|
||||
|
||||
compatible: "adi,max14916-gpio"
|
||||
|
||||
properties:
|
||||
"#gpio-cells":
|
||||
const: 2
|
||||
ngpios:
|
||||
type: int
|
||||
required: true
|
||||
const: 8
|
||||
description: Number of gpios supported
|
||||
drdy-gpios:
|
||||
description: |
|
||||
High-Side Open-Drain Output. READY is passive low when the internal
|
||||
logic supply is higher than the UVLO threshold, indicating that the
|
||||
registers have adequate supply voltage.
|
||||
type: phandle-array
|
||||
fault-gpios:
|
||||
description: |
|
||||
Fault pin indicates when there is Fault state in either FAULT1 or FAULT2
|
||||
bothe of which are cleaned on read once problem is not persistent
|
||||
type: phandle-array
|
||||
sync-gpios:
|
||||
description: |
|
||||
Latch the data so it could be read (partially duplicate CS)
|
||||
type: phandle-array
|
||||
en-gpios:
|
||||
description: |
|
||||
DOI Enable Pin. Drive the EN pin high to enable the DOI_ outputs.
|
||||
Drive EN low to disable/three-state all DOI_ outputs.
|
||||
type: phandle-array
|
||||
crc-en:
|
||||
description: |
|
||||
Notify driver if crc pin is enabled.
|
||||
type: boolean
|
||||
spi-addr:
|
||||
type: int
|
||||
default: 0
|
||||
required: true
|
||||
enum:
|
||||
- 0
|
||||
- 1
|
||||
- 2
|
||||
- 3
|
||||
description: |
|
||||
On MAX14906PMB module default address is 0 (A0-LOW, A1-LOW)
|
||||
Selectable device address, configurable from A0 and A1
|
||||
ow-on-en:
|
||||
type: array
|
||||
default: [0, 0, 0, 0, 0, 0, 0, 0]
|
||||
description: |
|
||||
Default values are from documentation.
|
||||
Enable or disable open-wire-on functionality per channel.
|
||||
- 0 mean disable
|
||||
- 1 mean enable
|
||||
channels indentation start from CH0...CH7
|
||||
ow-off-en:
|
||||
type: array
|
||||
default: [0, 0, 0, 0, 0, 0, 0, 0]
|
||||
description: |
|
||||
Default values are from documentation.
|
||||
Enable or disable open-wire-off functionality per channel.
|
||||
- 0 mean disable
|
||||
- 1 mean enable
|
||||
channels indentation start from CH0...CH7
|
||||
sh-vdd-en:
|
||||
type: array
|
||||
default: [0, 0, 0, 0, 0, 0, 0, 0]
|
||||
description: |
|
||||
Default values are from documentation.
|
||||
ShVddEN - Short to VDD enable
|
||||
Enable or disable short to VDD functionality per channel.
|
||||
- 0 mean disable
|
||||
- 1 mean enable
|
||||
channels indentation start from CH0...CH3
|
||||
fled-set:
|
||||
type: boolean
|
||||
description: |
|
||||
Internal fault diagnostics include (if enabled): SafeDemagF_, SHVDD_,
|
||||
VDDOV_, OWOff_, AboveVDD_, CL_, OVL_, VDDOKFault_.
|
||||
sled-set:
|
||||
type: boolean
|
||||
description: |
|
||||
Enable status LEDs
|
||||
fled-stretch:
|
||||
type: int
|
||||
default: 0
|
||||
enum:
|
||||
- 0
|
||||
- 1
|
||||
- 2
|
||||
- 3
|
||||
description: |
|
||||
Default values are from documentation.
|
||||
Set minimum on time for FLEDs in case of fault
|
||||
0 - Disable minimum fault LED (FLED) on-time
|
||||
1 - Minimum fault LED (FLED) on-time = 1s (typ)
|
||||
2 - Minimum fault LED (FLED) on-time = 2s (typ)
|
||||
3 - Minimum fault LED (FLED) on-time = 3s (typ)
|
||||
ffilter-en:
|
||||
type: boolean
|
||||
description: |
|
||||
When the fault LEDs (FLEDs) are controlled internally (FLEDSet = 0), open-
|
||||
wire and short-to-V DD diagnostics always use filtering and cannot be disabled
|
||||
by the FFilterEn bit.
|
||||
filter-long:
|
||||
type: boolean
|
||||
description: |
|
||||
false: To select regular blanking time (4ms, typ) for diagnostic fault bits, OWOff_
|
||||
and SHVDD_
|
||||
true: To select long blanking time (8ms, typ) for diagnostic fault bits, OWOff_
|
||||
and SHVDD_
|
||||
flatch-en:
|
||||
type: boolean
|
||||
description: |
|
||||
false: Disable latching of diagnostic fault bits in the OvrLdChF, OpnWirChF, and
|
||||
ShtVDDChF registers
|
||||
true: Enable latching of diagnostic fault bits in the OvrLdChF, OpnWirChF, and
|
||||
ShtVDDChF registers
|
||||
led-cur-lim:
|
||||
type: boolean
|
||||
description: |
|
||||
false: Disable fault LEDs (FLEDs) signaling current limit
|
||||
true: Enable fault LEDs (FLEDs) signaling current limit
|
||||
vdd-on-thr:
|
||||
type: boolean
|
||||
description: |
|
||||
Enable higher voltage thresholds for VDD and VDD_ undervoltage monitoring
|
||||
synch-wd-en:
|
||||
type: boolean
|
||||
description: |
|
||||
The SYNCH watchdog timeout is defined by the WDTo[1:0] bits if the SPI
|
||||
watchdog is enabled. When WDTo[1:0] = 00 (SPI watchdog disabled), the
|
||||
SYNCH watchdog timeout is 600ms (typ) if enabled.
|
||||
sht-vdd-thr:
|
||||
type: int
|
||||
default: 0
|
||||
enum:
|
||||
- 0
|
||||
- 1
|
||||
- 2
|
||||
- 3
|
||||
description: |
|
||||
Default values are from documentation.
|
||||
Set threshold voltage for short-to-V DD detection
|
||||
0: Set threshold voltage for short-to-VDD detection to 9V (typ)
|
||||
1: Set threshold voltage for short-to-VDD detection to 10V (typ)
|
||||
2: Set threshold voltage for short-to-VDD detection to 12V (typ)
|
||||
3: Set threshold voltage for short-to-VDD detection to 14V (typ)
|
||||
ow-off-cs:
|
||||
type: int
|
||||
default: 0
|
||||
enum:
|
||||
- 0
|
||||
- 1
|
||||
- 2
|
||||
- 3
|
||||
description: |
|
||||
Default values are from documentation.
|
||||
Set the pullup current for open-wire and short-to-VDD detection
|
||||
0: Set open-wire and short-to-VDD detection current to 60μA (typ)
|
||||
1: Set open-wire and short-to-VDD detection current to 100μA (typ)
|
||||
2: Set open-wire and short-to-VDD detection current to 300μA (typ)
|
||||
3: Set open-wire and short-to-VDD detection current to 600μA (typ)
|
||||
wd-to:
|
||||
type: int
|
||||
default: 0
|
||||
enum:
|
||||
- 0
|
||||
- 1
|
||||
- 2
|
||||
- 3
|
||||
description: |
|
||||
Default values are from documentation.
|
||||
SPI Watchdog Status, set SPI and SYNCH Watchdog Timeout
|
||||
0: Disable SPI Watchdog Status and SPI Watchdog Timeout
|
||||
1: Enable SPI Watchdog Status, set SPI and SYNCH Watchdog Timeout to 200ms (typ)
|
||||
2: Enable SPI Watchdog Status, set SPI and SYNCH Watchdog Timeout to 600ms (typ)
|
||||
3: Enable SPI Watchdog Status, set SPI and SYNCH Watchdog Timeout to 1.2s (typ)
|
||||
|
||||
gpio-cells:
|
||||
- pin
|
||||
- flags
|
||||
|
||||
include: [gpio-controller.yaml, spi-device.yaml]
|
||||
Loading…
Reference in New Issue
Block a user