[PATCH v13 3/3] dt-bindings: drm/bridge: Document sn65dsi86 bridge bindings
spanda at codeaurora.org
spanda at codeaurora.org
Mon Jul 16 06:04:47 UTC 2018
On 2018-06-29 17:31, Andrzej Hajda wrote:
> On 27.06.2018 11:57, Sandeep Panda wrote:
>> Document the bindings used for the sn65dsi86 DSI to eDP bridge.
>>
>> Changes in v1:
>> - Rephrase the dt-binding descriptions to be more inline with
>> existing
>> bindings (Andrzej Hajda).
>> - Add missing dt-binding that are parsed by corresponding driver
>> (Andrzej Hajda).
>>
>> Changes in v2:
>> - Remove edp panel specific dt-binding entries. Only keep bridge
>> specific entries (Sean Paul).
>> - Remove custom-modes dt entry since its usage is removed from driver
>> also (Sean Paul).
>> - Remove is-pluggable dt entry since this will not be needed anymore
>> (Sean Paul).
>>
>> Changes in v3:
>> - Remove irq-gpio dt entry and instead populate is an interrupt
>> property (Rob Herring).
>>
>> Changes in v4:
>> - Add link to bridge chip datasheet (Stephen Boyd)
>> - Add vpll and vcc regulator supply bindings (Stephen Boyd)
>> - Add ref clk optional dt binding (Stephen Boyd)
>> - Add gpio-controller optional dt binding (Stephen Boyd)
>>
>> Changes in v5:
>> - Use clock property to specify the input refclk (Stephen Boyd).
>> - Update gpio cell and pwm cell numbers (Stephen Boyd).
>>
>> Changes in v6:
>> - Add property to mention the lane mapping scheme and polarity
>> inversion
>> (Stephen Boyd).
>>
>> Changes in v7:
>> - Detail description of lane mapping scheme dt property (Andrzej
>> Hajda/ Rob Herring).
>> - Removed HDP gpio binding, since the bridge uses IRQ signal to
>> determine HPD, and IRQ property is already documented in binding.
>>
>> Changes in v8:
>> - Removed unnecessary explanation of lane mapping and polarity dt
>> property, since these are already explained in
>> media/video-interface
>> dt binidng (Rob Herring).
>>
>> Changes in v9:
>> - Avoid putting re-definition of lane mapping and polarity dt binding
>> (Rob Herring).
>>
>> Changes in v10:
>> - Use interrupts-extended property instead of interrupts to specify
>> interrupt line (Andrzej Hajda).
>> - Move data-lanes and lane-polarity property example to proper place
>> (Andrzej Hajda).
>>
>> Changes in v11:
>> - Add a property for suspend gpio function of GPIO1 pin on bridge
>> chip
>> (Stephen Boyd).
>>
>> Signed-off-by: Sandeep Panda <spanda at codeaurora.org>
>> ---
>> .../bindings/display/bridge/ti,sn65dsi86.txt | 89
>> ++++++++++++++++++++++
>> 1 file changed, 89 insertions(+)
>> create mode 100644
>> Documentation/devicetree/bindings/display/bridge/ti,sn65dsi86.txt
>>
>> diff --git
>> a/Documentation/devicetree/bindings/display/bridge/ti,sn65dsi86.txt
>> b/Documentation/devicetree/bindings/display/bridge/ti,sn65dsi86.txt
>> new file mode 100644
>> index 000000000000..6787f5f2c7cd
>> --- /dev/null
>> +++
>> b/Documentation/devicetree/bindings/display/bridge/ti,sn65dsi86.txt
>> @@ -0,0 +1,89 @@
>> +SN65DSI86 DSI to eDP bridge chip
>> +--------------------------------
>> +
>> +This is the binding for Texas Instruments SN65DSI86 bridge.
>> +http://www.ti.com/general/docs/lit/getliterature.tsp?genericPartNumber=sn65dsi86&fileType=pdf
>> +
>> +Required properties:
>> +- compatible: Must be "ti,sn65dsi86"
>> +- reg: i2c address of the chip, 0x2d as per datasheet
>> +- enable-gpios: OF device-tree gpio specification for bridge_en pin
>> (active high)
>> +
>> +- vccio-supply: A 1.8V supply that powers up the digital IOs.
>> +- vpll-supply: A 1.8V supply that powers up the displayport PLL.
>> +- vcca-supply: A 1.2V supply that powers up the analog circuits.
>> +- vcc-supply: A 1.2V supply that powers up the digital core.
>> +
>> +Optional properties:
>> +- interrupts-extended: Specifier for the SN65DSI86 interrupt line.
>> +
>> +- ddc-i2c-bus: phandle of the I2C controller used for DDC EDID
>> probing
>
> One more thing, I have overlooked: why do you need this property? eDP
> panels passes its EDID via DP-AUX channel, do you have some strange
> panel?
OK i will remove this property in next patchset.
I have looked for the panel you want to add in this patchset -
> "Innolux TV123WAM" and found nothing, there is TV123WAM made by BOE (it
> is the same panel??) and it reports EDID via DP-AUX, no I2C lines for
> DDC.
>
> Regards
> Andrzej
>
>> +
>> +- gpio-controller: Marks the device has a GPIO controller.
>> +- #gpio-cells : Should be two. The first cell is the pin number
>> and
>> + the second cell is used to specify flags.
>> + See ../../gpio/gpio.txt for more information.
>> +- #pwm-cells : Should be one. See ../../pwm/pwm.txt for description
>> of
>> + the cell formats.
>> +
>> +- clock-names: should be "refclk"
>> +- clocks: Specification for input reference clock. The reference
>> + clock rate must be 12 MHz, 19.2 MHz, 26 MHz, 27 MHz or 38.4 MHz.
>> +
>> +- data-lanes: See ../../media/video-interface.txt
>> +- lane-polarities: See ../../media/video-interface.txt
>> +
>> +- suspend-gpios: OF device-tree specification for GPIO1 pin on bridge
>> (active low)
>> +
>> +Required nodes:
>> +This device has two video ports. Their connections are modelled using
>> the
>> +OF graph bindings specified in
>> Documentation/devicetree/bindings/graph.txt.
>> +
>> +- Video port 0 for DSI input
>> +- Video port 1 for eDP output
>> +
>> +Example
>> +-------
>> +
>> +edp-bridge at 2d {
>> + compatible = "ti,sn65dsi86";
>> + #address-cells = <1>;
>> + #size-cells = <0>;
>> + reg = <0x2d>;
>> +
>> + enable-gpios = <&msmgpio 33 GPIO_ACTIVE_HIGH>;
>> + suspend-gpios = <&msmgpio 34 GPIO_ACTIVE_LOW>;
>> +
>> + interrupts-extended = <&gpio3 4 IRQ_TYPE_EDGE_FALLING>;
>> +
>> + vccio-supply = <&pm8916_l17>;
>> + vcca-supply = <&pm8916_l6>;
>> + vpll-supply = <&pm8916_l17>;
>> + vcc-supply = <&pm8916_l6>;
>> +
>> + clock-names = "refclk";
>> + clocks = <&input_refclk>;
>> +
>> + ports {
>> + #address-cells = <1>;
>> + #size-cells = <0>;
>> +
>> + port at 0 {
>> + reg = <0>;
>> +
>> + edp_bridge_in: endpoint {
>> + remote-endpoint = <&dsi_out>;
>> + };
>> + };
>> +
>> + port at 1 {
>> + reg = <1>;
>> +
>> + edp_bridge_out: endpoint {
>> + data-lanes = <2 1 3 0>;
>> + lane-polarities = <0 1 0 1>;
>> + remote-endpoint = <&edp_panel_in>;
>> + };
>> + };
>> + };
>> +}
More information about the dri-devel
mailing list