Zum Inhalt springen

WSAL27710 – PCIe TO 2-CH M.2 HAT+ (B)/en

Aus JW Tech Wiki

Documentation notice: This technical documentation was independently rewritten from an archived supplier source. Check technical details and commands against the product version and manufacturer documentation before use.

Summary

Technical overview of the Waveshare PCIe TO 2-CH M.2 HAT+ (B) for Raspberry Pi 5: NVMe SSD connection, partitioning, formatting, mounting, boot from SSD, and power monitoring.

Related products at JW Tech

Technical overview

  • The adapter is a PCIe-to-M.2 board for the Raspberry Pi 5 and supports M.2 drives in sizes 2230, 2242, 2260, and 2280.
  • Only the Pi 5B model is supported; the PCIe interface operates in Gen2 x1 mode.
  • The board has two M.2 slots; for booting, it is recommended to connect the boot SSD to port NVME1.
  • Two status LEDs indicate state: PWR stays lit when powered, ACT blinks during read/write operations.
  • The PCIe interface is enabled by default on the Pi 5; if not, add 'dtparam=pciex1' to /boot/firmware/config.txt.
  • After reboot, the system recognizes the SSD as nvme0n1; partition with fdisk and format with mkfs.ext4.
  • To mount, create a target directory and bind the partition; df -h shows available space.
  • For automatic mounting after reboot, add an entry to /etc/fstab and activate with 'sudo mount -a'.
  • To boot from the NVMe SSD, use 'rpi-eeprom-config --edit' to set NVME_CONTROLLER=1 and adjust BOOT_ORDER accordingly.
  • An onboard INA219 chip measures voltage and current of the SSD; default I2C address is 0x40.

Commands and examples – verify before use: 

dtparam=pciex1
lsblk
sudo fdisk /dev/nvme0n1
sudo mkfs.ext4 /dev/nvme0n1p1
sudo mkdir toshiba
sudo mount /dev/nvme0n1p1 ./toshiba
df -h
sudo dd if=/dev/zero of=./test_write count=2000 bs=1024k
sudo dd if=./test_write of=/dev/null count=2000 bs=1024k
sudo nano /etc/fstab
sudo mount -a
sudo rpi-eeprom-config --edit
NVME_CONTROLLER=1
BOOT_ORDER=0xf416

Notes and version constraints

  • All commands are version-sensitive and may change depending on firmware revision; verify against current documentation before running.
  • Partitioning and formatting permanently erase existing data on the SSD – back up first.
  • Changes to /etc/fstab should be tested before rebooting, since faulty entries can prevent the system from starting.
  • If booting from the SSD fails repeatedly, a timestamp mismatch may be present; synchronize network time or set the clock manually.
  • Exact read/write performance depends heavily on the specific SSD and environment; use a PC-based test for precise figures.
  • Compatibility with other devices such as Hailo-8 is limited due to the Gen2 constraint; compatibility with third-party expansion boards must be verified case by case.

Source and revision record