X1009: Difference between revisions

(8 intermediate revisions by 2 users not shown)

Line 16:

* Older SATA drives with less efficient flash media may not perform as well as newer drives

* New SATA HDDs/SSDs are not partitioned and will need to be both partitioned and formatted when first connected to the Raspberry Pi before they will be accessed in the Explorer.

* <span style="color:red;">Disks not detected after Raspberry Pi 5 Kernel upgrade</span>, please refer to <span style="color:red; font-weight:bold;">[[#FAQ]]-Q2</span>.

==Overview==

Line 83:

Line 84:

==User Manual==

* Dimensions source file (DXF): [[File:X1009-V1.0.dxf]] - You can view it with [https://viewer.autodesk.com/ Autodesk Viewer] online

===Hardware===

[[File: X1009v1.1-dwg.png | 700px]]

[[File:X-1009-V1.1-install.jpg | 700px]]

Line 108:

Line 109:

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:

Line 122:

</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 - Recommand)''</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 - For reference, '''NOT''' tested by us)''</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.

:Thanks to users who reported issues in the comments. Your feedback helps us improve and update product documents.

</div>

<~~comments~~ />

<comment-streams id="main" />

@@ Line 16: / Line 16: @@
 * Older SATA drives with less efficient flash media may not perform as well as newer drives
 * New SATA HDDs/SSDs are not partitioned and will need to be both partitioned and formatted when first connected to the Raspberry Pi before they will be accessed in the Explorer.
+* <span style="color:red;">Disks not detected after Raspberry Pi 5 Kernel upgrade</span>, please refer to <span style="color:red; font-weight:bold;">[[#FAQ]]-Q2</span>.
 ==Overview==
@@ Line 83: / Line 84: @@
 ==User Manual==
 * Dimensions source file (DXF): [[File:X1009-V1.0.dxf]] - You can view it with [https://viewer.autodesk.com/ Autodesk Viewer] online
 ===Hardware===
 [[File: X1009v1.1-dwg.png | 700px]]
 [[File:X-1009-V1.1-install.jpg | 700px]]
@@ Line 108: / Line 109: @@
 <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 122: @@
 </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 - Recommand)''</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 - For reference, '''NOT''' tested by us)''</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.
+:Thanks to users who reported issues in the comments. Your feedback helps us improve and update product documents.
+</div>
+</div>
 <!--Add review function! -->
-<comments />
+<comment-streams id="main" />
 <!--Please choose the  -->