Skip to content
Open
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
Original file line number Diff line number Diff line change
Expand Up @@ -729,6 +729,103 @@
CONFIG_DRM_TIDSS=y
CONFIG_PHY_CADENCE_DPHY=y

Enabling DPI splash

Check warning on line 732 in source/linux/Foundational_Components/U-Boot/UG-Splash-Screen.rst

View workflow job for this annotation

GitHub Actions / vale

[vale] reported by reviewdog 🐶 [RedHat.Headings] Use sentence-style capitalization in 'Enabling DPI splash'. Raw Output: {"message":"[RedHat.Headings] Use sentence-style capitalization in 'Enabling DPI splash'.","location":{"path":"source/linux/Foundational_Components/U-Boot/UG-Splash-Screen.rst","range":{"start":{"line":732,"column":1},"end":{"line":732,"column":20}}},"severity":"INFO","code":{"value":"RedHat.Headings","url":"https://redhat-documentation.github.io/vale-at-red-hat/reference-guide.html#headings"}}
-------------------
The DPI display path should be enabled and recognized during U-Boot's display pipeline detection.

Check warning on line 734 in source/linux/Foundational_Components/U-Boot/UG-Splash-Screen.rst

View workflow job for this annotation

GitHub Actions / vale

[vale] reported by reviewdog 🐶 [RedHat.PassiveVoice] 'be enabled' is passive voice. In general, use active voice. Consult the style guide for acceptable use of passive voice. Raw Output: {"message":"[RedHat.PassiveVoice] 'be enabled' is passive voice. In general, use active voice. Consult the style guide for acceptable use of passive voice.","location":{"path":"source/linux/Foundational_Components/U-Boot/UG-Splash-Screen.rst","range":{"start":{"line":734,"column":29},"end":{"line":734,"column":39}}},"severity":"INFO","code":{"value":"RedHat.PassiveVoice","url":"https://redhat-documentation.github.io/vale-at-red-hat/reference-guide.html#passive-voice"}}

**Enabling DPI output in tidss_drv.c**

U-Boot's ``tidss`` driver detects and initializes display pipelines in
``tidss_enable_pipeline_components()`` (:file:`drivers/video/tidss/tidss_drv.c`) by

Check warning on line 739 in source/linux/Foundational_Components/U-Boot/UG-Splash-Screen.rst

View workflow job for this annotation

GitHub Actions / vale

[vale] reported by reviewdog 🐶 [RedHat.Slash] Use either 'or' or 'and' in 'drivers/video' Raw Output: {"message":"[RedHat.Slash] Use either 'or' or 'and' in 'drivers/video'","location":{"path":"source/linux/Foundational_Components/U-Boot/UG-Splash-Screen.rst","range":{"start":{"line":739,"column":48},"end":{"line":739,"column":61}}},"severity":"WARNING","code":{"value":"RedHat.Slash","url":"https://redhat-documentation.github.io/vale-at-red-hat/reference-guide.html#slash"}}
matching the device-tree node name of each port's remote endpoint against known
patterns: ``"oldi"`` and ``"dsi"``/``"dsi_host"``. A DPI panel connected
directly to the DSS video port does not match any of these patterns, so add a ``"dpi"`` branch alongside the

Check warning on line 742 in source/linux/Foundational_Components/U-Boot/UG-Splash-Screen.rst

View workflow job for this annotation

GitHub Actions / vale

[vale] reported by reviewdog 🐶 [RedHat.Definitions] Define acronyms and abbreviations (such as 'DSS') on first occurrence if they're likely to be unfamiliar. Raw Output: {"message":"[RedHat.Definitions] Define acronyms and abbreviations (such as 'DSS') on first occurrence if they're likely to be unfamiliar.","location":{"path":"source/linux/Foundational_Components/U-Boot/UG-Splash-Screen.rst","range":{"start":{"line":742,"column":17},"end":{"line":742,"column":20}}},"severity":"INFO","code":{"value":"RedHat.Definitions","url":"https://redhat-documentation.github.io/vale-at-red-hat/reference-guide.html#definitions"}}
existing interfaces:

.. code-block:: c

} else if (strstr(ofnode_get_name(remote_port), "dpi")) {
priv->bridge_dev = NULL;
priv->active_hw_vps[active_pipelines++] = hw_videoport;
break;
}

.. note::

The match is performed against the node name of the remote port's parent

Check warning on line 755 in source/linux/Foundational_Components/U-Boot/UG-Splash-Screen.rst

View workflow job for this annotation

GitHub Actions / vale

[vale] reported by reviewdog 🐶 [RedHat.PassiveVoice] 'is performed' is passive voice. In general, use active voice. Consult the style guide for acceptable use of passive voice. Raw Output: {"message":"[RedHat.PassiveVoice] 'is performed' is passive voice. In general, use active voice. Consult the style guide for acceptable use of passive voice.","location":{"path":"source/linux/Foundational_Components/U-Boot/UG-Splash-Screen.rst","range":{"start":{"line":755,"column":14},"end":{"line":755,"column":26}}},"severity":"INFO","code":{"value":"RedHat.PassiveVoice","url":"https://redhat-documentation.github.io/vale-at-red-hat/reference-guide.html#passive-voice"}}
(``ofnode_get_name(remote_port)``), not against the panel's ``compatible``
property. The panel node in the device tree must include ``dpi`` in its
node name/label for this branch to trigger.

Check warning on line 758 in source/linux/Foundational_Components/U-Boot/UG-Splash-Screen.rst

View workflow job for this annotation

GitHub Actions / vale

