Merge branch 'i2c/for-5.3' of git://git.kernel.org/pub/scm/linux/kernel/git/wsa/linux

What:		/sys/devices/platform/<i2c-demux-name>/available_masters

Date:		January 2016

KernelVersion:	4.6

Contact:	Wolfram Sang <wsa@the-dreams.de>

Contact:	Wolfram Sang <wsa+renesas@sang-engineering.com>

Description:

		Reading the file will give you a list of masters which can be

		selected for a demultiplexed bus. The format is

What:		/sys/devices/platform/<i2c-demux-name>/current_master

Date:		January 2016

KernelVersion:	4.6

Contact:	Wolfram Sang <wsa@the-dreams.de>

Contact:	Wolfram Sang <wsa+renesas@sang-engineering.com>

Description:

		This file selects/shows the active I2C master for a demultiplexed

		bus. It uses the <index> value from the file 'available_masters'.

# SPDX-License-Identifier: GPL-2.0

%YAML 1.2

---

$id: http://devicetree.org/schemas/i2c/allwinner,sun6i-a31-p2wi.yaml#

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

title: Allwinner A31 P2WI (Push/Pull 2 Wires Interface) Device Tree Bindings

maintainers:

  - Chen-Yu Tsai <wens@csie.org>

  - Maxime Ripard <maxime.ripard@bootlin.com>

allOf:

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

properties:

  compatible:

    const: allwinner,sun6i-a31-p2wi

  reg:

    maxItems: 1

  interrupts:

    maxItems: 1

  clocks:

    maxItems: 1

  resets:

    maxItems: 1

  clock-frequency:

    minimum: 1

    maximum: 6000000

required:

  - compatible

  - reg

  - interrupts

  - clocks

  - resets

# FIXME: We should set it, but it would report all the generic

# properties as additional properties.

# additionalProperties: false

examples:

  - |

    i2c@1f03400 {

        compatible = "allwinner,sun6i-a31-p2wi";

        reg = <0x01f03400 0x400>;

        interrupts = <0 39 4>;

        clocks = <&apb0_gates 3>;

        clock-frequency = <100000>;

        resets = <&apb0_rst 3>;

        #address-cells = <1>;

        #size-cells = <0>;

        axp221: pmic@68 {

            compatible = "x-powers,axp221";

            reg = <0x68>;

        };

    };

...

MediaTek MT7621/MT7628 I2C master controller

Required properties:

- compatible: Should be one of the following:

  - "mediatek,mt7621-i2c": for MT7621/MT7628/MT7688 platforms

- #address-cells: should be 1.

- #size-cells: should be 0.

- reg: Address and length of the register set for the device

- resets: phandle to the reset controller asserting this device in

          reset

  See ../reset/reset.txt for details.

Optional properties :

Example:

i2c: i2c@900 {

	compatible = "mediatek,mt7621-i2c";

	reg = <0x900 0x100>;

	#address-cells = <1>;

	#size-cells = <0>;

	resets = <&rstctrl 16>;

	reset-names = "i2c";

};

* Marvell MV64XXX I2C controller

Required properties :

 - reg             : Offset and length of the register set for the device

 - compatible      : Should be either:

                     - "allwinner,sun4i-a10-i2c"

                     - "allwinner,sun6i-a31-i2c"

                     - "marvell,mv64xxx-i2c"

                     - "marvell,mv78230-i2c"

                     - "marvell,mv78230-a0-i2c"

                       * Note: Only use "marvell,mv78230-a0-i2c" for a

                         very rare, initial version of the SoC which

                         had broken offload support.  Linux

                         auto-detects this and sets it appropriately.

 - interrupts      : The interrupt number

Optional properties :

 - clock-frequency : Desired I2C bus clock frequency in Hz. If not set the

default frequency is 100kHz

 - resets          : phandle to the parent reset controller. Mandatory

                     whenever you're using the "allwinner,sun6i-a31-i2c"

                     compatible.

 - clocks:	   : pointers to the reference clocks for this device, the

		     first one is the one used for the clock on the i2c bus,

		     the second one is the clock used to acces the registers

		     of the controller

 - clock-names	   : names of used clocks, mandatory if the second clock is

		     used, the name must be "core", and "reg" (the latter is

		     only for Armada 7K/8K).

Examples:

	i2c@11000 {

		compatible = "marvell,mv64xxx-i2c";

		reg = <0x11000 0x20>;

		interrupts = <29>;

		clock-frequency = <100000>;

	};

For the Armada XP:

	i2c@11000 {

		compatible = "marvell,mv78230-i2c", "marvell,mv64xxx-i2c";

		reg = <0x11000 0x100>;

		interrupts = <29>;

		clock-frequency = <100000>;

	};

For the Armada 7040:

	i2c@701000 {

		compatible = "marvell,mv78230-i2c";

		reg = <0x701000 0x20>;

		interrupts = <29>;

		clock-frequency = <100000>;

		clock-names = "core", "reg";

		clocks = <&core_clock>, <&reg_clock>;

	};

Device tree configuration for i2c-ocores

Required properties:

- compatible      : "opencores,i2c-ocores" or "aeroflexgaisler,i2cmst"

- compatible      : "opencores,i2c-ocores"

                    "aeroflexgaisler,i2cmst"

                    "sifive,fu540-c000-i2c", "sifive,i2c0"

                    For Opencore based I2C IP block reimplemented in

                    FU540-C000 SoC. Please refer to sifive-blocks-ip-versioning.txt

                    for additional details.

- reg             : bus address start and address range size of device

- interrupts      : interrupt number

- clocks          : handle to the controller clock; see the note below.

                    Mutually exclusive with opencores,ip-clock-frequency

- opencores,ip-clock-frequency: frequency of the controller clock in Hz;

- #size-cells     : should be <0>

Optional properties:

- interrupts      : interrupt number.

- clock-frequency : frequency of bus clock in Hz; see the note below.

                    Defaults to 100 KHz when the property is not specified

- reg-shift       : device register offsets are shifted by this value