Skip to content

Commit b34919e

Browse files
authored
add faq to boot from sdcard
1 parent 019f172 commit b34919e

File tree

1 file changed

+21
-0
lines changed

1 file changed

+21
-0
lines changed

content/docs/guides/faq.md

Lines changed: 21 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -60,3 +60,24 @@ The firmware currently does not support dynamic RAM discovery and assumes 4GB in
6060
Some pointers to change this:
6161
[RMM](https://github.com/opencca/tf-rmm/blob/opencca/main/configs/rk3588_defcfg.cmake#L13), [TF-A](https://github.com/opencca/arm-trusted-firmware/blob/opencca/main/plat/rockchip/rk3588/opencca/rk3588_opencca.h#L71), [U-Boot](https://github.com/opencca/u-boot/commit/219910188adc59a6f17cc192044880ce76e8dc2a).
6262
{{< /details >}}
63+
64+
65+
{{< details "Q: I want to boot from SDMMC instead of eMMC" >}}
66+
_October 2025_
67+
68+
We recommend booting from eMMC. Compatible eMMC chips cost around 10 USD.
69+
70+
https://de.aliexpress.com/item/1005007003959424.html?spm=a2g0o.order_list.order_list_main.35.4f2418023Ja2xZ&gatewayAdapt=glo2deu
71+
72+
The prebuilt image used for the SysTEX evaluation boots from eMMC. In this build, the kernel option `OPENCCA_HW_DEBUG=y` is enabled, which disables SDMMC and enables the SWD interface. Since both SD and hardware debugging share the same pins you can either do hardware debugging or use SD card at the same time.
73+
74+
You can see the relevant changes here:
75+
76+
https://github.com/opencca/linux/compare/d8e18330ec8e59bc5262368961cd16aa044e0195...6d37f0d15c317804ceeb2d50354695d35783f0f6#diff-00edfaa8eb3606d42da7fb68c09687cd611602038ff3aa55436b2742d2d69bd2R3
77+
78+
To fix this, you either:
79+
- boot from eMMC
80+
- or rebuild the kernel with `OPENCCA_HW_DEBUG=n`, and if needed, adjust the kernel cmd line arguments so the rootfs is loaded from SDMMC instead.
81+
82+
{{< /details >}}
83+

0 commit comments

Comments
 (0)