Book a Demo!
CoCalc Logo Icon
StoreFeaturesDocsShareSupportNewsAboutPoliciesSign UpSign In
torvalds
GitHub Repository: torvalds/linux
 Path: blob/master/Documentation/devicetree/bindings/i2c/i2c-mux-pca954x.yaml
26307 views
1
# SPDX-License-Identifier: GPL-2.0

2
%YAML 1.2

3
---

4
$id: http://devicetree.org/schemas/i2c/i2c-mux-pca954x.yaml#

5
$schema: http://devicetree.org/meta-schemas/core.yaml#

6


7
title: NXP PCA954x I2C and compatible bus switches

8


9
maintainers:

10
  - Laurent Pinchart <laurent.pinchart@ideasonboard.com>

11


12
description:

13
  The NXP PCA954x and compatible devices are I2C bus

14
  multiplexer/switches that share the same functionality

15
  and register layout.

16
  The devices usually have 4 or 8 child buses, which are

17
  attached to the parent bus by using the SMBus "Send Byte"

18
  command.

19


20
properties:

21
  compatible:

22
    oneOf:

23
      - enum:

24
          - maxim,max7356

25
          - maxim,max7357

26
          - maxim,max7358

27
          - maxim,max7367

28
          - maxim,max7368

29
          - maxim,max7369

30
          - nxp,pca9540

31
          - nxp,pca9542

32
          - nxp,pca9543

33
          - nxp,pca9544

34
          - nxp,pca9545

35
          - nxp,pca9546

36
          - nxp,pca9547

37
          - nxp,pca9548

38
          - nxp,pca9846

39
          - nxp,pca9847

40
          - nxp,pca9848

41
          - nxp,pca9849

42
      - items:

43
          - const: nxp,pca9646

44
          - const: nxp,pca9546

45


46
  reg:

47
    maxItems: 1

48


49
  interrupts:

50
    maxItems: 1

51


52
  "#interrupt-cells":

53
    const: 2

54


55
  interrupt-controller: true

56


57
  reset-gpios:

58
    maxItems: 1

59


60
  i2c-mux-idle-disconnect:

61
    type: boolean

62
    description: Forces mux to disconnect all children in idle state. This is

63
      necessary for example, if there are several multiplexers on the bus and

64
      the devices behind them use same I2C addresses.

65


66
  idle-state:

67
    description: if present, overrides i2c-mux-idle-disconnect

68
    $ref: /schemas/mux/mux-controller.yaml#/properties/idle-state

69


70
  vdd-supply:

71
    description: A voltage regulator supplying power to the chip. On PCA9846

72
      the regulator supplies power to VDD2 (core logic) and optionally to VDD1.

73


74
  maxim,isolate-stuck-channel:

75
    type: boolean

76
    description: Allows to use non faulty channels while a stuck channel is

77
      isolated from the upstream bus. If not set all channels are isolated from

78
      the upstream bus until the fault is cleared.

79


80
  maxim,send-flush-out-sequence:

81
    type: boolean

82
    description: Send a flush-out sequence to stuck auxiliary buses

83
      automatically after a stuck channel is being detected.

84


85
  maxim,preconnection-wiggle-test-enable:

86
    type: boolean

87
    description: Send a STOP condition to the auxiliary buses when the switch

88
      register activates a channel to detect a stuck high fault. On fault the

89
      channel is isolated from the upstream bus.

90


91
required:

92
  - compatible

93
  - reg

94


95
allOf:

96
  - $ref: /schemas/i2c/i2c-mux.yaml#

97
  - if:

98
      not:

99
        properties:

100
          compatible:

101
            contains:

102
              enum:

103
                - maxim,max7367

104
                - maxim,max7369

105
                - nxp,pca9542

106
                - nxp,pca9543

107
                - nxp,pca9544

108
                - nxp,pca9545

109
    then:

110
      properties:

111
        interrupts: false

112
        "#interrupt-cells": false

113
        interrupt-controller: false

114


115
  - if:

116
      not:

117
        properties:

118
          compatible:

119
            contains:

120
              enum:

121
                - maxim,max7357

122
    then:

123
      properties:

124
        maxim,isolate-stuck-channel: false

125
        maxim,send-flush-out-sequence: false

126
        maxim,preconnection-wiggle-test-enable: false

127


128
unevaluatedProperties: false

129


130
examples:

131
  - |

132
    #include <dt-bindings/interrupt-controller/irq.h>

133


134
    i2c {

135
        #address-cells = <1>;

136
        #size-cells = <0>;

137


138
        i2c-mux@74 {

139
            compatible = "nxp,pca9545";

140
            #address-cells = <1>;

141
            #size-cells = <0>;

142
            reg = <0x74>;

143


144
            vdd-supply = <&p3v3>;

145


146
            interrupt-parent = <&ipic>;

147
            interrupts = <17 IRQ_TYPE_LEVEL_LOW>;

148
            interrupt-controller;

149
            #interrupt-cells = <2>;

150


151
            i2c@2 {

152
                #address-cells = <1>;

153
                #size-cells = <0>;

154
                reg = <2>;

155


156
                eeprom@54 {

157
                    compatible = "atmel,24c08";

158
                    reg = <0x54>;

159
                };

160
            };

161


162
            i2c@4 {

163
                #address-cells = <1>;

164
                #size-cells = <0>;

165
                reg = <4>;

166


167
                rtc@51 {

168
                    compatible = "nxp,pcf8563";

169
                    reg = <0x51>;

170
                };

171
            };

172
        };

173
    };

174
...

175


176