-
Notifications
You must be signed in to change notification settings - Fork 6.5k
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
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 <[email protected]>
- Loading branch information
Showing
1 changed file
with
190 additions
and
0 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -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] |