mirror of
https://git.savannah.gnu.org/git/guix.git
synced 2026-04-06 21:20:33 +02:00
99b6b83230
* gnu/bootloader/u-boot.scm (u-boot-am335x-evm-bootloader): New exported variable. Change-Id: I258f7b7b31e7b7597710b8ff30d7a5ed882e147c Signed-off-by: Denis 'GNUtoo' Carikli <GNUtoo@cyberdimension.org> Signed-off-by: Vagrant Cascadian <vagrant@debian.org>
393 lines
14 KiB
Scheme
393 lines
14 KiB
Scheme
;;; GNU Guix --- Functional package management for GNU
|
||
;;; Copyright © 2017 David Craven <david@craven.ch>
|
||
;;; Copyright © 2017, 2019 Mathieu Othacehe <m.othacehe@gmail.com>
|
||
;;; Copyright © 2020 Julien Lepiller <julien@lepiller.eu>
|
||
;;; Copyright © 2020 Jan (janneke) Nieuwenhuizen <janneke@gnu.org>
|
||
;;; Copyright © 2022 Maxim Cournoyer <maxim@guixotic.coop>
|
||
;;; Copyright © 2023 Efraim Flashner <efraim@flashner.co.il>
|
||
;;; Copyright © 2023-2024 Herman Rimm <herman@rimm.ee>
|
||
;;; Copyright © 2024 Zheng Junjie <873216071@qq.com>
|
||
;;; Copyright © 2025 dan <i@dan.games>
|
||
;;; Copyright © 2026 Artyom V. Poptsov <poptsov.artyom@gmail.com>
|
||
;;;
|
||
;;; This file is part of GNU Guix.
|
||
;;;
|
||
;;; GNU Guix is free software; you can redistribute it and/or modify it
|
||
;;; under the terms of the GNU General Public License as published by
|
||
;;; the Free Software Foundation; either version 3 of the License, or (at
|
||
;;; your option) any later version.
|
||
;;;
|
||
;;; GNU Guix is distributed in the hope that it will be useful, but
|
||
;;; WITHOUT ANY WARRANTY; without even the implied warranty of
|
||
;;; MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
|
||
;;; GNU General Public License for more details.
|
||
;;;
|
||
;;; You should have received a copy of the GNU General Public License
|
||
;;; along with GNU Guix. If not, see <http://www.gnu.org/licenses/>.
|
||
|
||
(define-module (gnu bootloader u-boot)
|
||
#:use-module (gnu bootloader extlinux)
|
||
#:use-module (gnu bootloader)
|
||
#:use-module (gnu packages bootloaders)
|
||
#:use-module (guix gexp)
|
||
#:use-module (ice-9 match)
|
||
#:export (u-boot-bootloader
|
||
u-boot-a20-olinuxino-lime-bootloader
|
||
u-boot-a20-olinuxino-lime2-bootloader
|
||
u-boot-a20-olinuxino-micro-bootloader
|
||
u-boot-bananapi-m2-ultra-bootloader
|
||
u-boot-am335x-evm-bootloader
|
||
u-boot-beaglebone-black-bootloader
|
||
u-boot-cubietruck-bootloader
|
||
u-boot-firefly-rk3399-bootloader
|
||
u-boot-mx6cuboxi-bootloader
|
||
u-boot-nintendo-nes-classic-edition-bootloader
|
||
u-boot-novena-bootloader
|
||
u-boot-orangepi-r1-plus-lts-rk3328-bootloader
|
||
u-boot-orangepi-zero2w-bootloader
|
||
u-boot-pine64-plus-bootloader
|
||
u-boot-pine64-lts-bootloader
|
||
u-boot-pinebook-bootloader
|
||
u-boot-pinebook-pro-rk3399-bootloader
|
||
u-boot-nanopi-r4s-rk3399-bootloader
|
||
u-boot-puma-rk3399-bootloader
|
||
u-boot-rock-4c-plus-rk3399-bootloader
|
||
u-boot-rock64-rk3328-bootloader
|
||
u-boot-rockpro64-rk3399-bootloader
|
||
u-boot-sifive-unmatched-bootloader
|
||
u-boot-qemu-riscv64-bootloader
|
||
u-boot-starfive-visionfive2-bootloader
|
||
u-boot-ts7970-q-2g-1000mhz-c-bootloader
|
||
u-boot-wandboard-bootloader))
|
||
|
||
(define (make-u-boot-installer file)
|
||
(let ((file
|
||
(match file
|
||
((? string?)
|
||
(list #~(install-file (string-append bootloader #$file)
|
||
install-dir)))
|
||
((? file-like?)
|
||
(list #~(mkdir-p install-dir)
|
||
#~(copy-file #$file
|
||
(string-append install-dir
|
||
"/"
|
||
#$(plain-file-name file)))))
|
||
(#f '()))))
|
||
#~(lambda (bootloader device mount-point)
|
||
(let ((install-dir (string-append mount-point "/boot")))
|
||
#$@file))))
|
||
|
||
(define (write-u-boot-image files block-size)
|
||
"FILES is a list of (FILE COUNT OFFSET) tuples. Each FILE is written
|
||
to the target image at BLOCK-SIZE * OFFSET. The number of bytes written
|
||
is BLOCK-SIZE * COUNT, or FILE size if COUNT is not given."
|
||
(define (write-file-to-image file)
|
||
(match file
|
||
((file count ... offset)
|
||
(let* ((file #~(string-append bootloader "/libexec/" #$file))
|
||
(size (match count
|
||
(() #~(stat:size (stat #$file)))
|
||
((count) (* count block-size)))))
|
||
#~(write-file-on-device #$file #$size image
|
||
#$(* offset block-size))))))
|
||
#~(lambda (bootloader _ image)
|
||
#$@(map write-file-to-image files)))
|
||
|
||
(define install-u-boot
|
||
#~(lambda (bootloader root-index image)
|
||
(if bootloader
|
||
(error "Failed to install U-Boot"))))
|
||
|
||
(define install-am335x-evm-u-boot
|
||
(write-u-boot-image
|
||
;; According to the "26.1.8.5.5 MMC/SD Read Sector Procedure in Raw Mode"
|
||
;; section in the "AM335x and AMIC110 Sitara™ Processors Technical
|
||
;; Reference Manual", we have offset, the bootrom tries to load code at the
|
||
;; offsets 0x0, 0x20000 (128KB), 0x40000 (256KB) and 0x60000 (384KB).
|
||
;;
|
||
;; The MBR is 512 Bytes
|
||
;; (https://en.wikipedia.org/wiki/Master_boot_record#Sector_layout).
|
||
;;
|
||
;; At the time of writing, u-boot.img is 1.4 MiB, and it is at offset
|
||
;; 0x60000 (384KB) as per CONFIG_SYS_MMCSD_RAW_MODE_U_BOOT_SECTOR.
|
||
;;
|
||
;; We also need to align the first partition to make sure read/writes are
|
||
;; properly aligned.
|
||
;;
|
||
;; Given these constraints, we chose the following partitioning:
|
||
;;
|
||
;; 0 512 Bytes 128 KiB
|
||
;; | | (0x20000) 256 KiB
|
||
;; | | / (0x40000) 384 KiB 4 MiB
|
||
;; | | / | (0x60000) |
|
||
;; | | / | | |
|
||
;; v v / v v v
|
||
;; +-------+ +--------------+---------------+----------------+
|
||
;; | MBR | ... | First MLO | Second MLO | u-boot.img |
|
||
;; +-------+ +--------------+---------------+----------------+
|
||
;; <-512 B-> ... <-- 128 KiB --> <-- 128 KiB --> <-- 3712 KiB -->
|
||
;;
|
||
;; The rationale for that is as follows:
|
||
;;
|
||
;; - We add a second copy of the MLO at 256 KiB for improving reliability
|
||
;; as the doc/board/ti/am335x_evm.rst documentation in u-boot advise us
|
||
;; to do that, and also because the space there isn't used.
|
||
;;
|
||
;; - All can fit into 2MiB (u-boot.img can grow up to 1664 KiB), but we
|
||
;; want a bit more space in case u-boot.img grows over time, so we allow
|
||
;; u-boot to grow until the 4 MiB offset.
|
||
'(("MLO" 256 256) ;; First MLO
|
||
("MLO" 256 512) ;; Second MLO
|
||
("u-boot.img" 7424 768)) 512))
|
||
|
||
(define install-beaglebone-black-u-boot
|
||
;; http://wiki.beyondlogic.org/index.php?title=BeagleBoneBlack_Upgrading_uBoot
|
||
;; This first stage bootloader called MLO (U-Boot SPL) is expected at
|
||
;; 0x20000 by BBB ROM code. The second stage bootloader will be loaded by
|
||
;; the MLO and is expected at 0x60000. Write both first stage ("MLO") and
|
||
;; second stage ("u-boot.img") images, read in BOOTLOADER directory, to the
|
||
;; specified DEVICE.
|
||
(write-u-boot-image '(("MLO" 256 256) ("u-boot.img" 768 1024)) 512))
|
||
|
||
(define install-allwinner-u-boot
|
||
(write-u-boot-image '(("u-boot-sunxi-with-spl.bin" 8)) 1024))
|
||
|
||
(define install-allwinner64-u-boot
|
||
(write-u-boot-image '(("u-boot-sunxi-with-spl.bin" 8)
|
||
("u-boot-sunxi-with-spl.fit.itb" 40))
|
||
1024))
|
||
|
||
(define install-imx-u-boot
|
||
(write-u-boot-image '(("SPL" 1) ("u-boot.img" 69)) 1024))
|
||
|
||
(define install-puma-rk3399-u-boot
|
||
(write-u-boot-image '(("idbloader.img" 64) ("u-boot.itb" 512)) 512))
|
||
|
||
(define install-rockchip-u-boot
|
||
(write-u-boot-image '(("idbloader.img" 64) ("u-boot.itb" 16384)) 512))
|
||
|
||
(define install-sifive-unmatched-u-boot
|
||
(write-u-boot-image '(("spl/u-boot-spl.bin" 34) ("u-boot.itb" 2082))
|
||
512))
|
||
|
||
(define install-starfive-visionfive2-u-boot
|
||
(write-u-boot-image '(("spl/u-boot-spl.bin.normal.out" 34)
|
||
("u-boot.itb" 2082))
|
||
512))
|
||
|
||
(define install-starfive-visionfive2-uEnv.txt
|
||
(make-u-boot-installer
|
||
;; If the board SPI uses the vendor's U-Boot, it will find starfive/
|
||
;; starfive_visionfive2.dtb. We cannot guarantee that users will
|
||
;; update this U-Boot, so set the FDT explicitly.
|
||
(plain-file "uEnv.txt"
|
||
(string-join
|
||
(list
|
||
"boot_targets=mmc1 nvme0 mmc0 dhcp"
|
||
"bootcmd_mmc1=bootflow scan"
|
||
"fdtfile=starfive/jh7110-starfive-visionfive-2-v1.3b.dtb")
|
||
"\n"))))
|
||
|
||
|
||
;;;
|
||
;;; Bootloader definitions.
|
||
;;;
|
||
|
||
(define u-boot-bootloader
|
||
(bootloader
|
||
(inherit extlinux-bootloader)
|
||
(name 'u-boot)
|
||
(package #f)
|
||
(installer #f)
|
||
(disk-image-installer install-u-boot)))
|
||
|
||
(define u-boot-am335x-evm-bootloader
|
||
(bootloader
|
||
(inherit u-boot-bootloader)
|
||
;; This bootloader supports the following computers:
|
||
;; - SanCloud BeagleBone Enhanced
|
||
;; - SanCloud BeagleBone Enhanced Extended WiFi
|
||
;; - SanCloud BeagleBone Enhanced Lite
|
||
;; - Seeed Studio BeagleBone Green Eco
|
||
;; - TI AM3359 ICE-V2
|
||
;; - TI AM335x BeagleBone
|
||
;; - TI AM335x BeagleBone Black
|
||
;; - TI AM335x BeagleBone Green
|
||
;; - TI AM335x EVM
|
||
;; - TI AM335x EVM-SK
|
||
;; - TI AM335x PocketBeagle
|
||
;;
|
||
;; This list was made by retrieving the list of Devicetrees used in
|
||
;; configs/am335x_evm_defconfig in u-boot source code. Once we have that we
|
||
;; can look at each Devicetree in arch/arm/boot/dts/ti/omap/ inside Linux,
|
||
;; and in each file, look at the model property to find the name of the
|
||
;; computers that this image supports.
|
||
(package u-boot-am335x-evm)
|
||
;; At the time of writing, our u-boot.img is 1.4 MiB. This is why we can't
|
||
;; reuse install-beaglebone-black-u-boot. And having the same image being
|
||
;; able to boot on multiple computers is useful.
|
||
(disk-image-installer install-am335x-evm-u-boot)))
|
||
|
||
(define u-boot-beaglebone-black-bootloader
|
||
(bootloader
|
||
(inherit u-boot-bootloader)
|
||
(package u-boot-am335x-boneblack)
|
||
(disk-image-installer install-beaglebone-black-u-boot)))
|
||
|
||
(define u-boot-allwinner-bootloader
|
||
(bootloader
|
||
(inherit u-boot-bootloader)
|
||
(disk-image-installer install-allwinner-u-boot)))
|
||
|
||
(define u-boot-allwinner64-bootloader
|
||
(bootloader
|
||
(inherit u-boot-bootloader)
|
||
(disk-image-installer install-allwinner64-u-boot)))
|
||
|
||
(define u-boot-imx-bootloader
|
||
(bootloader
|
||
(inherit u-boot-bootloader)
|
||
(disk-image-installer install-imx-u-boot)))
|
||
|
||
(define u-boot-rockchip-bootloader
|
||
;; SD and eMMC use the same format
|
||
(bootloader
|
||
(inherit u-boot-bootloader)
|
||
(disk-image-installer install-rockchip-u-boot)))
|
||
|
||
(define u-boot-nintendo-nes-classic-edition-bootloader
|
||
(bootloader
|
||
(inherit u-boot-allwinner-bootloader)
|
||
(package u-boot-nintendo-nes-classic-edition)))
|
||
|
||
(define u-boot-a20-olinuxino-lime-bootloader
|
||
(bootloader
|
||
(inherit u-boot-allwinner-bootloader)
|
||
(package u-boot-a20-olinuxino-lime)))
|
||
|
||
(define u-boot-a20-olinuxino-lime2-bootloader
|
||
(bootloader
|
||
(inherit u-boot-allwinner-bootloader)
|
||
(package u-boot-a20-olinuxino-lime2)))
|
||
|
||
(define u-boot-a20-olinuxino-micro-bootloader
|
||
(bootloader
|
||
(inherit u-boot-allwinner-bootloader)
|
||
(package u-boot-a20-olinuxino-micro)))
|
||
|
||
(define u-boot-bananapi-m2-ultra-bootloader
|
||
(bootloader
|
||
(inherit u-boot-allwinner-bootloader)
|
||
(package u-boot-bananapi-m2-ultra)))
|
||
|
||
(define u-boot-cubietruck-bootloader
|
||
(bootloader
|
||
(inherit u-boot-allwinner-bootloader)
|
||
(package u-boot-cubietruck)))
|
||
|
||
(define u-boot-firefly-rk3399-bootloader
|
||
(bootloader
|
||
(inherit u-boot-rockchip-bootloader)
|
||
(package u-boot-firefly-rk3399)))
|
||
|
||
(define u-boot-mx6cuboxi-bootloader
|
||
(bootloader
|
||
(inherit u-boot-imx-bootloader)
|
||
(package u-boot-mx6cuboxi)))
|
||
|
||
(define u-boot-wandboard-bootloader
|
||
(bootloader
|
||
(inherit u-boot-imx-bootloader)
|
||
(package u-boot-wandboard)))
|
||
|
||
(define u-boot-novena-bootloader
|
||
(bootloader
|
||
(inherit u-boot-imx-bootloader)
|
||
(package u-boot-novena)))
|
||
|
||
(define u-boot-orangepi-r1-plus-lts-rk3328-bootloader
|
||
(bootloader
|
||
(inherit u-boot-rockchip-bootloader)
|
||
(package u-boot-orangepi-r1-plus-lts-rk3328)))
|
||
|
||
(define u-boot-orangepi-zero2w-bootloader
|
||
(bootloader
|
||
(inherit u-boot-allwinner-bootloader)
|
||
(package u-boot-orangepi-zero2w)))
|
||
|
||
(define u-boot-pine64-plus-bootloader
|
||
(bootloader
|
||
(inherit u-boot-allwinner64-bootloader)
|
||
(package u-boot-pine64-plus)))
|
||
|
||
(define u-boot-pine64-lts-bootloader
|
||
(bootloader
|
||
(inherit u-boot-allwinner-bootloader)
|
||
(package u-boot-pine64-lts)))
|
||
|
||
(define u-boot-pinebook-bootloader
|
||
(bootloader
|
||
(inherit u-boot-allwinner64-bootloader)
|
||
(package u-boot-pinebook)))
|
||
|
||
(define u-boot-puma-rk3399-bootloader
|
||
(bootloader
|
||
(inherit u-boot-bootloader)
|
||
(package u-boot-puma-rk3399)
|
||
(disk-image-installer install-puma-rk3399-u-boot)))
|
||
|
||
(define u-boot-rock-4c-plus-rk3399-bootloader
|
||
(bootloader
|
||
(inherit u-boot-rockchip-bootloader)
|
||
(package u-boot-rock-4c-plus-rk3399)))
|
||
|
||
(define u-boot-rock64-rk3328-bootloader
|
||
(bootloader
|
||
(inherit u-boot-rockchip-bootloader)
|
||
(package u-boot-rock64-rk3328)))
|
||
|
||
(define u-boot-rockpro64-rk3399-bootloader
|
||
(bootloader
|
||
(inherit u-boot-rockchip-bootloader)
|
||
(package u-boot-rockpro64-rk3399)))
|
||
|
||
(define u-boot-pinebook-pro-rk3399-bootloader
|
||
(bootloader
|
||
(inherit u-boot-rockchip-bootloader)
|
||
(package u-boot-pinebook-pro-rk3399)))
|
||
|
||
(define u-boot-nanopi-r4s-rk3399-bootloader
|
||
(bootloader
|
||
(inherit u-boot-rockchip-bootloader)
|
||
(package u-boot-nanopi-r4s-rk3399)))
|
||
|
||
(define u-boot-ts7970-q-2g-1000mhz-c-bootloader
|
||
;; This bootloader doesn't really need to be installed, as it is read from
|
||
;; an SPI memory chip, not the SD card. It is copied to /boot/u-boot.imx
|
||
;; for convenience and should be manually flashed at the U-Boot prompt.
|
||
(bootloader
|
||
(inherit u-boot-bootloader)
|
||
(package u-boot-ts7970-q-2g-1000mhz-c)
|
||
(installer (make-u-boot-installer "libexec/u-boot.imx"))
|
||
(disk-image-installer #f)))
|
||
|
||
(define u-boot-sifive-unmatched-bootloader
|
||
(bootloader
|
||
(inherit u-boot-bootloader)
|
||
(package u-boot-sifive-unmatched)
|
||
(disk-image-installer install-sifive-unmatched-u-boot)))
|
||
|
||
(define u-boot-starfive-visionfive2-bootloader
|
||
(bootloader
|
||
(inherit u-boot-bootloader)
|
||
(package u-boot-starfive-visionfive2)
|
||
(installer install-starfive-visionfive2-uEnv.txt)
|
||
(disk-image-installer install-starfive-visionfive2-u-boot)))
|
||
|
||
(define u-boot-qemu-riscv64-bootloader
|
||
(bootloader
|
||
(inherit u-boot-bootloader)
|
||
(package u-boot-qemu-riscv64)
|
||
(installer (make-u-boot-installer "libexec/u-boot.bin"))
|
||
(disk-image-installer #f)))
|