[vale] reported by reviewdog 🐶 [RedHat.Slash] Use either 'or' or 'and' in 'name/label' Raw Output: {"message":"[RedHat.Slash] Use either 'or' or 'and' in 'name/label'","location":{"path":"source/linux/Foundational_Components/U-Boot/UG-Splash-Screen.rst","range":{"start":{"line":758,"column":9},"end":{"line":758,"column":19}}},"severity":"WARNING","code":{"value":"RedHat.Slash","url":"https://redhat-documentation.github.io/vale-at-red-hat/reference-guide.html#slash"}}

**Adding a DPI panel node in the device tree**

Add a panel node whose name contains ``dpi`` and connect it to the DSS video port

Check warning on line 762 in source/linux/Foundational_Components/U-Boot/UG-Splash-Screen.rst

View workflow job for this annotation

GitHub Actions / vale

[vale] reported by reviewdog 🐶 [RedHat.Definitions] Define acronyms and abbreviations (such as 'DSS') on first occurrence if they're likely to be unfamiliar. Raw Output: {"message":"[RedHat.Definitions] Define acronyms and abbreviations (such as 'DSS') on first occurrence if they're likely to be unfamiliar.","location":{"path":"source/linux/Foundational_Components/U-Boot/UG-Splash-Screen.rst","range":{"start":{"line":762,"column":68},"end":{"line":762,"column":71}}},"severity":"INFO","code":{"value":"RedHat.Definitions","url":"https://redhat-documentation.github.io/vale-at-red-hat/reference-guide.html#definitions"}}

Check warning on line 762 in source/linux/Foundational_Components/U-Boot/UG-Splash-Screen.rst

View workflow job for this annotation

GitHub Actions / vale

[vale] reported by reviewdog 🐶 [RedHat.SimpleWords] Use simple language. Consider using 'has' rather than 'contains'. Raw Output: {"message":"[RedHat.SimpleWords] Use simple language. Consider using 'has' rather than 'contains'.","location":{"path":"source/linux/Foundational_Components/U-Boot/UG-Splash-Screen.rst","range":{"start":{"line":762,"column":29},"end":{"line":762,"column":37}}},"severity":"INFO","code":{"value":"RedHat.SimpleWords","url":"https://redhat-documentation.github.io/vale-at-red-hat/reference-guide.html#simple-words"}}
endpoint via ``remote-endpoint``, providing the panel's ``panel-timing`` properties.

Check warning on line 763 in source/linux/Foundational_Components/U-Boot/UG-Splash-Screen.rst

View workflow job for this annotation

GitHub Actions / vale

[vale] reported by reviewdog 🐶 [RedHat.TermsSuggestions] Depending on the context, consider using 'through', 'by', 'from', 'on', or 'by using' rather than 'via'. Raw Output: {"message":"[RedHat.TermsSuggestions] Depending on the context, consider using 'through', 'by', 'from', 'on', or 'by using' rather than 'via'.","location":{"path":"source/linux/Foundational_Components/U-Boot/UG-Splash-Screen.rst","range":{"start":{"line":763,"column":10},"end":{"line":763,"column":13}}},"severity":"INFO","code":{"value":"RedHat.TermsSuggestions","url":"https://redhat-documentation.github.io/vale-at-red-hat/reference-guide.html#terms-suggestions"}}
Below is an example device-tree snippet for adding a DPI panel node:

.. code-block:: dts

/ {
panel_dpi0: panel-dpi {
bootph-all;
compatible = "simple-panel";
status = "okay";

port {
bootph-all;
panel_dpi0_in: endpoint {
bootph-all;
remote-endpoint = <&dss_vp0_endpoint>;
};
};

panel-timing {
bootph-all;
clock-frequency = <9200000>;
hactive = <800>;
vactive = <480>;
hfront-porch = <8>;
hback-porch = <4>;
hsync-len = <41>;
vfront-porch = <4>;
vback-porch = <2>;
vsync-len = <10>;
hsync-active = <0>;
vsync-active = <0>;
de-active = <1>;
pixelclk-active = <1>;
};
};
};

&dss0 {
bootph-all;
status = "okay";

ports {
bootph-all;
#address-cells = <1>;
#size-cells = <0>;

port@0 {
bootph-all;
reg = <0>;
dss_vp0_endpoint: endpoint {
bootph-all;
remote-endpoint = <&panel_dpi0_in>;
};
};
};
};

The ``panel-timing`` values must match the panel's datasheet, and should be kept
consistent with the ``panel-timing`` values used in the Linux kernel device tree for
the same panel so that U-Boot and Linux drive the panel with identical timings across
the splash-to-kernel handoff.

Once all of the pipeline detection and device-tree changes are in place, the rest of
the splash screen flow is identical to the flow described in the previous sections.

Check warning on line 827 in source/linux/Foundational_Components/U-Boot/UG-Splash-Screen.rst

View workflow job for this annotation

GitHub Actions / vale

[vale] reported by reviewdog 🐶 [RedHat.SimpleWords] Use simple language. Consider using 'same' rather than 'identical'. Raw Output: {"message":"[RedHat.SimpleWords] Use simple language. Consider using 'same' rather than 'identical'.","location":{"path":"source/linux/Foundational_Components/U-Boot/UG-Splash-Screen.rst","range":{"start":{"line":827,"column":27},"end":{"line":827,"column":36}}},"severity":"INFO","code":{"value":"RedHat.SimpleWords","url":"https://redhat-documentation.github.io/vale-at-red-hat/reference-guide.html#simple-words"}}

Disable splash screen
---------------------

Expand Down
Loading