Skip to content

Add board: Lubancat 5IO (RK3588)#10029

Open
lch08 wants to merge 22 commits into
armbian:mainfrom
lch08:add_board_lubancat_5io
Open

Add board: Lubancat 5IO (RK3588)#10029
lch08 wants to merge 22 commits into
armbian:mainfrom
lch08:add_board_lubancat_5io

Conversation

@lch08

@lch08 lch08 commented Jun 24, 2026

Copy link
Copy Markdown
Member

Description

This PR adds initial Armbian support for the Embedfire LubanCat-5IO board based on RK3588.

The change introduces a new board definition, mainline U-Boot defconfig, and board DTS files for both kernel and U-Boot so the board can build with the existing rockchip-rk3588 family flow.

Documentation summary for feature / change

Add a new community-supported RK3588 board target for Embedfire LubanCat-5IO. The board boots with mainline U-Boot and provides DTS enablement for storage, networking, USB, display, PCIe, SATA, RTC, fan, and basic onboard peripherals.

Manufacturer documentation: https://doc.embedfire.com/linux/rk3588/quick_start/zh/latest/quick_start/lubancat/lubancat5.html#id7
Manufacturer BSP: https://github.com/LubanCat/manifests/

How Has This Been Tested?

Build: ./compile.sh build BOARD=lubancat-5io RELEASE=noble BRANCH=current BUILD_DESKTOP=yes BUILD_MINIMAL=no DESKTOP_ENVIRONMENT=kde-plasma DESKTOP_TIER=minimal
Than flashed the system to the lubancat-5io board, connected via debug serial console to test various functions

image

Hardware validation reported during bring-up:

  • eMMC
  • SD
  • NVMe
  • dual GMAC
  • 3x USB2.0
  • 1x USB3.0
  • 1x Type-C USB3.0
  • 1x Mini-PCIe over USB2.0
  • M.2 E-Key PCIe
  • 2x HDMI output
  • HDMI RX
  • RTC
  • PCA9535
  • LED
  • fan
  • power button

Known issues / not yet validated:

  • Type-C DP Alt Mode currently shows a black screen
  • RS485 not implemented yet
  • RS232 not implemented yet
  • CAN not implemented yet
  • MIPI DSI not supported in this bring-up
  • MIPI CSI not supported in this bring-up
  • SATA not tested
  • PCIe x4 slot not tested
  • Mini-PCIe PCIe mode not tested
  • ES8388 audio not tested
  • IR not tested

Checklist:

  • My code follows the style guidelines of this project
  • I have performed a self-review of my own code
  • My changes generate no new warnings
  • Any dependent changes have been merged and published in downstream modules

Summary by CodeRabbit

  • New Features
    • Added Linux device support for the Embedfire LubanCat 5IO (RK3588), including ES8388 audio, Recovery/GPIO IR input, dual HDMI, dual RGMII Ethernet, SATA/SD storage, PCIe/M.2 and Mini-PCIe slots, and USB-C with DisplayPort alternate mode.
    • Added board power/thermal modeling (RK806 PMIC/regulators, status LED, PWM fan and cooling trips).
    • Added matching U-Boot support (defconfig, board device-tree, and updated boot flow to use a mainline U-Boot image written during boot).

@coderabbitai

coderabbitai Bot commented Jun 24, 2026

Copy link
Copy Markdown
Contributor

Review Change Stack

Important

Review skipped

Auto reviews are limited based on label configuration.

🏷️ Required labels (at least one) (1)
  • Needs review

Please check the settings in the CodeRabbit UI or the .coderabbit.yaml file in this repository. To trigger a single review, invoke the @coderabbitai review command.

⚙️ Run configuration

Configuration used: Path: .coderabbit.yaml

Review profile: CHILL

Plan: Pro

Run ID: 2a7d89c8-b6bf-4a09-84f5-0c15f2d482db

You can disable this status message by setting the reviews.review_status to false in the CodeRabbit configuration file.

Use the checkbox below for a quick retry:

  • 🔍 Trigger review
📝 Walkthrough

Walkthrough

Adds LubanCat 5IO board support with new board config, U-Boot integration, and RK3588 device-tree files for U-Boot plus the 6.18 and 7.1 kernel archives.

Changes

LubanCat 5IO (RK3588) Board Support

