Documentation/devicetree/bindings/i2c/hisilicon,ascend910-i2c.yaml

# SPDX-License-Identifier: (GPL-2.0 OR BSD-2-Clause)
%YAML 1.2
---
$id: http://devicetree.org/schemas/i2c/hisilicon,ascend910-i2c.yaml#
$schema: http://devicetree.org/meta-schemas/core.yaml#

title: HiSilicon common I2C controller

maintainers:
  - Yicong Yang <yangyicong@hisilicon.com>

description:
  The HiSilicon common I2C controller can be used for many different
  types of SoC such as Huawei Ascend AI series chips.

allOf:
  - $ref: /schemas/i2c/i2c-controller.yaml#

properties:
  compatible:
    const: hisilicon,ascend910-i2c

  reg:
    maxItems: 1

  interrupts:
    maxItems: 1

  clocks:
    maxItems: 1

  clock-frequency:
    default: 400000

  i2c-sda-falling-time-ns:
    default: 343

  i2c-scl-falling-time-ns:
    default: 203

  i2c-sda-hold-time-ns:
    default: 830

  i2c-scl-rising-time-ns:
    default: 365

  i2c-digital-filter-width-ns:
    default: 0

required:
  - compatible
  - reg
  - interrupts

unevaluatedProperties: false

examples:
  - |
    #include <dt-bindings/interrupt-controller/arm-gic.h>

    i2c@38b0000 {
      compatible = "hisilicon,ascend910-i2c";
      reg = <0x38b0000 0x10000>;
      interrupts = <GIC_SPI 120 IRQ_TYPE_LEVEL_HIGH>;
      i2c-sda-falling-time-ns = <56>;
      i2c-scl-falling-time-ns = <56>;
      i2c-sda-hold-time-ns = <56>;
      i2c-scl-rising-time-ns = <56>;
      i2c-digital-filter;
      i2c-digital-filter-width-ns = <0x0>;
      clocks = <&alg_clk>;
      clock-frequency = <400000>;
    };