openwrt/target/linux/ath79/image
Michał Kępień a60721f2ed mikrotik: switch to Yafut for building MikroTik NOR images
The Yafut tool now has limited capabilities for working on filesystem
images stored in regular files.  This enables preparing Yaffs2 images
for devices with NOR flash using upstream Yaffs2 filesystem code instead
of the custom kernel2minor tool.

Since minimizing the size of the resulting filesystem image size is
important and upstream Yaffs2 code requires two allocator reserve blocks
to be available when writing a file to the filesystem, a trick is
employed while preparing an OpenWRT image: the blank filesystem image
that Yafut operates on initially contains two extra erase blocks that
are chopped off after the kernel file is written.  This is safe to do
because Yaffs2 has a true log structure and therefore only ever writes
sequentially (and the size of the kernel file is known beforehand).
While the two extra erase blocks are necessary for writes, Yaffs2 code
seems to be perfectly capable of reading back files from a "truncated"
filesystem that does not contain these extra erase blocks.

In terms of image size, this new approach is only marginally worse than
the current kernel2minor-based one: specifically, upstream Yaffs2 code
needs to write three object headers (each of which takes up an entire
data chunk) when the kernel file is written to the filesystem:

  - an object header for the kernel file when it is created,

  - an object header for the root directory when the kernel file is
    created,

  - an updated object header for the kernel file when the latter is
    fully written (so that its new size can be recorded).

kernel2minor only writes two of these headers, which is the absolute
minimum required for reading the file back.  This means that the
Yafut-based approach causes firmware images to be at most one erase
block (64 kB) larger than those created using kernel2minor, but only in
the very unfortunate scenario where the size of the kernel file is
really close to a multiple of the erase block size.

The rest of the calculations performed when the empty filesystem image
is first prepared stems from the Yaffs2 layout used by MikroTik NOR
devices: each 65,536-byte erase block contains 63 chunks, each of which
consists of 1024 bytes of data followed by 16-byte Yaffs tags without
ECC data; each such group of 63 chunks is then followed by 16 bytes of
padding, which translates to "-C 1040 -B 64k -E" in the Yafut
invocation.  Yaffs2 checkpoints and summaries are disabled (using
Yafut's -P and -S switches, respectively) as they are merely performance
optimizations that require extra storage space.  The -L and -M switches
are used to force little-endian or big-endian byte order (respectively)
in the resulting filesystem image, no matter what byte order the build
host uses.  The tr invocation is used to ensure that the filesystem
image is initialized with 0xFF bytes (which are an indicator of unused
space for Yaffs2 code).

Signed-off-by: Michał Kępień <openwrt@kempniu.pl>
Link: https://github.com/openwrt/openwrt/pull/13453
Signed-off-by: Robert Marko <robimarko@gmail.com>
2024-06-05 17:03:24 +02:00
..
bin ath79: add support for PISEN WMB001N 2019-08-08 21:00:59 +08:00
lzma-loader ath79: add support for Huawei AP5030DN 2024-03-31 18:09:43 +02:00
common-buffalo.mk ath79: use common device definition for Buffalo devices 2020-09-16 17:31:03 +02:00
common-mikrotik.mk mikrotik: switch to Yafut for building MikroTik NOR images 2024-06-05 17:03:24 +02:00
common-netgear.mk tools/squashfs: rename to squashfs3-lzma 2023-02-18 21:11:36 +01:00
common-senao.mk ath79: use lzma-loader for Senao initramfs images 2023-01-06 15:34:07 +01:00
common-tp-link.mk treewide: call check-size before append-metadata 2021-07-10 19:40:10 +02:00
common-ubnt.mk ath79: update WA/XC devices UBNT_VERSION to 8.7.4 2024-02-19 16:51:39 +01:00
common-yuncore.mk ath79: add support for YunCore TFTP image generation 2019-11-25 17:32:46 +01:00
generic-tp-link.mk ath79: add support for TP-Link TL-WDR6500 v2 2023-06-11 23:20:39 +02:00
generic-ubnt.mk ath79: qca9563: add support for Amplifi Router HD 2024-05-25 19:52:42 +02:00
generic.mk ath79: add support for Dell SonicPoint ACe APL26-0AE 2024-05-27 00:32:57 +02:00
Makefile ath79: move seama image recipe to the common Makefile 2024-03-30 01:04:17 +01:00
mikrotik.mk ath79: support MikroTik RouterBOARD 911G-5HPacD 2024-01-07 01:19:56 +01:00
nand.mk ath79: nand: add SUPPORTED_DEVICES for Meraki MR18 2024-02-29 21:28:47 +01:00
tiny-netgear.mk ath79: netgear: trim down uImage customisations 2020-11-25 16:33:49 +01:00
tiny-tp-link.mk ath79: tiny: Do not build TPLink WPA8630Pv2 by default 2023-01-06 18:52:01 +01:00
tiny-ubnt.mk ath79: move ubnt-xm 64M RAM boards back to generic 2023-07-19 08:04:08 +02:00
tiny.mk ath79: move D-Link DAP-1720 A1 to tiny sub-target 2024-03-30 01:04:17 +01:00