5,375
edits
Changes
Jump to navigation
Jump to search
<div class="toccolours mw{{X100x-collapsible mw-collapsed"><div style="font-weight:bold;line-height:1.0; color:red;">Q1: Can't boot/recognize from NVMe SSD?</div><div class="mw-collapsible-content">[[File:Supported-SSD-1.jpg|thumb|right|300px|click it to zoom out]]A: Here are a few steps to help you troubleshoot some issues：#'''Only''' Raspberry Pi OS ('''Bookworm''') supports PCIe, Raspberry Pi OS bullseye is NOT supported, refer to https://www.raspberrypi.com/software/operating-systems/# Make sure that your OS configuration (<code>/boot/firmware/config.txt</code>) is completely correct: refer to the tutorial:[[NVMe SSD boot with the Raspberry Pi 5]] (will Continuously updating)# <span class="tb_red">Update the bootloader firmware to the last verson, refer to [[How to update eeprom firmware]], this is very important!!!</span> Make sure your upgrade is successful by running command '''vcgencmd bootloader_version'''# Add '''''PCIE_PROBE=1''''' to the eeprom, (Run '''sudo rpi-eeprom-config --edit''' command, then add this line, then press CTRL+O to write change to file, press CTRL+X to exit, then '''reboot''')# Make sure the SSD type you use is correct, only support <span class="tb_red">M.2 NVME (Sata) Key-M SSD '''</span>NOT support''' M.2 NGFF Key-B SSD. Refer to the right diagram: # Make sure the FPC cable is '''firmly and fully inserted''' into the PI 5, this is '''very important'''. For [[X1003]] shield, make sure the FPC cable '''direction''' is correct also.# <span class="tb_red_bold">For [[X1003]] shield, make sure the FPC cable '''direction''' is correct also. If an error still occurs, replace the FFC cable to test or purchase other PFC from here<ref><br/>Amazon US: https://www.amazon.com/dp/B0CXCTPQ2N<br/>Amazon DE: https://www.amazon.de/dp/B0CX4T993J<br/>Amazon UK: https://www.amazon.co.uk/dp/B0CX4T993J<br/>Amazon JP: https://www.amazon.co.jp/dp/B0CYGKN7G1</ref>to troubleshoot the issue.<span># Read [https://geekworm.com/community/forum/topic/120764/geekworm-x1001-for-raspberry-pi-5 this post] to get some help;# Although you can also boot from a SD card, Pi OS is required for the NVMe SSD to boot, DON'T forget Flash OS into NVMe SSD.# If you're flashing a fresh Pi OS into NVME SSD , DON'T forget to '''ENABLE PCIe''' to NVME SSD.# Run the '''lspci''' and'''lsblk''' command to check the NVMe SSD is recognized.<!--# If your SSD is old and has a '''DOS partition''', delete the DOS partition and repartition the SSD (feedback from buyer)--># Start thinking about SSD compatibility issues and try to switch to other brands of NVME SSDs.# Contact us at email: support@geekworm.com, and attached your product model, OS version (run '''uname -a''' to get), bootloader version (run '''vcgencmd bootloader_version''' to get) and order number :*'''How to get FPC Wires:'''<references />::<span class="tb_red">PS: The shortest length of the FPC cable here is '''30mm''', but the length of the FPC cable used by X1003 is only '''22mm'''. For X1003, this may not be perfect, but you can use these FPC cables to troubleshoot the issue. DON'T buy it if you mind.</span></div></div> <div class="toccolours mw-collapsible mw-collapsed"><div style="font-weight:bold;line-height:1.0;">Q2: Don't recognize / boot from NVME SSD?</div><div class="mw-collapsible-content">A: If you have '''enabled pcie''' and find that you still cannot boot from NVME SSD, please perform the following actions 1. Follow the picture below to check the version of [[X1001]] or [[X1000]] [[File:X1001-V1.1-IMG-6871-old-new.jpg|600px]] 2. If it is an '''Old Version''', refer to [[How to update eeprom firmware]] to update the firmware with '''pieeprom-2023-10-30.bin file'''. 3. If it is an '''New Version''', refer to [[How to update eeprom firmware]] to update the firmware to '''lasted version'''. 4. '''If you still have not solved the problem, please refer to the next FAQ:Q1'''</div></div> <div class="toccolours mw-collapsible mw-collapsed"><div style="font-weight:bold;line-height:1.0;">Q3: How to fix the 2230/2242/2260 SSD on X1001 or other PIP?</div><div class="mw-collapsible-content">A: The X1001 and other pips does not reserve the nut column to fix the 2230/2242/2260 SSD. Based on our test, you can secure the 2230/2242/2260 SSD using an M2*6mm screw and 2pcs M2 nuts. Place one M2 nut under the SSD, then use the M2*6mm screw and the other M2 nut to fasten the SSD. <SPAN class="tb_red_bold">PS: As of April 2024, we have added customized copper pillar in only '''X1001''' packing list to solve this issue, please refer to [[X1001#Packing_Lis | the packing list of X1001]].</SPAN></div></div> <div class="toccolours mw-collapsible mw-collapsed"><div style="font-weight:bold;line-height:1.0;">Q4. X1002 can't boot when install into the P580 case?</div><div class="mw-collapsible-content">A: Please check if the FPC cable touch the metal case make shorting when install X1002 into the metal case, you can stick the electrical tape on the case to prevent the ribbon FPC cable from contacting the case to test.</div></div> <div class="toccolours mw-collapsible mw-collapsed"><div style="font-weight:bold;line-height:1.0;">Q5: Which NVMe drives work with a Raspberry Pi 5?</div><div class="mw-collapsible-content">A: You can refer to the video: https://youtu.be/3mUgVTBmKio.</div></div>}}
-->
'''This tutorial<ref>Refer to [https://www.jeffgeerling.com/blog/2023/nvme-ssd-boot-raspberry-pi-5 NVM NVMe SSD boot with the Raspberry Pi 5]</ref> describes how to configure the Raspberry Pi OS on PI 5 to get pcie pip working'''
== Important Notes==
You also can refer to official documentatio:[https://www.raspberrypi.com/documentation/computers/raspberry-pi-5.html#enabling-pcie Enabling PCIe]
After reboot,use the '''lspci ''' command to display your PCIe devices
sudo lspci
The output is as follows, note that the content of the third line depends on the NVME control you are using.
0001:00:00.0 PCI bridge: Broadcom Inc. and subsidiaries Device 2712 (rev 21)
0001:01:00.0 Ethernet controller: Device 1de4:0001
* Make sure your NVME SSD is plugged into the PCIe PIP, not just connecting PCIe PIP to the Pi 5, otherwise the '''lspci''' will not be able to display any PCIe device.* <span class="tb_red">If your NVMe SSD is not recognized, updating the bootloader firmware is essential!</span>Refer to [[How to update eeprom firmware]] to update firmware or [[#FAQ]] Q1 to know more details.
==Flash OS onto NVME SSD==
# Choose the drive (connected through your adapter) to flash
# Click write (and set any options you'd like)
# Once you have finished flashing the OS, DON'T remove the nvme SSD. You need to change the config.txt in the root directory of the NVME SSD drive to '''enable pcie''' (<span class="tb_blue">edit config.txt and add 'dtparam=pciex1'</span> on the end of file), this is very important and too many people forget thismust [[#Enable PCIe]].
Then pull the NVMe drive, attach it to your Pi 5, and it should boot off it (with or without a microSD card inserted)—assuming you have the bootloader up to date and set the '''BOOT_ORDER''' appropriately!
<span class="tb_red">'''NOTE:'''</span>
If you are flashing a fresh Pi OS to NVME ssd, you must [[#Enable PCIe]]; but if you are COPY or CLONE an old Pi OS from SD card to NVME ssd, and you have already enabled pcie in the old Pi OS in advance, then you don't need to do enable pcie again!
==Set NVMe early in the boot order==
BOOT_ORDER=0xf416
- Press '''Ctrl-O''', then enter, to write the change to the file.
- Press '''Ctrl-X ''' to exit nano (the editor).
Read [https://www.raspberrypi.com/documentation/computers/raspberry-pi.html#BOOT_ORDER Raspberry Pi's documentation on BOOT_ORDER] for all the details. For now, the pertinent bit is the '''6''' at the end: that is what tells the Pi to attempt NVMe boot first!
<references />
==FAQ==
Return to [[X1000]] / [[X1001]] / [[X1002]] / [[X1003]]