- Home
- CONNECT Home Page
- Axelera Assist
- Metis M.2
- Trying to setup rpi5 with metis m2
Trying to setup rpi5 with metis m2
- May 6, 2025
- 29 replies
- 652 views
29 replies
- Axelera Team
- May 6, 2025
Hello
Thanks for reaching us.
I tested both Ubuntu 24.04 and Raspberry Pi OS, but remember that at the moment you need to use Docker container for this.
The only setting you need to do in config.txt is:
Enable PCIe Gen3 by following the instructions in:
If you use a M.2 HAT different to the official Raspberry Pi HAT, you might need to add something extra. But that always appears in the documentation from the HAT’s manufacturer.
You can find all the details in https://support.axelera.ai/hc/en-us/articles/26362016484114-Bring-up-Voyager-SDK-in-Raspberry-Pi-5. I’d highly recommend to go through it :)
Hope this info helps,
Victor
- Axelera Team
- May 6, 2025
Welcome on board! 😃. What kind of project are you working on
- Author
- Cadet
- May 6, 2025
I'm using the official Raspberry Pi M.2 HAT+ (M-key) from RaspberryPi.dk with a Raspberry Pi 5. I’ve added the following line to config.txt:
dtparam=pciex1_gen=3
I also followed the Docker-based installation steps provided by Axelera. However, the Metis card does not appear (e.g., no /dev/metis-0:86:0 device is created).
The same m2 metis board does work correctly on my Gigabyte G292-Z20 server, where I get the following output:
refreshing pcie and firmware 0000:86:00.0 : Axelera AI Metis AIPU (rev 02) Device 0: metis-0:86:0 board_type=m2 fwver='v1.2.5' clock=800MHz(0-3:800MHz) mvm=0-3:100% Installation complete. To activate the environment...
However, I tried the board on other systems:
-
Jetson Orin Nano
-
Odroid M1
-
Raspberry Pi 5 with M.2 HAT+
-
Lenovo M910q
And on all of these, I get an error like:
Failed to: refreshing pcie and firmware
My Question:
Could there be different versions of the Metis M.2 card (e.g., firmware, revision, compatibility) that cause this issue on ARM and some x86 devices? Or are there specific PCIe, power, or BIOS/firmware requirements that must be met for the card to initialize correctly?
- Author
- Cadet
- May 6, 2025
Welcome on board! 😃. What kind of project are you working on
Great to be here!
I’m building observation system with two sensors RGB + THERMAL. Doing custom object detection and object segmentation with YOLO
- Axelera Team
- May 6, 2025
Hello
Thanks for sharing the info.
Just to confirm, you are using Docker container, right?
Let’s take these actions:
- In Raspberry Pi 5 can you try doing a reboot and see if it helps?
-
@pautu227 can you try following the troubleshooting guide in https://support.axelera.ai/hc/en-us/articles/26261515755538-PCIe-Troubleshooting-Guide and share with us the output you see for the different suggestions in the guide? Let’s start with the Raspberry Pi 5 with the following sections in the guide (can you also specify which OS you are using?):- Check lspci output
- Update PCI IDs
- Remove and rescan devices with axdevice Voyager SDK tool
- Check the driver is loaded
- Check Firmware version of your Metis card [uses triton_multi_ctx]
- Check Board Controller version of your Metis card [uses triton_multi_ctx]
Thanks beforehand,
Victor
- Author
- Cadet
- May 6, 2025
Setup:
Raspberry pi 5b 4gb
Official Raspberry pi m2.hat+
Official power supply
Debian Bookworm 64bit
USB Boot from SSD


