X1009 - Revision history

Lisa: /* User Manual */

2026-06-01T06:44:29Z

User Manual

← Older revision		Revision as of 14:44, 1 June 2026
Line 84:		Line 84:
	==User Manual==		==User Manual==
	* Dimensions source file (DXF): [[File:X1009-V1.0.dxf]] - You can view it with [https://viewer.autodesk.com/ Autodesk Viewer] online		* Dimensions source file (DXF): [[File:X1009-V1.0.dxf]] - You can view it with [https://viewer.autodesk.com/ Autodesk Viewer] online

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

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

Admin: Replace with

2026-05-27T02:13:34Z

Replace <comments/> with <comment-streams />

← Older revision		Revision as of 10:13, 27 May 2026
Line 162:		Line 162:

	<!--Add review function! -->		<!--Add review function! -->
	<comment-streams />		<comment-streams id="main" />

	<!--Please choose the -->		<!--Please choose the -->

Admin: Replace with

2026-05-26T12:07:41Z

Replace <comments/> with <comment-streams />

← Older revision		Revision as of 20:07, 26 May 2026
Line 162:		Line 162:

	<!--Add review function! -->		<!--Add review function! -->
	<~~comments~~ />		<comment-streams />

	<!--Please choose the -->		<!--Please choose the -->

Ruby: /* FAQ */

2026-05-22T04:02:53Z

FAQ

← Older revision		Revision as of 12:02, 22 May 2026
Line 137:		Line 137:

	'''3. Configuration'''		'''3. Configuration'''
	:3-1. Manual Configuration Fix <span style="color:red;">''(Solution 1 - Recommand)''</span>		:3.1 Manual Configuration Fix <span style="color:red;">''(Solution 1 - Recommand)''</span>
	::Open the config file via terminal command:		::Open the config file via terminal command:
	::<code>sudo nano /boot/firmware/config.txt</code>		::<code>sudo nano /boot/firmware/config.txt</code>
Line 146:		Line 146:
	::Multiple dtoverlay entries are allowed, just write each on separate lines.		::Multiple dtoverlay entries are allowed, just write each on separate lines.
	::Save and exit the editor.		::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>		: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:		::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>		::<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>

Ruby: /* FAQ */

2026-05-22T03:59:58Z

FAQ

← Older revision		Revision as of 11:59, 22 May 2026
Line 130:		Line 130:

	'''1. Root Cause'''		'''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.		: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'''		'''2. Affected System & Kernel Versions'''
Line 137:		Line 137:

	'''3. Configuration'''		'''3. Configuration'''
	:3-1. Manual Configuration Fix <span style="color:red;">''(Solution 1)''</span>		:3-1. Manual Configuration Fix <span style="color:red;">''(Solution 1 - Recommand)''</span>
	::Open the config file via terminal command:		::Open the config file via terminal command:
	::<code>sudo nano /boot/firmware/config.txt</code>		::<code>sudo nano /boot/firmware/config.txt</code>
Line 146:		Line 146:
	::Multiple dtoverlay entries are allowed, just write each on separate lines.		::Multiple dtoverlay entries are allowed, just write each on separate lines.
	::Save and exit the editor.		::Save and exit the editor.
	:3-2. One-click Command to Add Configuration <span style="color:red;">''(Solution 2)''</span>		: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:		::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>		::<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>
Line 154:		Line 154:
	: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.		: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.		'''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>
	</div>		</div>

Ruby: /* FAQ */

2026-05-22T03:51:33Z

FAQ

← Older revision		Revision as of 11:51, 22 May 2026
Line 152:		Line 152:

	'''4. Final Required Operation'''		'''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.		: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.		'''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.

Ruby at 03:38, 22 May 2026

2026-05-22T03:38:53Z

← Older revision		Revision as of 11:38, 22 May 2026
Line 16:		Line 16:
	* Older SATA drives with less efficient flash media may not perform as well as newer drives		* 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.		* 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 FAQ-Q2		* <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==		==Overview==

Ruby: /* Important Notes */

2026-05-22T03:35:15Z

Important Notes

← Older revision		Revision as of 11:35, 22 May 2026
Line 16:		Line 16:
	* Older SATA drives with less efficient flash media may not perform as well as newer drives		* 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.		* 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 FAQ-Q2

	==Overview==		==Overview==

Ruby: /* FAQ */

2026-05-22T03:31:30Z

FAQ

@@ 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>

Abby at 04:33, 9 March 2026

2026-03-09T04:33:14Z

← Older revision		Revision as of 12:33, 9 March 2026
Line 1:		Line 1:
	{{GD Template Impl}}		{{GD Template Impl}}
	[[File:X1009-V1.1-IMG-7801-Interface.jpg\|thumb\|right\|X1009 V1.1 Interface Diagram]]		[[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-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-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.jpg\|thumb\|right\|X1009 V1.1]]
	[[File:X1009-V1.1-Bottom.jpg\|thumb\|right\|X1009 V1.1]]		[[File:X1009-V1.1-Bottom.jpg\|thumb\|right\|X1009 V1.1]]

← Older revision		Revision as of 12:33, 9 March 2026
Line 1:		Line 1:
	{{GD Template Impl}}		{{GD Template Impl}}
	[[File:X1009-V1.1-IMG-7801-Interface.jpg\|thumb\|right\|X1009 V1.1 Interface Diagram]]		[[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-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-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.jpg\|thumb\|right\|X1009 V1.1]]
	[[File:X1009-V1.1-Bottom.jpg\|thumb\|right\|X1009 V1.1]]		[[File:X1009-V1.1-Bottom.jpg\|thumb\|right\|X1009 V1.1]]