The new uImage format allows more flexibility in handling images of various types (kernel, ramdisk, etc.), it also enhances integrity protection of images with sha1 and md5 checksums.
This page hosts a formal specification of U-Boot Image wrapper using Kaitai Struct. This specification can be automatically translated into a variety of programming languages to get a parsing library.
// This is a generated file! Please edit source .ksy file and use kaitai-struct-compiler to rebuild
import io.kaitai.struct.ByteBufferKaitaiStream;
import io.kaitai.struct.KaitaiStruct;
import io.kaitai.struct.KaitaiStream;
import java.io.IOException;
import java.util.Map;
import java.util.HashMap;
import java.util.Objects;
import io.kaitai.struct.ConsistencyError;
import java.util.Arrays;
import java.nio.charset.StandardCharsets;
import java.nio.charset.Charset;
/**
* The new uImage format allows more flexibility in handling images of various
* types (kernel, ramdisk, etc.), it also enhances integrity protection of images
* with sha1 and md5 checksums.
* @see <a href="https://source.denx.de/u-boot/u-boot/-/raw/e4dba4ba6f/include/image.h">Source</a>
*/
public class Uimage extends KaitaiStruct.ReadWrite {
public static Uimage fromFile(String fileName) throws IOException {
return new Uimage(new ByteBufferKaitaiStream(fileName));
}
public enum UimageArch {
INVALID(0),
ALPHA(1),
ARM(2),
I386(3),
IA64(4),
MIPS(5),
MIPS64(6),
PPC(7),
S390(8),
SH(9),
SPARC(10),
SPARC64(11),
M68K(12),
NIOS(13),
MICROBLAZE(14),
NIOS2(15),
BLACKFIN(16),
AVR32(17),
ST200(18),
SANDBOX(19),
NDS32(20),
OPENRISC(21),
ARM64(22),
ARC(23),
X86_64(24),
XTENSA(25),
RISCV(26);
private final long id;
UimageArch(long id) { this.id = id; }
public long id() { return id; }
private static final Map<Long, UimageArch> byId = new HashMap<Long, UimageArch>(27);
static {
for (UimageArch e : UimageArch.values())
byId.put(e.id(), e);
}
public static UimageArch byId(long id) { return byId.get(id); }
}
public enum UimageComp {
NONE(0),
GZIP(1),
BZIP2(2),
LZMA(3),
LZO(4),
LZ4(5),
ZSTD(6);
private final long id;
UimageComp(long id) { this.id = id; }
public long id() { return id; }
private static final Map<Long, UimageComp> byId = new HashMap<Long, UimageComp>(7);
static {
for (UimageComp e : UimageComp.values())
byId.put(e.id(), e);
}
public static UimageComp byId(long id) { return byId.get(id); }
}
public enum UimageOs {
INVALID(0),
OPENBSD(1),
NETBSD(2),
FREEBSD(3),
BSD4_4(4),
LINUX(5),
SVR4(6),
ESIX(7),
SOLARIS(8),
IRIX(9),
SCO(10),
DELL(11),
NCR(12),
LYNXOS(13),
VXWORKS(14),
PSOS(15),
QNX(16),
U_BOOT(17),
RTEMS(18),
ARTOS(19),
UNITY(20),
INTEGRITY(21),
OSE(22),
PLAN9(23),
OPENRTOS(24),
ARM_TRUSTED_FIRMWARE(25),
TEE(26),
OPENSBI(27),
EFI(28);
private final long id;
UimageOs(long id) { this.id = id; }
public long id() { return id; }
private static final Map<Long, UimageOs> byId = new HashMap<Long, UimageOs>(29);
static {
for (UimageOs e : UimageOs.values())
byId.put(e.id(), e);
}
public static UimageOs byId(long id) { return byId.get(id); }
}
public enum UimageType {
INVALID(0),
STANDALONE(1),
KERNEL(2),
RAMDISK(3),
MULTI(4),
FIRMWARE(5),
SCRIPT(6),
FILESYSTEM(7),
FLATDT(8),
KWBIMAGE(9),
IMXIMAGE(10),
UBLIMAGE(11),
OMAPIMAGE(12),
AISIMAGE(13),
KERNEL_NOLOAD(14),
PBLIMAGE(15),
MXSIMAGE(16),
GPIMAGE(17),
ATMELIMAGE(18),
SOCFPGAIMAGE(19),
X86_SETUP(20),
LPC32XXIMAGE(21),
LOADABLE(22),
RKIMAGE(23),
RKSD(24),
RKSPI(25),
ZYNQIMAGE(26),
ZYNQMPIMAGE(27),
ZYNQMPBIF(28),
FPGA(29),
VYBRIDIMAGE(30),
TEE(31),
FIRMWARE_IVT(32),
PMMC(33),
STM32IMAGE(34),
SOCFPGAIMAGE_V1(35),
MTKIMAGE(36),
IMX8MIMAGE(37),
IMX8IMAGE(38),
COPRO(39),
SUNXI_EGON(40);
private final long id;
UimageType(long id) { this.id = id; }
public long id() { return id; }
private static final Map<Long, UimageType> byId = new HashMap<Long, UimageType>(41);
static {
for (UimageType e : UimageType.values())
byId.put(e.id(), e);
}
public static UimageType byId(long id) { return byId.get(id); }
}
public Uimage() {
this(null, null, null);
}
public Uimage(KaitaiStream _io) {
this(_io, null, null);
}
public Uimage(KaitaiStream _io, KaitaiStruct.ReadWrite _parent) {
this(_io, _parent, null);
}
public Uimage(KaitaiStream _io, KaitaiStruct.ReadWrite _parent, Uimage _root) {
super(_io);
this._parent = _parent;
this._root = _root == null ? this : _root;
}
public void _read() {
this.header = new Uheader(this._io, this, _root);
this.header._read();
this.data = this._io.readBytes(header().lenImage());
_dirty = false;
}
public void _fetchInstances() {
this.header._fetchInstances();
}
public void _write_Seq() {
_assertNotDirty();
this.header._write_Seq(this._io);
this._io.writeBytes(this.data);
}
public void _check() {
if (!Objects.equals(this.header._root(), _root()))
throw new ConsistencyError("header", _root(), this.header._root());
if (!Objects.equals(this.header._parent(), this))
throw new ConsistencyError("header", this, this.header._parent());
if (this.data.length != header().lenImage())
throw new ConsistencyError("data", header().lenImage(), this.data.length);
_dirty = false;
}
public static class Uheader extends KaitaiStruct.ReadWrite {
public static Uheader fromFile(String fileName) throws IOException {
return new Uheader(new ByteBufferKaitaiStream(fileName));
}
public Uheader() {
this(null, null, null);
}
public Uheader(KaitaiStream _io) {
this(_io, null, null);
}
public Uheader(KaitaiStream _io, Uimage _parent) {
this(_io, _parent, null);
}
public Uheader(KaitaiStream _io, Uimage _parent, Uimage _root) {
super(_io);
this._parent = _parent;
this._root = _root;
}
public void _read() {
this.magic = this._io.readBytes(4);
if (!(Arrays.equals(this.magic, new byte[] { 39, 5, 25, 86 }))) {
throw new KaitaiStream.ValidationNotEqualError(new byte[] { 39, 5, 25, 86 }, this.magic, this._io, "/types/uheader/seq/0");
}
this.headerCrc = this._io.readU4be();
this.timestamp = this._io.readU4be();
this.lenImage = this._io.readU4be();
this.loadAddress = this._io.readU4be();
this.entryAddress = this._io.readU4be();
this.dataCrc = this._io.readU4be();
this.osType = Uimage.UimageOs.byId(this._io.readU1());
this.architecture = Uimage.UimageArch.byId(this._io.readU1());
this.imageType = Uimage.UimageType.byId(this._io.readU1());
this.compressionType = Uimage.UimageComp.byId(this._io.readU1());
this.name = new String(KaitaiStream.bytesTerminate(this._io.readBytes(32), (byte) 0, false), StandardCharsets.UTF_8);
_dirty = false;
}
public void _fetchInstances() {
}
public void _write_Seq() {
_assertNotDirty();
this._io.writeBytes(this.magic);
this._io.writeU4be(this.headerCrc);
this._io.writeU4be(this.timestamp);
this._io.writeU4be(this.lenImage);
this._io.writeU4be(this.loadAddress);
this._io.writeU4be(this.entryAddress);
this._io.writeU4be(this.dataCrc);
this._io.writeU1(((Number) (this.osType.id())).intValue());
this._io.writeU1(((Number) (this.architecture.id())).intValue());
this._io.writeU1(((Number) (this.imageType.id())).intValue());
this._io.writeU1(((Number) (this.compressionType.id())).intValue());
this._io.writeBytesLimit((this.name).getBytes(Charset.forName("UTF-8")), 32, (byte) 0, (byte) 0);
}
public void _check() {
if (this.magic.length != 4)
throw new ConsistencyError("magic", 4, this.magic.length);
if (!(Arrays.equals(this.magic, new byte[] { 39, 5, 25, 86 }))) {
throw new KaitaiStream.ValidationNotEqualError(new byte[] { 39, 5, 25, 86 }, this.magic, null, "/types/uheader/seq/0");
}
if ((this.name).getBytes(Charset.forName("UTF-8")).length > 32)
throw new ConsistencyError("name", 32, (this.name).getBytes(Charset.forName("UTF-8")).length);
if (KaitaiStream.byteArrayIndexOf((this.name).getBytes(Charset.forName("UTF-8")), ((byte) 0)) != -1)
throw new ConsistencyError("name", -1, KaitaiStream.byteArrayIndexOf((this.name).getBytes(Charset.forName("UTF-8")), ((byte) 0)));
_dirty = false;
}
private byte[] magic;
private long headerCrc;
private long timestamp;
private long lenImage;
private long loadAddress;
private long entryAddress;
private long dataCrc;
private UimageOs osType;
private UimageArch architecture;
private UimageType imageType;
private UimageComp compressionType;
private String name;
private Uimage _root;
private Uimage _parent;
public byte[] magic() { return magic; }
public void setMagic(byte[] _v) { _dirty = true; magic = _v; }
public long headerCrc() { return headerCrc; }
public void setHeaderCrc(long _v) { _dirty = true; headerCrc = _v; }
public long timestamp() { return timestamp; }
public void setTimestamp(long _v) { _dirty = true; timestamp = _v; }
public long lenImage() { return lenImage; }
public void setLenImage(long _v) { _dirty = true; lenImage = _v; }
public long loadAddress() { return loadAddress; }
public void setLoadAddress(long _v) { _dirty = true; loadAddress = _v; }
public long entryAddress() { return entryAddress; }
public void setEntryAddress(long _v) { _dirty = true; entryAddress = _v; }
public long dataCrc() { return dataCrc; }
public void setDataCrc(long _v) { _dirty = true; dataCrc = _v; }
public UimageOs osType() { return osType; }
public void setOsType(UimageOs _v) { _dirty = true; osType = _v; }
public UimageArch architecture() { return architecture; }
public void setArchitecture(UimageArch _v) { _dirty = true; architecture = _v; }
public UimageType imageType() { return imageType; }
public void setImageType(UimageType _v) { _dirty = true; imageType = _v; }
public UimageComp compressionType() { return compressionType; }
public void setCompressionType(UimageComp _v) { _dirty = true; compressionType = _v; }
public String name() { return name; }
public void setName(String _v) { _dirty = true; name = _v; }
public Uimage _root() { return _root; }
public void set_root(Uimage _v) { _dirty = true; _root = _v; }
public Uimage _parent() { return _parent; }
public void set_parent(Uimage _v) { _dirty = true; _parent = _v; }
}
private Uheader header;
private byte[] data;
private Uimage _root;
private KaitaiStruct.ReadWrite _parent;
public Uheader header() { return header; }
public void setHeader(Uheader _v) { _dirty = true; header = _v; }
public byte[] data() { return data; }
public void setData(byte[] _v) { _dirty = true; data = _v; }
public Uimage _root() { return _root; }
public void set_root(Uimage _v) { _dirty = true; _root = _v; }
public KaitaiStruct.ReadWrite _parent() { return _parent; }
public void set_parent(KaitaiStruct.ReadWrite _v) { _dirty = true; _parent = _v; }
}