kernel_samsung_msm8974/Documentation/devicetree/bindings/i2c/i2c-qup.txt

Qualcomm I2C controller

Required properties:

 - reg : Offset and length of the register region(s) for the device
	 For GSBI based controller, GSBI and QUP regions are expected
	 For BLSP based controller, QUP region offset is expected
 - reg-names : Register region name(s) referenced in reg above
	 BLSP based controller expects QUP region name ("qup_phys_addr")
	 GSBI controller expects QUP region name and GSBI region name
	 ("gsbi_qup_i2c_addr")
 - compatible : should be "qcom,i2c-qup"
 - cell-index : I2C bus number used for this controller
 - interrupts : QUP core interrupt(s). Core may have 1 error interrupt and flags
	 for input/output service, or 3 separate interrupts for the 3 services
 - interrupt-names: QUP core interrupt name(s) referenced in interrupts above
	 Expected interrupt resource name(s) are: "qup_err_irq", "qup_in_irq",
	 and "qup_out_irq"
 - qcom,i2c-bus-freq : desired I2C bus clock frequency is Hz

Optional property:
 - qcom,i2c-src-freq : Frequency of the source clocking this bus in Hz.
		      Divider value is set based on soruce-frequency and
		      desired I2C bus frequency. If this value is not
		      provided, the source clock is assumed to be running
		      at 19.2 MHz.
 - qcom,scl-gpio     : I2C clock GPIO number. Required for execution of bus
		      recovery procedure.
 - qcom,sda-gpio     : I2C data  GPIO number. Required for execution of bus
		      recovery procedure.
 - qcom,active-only  : Vote for core clock when the application processor goes
		      to active state and remove that vote when it goes to idle
		      state. This flag may improve service time of first i2c
		      request at the expense of power consumption. When this
		      entry is not present, voting is done by the runtime-pm
		      callbacks.
 - qcom,master-id    : Master endpoint number used for voting on clocks using
		      bus-scaling driver.
 - qcom,clk-ctl-xfer : When present, the clocks's state (prepare_enable/
		      unprepare_disable) is controlled by i2c-transaction's
		      begining and ending. When missing, the clock's state
		      is controlled by runtime-pm events.

Example:
	i2c_3: i2c@f9966000 {
		cell-index = <3>;
		compatible = "qcom,i2c-qup";
		reg = <0xf9966000 0x1000>;
		reg-names = "qup_phys_addr";
		interrupts = <0 104 0>;
		interrupt-names = "qup_err_intr";
		qcom,i2c-bus-freq = <100000>;
		qcom,i2c-src-freq = <24000000>;
		qcom,clk-ctl-xfer;
		qcom,scl-gpio = <&msmgpio 7 0>;
		qcom,sda-gpio = <&msmgpio 6 0>;
	};