tools/sunxi: Use mkimage for SPL generation
Subsystems (3)
v4 cover tools/sunxi: Use mkimage for SPL generation
Hi,
a small update fixing the strncpy bug and addressing too long DT names properly. Thanks to Samuel for pointing this out.
==================
So far creating a bootable SPL image for Allwinner based boards uses the mksunxiboot tool. Most other platforms seemed to have integrated this kind of functionality into the common mkimage tool.
Since there is nothing special about the Allwinner image in this respect, just add support for the so-called "eGON" image type into mkimage. If there was a particular reason this hasn't been done before, please let me know.
This will eventually allow us to remove mksunxiboot, but I leave it around for now in case of regressions and since some people depend on it from external projects.
Patch 1/3 splits some existing sunxi specific header file, so we can share the eGON header definition between the tools and the SPL. Patch 2/3 adds the actual support to mkimage, patch 3/3 then switches the Makefile to use mkimage instead of mksunxiboot.
I tested all 152 Allwinner boards by building each u-boot-sunxi-with-spl.bin and comparing them against the version created using mksunxiboot (using SOURCE_DATE_EPOCH and .scmversion to create reproducible builds, and by reverting just patch 3/3).
All files before and after were identical.
Cheers,
Andre
Changelog v3 .. v4:
- properly check DT name length before inserting into header
Changelog v2 .. v3:
- factor out eGON struct into separate header file
- only print extended header information when applicable
- remove redundant alignment
- minor cosmetic fixes
Changelog v1 .. v2:
- Drop already merged cleanup patch (v1 1/3)
- replace relative include path
- remove already defined ALIGN macro
- rebase against current master
Andre Przywara (3):
sunxi: Factor out eGON BROM header description
tools: mkimage: Add Allwinner eGON support
sunxi: Use mkimage for SPL boot image generation
arch/arm/include/asm/arch-sunxi/spl.h | 65 +----------- common/image.c | 1 + include/image.h | 1 + include/sunxi_image.h | 82 ++++++++++++++++ scripts/Makefile.spl | 8 +- tools/Makefile | 1 + tools/sunxi_egon.c | 136 ++++++++++++++++++++++++++ 7 files changed, 226 insertions(+), 68 deletions(-) create mode 100644 include/sunxi_image.h create mode 100644 tools/sunxi_egon.c
Signature · 1 line
2.17.5
PATCH v4 1/3 sunxi: Factor out eGON BROM header description
To be able to easily share the Allwinner eGON BROM header structure between the tools and the SPL code, move the struct definition into a separate header file.
--- arch/arm/include/asm/arch-sunxi/spl.h | 65 +-------------------- include/sunxi_image.h | 81 +++++++++++++++++++++++++++ 2 files changed, 82 insertions(+), 64 deletions(-) create mode 100644 include/sunxi_image.h
arch/arm/include/asm/arch-sunxi/spl.h +1 -64
@@ -7,19 +7,7 @@#ifndef _ASM_ARCH_SPL_H_#define _ASM_ARCH_SPL_H_ -#define BOOT0_MAGIC "eGON.BT0" -#define SPL_SIGNATURE "SPL"/* marks "sunxi" SPL header */ -#define SPL_MAJOR_BITS 3 -#define SPL_MINOR_BITS 5 -#define SPL_VERSION (maj, min) \ - ((((maj) & ((1U << SPL_MAJOR_BITS) - 1)) << SPL_MINOR_BITS) | \ - ((min) & ((1U << SPL_MINOR_BITS) - 1))) - -#define SPL_HEADER_VERSION SPL_VERSION(0, 2) - -#define SPL_ENV_HEADER_VERSION SPL_VERSION(0, 1) -#define SPL_DT_HEADER_VERSION SPL_VERSION(0, 2) -#define SPL_DRAM_HEADER_VERSION SPL_VERSION(0, 3) +#include <sunxi_image.h> #define SPL_ADDR CONFIG_SUNXI_SRAM_ADDRESS
@@ -31,57 +19,6 @@#define SUNXI_BOOTED_FROM_MMC0_HIGH 0x10#define SUNXI_BOOTED_FROM_MMC2_HIGH 0x12 -/* boot head definition from sun4i boot code */ -struct boot_file_head { -uint32_t b_instruction;/* one intruction jumping to real code */ -uint8_t magic[8 ];/* ="eGON.BT0" or "eGON.BT1", not C-style str */ -uint32_t check_sum;/* generated by PC */ -uint32_t length;/* generated by PC */ -/* -* We use a simplified header, only filling in what is needed -* by the boot ROM. To be compatible with Allwinner tools we -* would need to implement the proper fields here instead of -* padding. -* -* Actually we want the ability to recognize our "sunxi" variant -* of the SPL. To do so, let's place a special signature into the -* "pub_head_size" field. We can reasonably expect Allwinner's -* boot0 to always have the upper 16 bits of this set to 0 (after -* all the value shouldn't be larger than the limit imposed by -* SRAM size). -* If the signature is present (at 0x14), then we know it's safe -* to use the remaining 8 bytes (at 0x18) for our own purposes. -* (E.g. sunxi-tools "fel" utility can pass information there.) -*/ -union { -uint32_t pub_head_size; -uint8_t spl_signature[4 ]; - }; -uint32_t fel_script_address;/* since v0.1, set by sunxi-fel */ -/* -* If the fel_uEnv_length member below is set to a non-zero value, -* it specifies the size (byte count) of data at fel_script_address. -* At the same time this indicates that the data is in uEnv.txt -* compatible format, ready to be imported via "env import -t". -*/ -uint32_t fel_uEnv_length;/* since v0.1, set by sunxi-fel */ -/* -* Offset of an ASCIIZ string (relative to the SPL header), which -* contains the default device tree name (CONFIG_DEFAULT_DEVICE_TREE). -* This is optional and may be set to NULL. Is intended to be used -* by flash programming tools for providing nice informative messages -* to the users. -*/ -uint32_t dt_name_offset;/* since v0.2, set by mksunxiboot */ -uint32_t dram_size;/* in MiB, since v0.3, set by SPL */ -uint32_t boot_media;/* written here by the boot ROM */ -/* A padding area (may be used for storing text strings) */ -uint32_t string_pool[13 ];/* since v0.2, filled by mksunxiboot */ -/* The header must be a multiple of 32 bytes (for VBAR alignment) */ -}; - -/* Compile time check to assure proper alignment of structure */ -typedef char boot_file_head_not_multiple_of_32 [1 -2 *(sizeof (struct boot_file_head ) %32 )];#define is_boot0_magic (addr) (memcmp((void *)addr, BOOT0_MAGIC, 8) == 0)
include/sunxi_image.h new file +81 -0
81 lines not on this page · raw message
Signature · 1 line
2.17.5
PATCH v4 2/3 tools: mkimage: Add Allwinner eGON support
In reply to Andre PrzywaraSo far we used the separate mksunxiboot tool for generating a bootable image for Allwinner SPLs, probably just for historical reasons.
Use the mkimage framework to generate a so called eGON image the Allwinner BROM expects.
The new image type is called "sunxi_egon", to differentiate it from the (still to be implemented) secure boot TOC0 image.
--- common/image.c | 1 + include/image.h | 1 + include/sunxi_image.h | 1 + tools/Makefile | 1 + tools/sunxi_egon.c | 136 ++++++++++++++++++++++++++++++++++++++++++ 5 files changed, 140 insertions(+) create mode 100644 tools/sunxi_egon.c
common/image.c +1 -0
@@ -189,6 +189,7 @@ static const table_entry_t uimage_type[] = { { IH_TYPE_STM32IMAGE, "stm32image", "STMicroelectronics STM32 Image" }, { IH_TYPE_MTKIMAGE, "mtk_image", "MediaTek BootROM loadable Image" }, { IH_TYPE_COPRO, "copro", "Coprocessor Image"}, + { IH_TYPE_SUNXI_EGON, "sunxi_egon", "Allwinner eGON Boot Image" }, { -1, "", "", }, };
include/image.h +1 -0
@@ -308,6 +308,7 @@ enum {IH_TYPE_IMX8MIMAGE ,/* Freescale IMX8MBoot Image */ IH_TYPE_IMX8IMAGE ,/* Freescale IMX8Boot Image */ IH_TYPE_COPRO ,/* Coprocessor Image for remoteproc*/ +IH_TYPE_SUNXI_EGON ,/* Allwinner eGON Boot Image */ IH_TYPE_COUNT, /* Number of image types */ };
include/sunxi_image.h +1 -0
@@ -13,6 +13,7 @@#define SUNXI_IMAGE_H #define BOOT0_MAGIC "eGON.BT0" +#define BROM_STAMP_VALUE 0x5f0a6c39#define SPL_SIGNATURE "SPL"/* marks "sunxi" SPL header */ #define SPL_MAJOR_BITS 3#define SPL_MINOR_BITS 5
tools/Makefile +1 -0
@@ -104,6 +104,7 @@ dumpimage-mkimage-objs := aisimage.o \ stm32image.o \ $(ROCKCHIP_OBS) \ socfpgaimage.o \ + sunxi_egon.o \ lib/crc16.o \ lib/sha1.o \ lib/sha256.o \
tools/sunxi_egon.c new file +136 -0
136 lines not on this page · raw message
Signature · 1 line
2.17.5
PATCH v4 2/3 tools: mkimage: Add Allwinner eGON support
Quoted 10 lines · Andre Przywara
So far we used the separate mksunxiboot tool for generating a bootable image for Allwinner SPLs, probably just for historical reasons.
Use the mkimage framework to generate a so called eGON image the Allwinner BROM expects.
The new image type is called "sunxi_egon", to differentiate it from the (still to be implemented) secure boot TOC0 image.Signed-off-by Andre Przywara <[email protected]>
Quoted 9 lines
--- common/image.c | 1 + include/image.h | 1 + include/sunxi_image.h | 1 + tools/Makefile | 1 + tools/sunxi_egon.c | 136 ++++++++++++++++++++++++++++++++++++++++++ 5 files changed, 140 insertions(+) create mode 100644 tools/sunxi_egon.c
PATCH v4 3/3 sunxi: Use mkimage for SPL boot image generation
In reply to Andre PrzywaraSwitch the SPL boot image generation from using mksunxiboot to the new sunxi_egon format of mkimage.
Verified to create identical results for all 152 Allwinner boards.
--- scripts/Makefile.spl | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-)
scripts/Makefile.spl +4 -4
@@ -382,11 +382,11 @@ endif $(obj)/$(SPL_BIN).sfp: $(obj)/$(SPL_BIN).bin FORCE $(call if_changed,mkimage) -quiet_cmd_mksunxiboot = MKSUNXI $@ -cmd_mksunxiboot = $(objtree)/tools/mksunxiboot \ - --default-dt $(CONFIG_DEFAULT_DEVICE_TREE) $< $@ +MKIMAGEFLAGS_sunxi-spl.bin = -T sunxi_egon \ + -n $(CONFIG_DEFAULT_DEVICE_TREE) + $(obj)/sunxi-spl.bin: $(obj)/$(SPL_BIN).bin FORCE - $(call if_changed,mksunxiboot) + $(call if_changed,mkimage) quiet_cmd_sunxi_spl_image_builder = SUNXI_SPL_IMAGE_BUILDER $@ cmd_sunxi_spl_image_builder = $(objtree)/tools/sunxi-spl-image-builder \
Signature · 1 line
2.17.5
PATCH v4 3/3 sunxi: Use mkimage for SPL boot image generation
Quoted 10 lines · Andre Przywara
Switch the SPL boot image generation from using mksunxiboot to the new
sunxi_egonformat of mkimage.Verified to create identical results for all 152 Allwinner boards.
Signed-off-by Andre Przywara <[email protected]>--- scripts/Makefile.spl | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-)
Do we need to delete the old tool?
PATCH v4 3/3 sunxi: Use mkimage for SPL boot image generation
On 07/01/2021 12:36, Simon Glass wrote:
Hi Simon,
thanks for the review!
Quoted 7 lines · Andre Przywara
Quoted 6 lines
Switch the SPL boot image generation from using mksunxiboot to the new
sunxi_egonformat of mkimage.Verified to create identical results for all 152 Allwinner boards.
Quoted 8 lines
Quoted 4 lines
Signed-off-by Andre Przywara <[email protected]>--- scripts/Makefile.spl | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-)Reviewed-by Simon Glass <[email protected]>Do we need to delete the old tool?
I would rather not quite do this yet, instead leave it around for a bit. There is for instance sunxi-tools, that relies on this, and it's also packaged as part of Debian's u-boot-tools package.
We surely will transition them over, but this might take a while.
Cheers,
Andre
Jernej Škrabec
maintainerv4 cover tools/sunxi: Use mkimage for SPL generation
In reply to Andre PrzywaraDne sreda, 06. januar 2021 ob 10:24:35 CET je Andre Przywara napisal(a):
Quoted 23 lines
Hi,
a small update fixing the strncpy bug and addressing too long DT names properly. Thanks to Samuel for pointing this out.
==================So far creating a bootable SPL image for Allwinner based boards uses the mksunxiboot tool. Most other platforms seemed to have integrated this kind of functionality into the common mkimage tool.
Since there is nothing special about the Allwinner image in this respect, just add support for the so-called "eGON" image type into mkimage. If there was a particular reason this hasn't been done before, please let me know.
This will eventually allow us to remove mksunxiboot, but I leave it around for now in case of regressions and since some people depend on it from external projects.
Patch 1/3 splits some existing sunxi specific header file, so we can share the eGON header definition between the tools and the SPL. Patch 2/3 adds the actual support to mkimage, patch 3/3 then switches the
Makefileto use mkimage instead of mksunxiboot.
Quoted 8 lines
I tested all 152 Allwinner boards by building each u-boot-sunxi-with-spl.bin and comparing them against the version created using mksunxiboot (using
SOURCE_DATE_EPOCHand .scmversion to create reproducible builds, and by reverting just patch 3/3).
All files before and after were identical.Cheers,
Andre
Whole series is:
Best regards,
Jernej
Quoted 21 lines
Changelog v3 .. v4:
- properly check DT name length before inserting into headerChangelog v2 .. v3:
- factor out eGON struct into separate header file
- only print extended header information when applicable
- remove redundant alignment
- minor cosmetic fixesChangelog v1 .. v2:
- Drop already merged cleanup patch (v1 1/3)
- replace relative include path
- remove already defined ALIGN macro
- rebase against current masterAndre Przywara (3):
sunxi: Factor out eGON BROM header description
tools: mkimage: Add Allwinner eGON support
sunxi: Use mkimage for SPL boot image generation
Quoted 16 lines
arch/arm/include/asm/arch-sunxi/spl.h | 65 +----------- common/image.c | 1 + include/image.h | 1 + include/sunxi_image.h | 82 ++++++++++++++++ scripts/Makefile.spl | 8 +- tools/Makefile | 1 + tools/sunxi_egon.c | 136 ++++++++++++++++++++++++++ 7 files changed, 226 insertions(+), 68 deletions(-) create mode 100644 include/sunxi_image.h create mode 100644 tools/sunxi_egon.cSignature · 4 lines
2.17.5 -- You received this message because you are subscribed to the Google Groups
"linux-sunxi" group.
Quoted 1 line
To unsubscribe from this group and stop receiving emails from it, send an
email to linux-sunxi+unsubscribe at googlegroups.com.
Quoted 1 line
To view this discussion on the web, visit https://groups.google.com/d/msgid/
linux-sunxi/20210106092438.3438-1-andre.przywara%40arm.com.
Quoted 1 line
Samuel Holland
maintainerv4 cover tools/sunxi: Use mkimage for SPL generation
In reply to Andre PrzywaraQuoted 52 lines · Andre Przywara
Hi,
a small update fixing the strncpy bug and addressing too long DT names properly. Thanks to Samuel for pointing this out.
==================So far creating a bootable SPL image for Allwinner based boards uses the mksunxiboot tool. Most other platforms seemed to have integrated this kind of functionality into the common mkimage tool.
Since there is nothing special about the Allwinner image in this respect, just add support for the so-called "eGON" image type into mkimage. If there was a particular reason this hasn't been done before, please let me know.
This will eventually allow us to remove mksunxiboot, but I leave it around for now in case of regressions and since some people depend on it from external projects.
Patch 1/3 splits some existing sunxi specific header file, so we can share the eGON header definition between the tools and the SPL. Patch 2/3 adds the actual support to mkimage, patch 3/3 then switches the
Makefileto use mkimage instead of mksunxiboot.I tested all 152 Allwinner boards by building each u-boot-sunxi-with-spl.bin and comparing them against the version created using mksunxiboot (using
SOURCE_DATE_EPOCHand .scmversion to create reproducible builds, and by reverting just patch 3/3).
All files before and after were identical.Cheers,
AndreChangelog v3 .. v4:
- properly check DT name length before inserting into headerChangelog v2 .. v3:
- factor out eGON struct into separate header file
- only print extended header information when applicable
- remove redundant alignment
- minor cosmetic fixesChangelog v1 .. v2:
- Drop already merged cleanup patch (v1 1/3)
- replace relative include path
- remove already defined ALIGN macro
- rebase against current masterAndre Przywara (3):
sunxi: Factor out eGON BROM header description
tools: mkimage: Add Allwinner eGON support
sunxi: Use mkimage for SPL boot image generation
Quoted 10 lines
arch/arm/include/asm/arch-sunxi/spl.h | 65 +----------- common/image.c | 1 + include/image.h | 1 + include/sunxi_image.h | 82 ++++++++++++++++ scripts/Makefile.spl | 8 +- tools/Makefile | 1 + tools/sunxi_egon.c | 136 ++++++++++++++++++++++++++ 7 files changed, 226 insertions(+), 68 deletions(-) create mode 100644 include/sunxi_image.h create mode 100644 tools/sunxi_egon.c
For the series: