From Geekworm Wiki
Jump to navigation Jump to search

X882 V2.0 Interface Indication
Connection diagram of GPIO connector and OLED screen
How to Power X882 V2.0&Pi4
X882 V2.0 Packing List
X882 V1.3 Packing List
X882 V1.3 Interface Indication
How to Power X882 V1.3&Pi4


This is an ultra-compact raspberry pi 4 dual 2.5 inch sata hdd/ssd storage board X882, it allows two 2.5" HDD/SSD to working at the same time with your Raspberry Pi 4. The SuperSpeed USB 3.0 port delivers a blistering data transfer rate of up to 5Gbps, letting you transfer a large amount of data in seconds.

X882 is not sold seperately, we have designed a case for X882 and sold it as a set, please refer to NASPi Gemini

Update History: In December 2022, the X882 V1.3 has been updated to X882 V2.0, remove the USB-C port on X882 V1.3, and update DC 5V power in to wide voltage input DC6-18V power in. The new version completely solve the issue of I/O error.

X882 V2.0 VS X882 V1.3



Raspberry Pi 4 Model B

Operating System

All Raspberry Pi operating systems

  • Ultra-compact storage solution for Raspberry Pi 4 - Dual 2.5" SATA HDD/SSD Shield
  • UASP supported ONLY, NOT support TRIM
  • Supports dual 2.5 SATA HDDs/SSDs working at the same time
  • Allows booting OS from your HDD/SSD for faster app opens, web serving and file copying
  • Function to power the RPI via XH2.54 only needing a single power supply
  • Integrated USB 3.1 Gen1 to SATA 6Gb/s bridge controllers
  • Integrated USB 3.1 Gen 1 Hub Controller
  • USB3.1 Gen1 5Gb/s connectivity offers plug-and-play functionality on your Raspberry Pi 4
  • Specially-made USB3.1 jumper to connect with Raspberry Pi - no additional cables needed
  • Specially-made X882-A1 connector to connect with Raspberry Pi - power Pi4 without additional cables
  • Ultra-compact design allows for ease of use two HDD/SSD with Raspberry Pi 4
  • LED blue indicator(HDD1,HDD2) indicates each drive status
  • Support Auto power on function
  • Support connecting 3pin PWM Fan
  • On board switch with LED light
  • Press button switch to turn on
  • Press button switch and hold for 1~2 seconds to reboot
  • Press button switch and hold for 3 seconds to implement safe shutdown
  • Press button switch and hold for more than 8 seconds to force shutdown
  • Power supply: 5.1Vdc +/-5% , ≥4A(For X882 V1.3 Version)
  • Power supply: 6-18Vdc +/-5% , ≥4A(For X882 V2.0 Version)
  • Ports & Connectors:
  1. DC jack - 5.5x2.1mm (DC5525 Jack is compatible with DC5521, you can also use the PSU with DC5525 Jack)
  2. Type-C port(Geekworm Type-C 5V 4A 20W power supply is recommended.)
  3. USB socket - USB 3.0 type A
  4. Power connector - 5V Out XH2.54 2-pin
  5. PWM Fan port 3-pin
  6. SATA socket - 7+15P Female
  • PCB Size 160mm x 107mm
Power Supply Requirement
  • Please use high quality power adapter, or the HDD/SSD may cannot be recognized.
  • Since X882 can install two 2.5-inch hard drives, it needs a high-quality power supply to provide enough current.
  • Due to installation restrictions, please pay attention to the thickness of 2.5" SSD/HDD.
  • We do not recommend using Samsung hard drives,Please use hard drives of other brands.
  • As with all SSDs, new SSD/HDD must be formatted before use.
  • Older SSD drives with less efficient flash media may not perform as well as newer drives.
  • A microSD card is required for forceing the Raspbian OS to use the HDD/SSD for its "root" partition
  • Additional USB3.0 A Male to A Male cable is required (not supplied)
  • Do not power your Raspberry Pi via the Pi's 40-pin header and Type-C USB socket at the same time.

Raid setup

Refer to How to Configure RAID Setting

Matching Metal Case

X882-C1 metal case with 4010 PWM cooling fan, you can refer to NASPi Gemini.