Layer / File(s) Summary
Board config and U-Boot hook
config/boards/lubancat-5io.csc
Adds board metadata and boot defaults, then overrides family U-Boot settings to use mainline v2026.04 and write the binman-produced image with dd.
U-Boot defconfig and DTS
patch/u-boot/v2026.04/defconfig/lubancat-5io-rk3588_defconfig, patch/u-boot/v2026.04/dt_upstream_rockchip/rk3588-lubancat-5io.dts
Adds the RK3588 U-Boot defconfig and board DTS covering board identity, input/audio/display, regulators, SoC power, PCIe, storage, PMIC, USB, and watchdog wiring.
Kernel 6.18 DTS
patch/kernel/archive/rockchip64-6.18/dt/rk3588-lubancat-5io.dts
Defines board identity, audio, IR input, LEDs, fan cooling, regulators, SoC power, display, networking, storage, PCIe, PMIC, USB, video, and watchdog wiring for the 6.18 archive DTS.
Kernel 7.1 DTS
patch/kernel/archive/rockchip64-7.1/dt/rk3588-lubancat-5io.dts
Defines board identity, audio, HDMI, regulators, SoC power, I2C devices, PCIe, pinctrl, storage, PMIC, USB, video, and watchdog wiring for the 7.1 archive DTS.

Estimated code review effort

🎯 4 (Complex) | ⏱️ ~60 minutes

Possibly related PRs

  • armbian/build#9119: Both PRs add RK3588 board support that injects a board-specific post_family_config__..._use_mainline_uboot() hook (including write_uboot_platform/U-Boot platform blob handling), but for different boards/files.
  • armbian/build#9398: Both PRs add board-specific post_family_config__..._use_mainline_uboot() hooks in .csc files to switch Armbian’s U-Boot setup to a mainline v2026.x flow.
  • armbian/build#9880: Both PRs add board-specific mainline U-Boot override hooks and write_uboot_platform handling for Rockchip boards.

Suggested labels

BSP

Suggested reviewers

  • ColorfulRhino
  • HeyMeco
  • JohnTheCoolingFan
  • TheSnowfield
  • Tonymac32
  • amazingfate
  • brentr
  • catalinii
  • chainsx
  • efectn
  • iav
  • joekhoobyar
  • krachlatte
  • lanefu
  • paolosabatino
  • prahal
  • pyavitz
  • rpardini
  • schwar3kat
  • EvilOlaf

Poem

🐰 Hop-hop, the 5IO wakes in light,
Mainline boots and spins up right.
HDMI hums, and fans go purr,
RK3588 makes the circuits stir.
One board, two kernels, all set to go—
Thump! says the rabbit, a happy glow.

🚥 Pre-merge checks | ✅ 5
✅ Passed checks (5 passed)
Check name Status Explanation
Description Check ✅ Passed Check skipped - CodeRabbit’s high-level summary is enabled.
Title check ✅ Passed The title clearly summarizes the main change: adding support for the LubanCat 5IO RK3588 board.
Docstring Coverage ✅ Passed No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.
Linked Issues check ✅ Passed Check skipped because no linked issues were found for this pull request.
Out of Scope Changes check ✅ Passed Check skipped because no linked issues were found for this pull request.
✨ Finishing Touches
🧪 Generate unit tests (beta)
  • Create PR with unit tests

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

Comment @coderabbitai help to get the list of available commands.

@github-actions

Copy link
Copy Markdown
Contributor

Hey @lch08! 👋

Thanks for submitting your first pull request to the Armbian project — we're excited to have you contributing! 🧡
Your effort doesn’t just improve Armbian — it benefits the entire community of users and developers.

If you'd like to stay informed about project updates or collaborate more closely with the team,
you can optionally share some personal contact preferences at armbian.com/update-data.
This helps us keep in touch without relying solely on GitHub notifications.

Also, don’t forget to ⭐ star the repo if you haven’t already — and welcome aboard! 🚀

@github-actions github-actions Bot added Needs review Seeking for review Hardware Hardware related like kernel, U-Boot, ... labels Jun 24, 2026
Comment thread patch/kernel/archive/rockchip64-7.1/dt/rk3588-lubancat-5io.dts Outdated
@EvilOlaf

Copy link
Copy Markdown
Member

Add board assets to https://github.com/armbian/armbian.github.io
The workflow seems broken. @igorpecovnik

@igorpecovnik

Copy link
Copy Markdown
Member

The workflow seems broken.

This is the correct behaviour:

image

It was corrected later, so merging.

@lch08

lch08 commented Jun 30, 2026

Copy link
Copy Markdown
Member Author

Add board assets to https://github.com/armbian/armbian.github.io The workflow seems broken. @igorpecovnik

I have submitted a PR for the development board image and manufacturer logo to armbian.github.io: armbian/armbian.github.io#348

@github-actions github-actions Bot added the Ready to merge Reviewed, tested and ready for merge label Jul 1, 2026
@github-actions

github-actions Bot commented Jul 1, 2026

Copy link
Copy Markdown
Contributor

✅ This PR has been reviewed and approved — all set for merge!

@github-actions github-actions Bot removed the Needs review Seeking for review label Jul 1, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

08 Milestone: Third quarter release Hardware Hardware related like kernel, U-Boot, ... Patches Patches related to kernel, U-Boot, ... Ready to merge Reviewed, tested and ready for merge size/large PR with 250 lines or more

Development

Successfully merging this pull request may close these issues.

4 participants