Skip to content

Conversation

@rpardini
Copy link
Member

@rpardini rpardini commented Dec 22, 2025

mixtile-core3588e: add board with vendor and edge branches (Joshua Riek + fixes)

  • mixtile-core3588e: add board with vendor and edge branches (Joshua Riek + fixes)
    • vendor:
      • kernel: armbian/linux-rockchip already had a DTS from jriek
      • u-boot: taken from jriek (reorg'ed the defconfig)
    • edge:
      • kernel: taken from jriek's 6.11 wip branch
      • u-boot: generic (can only boot SD/eMMC)
  • rockchip64-6.18: mixtile-core3588e: device tree additions & fixes
    • on top of Joshua Riek's DT, add:
      • GPU
      • NPU
      • i2c5 (40-pin)
      • saradc
      • tsadc (thermals)
      • pwm2 / tacho / cooling fan
      • sys-led
      • usb2 otg (for flashing / UMS - microusb port)
      • USB3 ports (via usb hub on carrier board)
      • hdmi0 & hdmi0 audio & vop
      • uart1 (40-pin)
  • mixtile-core3588e: edge: u-boot defconfig/dt with working nvme/gmac/usb
    • boot order: NVMe -> MMC
    • GMAC works
    • nvme works
    • ums et al working
    • usb3 ports (on carrier board) work
    • DT is copy (not symlink) from kernel DT due to NPU nodes
  • mixtile-core3588e: drop vendor u-boot (mainline works great)
    • no need for vendor u-boot, as mainline can boot vendor kernel fine
    • update comments with hardware pin references
    • mainline boot order: NVMe -> USB -> eMMC

Summary by CodeRabbit

Release Notes

  • New Features
    • Added Mixtile Core3588E board support (RK3588-based SoC)
    • Device tree configuration enables: HDMI, Gigabit Ethernet, USB, PCIe, NVMe, thermal fan control, RTC, LED support, and comprehensive power management
    • U-Boot bootloader configured for mainline integration with extended hardware and peripheral support

✏️ Tip: You can customize this high-level summary in your review settings.

…ek + fixes)