Packing List

  • 1 x X882 Dual 2.5 SATA HDD Shield(V2.0 or V1.3 Version)
  • 1 x X882-A1 Connector
  • 1 x USB Connector
  • 3 x Jumper Link Pitch 2.54mm
  • 4 x TM3 *6mm Screws (to fix 2.5" HDD/SSD)
  • 4 x F/F Spacer M2.5 *20mm
  • 8 x M2.5 * 5mm Screws

User Manual

Software guide, please refer to X-C1 Software


For better system compatibility & performance, Please format your HDD/SSD to Ext4 file system.


Some Tips


Q1. Why did the second HDD is not recognized?

You found only one hard drive if you select the RAID0/RAID1 mode.

Please exit the RAID mode and check again after entering the PM mode(clear raid mode).

More details please refer to Set CLEAR RAID mode of How to configure RAID

Q2: What to do if HDD/SSD is not recognized?

A: Please refer to How to View/Partition/Format/Mount HDD/SSD

Add your comment
Geekworm Wiki welcomes all comments. If you do not want to be anonymous, register or log in. It is free.

Anonymous user #7

7 hours 19 minutes ago
Score 0++
Do you think you will bring out an "Raspberry Pi 5" upgrade kit? Or do I have to buy a new gemini built for Pi5?

Anonymous user #6

3 days ago
Score 0++


I've got the version 1.3. I tried several settings but always got troubles when i try to upload a large amount of files: the SSD are disconnecting.

When i tried using seafile, this issue corrupted the database and i lost all the data. Now i'm only using Samba and at least the issue only stop the current upload and don't destroy previous data.

My question is: may it be related to the DC 5V power supply? I'm using a 5V10A supply, but maybe something is limited on the board?

How could i solve or circumvent this problem?

Anonymous user #6

3 days ago
Score 0++
Some precision: when I said "SSD are disconnecting": the Pi works well, and i got a message on raspbian specifying that the disks unmounted. when I reboot the pi, the drives are mounted back.

Anonymous user #5

4 months ago
Score 0++
Somehow my 1.3 seems to not start anymore when I install the script. Anyone experience this as well/has a solution?


4 months ago
Score 0++
Hello, I probably understand what you mean, may I ask if it cannot be turned on or the system cannot be started?

Anonymous user #4

4 months ago
Score 0++

Hi... Did anyone try to boot a Pi from SSD / HDD with this x882 board with just ONE drive attached? In this case my Pi do just NOTHING only if i attach a second drive to the board (no matter if there is something saved on the drive or not - just the hardware) the Pi will boot properly.

Can please anyone try this & give a report?


4 months ago
Score 0++
Hello, it can also work if only one driver is installed

Anonymous user #3

6 months ago
Score 0++
Could you please illustrate, or make a video to show, how to set the jumpers, I looked all over, and have no idea how read the raid mode schema.


5 months ago
Score 0++

Hi, you can refer to this: https://wiki...nterface.jpg

Let me introduce you roughly, RAID mode (PM/RAID 0/RAID 1/SPAN), when choosing one of the RAID modes, you need short or open A/B, you can choose one of the RAID modes, 1 .Short A&B (RAID 0) at the same time, or 2.open A and short B(RAID 1),3.open B and short A(SPAN),4.open A and B(PM) at the same time, hope it can help you, If you still don’t understand, you can send question to our email. Please contact us at support@geekworm.com. We will explain in more detail and solve the problem for you

Anonymous user #2

15 months ago
Score 0++

Hi - the X882 board has a blue LED for both HDD1 and HDD2. Just above those blue LEDs are smaller red LEDs.

What do those red LEDs indicate: a) when briefly flash b) when constantly on

Thank you!


15 months ago
Score 0++


It means HDD ERROR, HDD feedback SMART information is wrong, but if your HDD can work normally, you can ignore it.

Anonymous user #1

17 months ago
Score 0++
ETA for case X882-C1?


17 months ago
Score 0++


X882 board is not sold seperately, we sell it as a kit, which include X882 and a case and a PWM fan, pls refer to NASPi Gemini

Anonymous user #1

17 months ago
Score 0++
X835 compatible?


17 months ago
Score 0++


No compatible X835;metal case please refer toNASPi Gemini