[{"data":1,"prerenderedAt":1295},["ShallowReactive",2],{"search-index":3,"doc-secure-boot-uboot-fit-signatures-chain-of-trust":105},[4,9,13,17,21,26,31,36,41,46,51,56,61,66,71,76,81,86,91,96,101],{"_path":5,"title":6,"description":7,"date":8},"/dev/eu-cyber-resilience-act-firmware-evidence-pack","CRA Firmware Evidence: Scope, Dates and Preparation","Practical breakdown of the EU Cyber Resilience Act requirements for embedded firmware teams, covering technical obligations, SBOM requirements, vulnerability handling, and the evidence pack needed for compliance.","2026-04-19T08:00:00.000Z",{"_path":10,"title":11,"description":12,"date":8},"/dev/pkg/firmware-sboms-spdx-cyclonedx-2026","Firmware SBOMs: SPDX, CycloneDX and Publication Workflows","Practical comparison of SPDX and CycloneDX for firmware SBOMs, covering what to include, automation approaches, tooling, and publication strategies for embedded Linux products.",{"_path":14,"title":15,"description":16,"date":8},"/dev/pkg/spdx-3-0-embedded-builds-practical","SPDX 3.0 for Embedded Builds: Packages, Files, and Relationships Engineers Actually Use","Practical guide to SPDX 3.0 for embedded Linux, covering the data model, package and file elements, relationship types, and how to produce useful SPDX documents from Yocto and Buildroot builds.",{"_path":18,"title":19,"description":20,"date":8},"/dev/slsa-build-provenance-firmware-sign-verify","SLSA Build Provenance for Firmware: What to Collect, How to Sign, How to Verify","Practical implementation guide for SLSA build provenance in firmware pipelines, covering provenance generation, signing with Sigstore, verification workflows, and integration with SBOMs.",{"_path":22,"title":23,"description":24,"date":25},"/dev/vex-csaf-embedded-not-affected-scale","VEX and CSAF for Embedded Vulnerability Status","How to produce and distribute VEX documents and CSAF advisories for embedded firmware, enabling downstream consumers to filter false positives from vulnerability scans.","2026-04-15T20:03:00.000Z",{"_path":27,"title":28,"description":29,"date":30},"/dev/yocto-5-2-walnascar-highlights-embedded-2026","Yocto 5.2 Walnascar: Release Changes and Migration Context","Key changes in Yocto 5.2 Walnascar relevant to embedded product teams, covering toolchain updates, security improvements, SPDX 3.0 support, and migration notes.","2026-04-12T08:14:00.000Z",{"_path":32,"title":33,"description":34,"date":35},"/dev/yocto-esdk-faster-iteration-2026","Yocto eSDK in 2026: Faster Application Iteration Without Full Rebuild Cycles","How to use Yocto's extensible SDK to speed up application development by building and testing packages without running full BitBake builds.","2026-04-11T07:09:00.000Z",{"_path":37,"title":38,"description":39,"date":40},"/dev/yocto-layers-maintainable-strategy-2026","Maintaining Yocto Layers: Appends, Forks and Upgrades","Practical guidance on structuring Yocto layers for long-term maintainability, covering layer boundaries, naming conventions, version pinning, and upgrade workflows.","2026-04-07T13:41:00.000Z",{"_path":42,"title":43,"description":44,"date":45},"/doc/bootlin-toolchains-arm-riscv-2026","Bootlin Toolchains in Practice: Picking the Right Prebuilt Toolchain for ARM and RISC-V","How to select and validate Bootlin prebuilt cross-compilation toolchains for ARM Cortex-A, Cortex-M, and RISC-V targets in embedded Linux projects.","2026-03-10T16:05:00.000Z",{"_path":47,"title":48,"description":49,"date":50},"/doc/buildroot-vs-yocto-2026","Buildroot vs Yocto: BSPs, Build Workflow and Maintenance","A detailed comparison of Buildroot and Yocto for embedded Linux, covering build performance, long-term maintenance, layer ecosystems, and practical decision criteria for product teams in 2026.","2026-03-05T08:12:00.000Z",{"_path":52,"title":53,"description":54,"date":55},"/doc/cross-compilation-toolchain-triplet-clib-2026","Cross-Compilation: Target Triplets and glibc vs musl","Practical guidance on selecting cross-compilation toolchains for embedded Linux, understanding target triplets, and choosing between glibc and musl for your production firmware.","2026-03-07T07:43:00.000Z",{"_path":57,"title":58,"description":59,"date":60},"/doc/erofs-vs-squashfs-2026","EROFS vs SquashFS: Compression, Performance and OTA Trade-offs","Detailed comparison of EROFS and SquashFS for embedded Linux in 2026, covering read performance, compression ratios, deduplication, and integration with OTA update schemes.","2026-03-22T14:22:00.000Z",{"_path":62,"title":63,"description":64,"date":65},"/doc/ota-updates-rauc-swupdate-mender-2026","RAUC vs SWUpdate vs Mender: Embedded Linux OTA Compared","Comparison of RAUC, SWUpdate, and Mender for embedded Linux OTA updates, covering update models, rollback strategies, fleet management, and integration with Yocto and Buildroot.","2026-03-28T19:07:00.000Z",{"_path":67,"title":68,"description":69,"date":70},"/doc/plat/device-tree-debugging-overlays-validation-2026","Device Tree Debugging for Embedded Linux: Overlays, Common Errors, and Validation","Practical guide to debugging device tree issues in embedded Linux, covering overlay mechanics, common DTS errors, validation tools, and runtime debugging techniques.","2026-04-05T06:58:00.000Z",{"_path":72,"title":73,"description":74,"date":75},"/doc/plat/porting-checklist-bootloader-kernel-rootfs-2026","Porting Checklist 2026: Bootloader → Kernel → RootFS for New Boards","Complete checklist for porting embedded Linux to a new board, from bootloader bring-up through kernel configuration to root filesystem validation, with practical tips for each stage.","2026-04-02T15:16:00.000Z",{"_path":77,"title":78,"description":79,"date":80},"/doc/real-time-linux-preempt-rt-latency-2026","PREEMPT_RT Linux: Configuration and Cyclictest Latency Tests","Practical guide to PREEMPT_RT on embedded Linux covering kernel configuration, IRQ threading, latency measurement with cyclictest, and tuning techniques with explicit test conditions and interpretation limits.","2026-03-23T05:48:00.000Z",{"_path":82,"title":83,"description":84,"date":85},"/doc/rootfs-integrity-dm-verity-immutable-images","dm-verity for Rootfs Integrity: Design, Trust and Recovery","How to design and implement dm-verity-protected root filesystems for embedded Linux, covering hash tree generation, kernel integration, error handling, and update strategies.","2026-03-19T08:56:00.000Z",{"_path":87,"title":88,"description":89,"date":90},"/doc/rtos-vs-embedded-linux-zephyr-2026","RTOS vs Embedded Linux: Zephyr, FreeRTOS and Linux Compared","Practical comparison of RTOS (Zephyr, FreeRTOS) and embedded Linux for product design, covering latency, memory footprint, ecosystem maturity, and hybrid architectures.","2026-03-30T09:35:00.000Z",{"_path":92,"title":93,"description":94,"date":95},"/doc/secure-boot-uboot-fit-signatures-chain-of-trust","U-Boot Secure Boot: FIT Signatures and Chain of Trust","Understand U-Boot FIT signatures, trusted control device trees and boot-chain limits with a versioned example and explicit rejection and recovery tests.","2026-03-14T06:29:00.000Z",{"_path":97,"title":98,"description":99,"date":100},"/doc/verified-boot-patterns-uboot-keys-failure-modes","Verified Boot Patterns in U-Boot: What to Verify, Where Keys Live, and Failure Modes","Deep dive into U-Boot verified boot patterns covering signature scopes, key storage options, common failure modes, and practical debugging techniques for embedded Linux platforms.","2026-03-16T18:11:00.000Z",{"_path":102,"title":103,"description":104},"/image-manifest","ProteanOS Image Manifest","This document lists all hero and supporting images needed for the website.",{"_path":92,"_dir":106,"_draft":107,"_partial":107,"_locale":108,"title":93,"description":94,"date":95,"lastmod":109,"draft":107,"hero":110,"tags":111,"category":106,"body":115,"_type":1289,"_id":1290,"_source":1291,"_file":1292,"_stem":1293,"_extension":1294},"doc",false,"","2026-11-16T00:00:00.000Z","/images/hero/secure-boot-uboot-fit-signatures-chain-of-trust-1600x900.jpg",[112,113,114],"Embedded Linux","ProteanOS","Security",{"type":116,"children":117,"toc":1275},"root",[118,126,133,138,184,198,235,241,246,256,261,267,272,410,415,421,434,446,459,465,478,888,893,947,992,998,1003,1011,1024,1030,1035,1063,1069,1074,1087,1092,1098,1103,1145,1151,1156,1174,1179,1185,1190,1202,1207,1220,1233,1246,1258,1264,1269],{"type":119,"tag":120,"props":121,"children":122},"element","p",{},[123],{"type":124,"value":125},"text","An enforced boot chain authenticates the objects it covers. Mutable execution paths and recovery mechanisms need their own controls. In embedded Linux systems using U-Boot, the Flattened Image Tree (FIT) format provides a structured way to bundle kernel, device tree, and initramfs images with cryptographic signatures. This guide explains the signing objects, trust boundaries and failure tests using the U-Boot v2025.01 documentation. The example is illustrative and has not been executed as a complete boot sequence.",{"type":119,"tag":127,"props":128,"children":130},"h2",{"id":129},"what-the-chain-of-trust-looks-like",[131],{"type":124,"value":132},"What the chain of trust looks like",{"type":119,"tag":120,"props":134,"children":135},{},[136],{"type":124,"value":137},"A complete chain of trust for an embedded Linux device typically has three or four stages:",{"type":119,"tag":139,"props":140,"children":141},"ol",{},[142,154,164,174],{"type":119,"tag":143,"props":144,"children":145},"li",{},[146,152],{"type":119,"tag":147,"props":148,"children":149},"strong",{},[150],{"type":124,"value":151},"ROM bootloader",{"type":124,"value":153}," (in silicon) → verifies the secondary bootloader",{"type":119,"tag":143,"props":155,"children":156},{},[157,162],{"type":119,"tag":147,"props":158,"children":159},{},[160],{"type":124,"value":161},"Secondary bootloader (SPL/TPL)",{"type":124,"value":163}," → verifies U-Boot proper",{"type":119,"tag":143,"props":165,"children":166},{},[167,172],{"type":119,"tag":147,"props":168,"children":169},{},[170],{"type":124,"value":171},"U-Boot",{"type":124,"value":173}," → verifies the FIT image (kernel + DTB + optional initramfs)",{"type":119,"tag":143,"props":175,"children":176},{},[177,182],{"type":119,"tag":147,"props":178,"children":179},{},[180],{"type":124,"value":181},"Kernel",{"type":124,"value":183}," → verifies the root filesystem (via dm-verity or IMA)",{"type":119,"tag":120,"props":185,"children":186},{},[187,189,196],{"type":124,"value":188},"This guide focuses on stage 3: U-Boot verifying a signed FIT image. For root filesystem verification, see ",{"type":119,"tag":190,"props":191,"children":193},"a",{"href":192},"/doc/rootfs-integrity-dm-verity-immutable-images/",[194],{"type":124,"value":195},"dm-verity for root filesystem integrity",{"type":124,"value":197},".",{"type":119,"tag":199,"props":200,"children":204},"div",{"className":201},[202,203],"callout","callout-success",[205],{"type":119,"tag":199,"props":206,"children":209},{"className":207},[208],"callout-content",[210,217],{"type":119,"tag":120,"props":211,"children":214},{"className":212},[213],"callout-title",[215],{"type":124,"value":216},"Understand the boot process end-to-end",{"type":119,"tag":120,"props":218,"children":219},{},[220,222,233],{"type":124,"value":221},"Secure boot spans hardware, bootloader, kernel, and filesystem layers. A solid grounding in how operating systems initialise hardware, load code, and transition between privilege levels makes this chain of trust easier to reason about. The ",{"type":119,"tag":190,"props":223,"children":230},{"href":224,"target":225,"rel":226},"/posgo/linux-os-course","_blank",[227,228,229],"nofollow","noopener","noreferrer",[231],{"type":124,"value":232},"Fundamentals of Operating Systems",{"type":124,"value":234}," course is a good place to build that understanding.",{"type":119,"tag":127,"props":236,"children":238},{"id":237},"fit-image-structure",[239],{"type":124,"value":240},"FIT image structure",{"type":119,"tag":120,"props":242,"children":243},{},[244],{"type":124,"value":245},"A FIT image is a single binary containing multiple components described by an embedded device tree structure. A typical signed FIT image includes:",{"type":119,"tag":247,"props":248,"children":250},"pre",{"code":249},"/images/\n    kernel-1   → compressed kernel binary\n    fdt-1      → device tree blob\n    ramdisk-1  → initramfs (optional)\n/configurations/\n    conf-1     → ties kernel + fdt + ramdisk together\n               → carries the RSA signature\n",[251],{"type":119,"tag":252,"props":253,"children":254},"code",{"__ignoreMap":108},[255],{"type":124,"value":249},{"type":119,"tag":120,"props":257,"children":258},{},[259],{"type":124,"value":260},"The configuration node is what gets signed. This means the signature covers the specific combination of kernel, device tree, and initramfs. Swapping any component invalidates the signature.",{"type":119,"tag":127,"props":262,"children":264},{"id":263},"key-generation",[265],{"type":124,"value":266},"Key generation",{"type":119,"tag":120,"props":268,"children":269},{},[270],{"type":124,"value":271},"Generate an RSA key pair. U-Boot supports RSA-2048, RSA-3072, and RSA-4096. Use RSA-4096 for new designs unless performance constraints dictate otherwise.",{"type":119,"tag":247,"props":273,"children":277},{"code":274,"language":275,"meta":108,"className":276,"style":108},"# Illustrative U-Boot v2025.01 key-directory layout, disposable keys only\nmkdir -p keys\nopenssl genpkey -algorithm RSA -out keys/sign-key.key -pkeyopt rsa_keygen_bits:4096\nopenssl req -new -x509 -key keys/sign-key.key -out keys/sign-key.crt -subj /CN=Disposable-FIT-Test/\n","bash","language-bash shiki shiki-themes github-dark",[278],{"type":119,"tag":252,"props":279,"children":280},{"__ignoreMap":108},[281,293,315,359],{"type":119,"tag":282,"props":283,"children":286},"span",{"class":284,"line":285},"line",1,[287],{"type":119,"tag":282,"props":288,"children":290},{"style":289},"--shiki-default:#6A737D",[291],{"type":124,"value":292},"# Illustrative U-Boot v2025.01 key-directory layout, disposable keys only\n",{"type":119,"tag":282,"props":294,"children":296},{"class":284,"line":295},2,[297,303,309],{"type":119,"tag":282,"props":298,"children":300},{"style":299},"--shiki-default:#B392F0",[301],{"type":124,"value":302},"mkdir",{"type":119,"tag":282,"props":304,"children":306},{"style":305},"--shiki-default:#79B8FF",[307],{"type":124,"value":308}," -p",{"type":119,"tag":282,"props":310,"children":312},{"style":311},"--shiki-default:#9ECBFF",[313],{"type":124,"value":314}," keys\n",{"type":119,"tag":282,"props":316,"children":318},{"class":284,"line":317},3,[319,324,329,334,339,344,349,354],{"type":119,"tag":282,"props":320,"children":321},{"style":299},[322],{"type":124,"value":323},"openssl",{"type":119,"tag":282,"props":325,"children":326},{"style":311},[327],{"type":124,"value":328}," genpkey",{"type":119,"tag":282,"props":330,"children":331},{"style":305},[332],{"type":124,"value":333}," -algorithm",{"type":119,"tag":282,"props":335,"children":336},{"style":311},[337],{"type":124,"value":338}," RSA",{"type":119,"tag":282,"props":340,"children":341},{"style":305},[342],{"type":124,"value":343}," -out",{"type":119,"tag":282,"props":345,"children":346},{"style":311},[347],{"type":124,"value":348}," keys/sign-key.key",{"type":119,"tag":282,"props":350,"children":351},{"style":305},[352],{"type":124,"value":353}," -pkeyopt",{"type":119,"tag":282,"props":355,"children":356},{"style":311},[357],{"type":124,"value":358}," rsa_keygen_bits:4096\n",{"type":119,"tag":282,"props":360,"children":362},{"class":284,"line":361},4,[363,367,372,377,382,387,391,395,400,405],{"type":119,"tag":282,"props":364,"children":365},{"style":299},[366],{"type":124,"value":323},{"type":119,"tag":282,"props":368,"children":369},{"style":311},[370],{"type":124,"value":371}," req",{"type":119,"tag":282,"props":373,"children":374},{"style":305},[375],{"type":124,"value":376}," -new",{"type":119,"tag":282,"props":378,"children":379},{"style":305},[380],{"type":124,"value":381}," -x509",{"type":119,"tag":282,"props":383,"children":384},{"style":305},[385],{"type":124,"value":386}," -key",{"type":119,"tag":282,"props":388,"children":389},{"style":311},[390],{"type":124,"value":348},{"type":119,"tag":282,"props":392,"children":393},{"style":305},[394],{"type":124,"value":343},{"type":119,"tag":282,"props":396,"children":397},{"style":311},[398],{"type":124,"value":399}," keys/sign-key.crt",{"type":119,"tag":282,"props":401,"children":402},{"style":305},[403],{"type":124,"value":404}," -subj",{"type":119,"tag":282,"props":406,"children":407},{"style":311},[408],{"type":124,"value":409}," /CN=Disposable-FIT-Test/\n",{"type":119,"tag":120,"props":411,"children":412},{},[413],{"type":124,"value":414},"The private key signs images during the build. The public key is embedded in U-Boot itself (or in the SPL that verifies U-Boot). Protect the private key; if it leaks, an attacker can sign arbitrary images.",{"type":119,"tag":127,"props":416,"children":418},{"id":417},"embedding-the-public-key-in-u-boot",[419],{"type":124,"value":420},"Embedding the public key in U-Boot",{"type":119,"tag":120,"props":422,"children":423},{},[424,426,432],{"type":124,"value":425},"U-Boot stores the public key in its control device tree (the DTB compiled into U-Boot or loaded alongside it). The ",{"type":119,"tag":252,"props":427,"children":429},{"className":428},[],[430],{"type":124,"value":431},"mkimage",{"type":124,"value":433}," tool handles this during the signing step.",{"type":119,"tag":120,"props":435,"children":436},{},[437,439,444],{"type":124,"value":438},"Use the control DTB generated by the pinned U-Boot build. Keep a disposable copy for the signing test. ",{"type":119,"tag":252,"props":440,"children":442},{"className":441},[],[443],{"type":124,"value":431},{"type":124,"value":445}," creates the public-key properties from the matching certificate; a handwritten node containing only an algorithm and name is not a complete verification key.",{"type":119,"tag":120,"props":447,"children":448},{},[449,451,457],{"type":124,"value":450},"During the FIT signing step, ",{"type":119,"tag":252,"props":452,"children":454},{"className":453},[],[455],{"type":124,"value":456},"mkimage -K",{"type":124,"value":458}," writes public-key parameters into the specified control DTB. That updated DTB must be the trusted one actually used by U-Boot.",{"type":119,"tag":127,"props":460,"children":462},{"id":461},"creating-and-signing-a-fit-image",[463],{"type":124,"value":464},"Creating and signing a FIT image",{"type":119,"tag":120,"props":466,"children":467},{},[468,470,476],{"type":124,"value":469},"Write a FIT image description (",{"type":119,"tag":252,"props":471,"children":473},{"className":472},[],[474],{"type":124,"value":475},".its",{"type":124,"value":477}," file):",{"type":119,"tag":247,"props":479,"children":483},{"code":480,"language":481,"meta":108,"className":482,"style":108},"/dts-v1/;\n\n/ {\n    description = \"Signed kernel image\";\n    #address-cells = \u003C1>;\n\n    images {\n        kernel-1 {\n            description = \"Linux kernel\";\n            data = /incbin/(\"Image.gz\");\n            type = \"kernel\";\n            arch = \"arm64\";\n            os = \"linux\";\n            compression = \"gzip\";\n            load = \u003C0x40480000>;\n            entry = \u003C0x40480000>;\n            hash-1 {\n                algo = \"sha256\";\n            };\n        };\n        fdt-1 {\n            description = \"Device tree\";\n            data = /incbin/(\"target.dtb\");\n            type = \"flat_dt\";\n            arch = \"arm64\";\n            compression = \"none\";\n            hash-1 {\n                algo = \"sha256\";\n            };\n        };\n    };\n\n    configurations {\n        default = \"conf-1\";\n        conf-1 {\n            description = \"Boot configuration\";\n            kernel = \"kernel-1\";\n            fdt = \"fdt-1\";\n            signature-1 {\n                algo = \"sha256,rsa4096\";\n                key-name-hint = \"sign-key\";\n                sign-images = \"kernel\", \"fdt\";\n            };\n        };\n    };\n};\n","dts","language-dts shiki shiki-themes github-dark",[484],{"type":119,"tag":252,"props":485,"children":486},{"__ignoreMap":108},[487,495,504,512,520,529,537,546,555,564,573,582,591,600,609,618,627,636,645,654,663,672,681,690,699,707,716,724,732,740,748,757,765,774,783,792,801,810,819,828,837,846,855,863,871,879],{"type":119,"tag":282,"props":488,"children":489},{"class":284,"line":285},[490],{"type":119,"tag":282,"props":491,"children":492},{},[493],{"type":124,"value":494},"/dts-v1/;\n",{"type":119,"tag":282,"props":496,"children":497},{"class":284,"line":295},[498],{"type":119,"tag":282,"props":499,"children":501},{"emptyLinePlaceholder":500},true,[502],{"type":124,"value":503},"\n",{"type":119,"tag":282,"props":505,"children":506},{"class":284,"line":317},[507],{"type":119,"tag":282,"props":508,"children":509},{},[510],{"type":124,"value":511},"/ {\n",{"type":119,"tag":282,"props":513,"children":514},{"class":284,"line":361},[515],{"type":119,"tag":282,"props":516,"children":517},{},[518],{"type":124,"value":519},"    description = \"Signed kernel image\";\n",{"type":119,"tag":282,"props":521,"children":523},{"class":284,"line":522},5,[524],{"type":119,"tag":282,"props":525,"children":526},{},[527],{"type":124,"value":528},"    #address-cells = \u003C1>;\n",{"type":119,"tag":282,"props":530,"children":532},{"class":284,"line":531},6,[533],{"type":119,"tag":282,"props":534,"children":535},{"emptyLinePlaceholder":500},[536],{"type":124,"value":503},{"type":119,"tag":282,"props":538,"children":540},{"class":284,"line":539},7,[541],{"type":119,"tag":282,"props":542,"children":543},{},[544],{"type":124,"value":545},"    images {\n",{"type":119,"tag":282,"props":547,"children":549},{"class":284,"line":548},8,[550],{"type":119,"tag":282,"props":551,"children":552},{},[553],{"type":124,"value":554},"        kernel-1 {\n",{"type":119,"tag":282,"props":556,"children":558},{"class":284,"line":557},9,[559],{"type":119,"tag":282,"props":560,"children":561},{},[562],{"type":124,"value":563},"            description = \"Linux kernel\";\n",{"type":119,"tag":282,"props":565,"children":567},{"class":284,"line":566},10,[568],{"type":119,"tag":282,"props":569,"children":570},{},[571],{"type":124,"value":572},"            data = /incbin/(\"Image.gz\");\n",{"type":119,"tag":282,"props":574,"children":576},{"class":284,"line":575},11,[577],{"type":119,"tag":282,"props":578,"children":579},{},[580],{"type":124,"value":581},"            type = \"kernel\";\n",{"type":119,"tag":282,"props":583,"children":585},{"class":284,"line":584},12,[586],{"type":119,"tag":282,"props":587,"children":588},{},[589],{"type":124,"value":590},"            arch = \"arm64\";\n",{"type":119,"tag":282,"props":592,"children":594},{"class":284,"line":593},13,[595],{"type":119,"tag":282,"props":596,"children":597},{},[598],{"type":124,"value":599},"            os = \"linux\";\n",{"type":119,"tag":282,"props":601,"children":603},{"class":284,"line":602},14,[604],{"type":119,"tag":282,"props":605,"children":606},{},[607],{"type":124,"value":608},"            compression = \"gzip\";\n",{"type":119,"tag":282,"props":610,"children":612},{"class":284,"line":611},15,[613],{"type":119,"tag":282,"props":614,"children":615},{},[616],{"type":124,"value":617},"            load = \u003C0x40480000>;\n",{"type":119,"tag":282,"props":619,"children":621},{"class":284,"line":620},16,[622],{"type":119,"tag":282,"props":623,"children":624},{},[625],{"type":124,"value":626},"            entry = \u003C0x40480000>;\n",{"type":119,"tag":282,"props":628,"children":630},{"class":284,"line":629},17,[631],{"type":119,"tag":282,"props":632,"children":633},{},[634],{"type":124,"value":635},"            hash-1 {\n",{"type":119,"tag":282,"props":637,"children":639},{"class":284,"line":638},18,[640],{"type":119,"tag":282,"props":641,"children":642},{},[643],{"type":124,"value":644},"                algo = \"sha256\";\n",{"type":119,"tag":282,"props":646,"children":648},{"class":284,"line":647},19,[649],{"type":119,"tag":282,"props":650,"children":651},{},[652],{"type":124,"value":653},"            };\n",{"type":119,"tag":282,"props":655,"children":657},{"class":284,"line":656},20,[658],{"type":119,"tag":282,"props":659,"children":660},{},[661],{"type":124,"value":662},"        };\n",{"type":119,"tag":282,"props":664,"children":666},{"class":284,"line":665},21,[667],{"type":119,"tag":282,"props":668,"children":669},{},[670],{"type":124,"value":671},"        fdt-1 {\n",{"type":119,"tag":282,"props":673,"children":675},{"class":284,"line":674},22,[676],{"type":119,"tag":282,"props":677,"children":678},{},[679],{"type":124,"value":680},"            description = \"Device tree\";\n",{"type":119,"tag":282,"props":682,"children":684},{"class":284,"line":683},23,[685],{"type":119,"tag":282,"props":686,"children":687},{},[688],{"type":124,"value":689},"            data = /incbin/(\"target.dtb\");\n",{"type":119,"tag":282,"props":691,"children":693},{"class":284,"line":692},24,[694],{"type":119,"tag":282,"props":695,"children":696},{},[697],{"type":124,"value":698},"            type = \"flat_dt\";\n",{"type":119,"tag":282,"props":700,"children":702},{"class":284,"line":701},25,[703],{"type":119,"tag":282,"props":704,"children":705},{},[706],{"type":124,"value":590},{"type":119,"tag":282,"props":708,"children":710},{"class":284,"line":709},26,[711],{"type":119,"tag":282,"props":712,"children":713},{},[714],{"type":124,"value":715},"            compression = \"none\";\n",{"type":119,"tag":282,"props":717,"children":719},{"class":284,"line":718},27,[720],{"type":119,"tag":282,"props":721,"children":722},{},[723],{"type":124,"value":635},{"type":119,"tag":282,"props":725,"children":727},{"class":284,"line":726},28,[728],{"type":119,"tag":282,"props":729,"children":730},{},[731],{"type":124,"value":644},{"type":119,"tag":282,"props":733,"children":735},{"class":284,"line":734},29,[736],{"type":119,"tag":282,"props":737,"children":738},{},[739],{"type":124,"value":653},{"type":119,"tag":282,"props":741,"children":743},{"class":284,"line":742},30,[744],{"type":119,"tag":282,"props":745,"children":746},{},[747],{"type":124,"value":662},{"type":119,"tag":282,"props":749,"children":751},{"class":284,"line":750},31,[752],{"type":119,"tag":282,"props":753,"children":754},{},[755],{"type":124,"value":756},"    };\n",{"type":119,"tag":282,"props":758,"children":760},{"class":284,"line":759},32,[761],{"type":119,"tag":282,"props":762,"children":763},{"emptyLinePlaceholder":500},[764],{"type":124,"value":503},{"type":119,"tag":282,"props":766,"children":768},{"class":284,"line":767},33,[769],{"type":119,"tag":282,"props":770,"children":771},{},[772],{"type":124,"value":773},"    configurations {\n",{"type":119,"tag":282,"props":775,"children":777},{"class":284,"line":776},34,[778],{"type":119,"tag":282,"props":779,"children":780},{},[781],{"type":124,"value":782},"        default = \"conf-1\";\n",{"type":119,"tag":282,"props":784,"children":786},{"class":284,"line":785},35,[787],{"type":119,"tag":282,"props":788,"children":789},{},[790],{"type":124,"value":791},"        conf-1 {\n",{"type":119,"tag":282,"props":793,"children":795},{"class":284,"line":794},36,[796],{"type":119,"tag":282,"props":797,"children":798},{},[799],{"type":124,"value":800},"            description = \"Boot configuration\";\n",{"type":119,"tag":282,"props":802,"children":804},{"class":284,"line":803},37,[805],{"type":119,"tag":282,"props":806,"children":807},{},[808],{"type":124,"value":809},"            kernel = \"kernel-1\";\n",{"type":119,"tag":282,"props":811,"children":813},{"class":284,"line":812},38,[814],{"type":119,"tag":282,"props":815,"children":816},{},[817],{"type":124,"value":818},"            fdt = \"fdt-1\";\n",{"type":119,"tag":282,"props":820,"children":822},{"class":284,"line":821},39,[823],{"type":119,"tag":282,"props":824,"children":825},{},[826],{"type":124,"value":827},"            signature-1 {\n",{"type":119,"tag":282,"props":829,"children":831},{"class":284,"line":830},40,[832],{"type":119,"tag":282,"props":833,"children":834},{},[835],{"type":124,"value":836},"                algo = \"sha256,rsa4096\";\n",{"type":119,"tag":282,"props":838,"children":840},{"class":284,"line":839},41,[841],{"type":119,"tag":282,"props":842,"children":843},{},[844],{"type":124,"value":845},"                key-name-hint = \"sign-key\";\n",{"type":119,"tag":282,"props":847,"children":849},{"class":284,"line":848},42,[850],{"type":119,"tag":282,"props":851,"children":852},{},[853],{"type":124,"value":854},"                sign-images = \"kernel\", \"fdt\";\n",{"type":119,"tag":282,"props":856,"children":858},{"class":284,"line":857},43,[859],{"type":119,"tag":282,"props":860,"children":861},{},[862],{"type":124,"value":653},{"type":119,"tag":282,"props":864,"children":866},{"class":284,"line":865},44,[867],{"type":119,"tag":282,"props":868,"children":869},{},[870],{"type":124,"value":662},{"type":119,"tag":282,"props":872,"children":874},{"class":284,"line":873},45,[875],{"type":119,"tag":282,"props":876,"children":877},{},[878],{"type":124,"value":756},{"type":119,"tag":282,"props":880,"children":882},{"class":284,"line":881},46,[883],{"type":119,"tag":282,"props":884,"children":885},{},[886],{"type":124,"value":887},"};\n",{"type":119,"tag":120,"props":889,"children":890},{},[891],{"type":124,"value":892},"Sign the image:",{"type":119,"tag":247,"props":894,"children":896},{"code":895,"language":275,"meta":108,"className":276,"style":108},"mkimage -f image.its -k keys -K u-boot.dtb -r fitImage\n",[897],{"type":119,"tag":252,"props":898,"children":899},{"__ignoreMap":108},[900],{"type":119,"tag":282,"props":901,"children":902},{"class":284,"line":285},[903,907,912,917,922,927,932,937,942],{"type":119,"tag":282,"props":904,"children":905},{"style":299},[906],{"type":124,"value":431},{"type":119,"tag":282,"props":908,"children":909},{"style":305},[910],{"type":124,"value":911}," -f",{"type":119,"tag":282,"props":913,"children":914},{"style":311},[915],{"type":124,"value":916}," image.its",{"type":119,"tag":282,"props":918,"children":919},{"style":305},[920],{"type":124,"value":921}," -k",{"type":119,"tag":282,"props":923,"children":924},{"style":311},[925],{"type":124,"value":926}," keys",{"type":119,"tag":282,"props":928,"children":929},{"style":305},[930],{"type":124,"value":931}," -K",{"type":119,"tag":282,"props":933,"children":934},{"style":311},[935],{"type":124,"value":936}," u-boot.dtb",{"type":119,"tag":282,"props":938,"children":939},{"style":305},[940],{"type":124,"value":941}," -r",{"type":119,"tag":282,"props":943,"children":944},{"style":311},[945],{"type":124,"value":946}," fitImage\n",{"type":119,"tag":120,"props":948,"children":949},{},[950,952,958,960,966,968,974,976,982,984,990],{"type":124,"value":951},"The ",{"type":119,"tag":252,"props":953,"children":955},{"className":954},[],[956],{"type":124,"value":957},"-k",{"type":124,"value":959}," flag selects the directory containing matching ",{"type":119,"tag":252,"props":961,"children":963},{"className":962},[],[964],{"type":124,"value":965},"sign-key.key",{"type":124,"value":967}," and ",{"type":119,"tag":252,"props":969,"children":971},{"className":970},[],[972],{"type":124,"value":973},"sign-key.crt",{"type":124,"value":975}," files. The ",{"type":119,"tag":252,"props":977,"children":979},{"className":978},[],[980],{"type":124,"value":981},"-K",{"type":124,"value":983}," flag selects the control DTB to receive public-key parameters. The ",{"type":119,"tag":252,"props":985,"children":987},{"className":986},[],[988],{"type":124,"value":989},"-r",{"type":124,"value":991}," flag marks the key as \"required\" in the U-Boot DTB, meaning U-Boot will refuse to boot unsigned or incorrectly signed configurations.",{"type":119,"tag":127,"props":993,"children":995},{"id":994},"configuring-u-boot-for-verified-boot",[996],{"type":124,"value":997},"Configuring U-Boot for verified boot",{"type":119,"tag":120,"props":999,"children":1000},{},[1001],{"type":124,"value":1002},"Enable these options in your U-Boot defconfig:",{"type":119,"tag":247,"props":1004,"children":1006},{"code":1005},"CONFIG_FIT=y\nCONFIG_FIT_SIGNATURE=y\nCONFIG_RSA=y\nCONFIG_FIT_VERBOSE=y\n# CONFIG_LEGACY_IMAGE_FORMAT is not set\n",[1007],{"type":119,"tag":252,"props":1008,"children":1009},{"__ignoreMap":108},[1010],{"type":124,"value":1005},{"type":119,"tag":120,"props":1012,"children":1013},{},[1014,1016,1022],{"type":124,"value":1015},"Disabling ",{"type":119,"tag":252,"props":1017,"children":1019},{"className":1018},[],[1020],{"type":124,"value":1021},"LEGACY_IMAGE_FORMAT",{"type":124,"value":1023}," is important. If legacy image format is enabled, an attacker can bypass FIT signature verification by providing a legacy (unsigned) image instead.",{"type":119,"tag":127,"props":1025,"children":1027},{"id":1026},"boot-flow-with-verification",[1028],{"type":124,"value":1029},"Boot flow with verification",{"type":119,"tag":120,"props":1031,"children":1032},{},[1033],{"type":124,"value":1034},"When U-Boot boots a signed FIT image:",{"type":119,"tag":139,"props":1036,"children":1037},{},[1038,1043,1048,1053,1058],{"type":119,"tag":143,"props":1039,"children":1040},{},[1041],{"type":124,"value":1042},"U-Boot parses the FIT structure",{"type":119,"tag":143,"props":1044,"children":1045},{},[1046],{"type":124,"value":1047},"For each configuration, U-Boot checks if a signature node exists",{"type":119,"tag":143,"props":1049,"children":1050},{},[1051],{"type":124,"value":1052},"U-Boot computes the hash of the referenced images (kernel, DTB, etc.)",{"type":119,"tag":143,"props":1054,"children":1055},{},[1056],{"type":124,"value":1057},"U-Boot verifies the signature against the embedded public key",{"type":119,"tag":143,"props":1059,"children":1060},{},[1061],{"type":124,"value":1062},"If verification succeeds, boot proceeds. If it fails, U-Boot halts or falls back (depending on configuration)",{"type":119,"tag":127,"props":1064,"children":1066},{"id":1065},"failure-modes-and-handling",[1067],{"type":124,"value":1068},"Failure modes and handling",{"type":119,"tag":120,"props":1070,"children":1071},{},[1072],{"type":124,"value":1073},"What happens when verification fails matters as much as the verification itself.",{"type":119,"tag":120,"props":1075,"children":1076},{},[1077,1079,1085],{"type":124,"value":1078},"A failed required-signature check must stop that boot attempt. The surrounding boot script decides whether to stop or try an independently authenticated recovery image. Inspect all subsequent commands: a failed ",{"type":119,"tag":252,"props":1080,"children":1082},{"className":1081},[],[1083],{"type":124,"value":1084},"bootm",{"type":124,"value":1086}," command must not fall through to an unsigned boot path.",{"type":119,"tag":120,"props":1088,"children":1089},{},[1090],{"type":124,"value":1091},"The required key policy applies to the verified FIT operation. It does not authenticate a mutable U-Boot environment or remove alternative execution commands. Constrain those paths and test the actual deployed configuration, including recovery and provisioning modes.",{"type":119,"tag":127,"props":1093,"children":1095},{"id":1094},"recovery-mechanisms",[1096],{"type":124,"value":1097},"Recovery mechanisms",{"type":119,"tag":120,"props":1099,"children":1100},{},[1101],{"type":124,"value":1102},"A device that refuses to boot due to a failed signature check needs a recovery path:",{"type":119,"tag":1104,"props":1105,"children":1106},"ul",{},[1107,1125,1135],{"type":119,"tag":143,"props":1108,"children":1109},{},[1110,1115,1117,1123],{"type":119,"tag":147,"props":1111,"children":1112},{},[1113],{"type":124,"value":1114},"Dual-bank (A/B) boot:",{"type":124,"value":1116}," Maintain two image slots. If the primary fails verification, boot the secondary. Plan ",{"type":119,"tag":190,"props":1118,"children":1120},{"href":1119},"/doc/ota-updates-rauc-swupdate-mender-2026/",[1121],{"type":124,"value":1122},"A/B updates and rollback",{"type":124,"value":1124}," with bounded retries and an authenticated recovery image.",{"type":119,"tag":143,"props":1126,"children":1127},{},[1128,1133],{"type":119,"tag":147,"props":1129,"children":1130},{},[1131],{"type":124,"value":1132},"Recovery partition:",{"type":124,"value":1134}," A minimal, separately-signed recovery image that can download and flash a new primary image.",{"type":119,"tag":143,"props":1136,"children":1137},{},[1138,1143],{"type":119,"tag":147,"props":1139,"children":1140},{},[1141],{"type":124,"value":1142},"Serial/USB recovery:",{"type":124,"value":1144}," U-Boot's USB DFU or serial boot modes can load a new image. These should be disabled or authenticated in production.",{"type":119,"tag":127,"props":1146,"children":1148},{"id":1147},"key-rotation",[1149],{"type":124,"value":1150},"Key rotation",{"type":119,"tag":120,"props":1152,"children":1153},{},[1154],{"type":124,"value":1155},"Plan for key rotation from the start. Embed a \"next key\" slot in your U-Boot DTB. When you need to rotate keys:",{"type":119,"tag":139,"props":1157,"children":1158},{},[1159,1164,1169],{"type":119,"tag":143,"props":1160,"children":1161},{},[1162],{"type":124,"value":1163},"Sign a transition image with the old key",{"type":119,"tag":143,"props":1165,"children":1166},{},[1167],{"type":124,"value":1168},"The transition image contains U-Boot with the new public key embedded",{"type":119,"tag":143,"props":1170,"children":1171},{},[1172],{"type":124,"value":1173},"Subsequent images are signed with the new key",{"type":119,"tag":120,"props":1175,"children":1176},{},[1177],{"type":124,"value":1178},"Without a key rotation mechanism, a compromised key means replacing U-Boot itself, which may require physical access.",{"type":119,"tag":127,"props":1180,"children":1182},{"id":1181},"testing-the-chain",[1183],{"type":124,"value":1184},"Testing the chain",{"type":119,"tag":120,"props":1186,"children":1187},{},[1188],{"type":124,"value":1189},"Test both the happy path and the failure path:",{"type":119,"tag":120,"props":1191,"children":1192},{},[1193,1195,1201],{"type":124,"value":1194},"Use the U-Boot v2025.01 sandbox verified-boot tests as the disposable integration reference. Record the source revision, build configuration and complete test log. The fragments above describe the signing layout and require board-specific addresses and input images. They have not been executed as a complete boot sequence here. ",{"type":119,"tag":190,"props":1196,"children":1198},{"href":1197},"https://docs.u-boot.org/en/v2025.01/usage/fit/signature.html",[1199],{"type":124,"value":1200},"U-Boot v2025.01 FIT signature documentation",{"type":124,"value":197},{"type":119,"tag":120,"props":1203,"children":1204},{},[1205],{"type":124,"value":1206},"Test a valid signed configuration, a changed signed component, a missing required signature and an untrusted signing key. Use a copy of the FIT and identify the component through the image tree. A fixed byte offset can modify the wrong region. Verify that each rejected image enters the intended bounded recovery flow.",{"type":119,"tag":120,"props":1208,"children":1209},{},[1210,1212,1218],{"type":124,"value":1211},"Download the ",{"type":119,"tag":190,"props":1213,"children":1215},{"href":1214},"/resources/boot-integrity-review-v1.md",[1216],{"type":124,"value":1217},"implementation-review worksheet",{"type":124,"value":1219},". Record how the control DTB is authenticated, how mutable boot arguments are constrained, and which recovery commands can load code. Hardware-anchored secure boot also requires the ROM-to-bootloader chain and provisioning policy to be verified on the actual platform.",{"type":119,"tag":120,"props":1221,"children":1222},{},[1223,1225,1231],{"type":124,"value":1224},"Integrating these cases into your CI pipeline alongside ",{"type":119,"tag":190,"props":1226,"children":1228},{"href":1227},"https://diyai.io/ai-tools/code-generation/code-review-automation/",[1229],{"type":124,"value":1230},"automated code review checks",{"type":124,"value":1232}," helps catch regressions in signing configuration before they reach hardware.",{"type":119,"tag":120,"props":1234,"children":1235},{},[1236,1238,1244],{"type":124,"value":1237},"For teams working within the ProteanOS ecosystem, ",{"type":119,"tag":190,"props":1239,"children":1241},{"href":1240},"/doc/verified-boot-patterns-uboot-keys-failure-modes/",[1242],{"type":124,"value":1243},"U-Boot verification patterns and failure modes",{"type":124,"value":1245}," covers additional U-Boot verification scenarios including key storage locations and common failure modes across different SoC families.",{"type":119,"tag":120,"props":1247,"children":1248},{},[1249,1250,1256],{"type":124,"value":951},{"type":119,"tag":190,"props":1251,"children":1253},{"href":1252},"/doc/plat/porting-checklist-bootloader-kernel-rootfs-2026/",[1254],{"type":124,"value":1255},"board bring-up checklist",{"type":124,"value":1257}," includes secure boot as a bring-up milestone for new hardware platforms.",{"type":119,"tag":127,"props":1259,"children":1261},{"id":1260},"summary",[1262],{"type":124,"value":1263},"Summary",{"type":119,"tag":120,"props":1265,"children":1266},{},[1267],{"type":124,"value":1268},"FIT image signing with U-Boot provides a practical, well-tested mechanism for embedded secure boot. The key steps are: generate keys, embed the public key in U-Boot, sign FIT images during the build, and configure U-Boot to require valid signatures. Test failure modes thoroughly and plan key rotation before your first production shipment.",{"type":119,"tag":1270,"props":1271,"children":1272},"style",{},[1273],{"type":124,"value":1274},"html .default .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}",{"title":108,"searchDepth":295,"depth":295,"links":1276},[1277,1278,1279,1280,1281,1282,1283,1284,1285,1286,1287,1288],{"id":129,"depth":295,"text":132},{"id":237,"depth":295,"text":240},{"id":263,"depth":295,"text":266},{"id":417,"depth":295,"text":420},{"id":461,"depth":295,"text":464},{"id":994,"depth":295,"text":997},{"id":1026,"depth":295,"text":1029},{"id":1065,"depth":295,"text":1068},{"id":1094,"depth":295,"text":1097},{"id":1147,"depth":295,"text":1150},{"id":1181,"depth":295,"text":1184},{"id":1260,"depth":295,"text":1263},"markdown","content:doc:secure-boot-uboot-fit-signatures-chain-of-trust.md","content","doc/secure-boot-uboot-fit-signatures-chain-of-trust.md","doc/secure-boot-uboot-fit-signatures-chain-of-trust","md",1795338687639]