MAX6956 输入/输出扩展器

MAX6956 组件允许你在 ESPHome 中使用 MAX6956 输入/输出扩展器（数据手册）。它使用 I²C 总线进行通信。

max6956 根据封装不同，存在 20 或 28 端口两种版本。配置完成后，你可以在项目中使用这 20 或 28 个引脚中的任意一个。在 ESPHome 中，它们模拟真实的内部 GPIO 引脚，因此可以与 ESPHome 的许多组件（如 GPIO 二进制传感器或 GPIO 开关）一起使用。输入不支持变化中断。

引脚还可以单独配置为 LED 驱动器，并与灯组件一起使用。电流值可全局设置，也可针对每个引脚设置，共有 16 档可选。驱动 RGB LED 需要 3 个引脚。

任何接受 Pin Schema 的选项原则上都可以使用。

组件/Hub

max6956 是一个 I²C 总线从设备。其地址通过 A0 和 A1 硬件引脚的组合配置，范围为 0x40 至 0x4F。

max6956:
  - id: max6956_1
    address: 0x40
    i2c_id: bus_a

配置变量

id (必选, ID): 用于此 max6956 组件的 id。
address (可选, int): 驱动器的 I²C 地址。默认为 0x40。
i2c_id (可选): I²C 总线 ID。默认为 false。
brightness_global (可选): 设置所有配置为 LED 驱动的引脚要灌入的电流值。默认为 0。
brightness_mode (可选): 定义灌入电流是全局配置还是按每个配置为 LED 驱动的引脚单独配置。默认为 global。

二进制传感器示例

max6956 引脚可以用作二进制传感器。支持单独的上拉。

# 示例配置
binary_sensor:
  - platform: gpio
    name: "MaxIn Pin 4"
    id: In_4
    pin:
      max6956: max6956_1
      number: 4
      mode:
        input: true
        pullup: true
      inverted: False

开关示例

max6956 引脚可以用作开关。

# 示例配置
  switch:
    - platform: gpio
      name: "MaxIn Pin 8"
      id: In_8
      pin:
        max6956: max6956_1
        number: 8
        mode:
          output: true
        inverted: False

LED 驱动器示例

max6956 可以控制一个恒流灌电流来驱动 LED，从 1.5mA 到 24mA 共 16 个等间隔档位。

# 示例配置：引脚作为 LED 驱动器，电流全局设置
i2c:
  id: bus_a
  sda: GPIOXX
  scl: GPIOXX

switch:
  - platform: template
    name: "Led"
    id: MaxOut4
    optimistic: true
    turn_on_action:
      - output.turn_on: maxOut_pin4
    turn_off_action:
      - output.turn_off: maxOut_pin4

number:
  - platform: template
    name: "Global brightness"
    id: global_brightness
    optimistic: true
    min_value: 0
    max_value: 15
    initial_value: 1
    step: 1
    mode: slider
    on_value:
      - max6956.set_brightness_global:
          id: max6956_1
          brightness_global: !lambda return x;

max6956:
  - id: max6956_1
    address: 0x40
    i2c_id: bus_a
    brightness_mode: global
    brightness_global: 5

#output to use
output:
  - platform: max6956
    pin: 4
    id: maxOut_pin4

#led binded to output
light:
  - platform: monochromatic
    id: Light_1
    output: maxOut_pin4

# 示例配置：引脚作为 LED 驱动器，电流单独管理（RGB LED）
i2c:
  id: bus_a
  sda: GPIOXX
  scl: GPIOXX

max6956:
  - id: max6956_1
    address: 0x40
    i2c_id: bus_a
    brightness_mode: segment

switch:
  - platform: template
    name: "Led Red"
    id: MaxOut4
    optimistic: true
    turn_on_action:
      - output.turn_on: maxOut_pin4
    turn_off_action:
      - output.turn_off: maxOut_pin4

  - platform: template
    name: "Led Green"
    id: MaxOut5
    optimistic: true
    turn_on_action:
      - output.turn_on: maxOut_pin5
    turn_off_action:
      - output.turn_off: maxOut_pin5

  - platform: template
    name: "Led Blue"
    id: MaxOut6
    optimistic: true
    turn_on_action:
      - output.turn_on: maxOut_pin6
    turn_off_action:
      - output.turn_off: maxOut_pin6

number:
  - platform: template
    name: "Number Red"
    id: number_LedRed
    optimistic: true
    min_value: 0
    max_value: 100
    initial_value: 10
    step: 1
    mode: slider
    on_value:
      - output.set_level:
          id: maxOut_pin4
          level: !lambda return x/100;

  - platform: template
    name: "Number Green"
    id: number_LedGreen
    optimistic: true
    min_value: 0
    max_value: 100
    initial_value: 10
    step: 1
    mode: slider
    on_value:
      - output.set_level:
          id: maxOut_pin5
          level: !lambda return x/100;

  - platform: template
    name: "Number Blue"
    id: number_LedBlue
    optimistic: true
    min_value: 0
    max_value: 100
    initial_value: 10
    step: 1
    mode: slider
    on_value:
      - output.set_level:
          id: maxOut_pin6
          level: !lambda return x/100;
output:
  - platform: max6956
    pin: 4
    id: maxOut_pin4
  - platform: max6956
    pin: 5
    id: maxOut_pin5
  - platform: max6956
    pin: 6
    id: maxOut_pin6

light:
  - platform: rgb
    id: Light_1
    default_transition_length: 0.1s
    gamma_correct: 1
    red: maxOut_pin4
    green: maxOut_pin5
    blue: maxOut_pin6