X1009: Difference between revisions

Line 108:

Q1:Display error message: ata1: '''SATA link down''' (SStatus 0 SControl 300)

Q1: Display error message: ata1: '''SATA link down''' (SStatus 0 SControl 300)

</div>

Line 121:

</div>

Q2: Disks not detected after Raspberry Pi 5 Kernel upgrade?

</div>

A:

'''1. Root Cause'''

:The problem is triggered by ''upstream Linux kernel code changes''. The JMicron JMB585 controller chip equipped on the SATA hat has potential data corruption risks when running under 64-bit DMA mode on certain platforms. Therefore, the kernel forces this chip to work with 32-bit DMA mode. Without matching configuration adjustment, the system cannot probe and identify SATA disks via AHCI protocol normally.

'''2. Affected System & Kernel Versions'''

:*Kernel 6.12.87 and above: Raspberry Pi OS Bookworm, OpenMediaVault 7 (OMV7)

:*Kernel 6.18.29 and above: Raspberry Pi OS Trixie, OpenMediaVault 8 (OMV8)

'''3. Configuration'''

:3-1. Manual Configuration Fix <span style="color:red;">''(Solution 1)''</span>

::Open the config file via terminal command:

::<code>sudo nano /boot/firmware/config.txt</code>

::Add the below overlay parameter on a new line, place it right under your existing PCIe setting:

::<code>dtoverlay=pcie-32bit-dma-pi5</code>

::*Put it below <code>dtparam=pciex1</code> for standard ''PCIe mode''

::*Put it below <code>dtparam=pciex1_gen=3</code> for ''PCIe Gen3 mode''

::Multiple dtoverlay entries are allowed, just write each on separate lines.

::Save and exit the editor.

:3-2. One-click Command to Add Configuration <span style="color:red;">''(Solution 2)''</span>

::Run this command directly in terminal to automatically insert the required setting:

::<code>grep -qxF 'dtoverlay=pcie-32bit-dma-pi5' /boot/firmware/config.txt || sudo sed -i -zE 's/(.*\ndtparam=[^\n]*pciex1[^\n]*)/\1\ndtoverlay=pcie-32bit-dma-pi5/' /boot/firmware/config.txt</code>

:<span style="color:red;">NOTE: Please select one from the two solutions.</span>

'''4. Final Required Operation'''

Reboot your Raspberry Pi 5 device after modifying the configuration. The new setting will take effect during startup, and the SATA hat will detect disks properly again.

'''5. Plus:''' Please refer to the [https://forum.openmediavault.org/index.php?thread/59049-psa-rpi5-users-of-the-radxa-sata-hat-now-need-to-use-dtoverlay-pcie-32bit-dma-pi/ original link]. The chip equipped on X1009 is the same as that of the author's Radxa Penta SATA HAT, both adopting JMicron JMB585.

</div>

@@ Line 108: / Line 108: @@
 <div class="toccolours mw-collapsible mw-collapsed">
 <div style="font-weight:bold;line-height:1.0; color:red;">
-Q1:Display error message: ata1: '''SATA link down''' (SStatus 0 SControl 300)
+Q1: Display error message: ata1: '''SATA link down''' (SStatus 0 SControl 300)
 </div>
 <div class="mw-collapsible-content">
@@ Line 121: / Line 121: @@
 </div>
+<div class="toccolours mw-collapsible mw-collapsed">
+<div style="font-weight:bold;line-height:1.0; color:red;">
+Q2: Disks not detected after Raspberry Pi 5 Kernel upgrade?
+</div>
+<div class="mw-collapsible-content">
+A:
+'''1. Root Cause'''
+:The problem is triggered by ''upstream Linux kernel code changes''. The JMicron JMB585 controller chip equipped on the SATA hat has potential data corruption risks when running under 64-bit DMA mode on certain platforms. Therefore, the kernel forces this chip to work with 32-bit DMA mode. Without matching configuration adjustment, the system cannot probe and identify SATA disks via AHCI protocol normally.
+'''2. Affected System & Kernel Versions'''
+:*Kernel 6.12.87 and above: Raspberry Pi OS Bookworm, OpenMediaVault 7 (OMV7)
+:*Kernel 6.18.29 and above: Raspberry Pi OS Trixie, OpenMediaVault 8 (OMV8)
+'''3. Configuration'''
+:3-1. Manual Configuration Fix <span style="color:red;">''(Solution 1)''</span>
+::Open the config file via terminal command:
+::<code>sudo nano /boot/firmware/config.txt</code>
+::Add the below overlay parameter on a new line, place it right under your existing PCIe setting:
+::<code>dtoverlay=pcie-32bit-dma-pi5</code>
+::*Put it below <code>dtparam=pciex1</code> for standard ''PCIe mode''
+::*Put it below <code>dtparam=pciex1_gen=3</code> for ''PCIe Gen3 mode''
+::Multiple dtoverlay entries are allowed, just write each on separate lines.
+::Save and exit the editor.
+:3-2. One-click Command to Add Configuration <span style="color:red;">''(Solution 2)''</span>
+::Run this command directly in terminal to automatically insert the required setting:
+::<code>grep -qxF 'dtoverlay=pcie-32bit-dma-pi5' /boot/firmware/config.txt || sudo sed -i -zE 's/(.*\ndtparam=[^\n]*pciex1[^\n]*)/\1\ndtoverlay=pcie-32bit-dma-pi5/' /boot/firmware/config.txt</code>
+:<span style="color:red;">NOTE: Please select one from the two solutions.</span>
+'''4. Final Required Operation'''
+Reboot your Raspberry Pi 5 device after modifying the configuration. The new setting will take effect during startup, and the SATA hat will detect disks properly again.
+'''5. Plus:''' Please refer to the [https://forum.openmediavault.org/index.php?thread/59049-psa-rpi5-users-of-the-radxa-sata-hat-now-need-to-use-dtoverlay-pcie-32bit-dma-pi/ original link]. The chip equipped on X1009 is the same as that of the author's Radxa Penta SATA HAT, both adopting JMicron JMB585.
+</div>
+</div>