diff mbox

[2/3] dt-bindings: add Silicon Image SiI8620 bridge bindings

Message ID 1449582546-18667-3-git-send-email-a.hajda@samsung.com (mailing list archive)
State New, archived
Headers show

Commit Message

Andrzej Hajda Dec. 8, 2015, 1:49 p.m. UTC
SiI8620 transmitter converts eTMDS/HDMI signal to MHL 3.0. It is controlled
via I2C bus.

Signed-off-by: Andrzej Hajda <a.hajda@samsung.com>
---
 .../bindings/video/bridge/sil-sii8620.txt          | 34 ++++++++++++++++++++++
 1 file changed, 34 insertions(+)
 create mode 100644 Documentation/devicetree/bindings/video/bridge/sil-sii8620.txt

Comments

Rob Herring (Arm) Dec. 9, 2015, 3:47 a.m. UTC | #1
On Tue, Dec 08, 2015 at 02:49:05PM +0100, Andrzej Hajda wrote:
> SiI8620 transmitter converts eTMDS/HDMI signal to MHL 3.0. It is controlled
> via I2C bus.
> 
> Signed-off-by: Andrzej Hajda <a.hajda@samsung.com>
> ---
>  .../bindings/video/bridge/sil-sii8620.txt          | 34 ++++++++++++++++++++++
>  1 file changed, 34 insertions(+)
>  create mode 100644 Documentation/devicetree/bindings/video/bridge/sil-sii8620.txt
> 
> diff --git a/Documentation/devicetree/bindings/video/bridge/sil-sii8620.txt b/Documentation/devicetree/bindings/video/bridge/sil-sii8620.txt
> new file mode 100644
> index 0000000..29f3f35
> --- /dev/null
> +++ b/Documentation/devicetree/bindings/video/bridge/sil-sii8620.txt
> @@ -0,0 +1,34 @@
> +Silicon Image SiI8620 bridge bindings

Bridging what to what?

> +
> +Required properties:
> +	- compatible: "sil,sii8620"
> +	- reg: i2c address of the bridge
> +	- cvcc10-supply: Digital Core Supply Voltage (1.0V)
> +	- iovcc18-supply: I/O Supply Voltage (1.8V)
> +	- int-gpios: gpio specifier of INT pin

Assuming INT means interrupt, this should use interrupts property.

