Merge pull request #1391 from kernelkit/update-bpi-recommendations

Doc: Update recommendations for bpi-r3
This commit is contained in:
Joachim Wiberg
2026-02-03 09:58:13 +01:00
committed by GitHub
+12 -2
View File
@@ -34,6 +34,10 @@ Infix comes preconfigured with:
The easiest way to get started is using an SD card: The easiest way to get started is using an SD card:
> [!NOTE]
> SD card boot works but we have observed stability issues. For production
> use or long-term reliability, we recommend installing to eMMC (see below).
1. **Download the SD card image:** [infix-bpi-r3-sdcard.img][2] 1. **Download the SD card image:** [infix-bpi-r3-sdcard.img][2]
2. **Flash the image to an SD card:** see [this guide][0] 2. **Flash the image to an SD card:** see [this guide][0]
3. **Set boot switches:** 3. **Set boot switches:**
@@ -53,8 +57,8 @@ The BPI-R3 has a 4-position DIP switch that controls boot media:
| Position | Mode | Description | | Position | Mode | Description |
|----------|-------------|---------------------------------------| |----------|-------------|---------------------------------------|
| 0000 | SD card | Boot from microSD card (recommended) | | 0000 | SD card | Boot from microSD card |
| 0110 | eMMC | Boot from internal eMMC storage | | 0110 | eMMC | Boot from internal eMMC (recommended) |
| 1010 | SPI NAND | Boot from SPI NAND (advanced users) | | 1010 | SPI NAND | Boot from SPI NAND (advanced users) |
> [!NOTE] > [!NOTE]
@@ -67,10 +71,16 @@ For production deployments or better performance, you can install Infix
to the internal eMMC storage. This is more complex but provides faster to the internal eMMC storage. This is more complex but provides faster
boot times and eliminates the external SD card. boot times and eliminates the external SD card.
> [!IMPORTANT]
> While Infix boots on both SD card and eMMC, we have observed stability
> issues with SD cards on this platform. **eMMC is recommended** for
> reliable operation.
### Why Use eMMC? ### Why Use eMMC?
**Advantages:** **Advantages:**
- More reliable than SD card (stability issues observed with SD cards)
- Faster boot and better performance - Faster boot and better performance
- No external SD card to manage - No external SD card to manage
- More robust for industrial/embedded deployments - More robust for industrial/embedded deployments