1# Copyright (c) 2023-2024 Analog Devices, Inc.
2# SPDX-License-Identifier: Apache-2.0
3
4description: ADI MAX32xxx MCUs 1-Wire Master
5
6include: [w1-master.yaml, pinctrl-device.yaml]
7
8compatible: "adi,max32-w1"
9
10properties:
11  reg:
12    required: true
13
14  clocks:
15    required: true
16
17  interrupts:
18    required: true
19
20  pinctrl-0:
21    required: true
22
23  pinctrl-names:
24    required: true
25
26  internal-pullup:
27    required: true
28    type: int
29    enum: [0, 1]
30    description: |
31      Set this field to enable the internal pullup resistor.
32      0 - Internal pullup disabled.
33      1 - Internal pullup enabled.
34
35  external-pullup:
36    type: int
37    enum: [0, 1, 2]
38    description: |
39      Set this field to enable the external pullup.
40      0 - Pullup pin is active high when enabled.
41      1 - Pullup pin is active low when enabled.
42      2 - Pullup pin is not used for an external pullup.
43
44  long-line-mode:
45    type: boolean
46    description: |
47      Long Line Mode Enable
48      Selects alternate timings for 1-Wire communication.
49      The recommended setting depends on the length of the wire.
50      For lines less than 40 meters, 0 should be used.
51
52      Setting this bit to 0 leaves the write one release,
53      the data sampling, and the time-slot recovery times at
54      approximately 5us (micro second), 15us, and 7us, respectively.
55
56      Setting this bit to 1 enables long line mode timings during standard mode communications.
57      This mode moves the write one release, the data sampling,
58      and the time-slot recovery times out to approximately 8us, 22us, and 14us, respectively.
59
60      0 - Standard operation for lines less than 40 meters.
61      1 - Long Line mode enabled.
62