> +	- reset-gpios: gpio specifier of RESET pin
> +	- clocks, clock-names: specification and name of "xtal" clock
> +	- video interfaces: Device node can contain video interface port
> +			    node for HDMI encoder according to [1].
> +
> +[1]: Documentation/devicetree/bindings/media/video-interfaces.txt
> +
> +Example:
> +	sii8620@39 {
> +		reg = <0x39>;
> +		compatible = "sil,sii8620";
> +		cvcc10-supply = <&ldo36_reg>;
> +		iovcc18-supply = <&ldo34_reg>;
> +		int-gpio = <&gpf0 2 0>;
> +		reset-gpio = <&gpv7 0 0>;
> +		clocks = <&pmu_system_controller 0>;
> +		clock-names = "xtal";

> +		assigned-clocks = <&pmu_system_controller 0>;
> +		assigned-clock-parents = <&xxti>;

These aren't listed in the doc.

> +
> +		port {
> +			mhl_to_hdmi: endpoint {
> +				remote-endpoint = <&hdmi_to_mhl>;
> +			};
> +		};

I'd like to see this have a port to a connector node, too. Possibly
that can come later.

Rob
Andrzej Hajda Dec. 9, 2015, 9:58 a.m. UTC | #2
Hi Rob,

Thanks for review.


On 12/09/2015 04:47 AM, Rob Herring wrote:
> On Tue, Dec 08, 2015 at 02:49:05PM +0100, Andrzej Hajda wrote:
>> SiI8620 transmitter converts eTMDS/HDMI signal to MHL 3.0. It is controlled
>> via I2C bus.
>>
>> Signed-off-by: Andrzej Hajda <a.hajda@samsung.com>
>> ---
>>  .../bindings/video/bridge/sil-sii8620.txt          | 34 ++++++++++++++++++++++
>>  1 file changed, 34 insertions(+)
>>  create mode 100644 Documentation/devicetree/bindings/video/bridge/sil-sii8620.txt
>>
>> diff --git a/Documentation/devicetree/bindings/video/bridge/sil-sii8620.txt b/Documentation/devicetree/bindings/video/bridge/sil-sii8620.txt
>> new file mode 100644
>> index 0000000..29f3f35
>> --- /dev/null
>> +++ b/Documentation/devicetree/bindings/video/bridge/sil-sii8620.txt
>> @@ -0,0 +1,34 @@
>> +Silicon Image SiI8620 bridge bindings
> Bridging what to what?

HDMI/MHL, I will add it in next iteration.

>
>> +
>> +Required properties:
>> +	- compatible: "sil,sii8620"
>> +	- reg: i2c address of the bridge
>> +	- cvcc10-supply: Digital Core Supply Voltage (1.0V)
>> +	- iovcc18-supply: I/O Supply Voltage (1.8V)
>> +	- int-gpios: gpio specifier of INT pin
> Assuming INT means interrupt, this should use interrupts property.

OK.

>
>> +	- reset-gpios: gpio specifier of RESET pin
>> +	- clocks, clock-names: specification and name of "xtal" clock
>> +	- video interfaces: Device node can contain video interface port
>> +			    node for HDMI encoder according to [1].
>> +
>> +[1]: Documentation/devicetree/bindings/media/video-interfaces.txt
>> +
>> +Example:
>> +	sii8620@39 {
>> +		reg = <0x39>;
>> +		compatible = "sil,sii8620";
>> +		cvcc10-supply = <&ldo36_reg>;
>> +		iovcc18-supply = <&ldo34_reg>;
>> +		int-gpio = <&gpf0 2 0>;
>> +		reset-gpio = <&gpv7 0 0>;
>> +		clocks = <&pmu_system_controller 0>;
>> +		clock-names = "xtal";
>> +		assigned-clocks = <&pmu_system_controller 0>;
>> +		assigned-clock-parents = <&xxti>;
> These aren't listed in the doc.

I will remove them.

>
>> +
>> +		port {
>> +			mhl_to_hdmi: endpoint {
>> +				remote-endpoint = <&hdmi_to_mhl>;
>> +			};
>> +		};
> I'd like to see this have a port to a connector node, too. Possibly
> that can come later.

MHL standard is connector agnostic, usually MHL wires are routed
via multi-function microUSB connector, which can serve also for
USB/charging/UART....
There is additional logic to determine which cable is currently
connected, usually
implemented by extcon driver.
I am not sure if/how it should be represented in DT. What do you think
about it?

Regards
Andrzej

>
> Rob
>
>
Rob Herring (Arm) Dec. 9, 2015, 9:54 p.m. UTC | #3
On Wed, Dec 9, 2015 at 3:58 AM, Andrzej Hajda <a.hajda@samsung.com> wrote:
> Hi Rob,
>
> Thanks for review.
>
>
> On 12/09/2015 04:47 AM, Rob Herring wrote:
>> On Tue, Dec 08, 2015 at 02:49:05PM +0100, Andrzej Hajda wrote:
>>> SiI8620 transmitter converts eTMDS/HDMI signal to MHL 3.0. It is controlled
>>> via I2C bus.
>>>
>>> Signed-off-by: Andrzej Hajda <a.hajda@samsung.com>
>>> ---
>>>  .../bindings/video/bridge/sil-sii8620.txt          | 34 ++++++++++++++++++++++
>>>  1 file changed, 34 insertions(+)
>>>  create mode 100644 Documentation/devicetree/bindings/video/bridge/sil-sii8620.txt
>>>
>>> diff --git a/Documentation/devicetree/bindings/video/bridge/sil-sii8620.txt b/Documentation/devicetree/bindings/video/bridge/sil-sii8620.txt

[...]

>>> +            port {
>>> +                    mhl_to_hdmi: endpoint {
>>> +                            remote-endpoint = <&hdmi_to_mhl>;
>>> +                    };
>>> +            };
>> I'd like to see this have a port to a connector node, too. Possibly
>> that can come later.
>
> MHL standard is connector agnostic, usually MHL wires are routed
> via multi-function microUSB connector, which can serve also for
> USB/charging/UART....
> There is additional logic to determine which cable is currently
> connected, usually
> implemented by extcon driver.
> I am not sure if/how it should be represented in DT. What do you think
> about it?

Probably all the more reason to have a connector defined, but for
muxed connectors I'm not sure how we should handle them and having
both drm connectors and extcon connectors is a problem. Like I said,
it can come later.

Rob
diff mbox

Patch

diff --git a/Documentation/devicetree/bindings/video/bridge/sil-sii8620.txt b/Documentation/devicetree/bindings/video/bridge/sil-sii8620.txt
new file mode 100644
index 0000000..29f3f35
--- /dev/null
+++ b/Documentation/devicetree/bindings/video/bridge/sil-sii8620.txt
@@ -0,0 +1,34 @@ 
+Silicon Image SiI8620 bridge bindings
+
+Required properties:
+	- compatible: "sil,sii8620"
+	- reg: i2c address of the bridge
+	- cvcc10-supply: Digital Core Supply Voltage (1.0V)
+	- iovcc18-supply: I/O Supply Voltage (1.8V)
+	- int-gpios: gpio specifier of INT pin
+	- reset-gpios: gpio specifier of RESET pin
+	- clocks, clock-names: specification and name of "xtal" clock
+	- video interfaces: Device node can contain video interface port
+			    node for HDMI encoder according to [1].
+
+[1]: Documentation/devicetree/bindings/media/video-interfaces.txt
+
+Example:
+	sii8620@39 {
+		reg = <0x39>;
+		compatible = "sil,sii8620";
+		cvcc10-supply = <&ldo36_reg>;
+		iovcc18-supply = <&ldo34_reg>;
+		int-gpio = <&gpf0 2 0>;
+		reset-gpio = <&gpv7 0 0>;
+		clocks = <&pmu_system_controller 0>;
+		clock-names = "xtal";
+		assigned-clocks = <&pmu_system_controller 0>;
+		assigned-clock-parents = <&xxti>;
+
+		port {
+			mhl_to_hdmi: endpoint {
+				remote-endpoint = <&hdmi_to_mhl>;
+			};
+		};
+	};