kumquat-buildroot/board/radxa/rock5b
Kilian Zinnecker c77a7acb88 board/radxa/rock5b: Disable FIQ debug interface
The custom kernel used for the Rock5B features an FIQ debug
interface which is enabled by default. As it is not needed, it is
disabled. The documentation features instructions on how to
re-enable it, if it is needed.

Signed-off-by: Kilian Zinnecker <kilian.zinnecker@mail.de>
Signed-off-by: Peter Korsgaard <peter@korsgaard.com>
2024-02-06 18:46:01 +01:00
..
patches
boot.cmd
genimage.cfg
linux.fragment board/radxa/rock5b: Disable FIQ debug interface 2024-02-06 18:46:01 +01:00
post-image.sh
readme.txt board/radxa/rock5b: Disable FIQ debug interface 2024-02-06 18:46:01 +01:00
rock5b.dts board/radxa/rock5b: Disable FIQ debug interface 2024-02-06 18:46:01 +01:00
rock5b.its board/radxa/rock5b: Disable FIQ debug interface 2024-02-06 18:46:01 +01:00

RADXA ROCK 5B
==============
https://wiki.radxa.com/Rock5/hardware/5b

Build:
======
  $ make rock5b_defconfig
  $ make

Files created in output directory
=================================

output/images
.
├── Image
├── Image.gz
├── boot.scr
├── boot.vfat
├── image.itb
├── rk3588-rock-5b.dtb
├── rk3588_bl31_v1.40.elf
├── rk3588_ddr_lp4_2112MHz_lp5_2736MHz_v1.12.bin
├── rock5b.dts
├── rock5b.its
├── rootfs.ext2
├── rootfs.ext4
├── rootfs.tar
├── sdcard.img
├── u-boot-rockchip.bin
└── u-boot.bin

Creating bootable SD card:
==========================

Simply invoke (as root)

sudo dd if=output/images/sdcard.img of=/dev/sdX && sync

Where X is your SD card device.

Booting:
========

Serial console:
---------------
The Rock 5B has a 40-pin GPIO header. Its layout can be seen here:
https://wiki.radxa.com/Rock5/hardware/5b/gpio

The Uart pins are as follows:

pin 6:  gnd
pin 8:  tx
pin 10: rx

Baudrate for this board is 1500000.

Login:
------
Enter 'root' as login user, and the prompt is ready.

wiki link:
----------
https://forum.radxa.com/c/rock5

Issues:
=======

WiFi
----
The custom Radxa kernel provides custom code to support WiFi. However,
that code does not compile with GCC 12, which is the current default
version in buildroot. Hence, the WiFi kernel drivers are disabled, until
the issues get fixed (if ever). If they are desperately needed, one may
apply the following workaround, as long as buildroot still supports GCC
version 11:

1. Set GCC version 11, by adding the following line to
configs/rock5b_defconfig:

BR2_GCC_VERSION_11_X=y

2. Re-enable custom WiFi drivers by removing the following line from
board/radxa/rock5b/linux.fragment:

# CONFIG_WL_ROCKCHIP is not set

Rockchip FIQ Debugger
---------------------
The custom kernel used for this board features an FIQ debugger, which
can be activated by typing "fiq" on the serial interface. As this can be
annoying if a user wants to type these charakters and it is not needed
for most users, this board support disables the FIQ debugger by default.
To re-enable the FIQ debugger follow the steps:

1. In board/radxa/rock5b/rock5b.dts set the status property of the
fiq_debugger node to "okay" and set the status property of the uart2
node to "disabled"

2. Re-enable the fiq debugger module  by removing the following line
from board/radxa/rock5b/linux.fragment:

# CONFIG_ROCKCHIP_FIQ_DEBUGGER is not set