- vendor:
  - kernel: armbian/linux-rockchip already had a DTS from jriek
  - u-boot: taken from jriek (reorg'ed the defconfig)
- edge:
  - kernel: taken from jriek's 6.11 wip branch
  - u-boot: generic (can only boot SD/eMMC)
- on top of Joshua Riek's DT, add:
  - GPU
  - NPU
  - i2c5 (40-pin)
  - saradc
  - tsadc (thermals)
  - pwm2 / tacho / cooling fan
  - sys-led
  - usb2 otg (for flashing / UMS - microusb port)
  - USB3 ports (via usb hub on carrier board)
  - hdmi0 & hdmi0 audio & vop
  - uart1 (40-pin)
- boot order: NVMe -> MMC
- GMAC works
- nvme works
- `ums` et al working
- usb3 ports (on carrier board) work
- DT is copy (not symlink) from kernel DT due to NPU nodes
- no need for vendor u-boot, as mainline can boot vendor kernel fine
- update comments with hardware pin references
- mainline boot order: NVMe -> USB -> eMMC
@coderabbitai
Copy link
Contributor

coderabbitai bot commented Dec 22, 2025

Walkthrough

This PR adds complete board support for the Mixtile Core3588E RK3588-based platform, including board configuration with mainline U-Boot integration, kernel device tree definitions, U-Boot defconfig, and U-Boot device tree sources. All components (bootloader, kernel, device tree) are configured and interconnected.

Changes

Cohort / File(s) Summary
Board Configuration
config/boards/mixtile-core3588e.csc
Adds board metadata (name, vendor, family, maintainer, kernel targets, boot configuration), three configuration functions to enable mainline U-Boot flow, patch boot order in rockchip-common.h, and apply extended U-Boot environment configurations (misc commands, preboot, EFI, filesystem/compression, LED, networking, USB gadget support).
Kernel Device Tree
patch/kernel/archive/rockchip64-6.18/dt/rk3588-mixtile-core3588e.dts
Introduces comprehensive hardware description for RK3588 Mixtile board with fan control, LED definitions, multi-regulator supplies, HDMI plumbing, GPU/GMAC/PCIe configuration, thermal zones with cooling maps, I2C buses with RTC and power rail regulators, USB/PHY controllers, NPU cores, and HDMI/VOP display endpoint wiring.
U-Boot Configuration
patch/u-boot/v2026.01/defconfig/mixtile-core3588e-rk3588_defconfig
Introduces U-Boot defconfig enabling ARM/RK3588 architecture, SPL support with ATF/FIT, GPIO/I2C/MMC/USB/PCIe/SATA subsystems, Rockchip PHYs, live device tree, and comprehensive USB/gadget/RNDIS support for the platform.
U-Boot Device Trees
patch/u-boot/v2026.01/dt_uboot/rk3588-mixtile-core3588e-u-boot.dtsi, patch/u-boot/v2026.01/dt_upstream_rockchip/rk3588-mixtile-core3588e.dts
Adds U-Boot-specific device tree include (generic RK3588 definitions) and complete upstream U-Boot device tree with model/compatibility, hardware aliases, regulator rails, I2C controllers with PMIC/RTC, PCIe/USB/UART configurations, power domains, and thermal zone/cooling definitions.

Estimated code review effort

🎯 4 (Complex) | ⏱️ ~45–60 minutes

  • Board configuration hooks: Verify post_family_config, pre_config_uboot_target, and post_config_uboot_target functions correctly select mainline U-Boot flow, patch boot order, and apply all required environment configurations without conflicts.
  • Device tree hierarchies and bindings: Ensure regulator supplies, pinctrl references, and endpoint wiring (HDMI/VOP paths, USB PHYs, I2C nodes) are correct and consistent across kernel and U-Boot device trees.
  • U-Boot defconfig scope: Confirm all selected subsystems (PCIe, SATA, USB, PHY variants) and gadget/RNDIS features are appropriate for this RK3588 variant and do not introduce unwanted dependencies.
  • Hardware peripheral mappings: Verify GPIO pins, I2C addresses, regulator naming, and thermal trip points align with actual Mixtile Core3588E hardware specifications.

Possibly related PRs

Suggested reviewers

  • igorpecovnik
  • paolosabatino
  • prahal
  • chainsx
  • pyavitz

Poem

🐰 A hop and a skip through RK3588's land,
A Mixtile Core blooms as if by command—
With U-Boot in mainline, device trees align,
Fans spin, LEDs glow, and the regulators shine!
The rabbit's delight: board support complete! ✨

Pre-merge checks and finishing touches

✅ Passed checks (3 passed)
Check name Status Explanation
Description Check ✅ Passed Check skipped - CodeRabbit’s high-level summary is enabled.
Title check ✅ Passed The title accurately describes the main change: adding support for the Mixtile Core3588E board with vendor and edge branches, with proper attribution to Joshua Riek and mentions fixes.
Docstring Coverage ✅ Passed No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.
✨ Finishing touches
🧪 Generate unit tests (beta)
  • Create PR with unit tests
  • Post copyable unit tests in a comment

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 and usage tips.

@github-actions github-actions bot added 02 Milestone: First quarter release size/large PR with 250 lines or more Needs review Seeking for review Hardware Hardware related like kernel, U-Boot, ... Patches Patches related to kernel, U-Boot, ... labels Dec 22, 2025
@github-actions
Copy link
Contributor

🚫 Missing required board assets

This PR adds new board configuration(s). Required assets must already exist in github/armbian/armbian.github.io.
They are required by Armbian Imager to ensure all boards are displayed with proper images.

  • Board images: board-images/<board>.png (1920x1080 px transparent)
  • Vendor logos: board-vendor-logos/<vendor>-logo.png (512x512 px transparent)

Missing items

  • Board image missing for mixtile-core3588e

    • Expected: board-images/mixtile-core3588e.png
    • Fix: add the file to armbian/armbian.github.io (folder board-images/)
  • BOARD_VENDOR not found in config/boards/mixtile-core3588e.csc

    • Fix: add e.g. BOARD_VENDOR="radxa" (lowercase recommended)

Once the missing files are added (or a PR is opened in armbian/armbian.github.io), re-run this check.

Copy link
Contributor

@coderabbitai coderabbitai bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Actionable comments posted: 0

🧹 Nitpick comments (1)
config/boards/mixtile-core3588e.csc (1)

93-101: Minor: Duplicate config entry and inconsistent prefix.

The enable_configs array has a duplicate "CONFIG_CMD_USB_MASS_STORAGE" entry (appears at both the beginning and end of the array). Additionally, "USB_GADGET_DOWNLOAD" is missing the CONFIG_ prefix while other entries include it. While scripts/config handles both forms, consistency improves readability.

🔎 Suggested cleanup
 	# UMS, RockUSB, gadget stuff
 	display_alert "u-boot for ${BOARD}/${BRANCH}" "u-boot: enable UMS/RockUSB gadget" "info"
-	declare -a enable_configs=("CONFIG_CMD_USB_MASS_STORAGE" "CONFIG_USB_GADGET" "USB_GADGET_DOWNLOAD" "CONFIG_USB_FUNCTION_ROCKUSB" "CONFIG_USB_FUNCTION_ACM" "CONFIG_CMD_ROCKUSB" "CONFIG_CMD_USB_MASS_STORAGE")
+	declare -a enable_configs=("CONFIG_USB_GADGET" "CONFIG_USB_GADGET_DOWNLOAD" "CONFIG_USB_FUNCTION_ROCKUSB" "CONFIG_USB_FUNCTION_ACM" "CONFIG_CMD_ROCKUSB" "CONFIG_CMD_USB_MASS_STORAGE")
 	for config in "${enable_configs[@]}"; do
 		run_host_command_logged scripts/config --enable "${config}"
 	done
 	# Auto-enabled by the above, force off...
-	run_host_command_logged scripts/config --disable USB_FUNCTION_FASTBOOT
+	run_host_command_logged scripts/config --disable CONFIG_USB_FUNCTION_FASTBOOT
📜 Review details

Configuration used: Path: .coderabbit.yaml

Review profile: CHILL

Plan: Pro

Disabled knowledge base sources:

  • Jira integration is disabled by default for public repositories

You can enable these sources in your CodeRabbit configuration.

📥 Commits

Reviewing files that changed from the base of the PR and between 823d977 and 7d37d14.

📒 Files selected for processing (5)
  • config/boards/mixtile-core3588e.csc
  • patch/kernel/archive/rockchip64-6.18/dt/rk3588-mixtile-core3588e.dts
  • patch/u-boot/v2026.01/defconfig/mixtile-core3588e-rk3588_defconfig
  • patch/u-boot/v2026.01/dt_uboot/rk3588-mixtile-core3588e-u-boot.dtsi
  • patch/u-boot/v2026.01/dt_upstream_rockchip/rk3588-mixtile-core3588e.dts
🧰 Additional context used
🧠 Learnings (29)
📓 Common learnings
Learnt from: rpardini
Repo: armbian/build PR: 8879
File: config/sources/families/uefi-x86.conf:0-0
Timestamp: 2025-11-06T15:36:04.682Z
Learning: As of PR #8879, the uefi-x86 family in the Armbian build system now includes kernel patches for the first time. The current and edge branches for uefi-x86 are specifically configured for Apple T2-based x86 machines, including T2-specific patches from the linux-t2 project and custom kernel configuration options for Apple hardware drivers.
Learnt from: EvilOlaf
Repo: armbian/build PR: 8428
File: config/boards/lckfb-taishanpi.csc:5-9
Timestamp: 2025-07-25T03:51:50.830Z
Learning: When reviewing PRs in the Armbian build system, U-Boot defconfig files and patches may be added as part of the PR changes but might not be visible in the current repository clone state during review. It's important to check the actual PR file changes directly via GitHub or the PR API to get the complete picture of what files are being added or modified.
Learnt from: HackingGate
Repo: armbian/build PR: 8665
File: config/boards/photonicat2.csc:4-4
Timestamp: 2025-10-26T10:41:35.118Z
Learning: In the Armbian build system, rk3576 boards consistently use BOARDFAMILY="rk35xx" for both vendor and edge kernel targets. The rk35xx family configuration sources rockchip64_common.inc, which provides edge and current kernel branch definitions, making these branches available even though they're not defined directly in rk35xx.conf.
Learnt from: tabrisnet
Repo: armbian/build PR: 8913
File: config/sources/families/k3-beagle.conf:16-16
Timestamp: 2025-11-10T22:05:40.490Z
Learning: In the Armbian build system, kernel branches using non-mainline/vendor forks (like BeagleBoard's linux repository) should be named "vendor" or "vendor-rt" rather than "current" or "edge". The "current" and "edge" naming is reserved for mainline kernel branches. This affects both the case statement in family config files (e.g., `vendor | vendor-rt)` instead of `current | current-rt)`) and the corresponding KERNEL_TARGET declarations in board config files.
Learnt from: amazingfate
Repo: armbian/build PR: 8619
File: config/sources/families/rockchip.conf:64-70
Timestamp: 2025-09-14T06:29:18.958Z
Learning: In the Armbian build system, vendor branch configurations in family files are designed to be shared across multiple SoCs within the same family that use the same vendor kernel tree. For example, rk35xx and rockchip-rk3588 families both use identical vendor branch settings (same KERNELSOURCE, KERNELBRANCH, and KERNELPATCHDIR), demonstrating that vendor branches are intentionally generic rather than SoC-specific.
Learnt from: EvilOlaf
Repo: armbian/build PR: 8428
File: config/boards/lckfb-taishanpi.csc:5-9
Timestamp: 2025-07-25T03:51:50.830Z
Learning: When reviewing PRs in the Armbian build system, U-Boot defconfig files and patches may be added as part of the PR changes but might not be visible in the current repository clone state during review. It's important to check the actual PR file changes directly via GitHub API (https://api.github.com/repos/armbian/build/pulls/{pr_number}/files) to get the complete picture of what files are being added or modified, especially for U-Boot patches that will be applied during the build process.
Learnt from: EvilOlaf
Repo: armbian/build PR: 0
File: :0-0
Timestamp: 2025-12-17T05:09:02.306Z
Learning: In the Armbian build system, kernel patches (e.g., in patch/kernel/archive/sunxi-6.18/patches.armbian/) contain device tree overlays and other code that have existed for years and are maintained/ported across kernel versions. When reviewing PRs that modify these patch files, focus on the actual changes being made (e.g., Makefile fixes, new additions) rather than reviewing the entire existing content within the patch as if it were new code. The patch file contents are existing, stable code unless explicitly modified in the PR diff.
Learnt from: tabrisnet
Repo: armbian/build PR: 9058
File: config/sources/families/spacemit.conf:39-45
Timestamp: 2025-12-12T23:10:00.819Z
Learning: In the Armbian build system, vendor kernel forks can use "vendor-edge" branch naming for bleeding-edge or pre-release vendor kernels, as demonstrated in config/sources/families/k3.conf. The typical vendor branch naming pattern is: "vendor" or "vendor-rt" for stable vendor releases, and "vendor-edge" for bleeding-edge/pre-release vendor versions. The "edge" naming without "vendor-" prefix is reserved for mainline kernel branches.
Learnt from: igorpecovnik
Repo: armbian/build PR: 9087
File: .github/workflows/pr-check-pictures.yml:138-146
Timestamp: 2025-12-16T13:40:07.649Z
Learning: In the Armbian build repository, when introducing new requirements or checks (like the board assets verification workflow), the project prefers an initial educational-only period where violations post helpful PR comments and warnings but don't block merges. This allows contributors to become familiar with new requirements before enforcement is enabled (typically after ~6 months).
Learnt from: EvilOlaf
Repo: armbian/build PR: 0
File: :0-0
Timestamp: 2025-12-19T13:56:45.124Z
Learning: When reviewing kernel or u-boot version bump PRs in the Armbian build system, check if patches existed in previous kernel version directories (e.g., sunxi-6.12, sunxi-6.13) before describing them as new features. If a patch and the majority of its contents existed previously with no major functionality changes, focus the review on the actual changes: the version bump itself and patch compatibility adjustments. Don't describe existing patches being ported/maintained across versions as new features or drivers—this is misleading. The patches are existing code being re-aligned to work with the new upstream version.
📚 Learning: 2025-11-08T06:39:24.527Z
Learnt from: EvilOlaf
Repo: armbian/build PR: 8886
File: patch/kernel/rk35xx-vendor-6.1/dt/rk3528-nanopi-rev01.dts:9-9
Timestamp: 2025-11-08T06:39:24.527Z
Learning: In Armbian's Rockchip vendor kernel branches (rk35xx-vendor), device tree files may not require the same headers as mainline Linux. For example, input key definitions like KEY_BACK and KEY_VOLUMEUP may be handled differently in BSP kernels and don't necessarily need explicit includes like <dt-bindings/input/input.h> that would be required in mainline kernel device trees.

Applied to files:

  • patch/u-boot/v2026.01/dt_upstream_rockchip/rk3588-mixtile-core3588e.dts
  • patch/u-boot/v2026.01/dt_uboot/rk3588-mixtile-core3588e-u-boot.dtsi
  • patch/kernel/archive/rockchip64-6.18/dt/rk3588-mixtile-core3588e.dts
📚 Learning: 2025-11-15T14:33:30.654Z
Learnt from: SuperKali
Repo: armbian/build PR: 8936
File: patch/kernel/archive/rockchip64-6.18/dt/rk3576-nanopi-r76s.dts:800-802
Timestamp: 2025-11-15T14:33:30.654Z
Learning: In RK3576 device tree files (like rk3576-nanopi-r76s.dts), the serial0 alias is already defined in the upstream kernel's rk3576.dtsi base file, so board-specific DTS files do not need to redeclare it when enabling &uart0 for serial console.

Applied to files:

  • patch/u-boot/v2026.01/dt_upstream_rockchip/rk3588-mixtile-core3588e.dts
  • patch/u-boot/v2026.01/dt_uboot/rk3588-mixtile-core3588e-u-boot.dtsi
  • patch/kernel/archive/rockchip64-6.18/dt/rk3588-mixtile-core3588e.dts
📚 Learning: 2025-09-14T06:32:29.806Z
Learnt from: amazingfate
Repo: armbian/build PR: 8619
File: config/sources/families/rockchip.conf:222-230
Timestamp: 2025-09-14T06:32:29.806Z
Learning: In the Armbian build system, the write_uboot_platform() function implementations follow different patterns across Rockchip family files. The newer standard (used in rockchip64_common.inc and rk3506) includes 'status=none' parameter in dd commands, while older implementations (rk3288, rk322x) use an older pattern without this parameter. The rk3506 implementation correctly follows the current Rockchip family standard.

Applied to files:

  • patch/u-boot/v2026.01/dt_upstream_rockchip/rk3588-mixtile-core3588e.dts
  • config/boards/mixtile-core3588e.csc
  • patch/u-boot/v2026.01/defconfig/mixtile-core3588e-rk3588_defconfig
  • patch/u-boot/v2026.01/dt_uboot/rk3588-mixtile-core3588e-u-boot.dtsi
📚 Learning: 2025-12-17T05:09:02.306Z
Learnt from: EvilOlaf
Repo: armbian/build PR: 0
File: :0-0
Timestamp: 2025-12-17T05:09:02.306Z
Learning: In the Armbian build system, kernel patches (e.g., in patch/kernel/archive/sunxi-6.18/patches.armbian/) contain device tree overlays and other code that have existed for years and are maintained/ported across kernel versions. When reviewing PRs that modify these patch files, focus on the actual changes being made (e.g., Makefile fixes, new additions) rather than reviewing the entire existing content within the patch as if it were new code. The patch file contents are existing, stable code unless explicitly modified in the PR diff.

Applied to files:

  • patch/u-boot/v2026.01/dt_upstream_rockchip/rk3588-mixtile-core3588e.dts
  • patch/u-boot/v2026.01/dt_uboot/rk3588-mixtile-core3588e-u-boot.dtsi
  • patch/kernel/archive/rockchip64-6.18/dt/rk3588-mixtile-core3588e.dts
📚 Learning: 2025-12-19T13:56:45.124Z
Learnt from: EvilOlaf
Repo: armbian/build PR: 0
File: :0-0
Timestamp: 2025-12-19T13:56:45.124Z
Learning: When reviewing kernel or u-boot version bump PRs in the Armbian build system, check if patches existed in previous kernel version directories (e.g., sunxi-6.12, sunxi-6.13) before describing them as new features. If a patch and the majority of its contents existed previously with no major functionality changes, focus the review on the actual changes: the version bump itself and patch compatibility adjustments. Don't describe existing patches being ported/maintained across versions as new features or drivers—this is misleading. The patches are existing code being re-aligned to work with the new upstream version.

Applied to files:

  • patch/u-boot/v2026.01/dt_upstream_rockchip/rk3588-mixtile-core3588e.dts
  • patch/u-boot/v2026.01/dt_uboot/rk3588-mixtile-core3588e-u-boot.dtsi
📚 Learning: 2025-11-10T23:44:53.363Z
Learnt from: tabrisnet
Repo: armbian/build PR: 0
File: :0-0
Timestamp: 2025-11-10T23:44:53.363Z
Learning: For the RV1106 family in Armbian (config/sources/families/rockchip-rv1106.conf), udev.children-max=1 is set in the kernel boot parameters to prevent early-boot OOM errors. The RV1106 has a single-core CPU, so parallelism in udev child processes provides no practical benefit. Testing higher values is impractical due to the difficulty of monitoring at this early boot stage.

Applied to files:

  • patch/u-boot/v2026.01/dt_upstream_rockchip/rk3588-mixtile-core3588e.dts
  • patch/u-boot/v2026.01/defconfig/mixtile-core3588e-rk3588_defconfig
  • patch/kernel/archive/rockchip64-6.18/dt/rk3588-mixtile-core3588e.dts
📚 Learning: 2025-12-13T11:00:33.143Z
Learnt from: pyavitz
Repo: armbian/build PR: 9058
File: patch/kernel/archive/spacemit-6.6/dt/lcd_tc358762xbg_dpi_800x480.dtsi:3-61
Timestamp: 2025-12-13T11:00:33.143Z
Learning: On the SpacemiT MusePi Pro board with spacemit-6.6 kernel, LCD/DSI support is disabled in k1-musepi-pro.dts because enabling it causes the unit to lock up during boot. The lcd_tc358762xbg_dpi_800x480.dtsi file exists but DSI remains disabled at the controller level.

Applied to files:

  • patch/u-boot/v2026.01/dt_upstream_rockchip/rk3588-mixtile-core3588e.dts
📚 Learning: 2025-11-02T20:49:56.719Z
Learnt from: igorpecovnik
Repo: armbian/build PR: 8849
File: config/boards/radxa-e54c.csc:14-28
Timestamp: 2025-11-02T20:49:56.719Z
Learning: In Armbian board configuration files (config/boards/*.conf, *.csc, etc.), do not use kernel_config_set, kernel_config_set_m, kernel_config_set_y, or custom_kernel_config__* functions to modify kernel configuration. Kernel configuration is associated with LINUXFAMILY/BOARDFAMILY, not individual BOARD. Board-specific kernel modifications cause inconsistency in kernel packages published to the apt repository because boards within a family share the same kernel packages. Kernel configuration changes must be made in the appropriate kernel config file (e.g., config/kernel/linux-*-*.config) or in family configuration files (config/sources/families/*.conf, *.inc) instead.

Applied to files:

  • config/boards/mixtile-core3588e.csc
  • patch/u-boot/v2026.01/defconfig/mixtile-core3588e-rk3588_defconfig
📚 Learning: 2025-10-26T10:41:35.118Z
Learnt from: HackingGate
Repo: armbian/build PR: 8665
File: config/boards/photonicat2.csc:4-4
Timestamp: 2025-10-26T10:41:35.118Z
Learning: In the Armbian build system, rk3576 boards consistently use BOARDFAMILY="rk35xx" for both vendor and edge kernel targets. The rk35xx family configuration sources rockchip64_common.inc, which provides edge and current kernel branch definitions, making these branches available even though they're not defined directly in rk35xx.conf.

Applied to files:

  • config/boards/mixtile-core3588e.csc
  • patch/u-boot/v2026.01/defconfig/mixtile-core3588e-rk3588_defconfig
  • patch/u-boot/v2026.01/dt_uboot/rk3588-mixtile-core3588e-u-boot.dtsi
📚 Learning: 2025-12-13T11:39:08.046Z
Learnt from: pyavitz
Repo: armbian/build PR: 9058
File: patch/u-boot/legacy/u-boot-spacemit-k1/003-SpacemiT-K1X-Fixups.patch:28-67
Timestamp: 2025-12-13T11:39:08.046Z
Learning: In the Armbian build system for SpacemiT U-Boot patches (patch/u-boot/legacy/u-boot-spacemit-k1/), alignment with mainline U-Boot behavior is prioritized. For example, in boot mode handling, leaving devnum unchanged in the default case (when devtype is cleared) follows mainline conventions rather than explicitly clearing it to handle edge cases.

Applied to files:

  • config/boards/mixtile-core3588e.csc
  • patch/u-boot/v2026.01/defconfig/mixtile-core3588e-rk3588_defconfig
  • patch/u-boot/v2026.01/dt_uboot/rk3588-mixtile-core3588e-u-boot.dtsi
📚 Learning: 2025-09-18T03:36:17.862Z
Learnt from: EvilOlaf
Repo: armbian/build PR: 8537
File: config/boards/qcom-robotics-rb5.conf:1-1
Timestamp: 2025-09-18T03:36:17.862Z
Learning: In Armbian board configuration files (regardless of file extension), the standard pattern is to have only one line as a comment describing the board hardware specifications. This single-line description typically includes the SoC model, core count, RAM options, and key features like connectivity options, storage interfaces, and special features. The file extensions indicate board support status: .conf (standard support), .csc (community supported), .eos (end of support), .tvb (tvbox), .wip (work in progress).

Applied to files:

  • config/boards/mixtile-core3588e.csc
📚 Learning: 2025-09-18T03:36:17.862Z
Learnt from: EvilOlaf
Repo: armbian/build PR: 8537
File: config/boards/qcom-robotics-rb5.conf:1-1
Timestamp: 2025-09-18T03:36:17.862Z
Learning: In Armbian board configuration files, .wip and .conf extensions require BOARD_MAINTAINER to be present and contain at least one maintainer. If no maintainer is present, the board support rules state it does not qualify for standard support and must be moved to community support (.csc extension). This is documented at https://docs.armbian.com/User-Guide_Board-Support-Rules/

Applied to files:

  • config/boards/mixtile-core3588e.csc
📚 Learning: 2025-09-14T06:29:18.958Z
Learnt from: amazingfate
Repo: armbian/build PR: 8619
File: config/sources/families/rockchip.conf:64-70
Timestamp: 2025-09-14T06:29:18.958Z
Learning: In the Armbian build system, vendor branch configurations in family files are designed to be shared across multiple SoCs within the same family that use the same vendor kernel tree. For example, rk35xx and rockchip-rk3588 families both use identical vendor branch settings (same KERNELSOURCE, KERNELBRANCH, and KERNELPATCHDIR), demonstrating that vendor branches are intentionally generic rather than SoC-specific.

Applied to files:

  • config/boards/mixtile-core3588e.csc
  • patch/u-boot/v2026.01/defconfig/mixtile-core3588e-rk3588_defconfig
📚 Learning: 2025-12-13T11:45:02.422Z
Learnt from: pyavitz
Repo: armbian/build PR: 9058
File: patch/u-boot/legacy/u-boot-spacemit-k1/003-SpacemiT-K1X-Fixups.patch:17-25
Timestamp: 2025-12-13T11:45:02.422Z
Learning: In the SpacemiT U-Boot patches for Armbian (patch/u-boot/legacy/u-boot-spacemit-k1/), the environment variable `devnum` is set to the device name string (e.g., "mmc", "nvme") rather than a numeric index, and `distro_bootpart` holds the partition number. This implementation aligns with mainline U-Boot conventions for the SpacemiT platform and has been verified to work correctly by the maintainer.

Applied to files:

  • config/boards/mixtile-core3588e.csc
  • patch/u-boot/v2026.01/defconfig/mixtile-core3588e-rk3588_defconfig
📚 Learning: 2025-09-12T19:28:38.491Z
Learnt from: Grippy98
Repo: armbian/build PR: 8622
File: config/sources/families/k3.conf:66-66
Timestamp: 2025-09-12T19:28:38.491Z
Learning: In the Armbian k3 family build system (config/sources/families/k3.conf), builds do not fail when TIBOOT3_BOOTCONFIG is unset, even though tiboot3.bin is still listed in UBOOT_TARGET_MAP. The gating mechanism in pre_config_uboot_target__build_first_stage function works as intended to conditionally build/copy tiboot3.bin only when TIBOOT3_BOOTCONFIG is defined.

Applied to files:

  • config/boards/mixtile-core3588e.csc
📚 Learning: 2025-11-06T15:36:04.682Z
Learnt from: rpardini
Repo: armbian/build PR: 8879
File: config/sources/families/uefi-x86.conf:0-0
Timestamp: 2025-11-06T15:36:04.682Z
Learning: As of PR #8879, the uefi-x86 family in the Armbian build system now includes kernel patches for the first time. The current and edge branches for uefi-x86 are specifically configured for Apple T2-based x86 machines, including T2-specific patches from the linux-t2 project and custom kernel configuration options for Apple hardware drivers.

Applied to files:

  • config/boards/mixtile-core3588e.csc
📚 Learning: 2025-08-02T05:46:10.664Z
Learnt from: EvilOlaf
Repo: armbian/build PR: 0
File: :0-0
Timestamp: 2025-08-02T05:46:10.664Z
Learning: In the Armbian build system, the modern recommended approach for kernel configuration is to use the kernel-config command via "./compile.sh BOARD=boardname BRANCH=branchname kernel-config" instead of the deprecated KERNEL_CONFIGURE=yes flag. This provides a two-step workflow: configure using menuconfig, then build, with better transparency and control over configuration changes.

Applied to files:

  • config/boards/mixtile-core3588e.csc
📚 Learning: 2025-10-14T05:08:11.785Z
Learnt from: EvilOlaf
Repo: armbian/build PR: 8754
File: config/boards/bestv-r3300-l.csc:14-16
Timestamp: 2025-10-14T05:08:11.785Z
Learning: In the Armbian build system, BOOTBRANCH_BOARD is a valid framework variable used as a fallback when BOOTBRANCH is unset. The framework checks BOOTBRANCH_BOARD before applying the default bootloader branch value (see config/sources/common.conf). Board configuration files can use BOOTBRANCH_BOARD to specify the bootloader branch.

Applied to files:

  • config/boards/mixtile-core3588e.csc
📚 Learning: 2025-07-25T03:51:50.830Z
Learnt from: EvilOlaf
Repo: armbian/build PR: 8428
File: config/boards/lckfb-taishanpi.csc:5-9
Timestamp: 2025-07-25T03:51:50.830Z
Learning: When reviewing PRs in the Armbian build system, U-Boot defconfig files and patches may be added as part of the PR changes but might not be visible in the current repository clone state during review. It's important to check the actual PR file changes directly via GitHub or the PR API to get the complete picture of what files are being added or modified.

Applied to files:

  • patch/u-boot/v2026.01/defconfig/mixtile-core3588e-rk3588_defconfig
  • patch/u-boot/v2026.01/dt_uboot/rk3588-mixtile-core3588e-u-boot.dtsi
📚 Learning: 2025-03-31T22:20:48.475Z
Learnt from: rpardini
Repo: armbian/build PR: 8044
File: patch/u-boot/v2025.04/cmd-fileenv-read-string-from-file-into-env.patch:76-86
Timestamp: 2025-03-31T22:20:48.475Z
Learning: For the Armbian build project, maintaining consistency with existing patches across U-Boot versions (such as between 2025.01 and 2025.04) is prioritized over refactoring individual patches for code improvements.

Applied to files:

  • patch/u-boot/v2026.01/defconfig/mixtile-core3588e-rk3588_defconfig
  • patch/u-boot/v2026.01/dt_uboot/rk3588-mixtile-core3588e-u-boot.dtsi
📚 Learning: 2025-10-22T07:51:53.015Z
Learnt from: igorpecovnik
Repo: armbian/build PR: 8789
File: config/kernel/linux-sunxi64-edge.config:839-839
Timestamp: 2025-10-22T07:51:53.015Z
Learning: In Armbian's wireless driver configuration, CONFIG_RK_WIFI_DEVICE_* options are Rockchip-specific device registration settings, while CONFIG_WLAN_UWE* are the actual cross-platform driver modules for UWE5622 wireless chips. The UWE5622 chip (manufactured by Unisoc/Spreadtrum) is used on multiple Allwinner boards including Orange Pi Zero 2/2W/3 and Orange Pi 3 LTS, so CONFIG_WLAN_UWE5621/5622 along with Unisoc infrastructure options (CONFIG_SPARD_WLAN_SUPPORT, CONFIG_SC23XX, CONFIG_UNISOC_WIFI_PS, CONFIG_WCN_BSP_DRIVER_BUILDIN) are correct in sunxi64 kernel configs.

Applied to files:

  • patch/u-boot/v2026.01/defconfig/mixtile-core3588e-rk3588_defconfig
  • patch/u-boot/v2026.01/dt_uboot/rk3588-mixtile-core3588e-u-boot.dtsi
📚 Learning: 2025-03-31T22:20:41.849Z
Learnt from: rpardini
Repo: armbian/build PR: 8044
File: patch/u-boot/v2025.04/cmd-fileenv-read-string-from-file-into-env.patch:73-75
Timestamp: 2025-03-31T22:20:41.849Z
Learning: When porting patches between U-Boot versions (like from 2025.01 to 2025.04), rpardini prefers to maintain patches as-is rather than introducing refactoring changes, even when potential improvements are identified. This approach prioritizes consistency and reduces the risk of introducing new issues.

Applied to files:

  • patch/u-boot/v2026.01/defconfig/mixtile-core3588e-rk3588_defconfig
  • patch/u-boot/v2026.01/dt_uboot/rk3588-mixtile-core3588e-u-boot.dtsi
📚 Learning: 2025-08-30T04:13:16.457Z
Learnt from: tabrisnet
Repo: armbian/build PR: 0
File: :0-0
Timestamp: 2025-08-30T04:13:16.457Z
Learning: Armbian kernel configuration files like linux-filogic-current.config are autogenerated overlays on top of arch defconfig. Comments added manually will be lost during future updates by maintainers, and explicit "CONFIG_OPTION is not set" statements aren't needed for mutually exclusive options since these are overlay configs that only specify changes from the base configuration.

Applied to files:

  • patch/u-boot/v2026.01/defconfig/mixtile-core3588e-rk3588_defconfig
📚 Learning: 2025-07-27T15:53:30.629Z
Learnt from: pyavitz
Repo: armbian/build PR: 8421
File: config/kernel/linux-sunxi64-edge.config:805-825
Timestamp: 2025-07-27T15:53:30.629Z
Learning: In the Armbian build system, kernel configurations prioritize broad hardware compatibility over optimization concerns. Even when including numerous legacy/obsolete drivers causes technical issues like increased initramfs size and slower enumeration, the project philosophy is to "appease the masses" by ensuring maximum device compatibility rather than optimizing for specific use cases.

Applied to files:

  • patch/u-boot/v2026.01/defconfig/mixtile-core3588e-rk3588_defconfig
📚 Learning: 2025-10-26T12:56:29.185Z
Learnt from: rpardini
Repo: armbian/build PR: 8820
File: config/sources/families/include/meson64_common.inc:51-53
Timestamp: 2025-10-26T12:56:29.185Z
Learning: In the Armbian build framework, scripts/config correctly handles kernel configuration option names both with and without the CONFIG_ prefix, so opts_m+=("CONFIG_RTL8822CS") and opts_m+=("RTL8822CS") are both valid and will work correctly.

Applied to files:

  • patch/u-boot/v2026.01/defconfig/mixtile-core3588e-rk3588_defconfig
📚 Learning: 2025-10-22T07:56:19.424Z
Learnt from: igorpecovnik
Repo: armbian/build PR: 8789
File: config/kernel/linux-sunxi64-edge.config:839-839
Timestamp: 2025-10-22T07:56:19.424Z
Learning: In Linux kernel configuration, some `=y` (builtin) options are infrastructure or feature flags that enable subsystems or features for modular drivers, rather than directly compiling code into the kernel. For example, in Armbian wireless configs, options like CONFIG_SPARD_WLAN_SUPPORT=y, CONFIG_SC23XX=y, CONFIG_WCN_BSP_DRIVER_BUILDIN=y, CONFIG_UNISOC_WIFI_PS=y are module infrastructure/feature enablers, while the actual drivers (CONFIG_WLAN_UWE5621=m, CONFIG_WLAN_UWE5622=m) remain as loadable modules. These infrastructure options don't cause kernel bloat.

Applied to files:

  • patch/u-boot/v2026.01/defconfig/mixtile-core3588e-rk3588_defconfig
📚 Learning: 2025-11-20T18:20:11.985Z
Learnt from: EvilOlaf
Repo: armbian/build PR: 8968
File: patch/u-boot/u-boot-sunxi/arm64-dts-sun50i-h6-orangepi.dtsi-Rollback-r_rsb-to-r_i2c.patch:36-36
Timestamp: 2025-11-20T18:20:11.985Z
Learning: The rewrite-patches tool (REWRITE_PATCHES=yes) in the Armbian build system can inadvertently introduce semantic changes when the u-boot/kernel git base revision differs from expected state. The tool applies patches, commits them, and re-exports them using git format-patch, which can cause the re-exported patch to reflect the base revision's state rather than preserving the original patch intent. This is particularly problematic for device tree changes like interrupt specifications. The tool currently lacks validation mechanisms to detect such semantic drift, and affected patches must be manually corrected after rewriting.

Applied to files:

  • patch/u-boot/v2026.01/dt_uboot/rk3588-mixtile-core3588e-u-boot.dtsi
📚 Learning: 2025-09-14T06:10:25.610Z
Learnt from: EvilOlaf
Repo: armbian/build PR: 8619
File: config/sources/families/rockchip.conf:64-70
Timestamp: 2025-09-14T06:10:25.610Z
Learning: In the Armbian build system, rk32xx and rk33xx Rockchip SoCs no longer have BSP-based (vendor) kernel branches. The rk3506 is the first 32-bit Rockchip SoC to use the vendor branch in the current codebase.

Applied to files:

  • patch/u-boot/v2026.01/dt_uboot/rk3588-mixtile-core3588e-u-boot.dtsi
🔇 Additional comments (11)
patch/u-boot/v2026.01/dt_uboot/rk3588-mixtile-core3588e-u-boot.dtsi (1)

1-1: LGTM!

Standard U-Boot DT include pattern for RK3588 boards, pulling in generic U-Boot device tree definitions.

patch/u-boot/v2026.01/dt_upstream_rockchip/rk3588-mixtile-core3588e.dts (3)

1-104: LGTM!

Well-structured device tree header with proper SPDX license, model/compatible strings, aliases, chosen node, and root-level peripherals (fan, LEDs, regulators, HDMI connector). The regulator supply chains are correctly defined.


106-303: LGTM!

CPU, GPU, GMAC, and I2C configurations are correctly structured. The RTL8211F Ethernet PHY reset timing values are appropriate, and regulator references are consistent throughout.


305-903: LGTM!

Comprehensive thermal management with appropriate trip points, PCIe domain assignments, pinctrl definitions, and PMIC regulator tree. The USB configuration correctly sets host0 as peripheral (for OTG/maskrom) and host1 as host (for carrier board hub).

patch/u-boot/v2026.01/defconfig/mixtile-core3588e-rk3588_defconfig (1)

1-96: LGTM!

Well-structured U-Boot defconfig for RK3588 with appropriate feature enablement. Using CONFIG_TARGET_ROCK5B_RK3588 as a base target is a common pattern for RK3588 boards in mainline U-Boot when a dedicated board target doesn't exist. The device tree paths correctly reference the Mixtile-specific DTB, and essential features (SPL, ATF, FIT, PCIe, NVMe, USB gadget) are properly enabled.

config/boards/mixtile-core3588e.csc (3)

33-50: LGTM!

The mainline U-Boot override function is well-structured with proper blob mapping and the correct write_uboot_platform implementation using status=none per Armbian standards. Disabling Plymouth is a sensible choice for this board.


52-60: LGTM!

Boot order customization is appropriate for this board's hardware configuration (mmc1 first for SD card boot priority during development, then NVMe for production use).


38-38: Update BOOTBRANCH to use v2026.01-rc3 instead of v2026.01-rc4.

The version v2026.01-rc4 is not documented in the official U-Boot release schedule. The most recent officially released candidate is v2026.01-rc3 (November 24, 2025). The stable v2026.01 release is scheduled for January 5, 2026.

⛔ Skipped due to learnings
Learnt from: HackingGate
Repo: armbian/build PR: 8665
File: config/boards/photonicat2.csc:4-4
Timestamp: 2025-10-26T10:41:35.118Z
Learning: In the Armbian build system, rk3576 boards consistently use BOARDFAMILY="rk35xx" for both vendor and edge kernel targets. The rk35xx family configuration sources rockchip64_common.inc, which provides edge and current kernel branch definitions, making these branches available even though they're not defined directly in rk35xx.conf.
Learnt from: igorpecovnik
Repo: armbian/build PR: 8849
File: config/boards/radxa-e54c.csc:14-28
Timestamp: 2025-11-02T20:49:56.719Z
Learning: In Armbian board configuration files (config/boards/*.conf, *.csc, etc.), do not use kernel_config_set, kernel_config_set_m, kernel_config_set_y, or custom_kernel_config__* functions to modify kernel configuration. Kernel configuration is associated with LINUXFAMILY/BOARDFAMILY, not individual BOARD. Board-specific kernel modifications cause inconsistency in kernel packages published to the apt repository because boards within a family share the same kernel packages. Kernel configuration changes must be made in the appropriate kernel config file (e.g., config/kernel/linux-*-*.config) or in family configuration files (config/sources/families/*.conf, *.inc) instead.
Learnt from: EvilOlaf
Repo: armbian/build PR: 8537
File: config/boards/qcom-robotics-rb5.conf:1-1
Timestamp: 2025-09-18T03:36:17.862Z
Learning: In Armbian board configuration files, .wip and .conf extensions require BOARD_MAINTAINER to be present and contain at least one maintainer. If no maintainer is present, the board support rules state it does not qualify for standard support and must be moved to community support (.csc extension). This is documented at https://docs.armbian.com/User-Guide_Board-Support-Rules/
Learnt from: EvilOlaf
Repo: armbian/build PR: 8537
File: config/boards/qcom-robotics-rb5.conf:1-1
Timestamp: 2025-09-18T03:36:17.862Z
Learning: In Armbian board configuration files (regardless of file extension), the standard pattern is to have only one line as a comment describing the board hardware specifications. This single-line description typically includes the SoC model, core count, RAM options, and key features like connectivity options, storage interfaces, and special features. The file extensions indicate board support status: .conf (standard support), .csc (community supported), .eos (end of support), .tvb (tvbox), .wip (work in progress).
Learnt from: rpardini
Repo: armbian/build PR: 8044
File: patch/u-boot/v2025.04/cmd-fileenv-read-string-from-file-into-env.patch:76-86
Timestamp: 2025-03-31T22:20:48.475Z
Learning: For the Armbian build project, maintaining consistency with existing patches across U-Boot versions (such as between 2025.01 and 2025.04) is prioritized over refactoring individual patches for code improvements.
Learnt from: tabrisnet
Repo: armbian/build PR: 8913
File: config/sources/families/k3-beagle.conf:16-16
Timestamp: 2025-11-10T22:05:40.490Z
Learning: In the Armbian build system, kernel branches using non-mainline/vendor forks (like BeagleBoard's linux repository) should be named "vendor" or "vendor-rt" rather than "current" or "edge". The "current" and "edge" naming is reserved for mainline kernel branches. This affects both the case statement in family config files (e.g., `vendor | vendor-rt)` instead of `current | current-rt)`) and the corresponding KERNEL_TARGET declarations in board config files.
Learnt from: amazingfate
Repo: armbian/build PR: 8619
File: config/sources/families/rockchip.conf:222-230
Timestamp: 2025-09-14T06:32:29.806Z
Learning: In the Armbian build system, the write_uboot_platform() function implementations follow different patterns across Rockchip family files. The newer standard (used in rockchip64_common.inc and rk3506) includes 'status=none' parameter in dd commands, while older implementations (rk3288, rk322x) use an older pattern without this parameter. The rk3506 implementation correctly follows the current Rockchip family standard.
Learnt from: EvilOlaf
Repo: armbian/build PR: 8428
File: config/boards/lckfb-taishanpi.csc:5-9
Timestamp: 2025-07-25T03:51:50.830Z
Learning: When reviewing PRs in the Armbian build system, U-Boot defconfig files and patches may be added as part of the PR changes but might not be visible in the current repository clone state during review. It's important to check the actual PR file changes directly via GitHub or the PR API to get the complete picture of what files are being added or modified.
Learnt from: amazingfate
Repo: armbian/build PR: 8619
File: config/sources/families/rockchip.conf:64-70
Timestamp: 2025-09-14T06:29:18.958Z
Learning: In the Armbian build system, vendor branch configurations in family files are designed to be shared across multiple SoCs within the same family that use the same vendor kernel tree. For example, rk35xx and rockchip-rk3588 families both use identical vendor branch settings (same KERNELSOURCE, KERNELBRANCH, and KERNELPATCHDIR), demonstrating that vendor branches are intentionally generic rather than SoC-specific.
Learnt from: EvilOlaf
Repo: armbian/build PR: 8754
File: config/boards/bestv-r3300-l.csc:14-16
Timestamp: 2025-10-14T05:08:11.785Z
Learning: In the Armbian build system, BOOTBRANCH_BOARD is a valid framework variable used as a fallback when BOOTBRANCH is unset. The framework checks BOOTBRANCH_BOARD before applying the default bootloader branch value (see config/sources/common.conf). Board configuration files can use BOOTBRANCH_BOARD to specify the bootloader branch.
Learnt from: The-going
Repo: armbian/build PR: 8147
File: config/sources/families/include/sunxi64_common.inc:38-39
Timestamp: 2025-04-30T16:16:47.150Z
Learning: The Armbian build system references Linux kernel versions in the form "tag:v6.14.4" in the KERNELBRANCH variable, even when point release tags might not be directly visible in the upstream repository in the same form.
Learnt from: EvilOlaf
Repo: armbian/build PR: 8417
File: config/boards/orangepi5pro.csc:57-58
Timestamp: 2025-07-23T07:30:52.265Z
Learning: In the Armbian build system, BOOTPATCHDIR can contain board-specific subdirectories (e.g., board_orangepi5pro) for applying patches to specific boards only. The framework automatically checks if such board-specific subdirectories exist for the board being built and applies those patches accordingly.
patch/kernel/archive/rockchip64-6.18/dt/rk3588-mixtile-core3588e.dts (3)

1-104: LGTM!

Kernel device tree header is correctly structured with proper licensing, model/compatible strings, and root-level hardware definitions. The DT maintains consistency with the U-Boot variant while targeting the Linux kernel.


890-922: LGTM!

NPU support is correctly added for the kernel device tree. The pd_npu power domain and all three RKNN cores with their respective MMUs properly reference the vdd_npu_s0 regulator defined on i2c1. This is appropriately present only in the kernel DT (not U-Boot) as NPU functionality is not needed during boot.


924-937: LGTM!

VOP and HDMI endpoint wiring is correctly defined, matching the U-Boot DT configuration for display output.

@rpardini
Copy link
Member Author

  • BOARD_VENDOR not found in config/boards/mixtile-core3588e.csc

    • Fix: add e.g. BOARD_VENDOR="radxa" (lowercase recommended)

Wrong, I already have declare -g BOARD_VENDOR="mixtile" in the board file.

@rpardini
Copy link
Member Author

  • Expected: board-images/mixtile-core3588e.png

There's an image at https://dh19rycdk230a.cloudfront.net/app/uploads/2023/11/231113-C3588E-Pic.webp but I've no image editor et al.

@rpardini
Copy link
Member Author

Hardware notes:

Images copy/pasted for posterity:
image

image

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

02 Milestone: First quarter release Hardware Hardware related like kernel, U-Boot, ... Needs review Seeking for review Patches Patches related to kernel, U-Boot, ... size/large PR with 250 lines or more

Development

Successfully merging this pull request may close these issues.

1 participant