X1009: Difference between revisions

(21 intermediate revisions by 6 users not shown)

Line 1:

[[File:X1009-V1.1-IMG-7801-Interface.jpg|thumb|right|X1009 V1.1]]

[[File:X1009-V1.1-IMG-7801-Interface.jpg|thumb|right|X1009 V1.1 Interface Diagram]]

[[File:X1009-IMG-0655.jpg|thumb|right|X1009 V1.1]]

[[File:X1009-V1.1-P4.jpg|thumb|right|X1009 V1.1]]

[[File:X1009-V1.1-P6.jpg|thumb|right|X1009 V1.1]]

[[File:X1009-V1.1-P5.jpg|thumb|right|X1009 V1.1 - How to connect SATA Powre Spillter cable]]

~~[[File:X1009-V1.1-P4.jpg|thumb|right|X1009 V1.1]]~~

[[File:X1009-V1.1.jpg|thumb|right|X1009 V1.1]]

[[File:X1009-V1.1-Bottom.jpg|thumb|right|X1009 V1.1]]

Line 15:

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 73:

Line 75:

* X1009 V1.1 PCIe to SATA shield x1

* SATA power spillter cable x1

* PCIe FFC 30mm x1

* PCIe FFC 30mm x2

* Screw pack x1

Line 82:

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 93:

Line 95:

Thanks for the video from HG Software: https://youtu.be/zD5zkPcbtaw

==Matching Case==

There is no dedicated case for X1009 installation. However, you can use the [https://geekworm.com/products/3-5-inch-hard-drive-mounting-rack 5-Layer 3.5-inch Hard Drive Mounting Rack Case with Cooling Fan for HDD/SSD mounting]. Additionally, the [https://geekworm.com/products/x880-a3 X880-A3 acrylic plate] can be used for HDD/SSD installation.

File:3.5-inch-HDD-Mounting-Rack-IMG-9337.jpg|3.5 inch HDD Mounting Rack

File:3.5-inch-HDD-Mounting-Rack-IMG-9499-size.jpg|3.5 inch HDD Mounting Rack

File:3.5-inch-HDD-Mounting-Rack-IMG-9490-Acc.jpg|3.5 inch HDD Mounting Rack

File:X880-A3-IMG-8367.jpg|none|X880-A3 Acrylic Plate

File:X880-A3-IMG-3627-Installation-Hole.jpg|X880-A3 Acrylic Plate

</gallery>

==FAQ==

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 103:

Line 116:

[[File:X1009-error-message.png|none]]

If the above error message appears, please check if the <code>lspci</code> command is running. If the PCIe device can be found, ~~please~~ check if the HDD is powered by X1009. If there is a problem with the data cable and the power supply of the HDD, a LINK DOWN error will appear.

If the above error message appears, please check if the <code>lspci</code> command is running. If the PCIe device can be found, then check if the HDD is powered by X1009.

If there is a problem with the data cable and the power supply of the HDD, a '''LINK DOWN''' error will appear.

</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 1: / Line 1: @@
 {{GD Template Impl}}
-[[File:X1009-V1.1-IMG-7801-Interface.jpg|thumb|right|X1009 V1.1]]
+[[File:X1009-V1.1-IMG-7801-Interface.jpg|thumb|right|X1009 V1.1 Interface Diagram]]
+[[File:X1009-IMG-0655.jpg|thumb|right|X1009 V1.1]]
+[[File:X1009-V1.1-P4.jpg|thumb|right|X1009 V1.1]]
 [[File:X1009-V1.1-P6.jpg|thumb|right|X1009 V1.1]]
 [[File:X1009-V1.1-P5.jpg|thumb|right|X1009 V1.1 - How to connect SATA Powre Spillter cable]]
-[[File:X1009-V1.1-P4.jpg|thumb|right|X1009 V1.1]]
 [[File:X1009-V1.1.jpg|thumb|right|X1009 V1.1]]
 [[File:X1009-V1.1-Bottom.jpg|thumb|right|X1009 V1.1]]
@@ Line 15: / 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 73: / Line 75: @@
 * X1009 V1.1 PCIe to SATA shield x1
 * SATA power spillter cable x1
-* PCIe FFC 30mm x1
+* PCIe FFC 30mm x2
 * Screw pack x1
@@ Line 82: / 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 93: / Line 95: @@
 Thanks for the video from HG Software: https://youtu.be/zD5zkPcbtaw
 {{#ev:youtube|https://youtu.be/zD5zkPcbtaw}}
+==Matching Case==
+There is no dedicated case for X1009 installation. However, you can use the [https://geekworm.com/products/3-5-inch-hard-drive-mounting-rack 5-Layer 3.5-inch Hard Drive Mounting Rack Case with Cooling Fan for HDD/SSD mounting]. Additionally, the [https://geekworm.com/products/x880-a3 X880-A3 acrylic plate] can be used for HDD/SSD installation.
+<gallery>
+File:3.5-inch-HDD-Mounting-Rack-IMG-9337.jpg|3.5 inch HDD Mounting Rack
+File:3.5-inch-HDD-Mounting-Rack-IMG-9499-size.jpg|3.5 inch HDD Mounting Rack
+File:3.5-inch-HDD-Mounting-Rack-IMG-9490-Acc.jpg|3.5 inch HDD Mounting Rack
+File:X880-A3-IMG-8367.jpg|none|X880-A3 Acrylic Plate
+File:X880-A3-IMG-3627-Installation-Hole.jpg|X880-A3 Acrylic Plate
+</gallery>
 ==FAQ==
 <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 103: / Line 116: @@
 [[File:X1009-error-message.png|none]]
-If the above error message appears, please check if the <code>lspci</code> command is running. If the PCIe device can be found, please check if the HDD is powered by X1009. If there is a problem with the data cable and the power supply of the HDD, a LINK DOWN error will appear.
+If the above error message appears, please check if the <code>lspci</code> command is running. If the PCIe device can be found, then check if the HDD is powered by X1009.
+If there is a problem with the data cable and the power supply of the HDD, a '''LINK DOWN''' error will appear.
+</div>
 </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  -->