From 0574ba1f4b46fe690264216ed0a2cfa63f00c49f Mon Sep 17 00:00:00 2001 From: Nhut Nguyen Date: Tue, 17 Dec 2024 14:02:24 +0700 Subject: [PATCH] doc: Add troubleshooting for RZ/G3S-SMARC Add troubleshooting for HW resource conflicts between Linux and Zephyr Signed-off-by: Nhut Nguyen --- boards/renesas/rzg3s_smarc/doc/index.rst | 24 ++++++++++++++++++++++++ 1 file changed, 24 insertions(+) diff --git a/boards/renesas/rzg3s_smarc/doc/index.rst b/boards/renesas/rzg3s_smarc/doc/index.rst index e442a836ee4..fa6a3705720 100644 --- a/boards/renesas/rzg3s_smarc/doc/index.rst +++ b/boards/renesas/rzg3s_smarc/doc/index.rst @@ -219,6 +219,30 @@ version. :goals: build flash :compact: +Troubleshooting +=============== + +Linux and Zephyr application should not share SoC HW resources otherwise it will cause HW corruption and unpredictable behavior. +Therefore, HW resources assigned to Zephyr application must be disabled in Linux. + +The below patch shows how to prevent Linux from configuring SCIF1 which is used by Zephyr. + +.. code-block:: diff + + diff --git a/arch/arm64/boot/dts/renesas/rzg3s-smarc.dtsi b/arch/arm64/boot/dts/renesas/rzg3s-smarc.dtsi + index f01801b18e8a..d9f9a0a2bb08 100644 + --- a/arch/arm64/boot/dts/renesas/rzg3s-smarc.dtsi + +++ b/arch/arm64/boot/dts/renesas/rzg3s-smarc.dtsi + @@ -347,7 +347,7 @@ &scif1 { + pinctrl-0 = <&scif1_pins>; + pinctrl-names = "default"; + uart-has-rtscts; + - status = "okay"; + + status = "disabled"; + }; + #elif SPDIF_SEL == SW_ON + &spdif { + References **********