1. Reboot doesn’t help
2.1 lspci output:
0002:00:00.0 PCI bridge: Broadcom Inc. and subsidiaries BCM2712 PCIe Bridge (rev 21)
0002:01:00.0 Ethernet controller: Raspberry Pi Ltd RP1 PCIe 2.0 South Bridge
paulius@raspberrypi:~ $ lspci -tv
-+-[0000:00]-
\-[0002:00]---00.0-[01]----00.0 Raspberry Pi Ltd RP1 PCIe 2.0 South Bridge
if I connect nvme drive - disk drive is present but no Metis present.
lspci -tv
-+-[0000:00]-
+-[0001:00]---00.0-[01]----00.0 KIOXIA Corporation NVMe SSD Controller BG4 (DRAM-less)
\-[0002:00]---00.0-[01]----00.0 Raspberry Pi Ltd RP1 PCIe 2.0 South Bridge
Any ideas?
- Author
- Cadet
- May 7, 2025
Setup:
Raspberry pi 5b 4gb
Official Raspberry pi m2.hat+
Official power supply
Debian Bookworm 64bit
USB Boot from SSD


1. Reboot doesn’t help
2.1 lspci output:
0002:00:00.0 PCI bridge: Broadcom Inc. and subsidiaries BCM2712 PCIe Bridge (rev 21)
0002:01:00.0 Ethernet controller: Raspberry Pi Ltd RP1 PCIe 2.0 South Bridge
paulius@raspberrypi:~ $ lspci -tv
-+-[0000:00]-
\-[0002:00]---00.0-[01]----00.0 Raspberry Pi Ltd RP1 PCIe 2.0 South Bridge
if I connect nvme drive - disk drive is present but no Metis present.
lspci -tv
-+-[0000:00]-
+-[0001:00]---00.0-[01]----00.0 KIOXIA Corporation NVMe SSD Controller BG4 (DRAM-less)
\-[0002:00]---00.0-[01]----00.0 Raspberry Pi Ltd RP1 PCIe 2.0 South Bridge
Any ideas?
- Axelera Team
- May 7, 2025
Hi
sudo lspci -vv | grep -i 'LnkSta'… should give you something like:
LnkSta: Speed 8GT/s (ok), Width x1 (ok)If it says 5GT/s instead of 8GT/s, it’s still in Gen2 apparently. Worth a quick test?
- Axelera Team
- May 7, 2025
Hi
We have tested Raspberry Pi 5 on Raspberry Pi OS and on Ubuntu 24.04 both with Docker.
We have tested booting from SD cards but not from SSD.
I would recommend you to:
- Remove SSD
- Get a micro SD card
- Use RPi imager app to image the card with RPi OS
- Then follow the guide in https://support.axelera.ai/hc/en-us/articles/26362016484114-Bring-up-Voyager-SDK-in-Raspberry-Pi-5 step by step. I recommend you to keep track of all your steps for debugging purposes.
This approach have been tested different times, so we expect it to work. If this works for you then we can test two things:
- Debian on SD card
- Boot from SSD but with RPi OS
That way we can see if the issue comes from using Debian or from booting from SSD.
Kind regards,
Victor
- Ensign
- May 11, 2025
i`ve got on this rpi gen2 of pcie1 activated
Hi
sudo lspci -vv | grep -i 'LnkSta' … should give you something like:
LnkSta: Speed 8GT/s (ok), Width x1 (ok) If it says 5GT/s instead of 8GT/s, it’s still in Gen2 apparently. Worth a quick test?
LnkSta: Speed 5GT/s, Width x1
LnkSta2: Current De-emphasis Level: -6dB, EqualizationComplete- EqualizationPhase1-
LnkSta: Speed 5GT/s, Width x1
LnkSta2: Current De-emphasis Level: -6dB, EqualizationComplete- EqualizationPhase1-
LnkSta: Speed 2.5GT/s, Width x1
LnkSta2: Current De-emphasis Level: -3.5dB, EqualizationComplete- EqualizationPhase1-
LnkSta: Speed 2.5GT/s, Width x1
LnkSta2: Current De-emphasis Level: -3.5dB, EqualizationComplete- EqualizationPhase1-
LnkSta: Speed 5GT/s, Width x4
LnkSta2: Current De-emphasis Level: -6dB, EqualizationComplete- EqualizationPhase1-
LnkSta: Speed 5GT/s, Width x4
LnkSta2: Current De-emphasis Level: -6dB, EqualizationComplete- EqualizationPhase1-
lspci
lspci
0001:00:00.0 PCI bridge: Broadcom Inc. and subsidiaries BCM2712 PCIe Bridge (rev 30)
0001:01:00.0 PCI bridge: ASMedia Technology Inc. ASM1182e 2-Port PCIe x1 Gen2 Packet Switch
0001:02:03.0 PCI bridge: ASMedia Technology Inc. ASM1182e 2-Port PCIe x1 Gen2 Packet Switch
0001:02:07.0 PCI bridge: ASMedia Technology Inc. ASM1182e 2-Port PCIe x1 Gen2 Packet Switch
0002:00:00.0 PCI bridge: Broadcom Inc. and subsidiaries BCM2712 PCIe Bridge (rev 30)
0002:01:00.0 Ethernet controller: Raspberry Pi Ltd RP1 PCIe 2.0 South Bridge
- Ensign
- May 11, 2025
I found this interesting “Prefetchable memory behind bridge: [disabled] [64-bit]”
how to enable? could it be that the prefetch memory must be enabled?
lspci -v
0001:01:00.0 PCI bridge: ASMedia Technology Inc. ASM1182e 2-Port PCIe x1 Gen2 Packet Switch (prog-if 00 [Normal decode])
Subsystem: ASMedia Technology Inc. ASM1182e 2-Port PCIe x1 Gen2 Packet Switch
Flags: bus master, fast devsel, latency 0, IRQ 38
Bus: primary=01, secondary=02, subordinate=04, sec-latency=0
Memory behind bridge: 00000000-000fffff [disabled] [32-bit]
Capabilities: [50] MSI: Enable- Count=1/1 Maskable- 64bit+
Capabilities: [78] Power Management version 3
Capabilities: [80] Express Upstream Port, MSI 00
Capabilities: [c0] Subsystem: ASMedia Technology Inc. ASM1182e 2-Port PCIe x1 Gen2 Packet Switch
Capabilities: [100] Virtual Channel
Capabilities: [200] Advanced Error Reporting
Capabilities: [300] Vendor Specific Information: ID=0000 Rev=0 Len=c00 <?>
Kernel driver in use: pcieport
0001:02:03.0 PCI bridge: ASMedia Technology Inc. ASM1182e 2-Port PCIe x1 Gen2 Packet Switch (prog-if 00 [Normal decode])
Subsystem: ASMedia Technology Inc. ASM1182e 2-Port PCIe x1 Gen2 Packet Switch
Flags: fast devsel, IRQ 40
Bus: primary=02, secondary=03, subordinate=03, sec-latency=0
I/O behind bridge: [disabled] [32-bit]
Memory behind bridge: [disabled] [32-bit]
Prefetchable memory behind bridge: [disabled] [64-bit]
Capabilities: [50] MSI: Enable- Count=1/1 Maskable- 64bit+
Capabilities: [78] Power Management version 3
Capabilities: [80] Express Downstream Port (Slot+), MSI 00
Capabilities: [c0] Subsystem: ASMedia Technology Inc. ASM1182e 2-Port PCIe x1 Gen2 Packet Switch
Capabilities: [100] Virtual Channel
Capabilities: [200] Advanced Error Reporting
Kernel driver in use: pcieport
0001:02:07.0 PCI bridge: ASMedia Technology Inc. ASM1182e 2-Port PCIe x1 Gen2 Packet Switch (prog-if 00 [Normal decode])
Subsystem: ASMedia Technology Inc. ASM1182e 2-Port PCIe x1 Gen2 Packet Switch
Flags: fast devsel, IRQ 40
Bus: primary=02, secondary=04, subordinate=04, sec-latency=0
I/O behind bridge: [disabled] [32-bit]
Memory behind bridge: [disabled] [32-bit]
Prefetchable memory behind bridge: [disabled] [64-bit]
Capabilities: [50] MSI: Enable- Count=1/1 Maskable- 64bit+
Capabilities: [78] Power Management version 3
Capabilities: [80] Express Downstream Port (Slot+), MSI 00
Capabilities: [c0] Subsystem: ASMedia Technology Inc. ASM1182e 2-Port PCIe x1 Gen2 Packet Switch
Capabilities: [100] Virtual Channel
Capabilities: [200] Advanced Error Reporting
Kernel driver in use: pcieport
- Ensign
- May 11, 2025
one guess I got … has it enough power?
sudo rpi-eeprom-config --edit[all]
PCIE_PROBE=1
BOOT_UART=1
BOOT_ORDER=0xf461
PSU_MAX_CURRENT=5000and in /boot/firmware/config.txt at the bottom
dtparam=pciex1_gen2
dtparam=pciex1_gen=2
dtparam=nvmesudo reboot
- Axelera Team
- May 12, 2025
Morning
dtparam=pciex1_gen2
dtparam=pciex1_gen=2
dtparam=nvme sudo reboot
… it looks like it might be using PCIe gen2, which is the native option on the Raspberry Pi, but the Metis needs gen3. I think you might have already activated that, if I remember from another post? But maybe the HAT is being detected as a gen2 device, and is forcing the whole chain to gen2?
You might be right about power, as well. An RPi5 without a HAT or SSDs can be flakey without enough juice! 😅 Are you using the official RPi PSU? Those are usually powerful enough.
- Axelera Team
- May 12, 2025
Hi
- Ensign
- May 12, 2025
Morning
dtparam=pciex1_gen2
dtparam=pciex1_gen=2
dtparam=nvme sudo reboot
… it looks like it might be using PCIe gen2, which is the native option on the Raspberry Pi, but the Metis needs gen3. I think you might have already activated that, if I remember from another post? But maybe the ASMedia ASM1182e switch is being detected as a gen2 device, and is forcing the whole chain to gen2?
You might be right about power, as well. An RPi5 without a HAT or SSDs can be flakey without enough juice! 😅 Are you using the official RPi PSU? Those are usually powerful enough.
yes I´ve tested with gen3 in another post … but now moved to another pi case with the GeeekPi X1004 hat what actually got gen2 see: https://wiki.geekworm.com/X1004
it´s hard to find a hat with gen3 support when it´s official not supported
so I switched to gen2 … see: https://docs.sunfounder.com/projects/pironman5/de/latest/ what support gen3 official
- Axelera Team
- May 12, 2025
I wonder if that’s the issue, and why the M.2 has disappeared? I think Gen3 is a requirement as far as the Metis is concerned. As a test, are you able to boot up without the X1004, and see if reactivating at least bring the Metis back into play?
- Ensign
- May 12, 2025
I‘ve tested on the gen3 case … but no luck
• uninsalled driver
• ready set to pcie1_gen3
• complete Powers off
• followed instructions what told
• installed dkms driver
• finaly reboot
but it does Not shine up on lspci
Only
0002:00:00.0 PCI bridge: Broadcom Inc. and subsidiaries BCM2712 PCIe Bridge (rev 30)
0002:01:00.0 Ethernet controller: Raspberry Pi Ltd RP1 PCIe 2.0 South Shine up
should I rma this Card?
tomorrow comes a second one so I can Test if it is the m.2 Modul … if the First Modul is broken so I Must rma the Card … if the second m.2 too dont shine up then is it a config Problem within the Raspberry Pi OS
- Axelera Team
- May 12, 2025
Hmm, looks like you’ve ticked all the boxes, yeah. Perhaps if we see what happens tomorrow with the second card, we’ll have a better idea whether it’s a config or power issue, or if it’s a card fault. 👍
Thanks for keeping us update on the progress, by the way!
- Ensign
- May 13, 2025
both now in the m.2 hat
and again …. m.2 hat cannot be found
0002:00:00.0 PCI bridge: Broadcom Inc. and subsidiaries BCM2712 PCIe Bridge (rev 30)
0002:01:00.0 Ethernet controller: Raspberry Pi Ltd RP1 PCIe 2.0 South Bridgethis could be a power issue
with one aipu
0001:00:00.0 PCI bridge: Broadcom Inc. and subsidiaries BCM2712 PCIe Bridge (rev 30)
0001:01:00.0 PCI bridge: ASMedia Technology Inc. ASM1182e 2-Port PCIe x1 Gen2 Packet Switch
0001:02:03.0 PCI bridge: ASMedia Technology Inc. ASM1182e 2-Port PCIe x1 Gen2 Packet Switch
0001:02:07.0 PCI bridge: ASMedia Technology Inc. ASM1182e 2-Port PCIe x1 Gen2 Packet Switch
0002:00:00.0 PCI bridge: Broadcom Inc. and subsidiaries BCM2712 PCIe Bridge (rev 30)
0002:01:00.0 Ethernet controller: Raspberry Pi Ltd RP1 PCIe 2.0 South Bridgenope
0001:00:00.0 PCI bridge: Broadcom Inc. and subsidiaries BCM2712 PCIe Bridge (rev 30)
0001:01:00.0 PCI bridge: ASMedia Technology Inc. ASM1182e 2-Port PCIe x1 Gen2 Packet Switch
0001:02:03.0 PCI bridge: ASMedia Technology Inc. ASM1182e 2-Port PCIe x1 Gen2 Packet Switch
0001:02:07.0 PCI bridge: ASMedia Technology Inc. ASM1182e 2-Port PCIe x1 Gen2 Packet Switch
0001:03:00.0 Non-Volatile memory controller: Micron/Crucial Technology P310 NVMe PCIe SSD (DRAM-less) (rev 01)
0002:00:00.0 PCI bridge: Broadcom Inc. and subsidiaries BCM2712 PCIe Bridge (rev 30)
0002:01:00.0 Ethernet controller: Raspberry Pi Ltd RP1 PCIe 2.0 South Bridgeso i do not know what's the problem
it could be that the m.2 hat give up functionality on the metis board
- Axelera Team
- May 13, 2025
Thanks for the update
- Ensign
- May 13, 2025
I wonder if the power is being provided to the M.2s via the Pi’s GPIO, and it can’t send enough juice through those lines?
don't think that's the problem once more test I remove the tpm2
- Ensign
- May 13, 2025
it is a power issue
i removed the tpm2 and ssd and boot from sd
0001:00:00.0 PCI bridge: Broadcom Inc. and subsidiaries BCM2712 PCIe Bridge (rev 30)
0001:01:00.0 PCI bridge: ASMedia Technology Inc. ASM1182e 2-Port PCIe x1 Gen2 Packet Switch
0001:02:03.0 PCI bridge: ASMedia Technology Inc. ASM1182e 2-Port PCIe x1 Gen2 Packet Switch
0001:02:07.0 PCI bridge: ASMedia Technology Inc. ASM1182e 2-Port PCIe x1 Gen2 Packet Switch
0001:04:00.0 Processing accelerators: Axelera AI Metis AIPU (rev 02)
0002:00:00.0 PCI bridge: Broadcom Inc. and subsidiaries BCM2712 PCIe Bridge (rev 30)
0002:01:00.0 Ethernet controller: Raspberry Pi Ltd RP1 PCIe 2.0 South Bridgeyes a power issue with tow m.2 cards it fallback to zero devs
- Ensign
- May 13, 2025
I can confirm
with a dual m.2 hat it has enough power … but only one m.2 metis device on slot 1 and boot from sd not ssd
- Ensign
- May 13, 2025
well the line
in eeprom is needed
had it brought both raspberry pi 5 to work
without this line it show nothing
so on get:
PSU_MAX_CURRENT=5000
Sign up
Already have an account? Login
Log in, or create an Axelera AI account
Log In or Register HereEnter your E-mail address. We'll send you an e-mail with instructions to reset your password.
Scanning file for viruses.
Sorry, we're still checking this file's contents to make sure it's safe to download. Please try again in a few minutes.
OKThis file cannot be downloaded
Sorry, our virus scanner detected that this file isn't safe to download.
OK
