[{"data":1,"prerenderedAt":1575},["ShallowReactive",2],{"search-index":3,"doc-plat-device-tree-debugging-overlays-validation-2026":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":67,"_dir":106,"_draft":107,"_partial":107,"_locale":108,"title":68,"description":69,"date":70,"lastmod":70,"draft":107,"hero":109,"tags":110,"category":114,"body":115,"_type":1569,"_id":1570,"_source":1571,"_file":1572,"_stem":1573,"_extension":1574},"plat",false,"","/images/hero/device-tree-debugging-overlays-validation-2026-1600x900.jpg",[111,112,113],"Embedded Linux","ProteanOS","Device Tree","doc-plat",{"type":116,"children":117,"toc":1539},"root",[118,126,133,138,209,214,220,233,246,375,389,401,407,412,420,441,447,460,466,471,477,483,488,553,588,594,599,624,629,635,640,692,697,703,709,714,816,822,827,835,840,845,858,976,981,987,992,1011,1017,1122,1128,1267,1273,1298,1308,1349,1355,1360,1476,1481,1487,1509,1522,1528,1533],{"type":119,"tag":120,"props":121,"children":122},"element","p",{},[123],{"type":124,"value":125},"text","The device tree is supposed to be a clean hardware description that separates board-specific details from driver code. In practice, it is one of the most frequent sources of bugs in embedded Linux bring-up. Drivers fail silently because a node is misconfigured, overlays do not apply as expected, and validation tools catch only a fraction of real-world errors. This guide covers the debugging techniques that actually work.",{"type":119,"tag":127,"props":128,"children":130},"h2",{"id":129},"how-the-device-tree-flows-through-the-system",[131],{"type":124,"value":132},"How the device tree flows through the system",{"type":119,"tag":120,"props":134,"children":135},{},[136],{"type":124,"value":137},"Understanding the flow helps locate where problems originate:",{"type":119,"tag":139,"props":140,"children":141},"ol",{},[142,171,186,198],{"type":119,"tag":143,"props":144,"children":145},"li",{},[146,152,154,161,163,169],{"type":119,"tag":147,"props":148,"children":149},"strong",{},[150],{"type":124,"value":151},"DTS source files",{"type":124,"value":153}," (",{"type":119,"tag":155,"props":156,"children":158},"code",{"className":157},[],[159],{"type":124,"value":160},".dts",{"type":124,"value":162},", ",{"type":119,"tag":155,"props":164,"children":166},{"className":165},[],[167],{"type":124,"value":168},".dtsi",{"type":124,"value":170},") are written by the developer",{"type":119,"tag":143,"props":172,"children":173},{},[174,179,181],{"type":119,"tag":147,"props":175,"children":176},{},[177],{"type":124,"value":178},"DTC (Device Tree Compiler)",{"type":124,"value":180}," compiles them into a ",{"type":119,"tag":147,"props":182,"children":183},{},[184],{"type":124,"value":185},"DTB (Device Tree Blob)",{"type":119,"tag":143,"props":187,"children":188},{},[189,191,196],{"type":124,"value":190},"The ",{"type":119,"tag":147,"props":192,"children":193},{},[194],{"type":124,"value":195},"bootloader",{"type":124,"value":197}," (U-Boot) may modify the DTB at runtime (fixups, overlays)",{"type":119,"tag":143,"props":199,"children":200},{},[201,202,207],{"type":124,"value":190},{"type":119,"tag":147,"props":203,"children":204},{},[205],{"type":124,"value":206},"kernel",{"type":124,"value":208}," receives the DTB and uses it to configure drivers and subsystems",{"type":119,"tag":120,"props":210,"children":211},{},[212],{"type":124,"value":213},"Bugs can be introduced at any stage. The DTS might have a typo. DTC might not warn about semantic errors. U-Boot fixups might overwrite your settings. A kernel driver might expect a property format different from what you provided.",{"type":119,"tag":127,"props":215,"children":217},{"id":216},"common-dts-errors",[218],{"type":124,"value":219},"Common DTS errors",{"type":119,"tag":221,"props":222,"children":224},"h3",{"id":223},"missing-status-okay",[225,227],{"type":124,"value":226},"Missing ",{"type":119,"tag":155,"props":228,"children":230},{"className":229},[],[231],{"type":124,"value":232},"status = \"okay\"",{"type":119,"tag":120,"props":234,"children":235},{},[236,238,244],{"type":124,"value":237},"Nodes default to ",{"type":119,"tag":155,"props":239,"children":241},{"className":240},[],[242],{"type":124,"value":243},"status = \"disabled\"",{"type":124,"value":245}," in many SoC-level DTSI files. If you don't override it in your board DTS, the driver never probes:",{"type":119,"tag":247,"props":248,"children":252},"pre",{"code":249,"language":250,"meta":108,"className":251,"style":108},"/* SoC DTSI */\nuart3: serial@12340000 {\n    compatible = \"vendor,uart\";\n    reg = \u003C0x12340000 0x1000>;\n    status = \"disabled\";\n};\n\n/* Your board DTS — this is required! */\n&uart3 {\n    status = \"okay\";\n    pinctrl-0 = \u003C&uart3_pins>;\n    pinctrl-names = \"default\";\n};\n","dts","language-dts shiki shiki-themes github-dark",[253],{"type":119,"tag":155,"props":254,"children":255},{"__ignoreMap":108},[256,267,276,285,294,303,312,322,331,340,349,358,367],{"type":119,"tag":257,"props":258,"children":261},"span",{"class":259,"line":260},"line",1,[262],{"type":119,"tag":257,"props":263,"children":264},{},[265],{"type":124,"value":266},"/* SoC DTSI */\n",{"type":119,"tag":257,"props":268,"children":270},{"class":259,"line":269},2,[271],{"type":119,"tag":257,"props":272,"children":273},{},[274],{"type":124,"value":275},"uart3: serial@12340000 {\n",{"type":119,"tag":257,"props":277,"children":279},{"class":259,"line":278},3,[280],{"type":119,"tag":257,"props":281,"children":282},{},[283],{"type":124,"value":284},"    compatible = \"vendor,uart\";\n",{"type":119,"tag":257,"props":286,"children":288},{"class":259,"line":287},4,[289],{"type":119,"tag":257,"props":290,"children":291},{},[292],{"type":124,"value":293},"    reg = \u003C0x12340000 0x1000>;\n",{"type":119,"tag":257,"props":295,"children":297},{"class":259,"line":296},5,[298],{"type":119,"tag":257,"props":299,"children":300},{},[301],{"type":124,"value":302},"    status = \"disabled\";\n",{"type":119,"tag":257,"props":304,"children":306},{"class":259,"line":305},6,[307],{"type":119,"tag":257,"props":308,"children":309},{},[310],{"type":124,"value":311},"};\n",{"type":119,"tag":257,"props":313,"children":315},{"class":259,"line":314},7,[316],{"type":119,"tag":257,"props":317,"children":319},{"emptyLinePlaceholder":318},true,[320],{"type":124,"value":321},"\n",{"type":119,"tag":257,"props":323,"children":325},{"class":259,"line":324},8,[326],{"type":119,"tag":257,"props":327,"children":328},{},[329],{"type":124,"value":330},"/* Your board DTS — this is required! */\n",{"type":119,"tag":257,"props":332,"children":334},{"class":259,"line":333},9,[335],{"type":119,"tag":257,"props":336,"children":337},{},[338],{"type":124,"value":339},"&uart3 {\n",{"type":119,"tag":257,"props":341,"children":343},{"class":259,"line":342},10,[344],{"type":119,"tag":257,"props":345,"children":346},{},[347],{"type":124,"value":348},"    status = \"okay\";\n",{"type":119,"tag":257,"props":350,"children":352},{"class":259,"line":351},11,[353],{"type":119,"tag":257,"props":354,"children":355},{},[356],{"type":124,"value":357},"    pinctrl-0 = \u003C&uart3_pins>;\n",{"type":119,"tag":257,"props":359,"children":361},{"class":259,"line":360},12,[362],{"type":119,"tag":257,"props":363,"children":364},{},[365],{"type":124,"value":366},"    pinctrl-names = \"default\";\n",{"type":119,"tag":257,"props":368,"children":370},{"class":259,"line":369},13,[371],{"type":119,"tag":257,"props":372,"children":373},{},[374],{"type":124,"value":311},{"type":119,"tag":221,"props":376,"children":378},{"id":377},"incorrect-reg-addresses",[379,381,387],{"type":124,"value":380},"Incorrect ",{"type":119,"tag":155,"props":382,"children":384},{"className":383},[],[385],{"type":124,"value":386},"reg",{"type":124,"value":388}," addresses",{"type":119,"tag":120,"props":390,"children":391},{},[392,394,399],{"type":124,"value":393},"A wrong base address means the driver reads garbage or hangs. Cross-reference every ",{"type":119,"tag":155,"props":395,"children":397},{"className":396},[],[398],{"type":124,"value":386},{"type":124,"value":400}," property with the SoC TRM. Off-by-one errors in the address or size are common when converting between hex and decimal.",{"type":119,"tag":221,"props":402,"children":404},{"id":403},"missing-or-wrong-clock-references",[405],{"type":124,"value":406},"Missing or wrong clock references",{"type":119,"tag":120,"props":408,"children":409},{},[410],{"type":124,"value":411},"Many drivers refuse to probe if their clock reference is missing or points to the wrong clock. The error message is often unhelpful:",{"type":119,"tag":247,"props":413,"children":415},{"code":414},"vendor-uart 12340000.serial: could not get clock\n",[416],{"type":119,"tag":155,"props":417,"children":418},{"__ignoreMap":108},[419],{"type":124,"value":414},{"type":119,"tag":120,"props":421,"children":422},{},[423,425,431,433,439],{"type":124,"value":424},"Check: is the clock node enabled? Does the ",{"type":119,"tag":155,"props":426,"children":428},{"className":427},[],[429],{"type":124,"value":430},"clocks",{"type":124,"value":432}," property point to the correct clock ID? Does the clock provider node have the right ",{"type":119,"tag":155,"props":434,"children":436},{"className":435},[],[437],{"type":124,"value":438},"#clock-cells",{"type":124,"value":440},"?",{"type":119,"tag":221,"props":442,"children":444},{"id":443},"pin-mux-conflicts",[445],{"type":124,"value":446},"Pin mux conflicts",{"type":119,"tag":120,"props":448,"children":449},{},[450,452,458],{"type":124,"value":451},"Two peripherals assigned to the same pins. The second one to probe fails, often silently. The pinctrl subsystem logs conflicts at boot if you enable ",{"type":119,"tag":155,"props":453,"children":455},{"className":454},[],[456],{"type":124,"value":457},"CONFIG_PINCTRL_DEBUG",{"type":124,"value":459},".",{"type":119,"tag":221,"props":461,"children":463},{"id":462},"interrupt-number-mismatches",[464],{"type":124,"value":465},"Interrupt number mismatches",{"type":119,"tag":120,"props":467,"children":468},{},[469],{"type":124,"value":470},"SoC TRMs number interrupts differently than the device tree expects. ARM GIC interrupts: the DT uses the GIC SPI number (peripheral interrupt minus 32 on most SoCs). Getting this wrong means the driver never receives interrupts.",{"type":119,"tag":127,"props":472,"children":474},{"id":473},"validation-tools",[475],{"type":124,"value":476},"Validation tools",{"type":119,"tag":221,"props":478,"children":480},{"id":479},"dtc-warnings",[481],{"type":124,"value":482},"DTC warnings",{"type":119,"tag":120,"props":484,"children":485},{},[486],{"type":124,"value":487},"DTC itself catches syntax errors and some semantic issues:",{"type":119,"tag":247,"props":489,"children":493},{"code":490,"language":491,"meta":108,"className":492,"style":108},"dtc -I dts -O dtb -W all -o board.dtb board.dts\n","bash","language-bash shiki shiki-themes github-dark",[494],{"type":119,"tag":155,"props":495,"children":496},{"__ignoreMap":108},[497],{"type":119,"tag":257,"props":498,"children":499},{"class":259,"line":260},[500,506,512,518,523,528,533,538,543,548],{"type":119,"tag":257,"props":501,"children":503},{"style":502},"--shiki-default:#B392F0",[504],{"type":124,"value":505},"dtc",{"type":119,"tag":257,"props":507,"children":509},{"style":508},"--shiki-default:#79B8FF",[510],{"type":124,"value":511}," -I",{"type":119,"tag":257,"props":513,"children":515},{"style":514},"--shiki-default:#9ECBFF",[516],{"type":124,"value":517}," dts",{"type":119,"tag":257,"props":519,"children":520},{"style":508},[521],{"type":124,"value":522}," -O",{"type":119,"tag":257,"props":524,"children":525},{"style":514},[526],{"type":124,"value":527}," dtb",{"type":119,"tag":257,"props":529,"children":530},{"style":508},[531],{"type":124,"value":532}," -W",{"type":119,"tag":257,"props":534,"children":535},{"style":514},[536],{"type":124,"value":537}," all",{"type":119,"tag":257,"props":539,"children":540},{"style":508},[541],{"type":124,"value":542}," -o",{"type":119,"tag":257,"props":544,"children":545},{"style":514},[546],{"type":124,"value":547}," board.dtb",{"type":119,"tag":257,"props":549,"children":550},{"style":514},[551],{"type":124,"value":552}," board.dts\n",{"type":119,"tag":120,"props":554,"children":555},{},[556,557,563,565,571,572,578,580,586],{"type":124,"value":190},{"type":119,"tag":155,"props":558,"children":560},{"className":559},[],[561],{"type":124,"value":562},"-W all",{"type":124,"value":564}," flag enables additional warnings. Pay attention to warnings about missing ",{"type":119,"tag":155,"props":566,"children":568},{"className":567},[],[569],{"type":124,"value":570},"#address-cells",{"type":124,"value":162},{"type":119,"tag":155,"props":573,"children":575},{"className":574},[],[576],{"type":124,"value":577},"#size-cells",{"type":124,"value":579},", and ",{"type":119,"tag":155,"props":581,"children":583},{"className":582},[],[584],{"type":124,"value":585},"compatible",{"type":124,"value":587}," strings.",{"type":119,"tag":221,"props":589,"children":591},{"id":590},"dt-schema-yaml-schema-validation",[592],{"type":124,"value":593},"dt-schema (YAML schema validation)",{"type":119,"tag":120,"props":595,"children":596},{},[597],{"type":124,"value":598},"The kernel includes YAML schemas for many bindings. Validate your DTB against them:",{"type":119,"tag":247,"props":600,"children":602},{"code":601,"language":491,"meta":108,"className":492,"style":108},"make dtbs_check DT_SCHEMA_FILES=Documentation/devicetree/bindings/serial/vendor,uart.yaml\n",[603],{"type":119,"tag":155,"props":604,"children":605},{"__ignoreMap":108},[606],{"type":119,"tag":257,"props":607,"children":608},{"class":259,"line":260},[609,614,619],{"type":119,"tag":257,"props":610,"children":611},{"style":502},[612],{"type":124,"value":613},"make",{"type":119,"tag":257,"props":615,"children":616},{"style":514},[617],{"type":124,"value":618}," dtbs_check",{"type":119,"tag":257,"props":620,"children":621},{"style":514},[622],{"type":124,"value":623}," DT_SCHEMA_FILES=Documentation/devicetree/bindings/serial/vendor,uart.yaml\n",{"type":119,"tag":120,"props":625,"children":626},{},[627],{"type":124,"value":628},"This catches missing required properties and wrong property types. It does not catch wrong values (e.g., wrong clock ID).",{"type":119,"tag":221,"props":630,"children":632},{"id":631},"fdtdump-fdtget",[633],{"type":124,"value":634},"fdtdump / fdtget",{"type":119,"tag":120,"props":636,"children":637},{},[638],{"type":124,"value":639},"Inspect the compiled DTB:",{"type":119,"tag":247,"props":641,"children":643},{"code":642,"language":491,"meta":108,"className":492,"style":108},"fdtdump board.dtb | less\nfdtget board.dtb /soc/serial@12340000 status\n",[644],{"type":119,"tag":155,"props":645,"children":646},{"__ignoreMap":108},[647,670],{"type":119,"tag":257,"props":648,"children":649},{"class":259,"line":260},[650,655,659,665],{"type":119,"tag":257,"props":651,"children":652},{"style":502},[653],{"type":124,"value":654},"fdtdump",{"type":119,"tag":257,"props":656,"children":657},{"style":514},[658],{"type":124,"value":547},{"type":119,"tag":257,"props":660,"children":662},{"style":661},"--shiki-default:#F97583",[663],{"type":124,"value":664}," |",{"type":119,"tag":257,"props":666,"children":667},{"style":502},[668],{"type":124,"value":669}," less\n",{"type":119,"tag":257,"props":671,"children":672},{"class":259,"line":269},[673,678,682,687],{"type":119,"tag":257,"props":674,"children":675},{"style":502},[676],{"type":124,"value":677},"fdtget",{"type":119,"tag":257,"props":679,"children":680},{"style":514},[681],{"type":124,"value":547},{"type":119,"tag":257,"props":683,"children":684},{"style":514},[685],{"type":124,"value":686}," /soc/serial@12340000",{"type":119,"tag":257,"props":688,"children":689},{"style":514},[690],{"type":124,"value":691}," status\n",{"type":119,"tag":120,"props":693,"children":694},{},[695],{"type":124,"value":696},"Useful for verifying that your DTS changes actually made it into the compiled blob.",{"type":119,"tag":127,"props":698,"children":700},{"id":699},"runtime-debugging",[701],{"type":124,"value":702},"Runtime debugging",{"type":119,"tag":221,"props":704,"children":706},{"id":705},"procdevice-tree-or-sysfirmwaredevicetree",[707],{"type":124,"value":708},"/proc/device-tree (or /sys/firmware/devicetree)",{"type":119,"tag":120,"props":710,"children":711},{},[712],{"type":124,"value":713},"The running kernel exposes the device tree it received. Compare it to what you expected:",{"type":119,"tag":247,"props":715,"children":717},{"code":716,"language":491,"meta":108,"className":492,"style":108},"# Check a specific property\ncat /proc/device-tree/soc/serial@12340000/status\n\n# List all nodes\nfind /proc/device-tree -name compatible -exec sh -c 'echo \"$1: $(cat \"$1\")\"' _ {} \\;\n",[718],{"type":119,"tag":155,"props":719,"children":720},{"__ignoreMap":108},[721,730,743,750,758],{"type":119,"tag":257,"props":722,"children":723},{"class":259,"line":260},[724],{"type":119,"tag":257,"props":725,"children":727},{"style":726},"--shiki-default:#6A737D",[728],{"type":124,"value":729},"# Check a specific property\n",{"type":119,"tag":257,"props":731,"children":732},{"class":259,"line":269},[733,738],{"type":119,"tag":257,"props":734,"children":735},{"style":502},[736],{"type":124,"value":737},"cat",{"type":119,"tag":257,"props":739,"children":740},{"style":514},[741],{"type":124,"value":742}," /proc/device-tree/soc/serial@12340000/status\n",{"type":119,"tag":257,"props":744,"children":745},{"class":259,"line":278},[746],{"type":119,"tag":257,"props":747,"children":748},{"emptyLinePlaceholder":318},[749],{"type":124,"value":321},{"type":119,"tag":257,"props":751,"children":752},{"class":259,"line":287},[753],{"type":119,"tag":257,"props":754,"children":755},{"style":726},[756],{"type":124,"value":757},"# List all nodes\n",{"type":119,"tag":257,"props":759,"children":760},{"class":259,"line":296},[761,766,771,776,781,786,791,796,801,806,811],{"type":119,"tag":257,"props":762,"children":763},{"style":502},[764],{"type":124,"value":765},"find",{"type":119,"tag":257,"props":767,"children":768},{"style":514},[769],{"type":124,"value":770}," /proc/device-tree",{"type":119,"tag":257,"props":772,"children":773},{"style":508},[774],{"type":124,"value":775}," -name",{"type":119,"tag":257,"props":777,"children":778},{"style":514},[779],{"type":124,"value":780}," compatible",{"type":119,"tag":257,"props":782,"children":783},{"style":508},[784],{"type":124,"value":785}," -exec",{"type":119,"tag":257,"props":787,"children":788},{"style":514},[789],{"type":124,"value":790}," sh",{"type":119,"tag":257,"props":792,"children":793},{"style":508},[794],{"type":124,"value":795}," -c",{"type":119,"tag":257,"props":797,"children":798},{"style":514},[799],{"type":124,"value":800}," 'echo \"$1: $(cat \"$1\")\"'",{"type":119,"tag":257,"props":802,"children":803},{"style":514},[804],{"type":124,"value":805}," _",{"type":119,"tag":257,"props":807,"children":808},{"style":514},[809],{"type":124,"value":810}," {}",{"type":119,"tag":257,"props":812,"children":813},{"style":508},[814],{"type":124,"value":815}," \\;\n",{"type":119,"tag":221,"props":817,"children":819},{"id":818},"dmesg-driver-probe-messages",[820],{"type":124,"value":821},"dmesg driver probe messages",{"type":119,"tag":120,"props":823,"children":824},{},[825],{"type":124,"value":826},"Enable verbose driver probing:",{"type":119,"tag":247,"props":828,"children":830},{"code":829},"# Kernel command line\nloglevel=8 initcall_debug\n",[831],{"type":119,"tag":155,"props":832,"children":833},{"__ignoreMap":108},[834],{"type":124,"value":829},{"type":119,"tag":120,"props":836,"children":837},{},[838],{"type":124,"value":839},"Look for \"probe\" and \"failed\" messages. Many drivers log why they failed to probe, but the messages scroll past quickly during boot.",{"type":119,"tag":221,"props":841,"children":843},{"id":842},"debugfs",[844],{"type":124,"value":842},{"type":119,"tag":120,"props":846,"children":847},{},[848,850,856],{"type":124,"value":849},"Many subsystems expose debug info under ",{"type":119,"tag":155,"props":851,"children":853},{"className":852},[],[854],{"type":124,"value":855},"/sys/kernel/debug/",{"type":124,"value":857},":",{"type":119,"tag":247,"props":859,"children":861},{"code":860,"language":491,"meta":108,"className":492,"style":108},"# Pin control\ncat /sys/kernel/debug/pinctrl/*/pinmux-pins\n\n# Clock tree\ncat /sys/kernel/debug/clk/clk_summary\n\n# GPIO\ncat /sys/kernel/debug/gpio\n\n# Regulators\ncat /sys/kernel/debug/regulator/regulator_summary\n",[862],{"type":119,"tag":155,"props":863,"children":864},{"__ignoreMap":108},[865,873,895,902,910,922,929,937,949,956,964],{"type":119,"tag":257,"props":866,"children":867},{"class":259,"line":260},[868],{"type":119,"tag":257,"props":869,"children":870},{"style":726},[871],{"type":124,"value":872},"# Pin control\n",{"type":119,"tag":257,"props":874,"children":875},{"class":259,"line":269},[876,880,885,890],{"type":119,"tag":257,"props":877,"children":878},{"style":502},[879],{"type":124,"value":737},{"type":119,"tag":257,"props":881,"children":882},{"style":514},[883],{"type":124,"value":884}," /sys/kernel/debug/pinctrl/",{"type":119,"tag":257,"props":886,"children":887},{"style":508},[888],{"type":124,"value":889},"*",{"type":119,"tag":257,"props":891,"children":892},{"style":514},[893],{"type":124,"value":894},"/pinmux-pins\n",{"type":119,"tag":257,"props":896,"children":897},{"class":259,"line":278},[898],{"type":119,"tag":257,"props":899,"children":900},{"emptyLinePlaceholder":318},[901],{"type":124,"value":321},{"type":119,"tag":257,"props":903,"children":904},{"class":259,"line":287},[905],{"type":119,"tag":257,"props":906,"children":907},{"style":726},[908],{"type":124,"value":909},"# Clock tree\n",{"type":119,"tag":257,"props":911,"children":912},{"class":259,"line":296},[913,917],{"type":119,"tag":257,"props":914,"children":915},{"style":502},[916],{"type":124,"value":737},{"type":119,"tag":257,"props":918,"children":919},{"style":514},[920],{"type":124,"value":921}," /sys/kernel/debug/clk/clk_summary\n",{"type":119,"tag":257,"props":923,"children":924},{"class":259,"line":305},[925],{"type":119,"tag":257,"props":926,"children":927},{"emptyLinePlaceholder":318},[928],{"type":124,"value":321},{"type":119,"tag":257,"props":930,"children":931},{"class":259,"line":314},[932],{"type":119,"tag":257,"props":933,"children":934},{"style":726},[935],{"type":124,"value":936},"# GPIO\n",{"type":119,"tag":257,"props":938,"children":939},{"class":259,"line":324},[940,944],{"type":119,"tag":257,"props":941,"children":942},{"style":502},[943],{"type":124,"value":737},{"type":119,"tag":257,"props":945,"children":946},{"style":514},[947],{"type":124,"value":948}," /sys/kernel/debug/gpio\n",{"type":119,"tag":257,"props":950,"children":951},{"class":259,"line":333},[952],{"type":119,"tag":257,"props":953,"children":954},{"emptyLinePlaceholder":318},[955],{"type":124,"value":321},{"type":119,"tag":257,"props":957,"children":958},{"class":259,"line":342},[959],{"type":119,"tag":257,"props":960,"children":961},{"style":726},[962],{"type":124,"value":963},"# Regulators\n",{"type":119,"tag":257,"props":965,"children":966},{"class":259,"line":351},[967,971],{"type":119,"tag":257,"props":968,"children":969},{"style":502},[970],{"type":124,"value":737},{"type":119,"tag":257,"props":972,"children":973},{"style":514},[974],{"type":124,"value":975}," /sys/kernel/debug/regulator/regulator_summary\n",{"type":119,"tag":120,"props":977,"children":978},{},[979],{"type":124,"value":980},"These files show the actual runtime state, which may differ from what the device tree requested.",{"type":119,"tag":127,"props":982,"children":984},{"id":983},"device-tree-overlays",[985],{"type":124,"value":986},"Device tree overlays",{"type":119,"tag":120,"props":988,"children":989},{},[990],{"type":124,"value":991},"Overlays allow modifying the device tree at runtime, typically applied by the bootloader. Common uses:",{"type":119,"tag":993,"props":994,"children":995},"ul",{},[996,1001,1006],{"type":119,"tag":143,"props":997,"children":998},{},[999],{"type":124,"value":1000},"Enabling a peripheral for a specific board variant",{"type":119,"tag":143,"props":1002,"children":1003},{},[1004],{"type":124,"value":1005},"Adding a cape or shield description",{"type":119,"tag":143,"props":1007,"children":1008},{},[1009],{"type":124,"value":1010},"Adjusting configuration without rebuilding the base DTB",{"type":119,"tag":221,"props":1012,"children":1014},{"id":1013},"creating-an-overlay",[1015],{"type":124,"value":1016},"Creating an overlay",{"type":119,"tag":247,"props":1018,"children":1020},{"code":1019,"language":250,"meta":108,"className":251,"style":108},"/dts-v1/;\n/plugin/;\n\n&uart3 {\n    status = \"okay\";\n};\n\n&i2c1 {\n    temperature-sensor@48 {\n        compatible = \"ti,tmp102\";\n        reg = \u003C0x48>;\n    };\n};\n",[1021],{"type":119,"tag":155,"props":1022,"children":1023},{"__ignoreMap":108},[1024,1032,1040,1047,1054,1061,1068,1075,1083,1091,1099,1107,1115],{"type":119,"tag":257,"props":1025,"children":1026},{"class":259,"line":260},[1027],{"type":119,"tag":257,"props":1028,"children":1029},{},[1030],{"type":124,"value":1031},"/dts-v1/;\n",{"type":119,"tag":257,"props":1033,"children":1034},{"class":259,"line":269},[1035],{"type":119,"tag":257,"props":1036,"children":1037},{},[1038],{"type":124,"value":1039},"/plugin/;\n",{"type":119,"tag":257,"props":1041,"children":1042},{"class":259,"line":278},[1043],{"type":119,"tag":257,"props":1044,"children":1045},{"emptyLinePlaceholder":318},[1046],{"type":124,"value":321},{"type":119,"tag":257,"props":1048,"children":1049},{"class":259,"line":287},[1050],{"type":119,"tag":257,"props":1051,"children":1052},{},[1053],{"type":124,"value":339},{"type":119,"tag":257,"props":1055,"children":1056},{"class":259,"line":296},[1057],{"type":119,"tag":257,"props":1058,"children":1059},{},[1060],{"type":124,"value":348},{"type":119,"tag":257,"props":1062,"children":1063},{"class":259,"line":305},[1064],{"type":119,"tag":257,"props":1065,"children":1066},{},[1067],{"type":124,"value":311},{"type":119,"tag":257,"props":1069,"children":1070},{"class":259,"line":314},[1071],{"type":119,"tag":257,"props":1072,"children":1073},{"emptyLinePlaceholder":318},[1074],{"type":124,"value":321},{"type":119,"tag":257,"props":1076,"children":1077},{"class":259,"line":324},[1078],{"type":119,"tag":257,"props":1079,"children":1080},{},[1081],{"type":124,"value":1082},"&i2c1 {\n",{"type":119,"tag":257,"props":1084,"children":1085},{"class":259,"line":333},[1086],{"type":119,"tag":257,"props":1087,"children":1088},{},[1089],{"type":124,"value":1090},"    temperature-sensor@48 {\n",{"type":119,"tag":257,"props":1092,"children":1093},{"class":259,"line":342},[1094],{"type":119,"tag":257,"props":1095,"children":1096},{},[1097],{"type":124,"value":1098},"        compatible = \"ti,tmp102\";\n",{"type":119,"tag":257,"props":1100,"children":1101},{"class":259,"line":351},[1102],{"type":119,"tag":257,"props":1103,"children":1104},{},[1105],{"type":124,"value":1106},"        reg = \u003C0x48>;\n",{"type":119,"tag":257,"props":1108,"children":1109},{"class":259,"line":360},[1110],{"type":119,"tag":257,"props":1111,"children":1112},{},[1113],{"type":124,"value":1114},"    };\n",{"type":119,"tag":257,"props":1116,"children":1117},{"class":259,"line":369},[1118],{"type":119,"tag":257,"props":1119,"children":1120},{},[1121],{"type":124,"value":311},{"type":119,"tag":221,"props":1123,"children":1125},{"id":1124},"compiling-and-applying",[1126],{"type":124,"value":1127},"Compiling and applying",{"type":119,"tag":247,"props":1129,"children":1131},{"code":1130,"language":491,"meta":108,"className":492,"style":108},"# Compile\ndtc -I dts -O dtb -@ -o overlay.dtbo overlay.dts\n\n# Apply in U-Boot\nfdt apply overlay.dtbo\n\n# Or apply in Linux (ConfigFS)\nmkdir /sys/kernel/config/device-tree/overlays/my-overlay\ncat overlay.dtbo > /sys/kernel/config/device-tree/overlays/my-overlay/dtbo\n",[1132],{"type":119,"tag":155,"props":1133,"children":1134},{"__ignoreMap":108},[1135,1143,1185,1192,1200,1218,1225,1233,1246],{"type":119,"tag":257,"props":1136,"children":1137},{"class":259,"line":260},[1138],{"type":119,"tag":257,"props":1139,"children":1140},{"style":726},[1141],{"type":124,"value":1142},"# Compile\n",{"type":119,"tag":257,"props":1144,"children":1145},{"class":259,"line":269},[1146,1150,1154,1158,1162,1166,1171,1175,1180],{"type":119,"tag":257,"props":1147,"children":1148},{"style":502},[1149],{"type":124,"value":505},{"type":119,"tag":257,"props":1151,"children":1152},{"style":508},[1153],{"type":124,"value":511},{"type":119,"tag":257,"props":1155,"children":1156},{"style":514},[1157],{"type":124,"value":517},{"type":119,"tag":257,"props":1159,"children":1160},{"style":508},[1161],{"type":124,"value":522},{"type":119,"tag":257,"props":1163,"children":1164},{"style":514},[1165],{"type":124,"value":527},{"type":119,"tag":257,"props":1167,"children":1168},{"style":508},[1169],{"type":124,"value":1170}," -@",{"type":119,"tag":257,"props":1172,"children":1173},{"style":508},[1174],{"type":124,"value":542},{"type":119,"tag":257,"props":1176,"children":1177},{"style":514},[1178],{"type":124,"value":1179}," overlay.dtbo",{"type":119,"tag":257,"props":1181,"children":1182},{"style":514},[1183],{"type":124,"value":1184}," overlay.dts\n",{"type":119,"tag":257,"props":1186,"children":1187},{"class":259,"line":278},[1188],{"type":119,"tag":257,"props":1189,"children":1190},{"emptyLinePlaceholder":318},[1191],{"type":124,"value":321},{"type":119,"tag":257,"props":1193,"children":1194},{"class":259,"line":287},[1195],{"type":119,"tag":257,"props":1196,"children":1197},{"style":726},[1198],{"type":124,"value":1199},"# Apply in U-Boot\n",{"type":119,"tag":257,"props":1201,"children":1202},{"class":259,"line":296},[1203,1208,1213],{"type":119,"tag":257,"props":1204,"children":1205},{"style":502},[1206],{"type":124,"value":1207},"fdt",{"type":119,"tag":257,"props":1209,"children":1210},{"style":514},[1211],{"type":124,"value":1212}," apply",{"type":119,"tag":257,"props":1214,"children":1215},{"style":514},[1216],{"type":124,"value":1217}," overlay.dtbo\n",{"type":119,"tag":257,"props":1219,"children":1220},{"class":259,"line":305},[1221],{"type":119,"tag":257,"props":1222,"children":1223},{"emptyLinePlaceholder":318},[1224],{"type":124,"value":321},{"type":119,"tag":257,"props":1226,"children":1227},{"class":259,"line":314},[1228],{"type":119,"tag":257,"props":1229,"children":1230},{"style":726},[1231],{"type":124,"value":1232},"# Or apply in Linux (ConfigFS)\n",{"type":119,"tag":257,"props":1234,"children":1235},{"class":259,"line":324},[1236,1241],{"type":119,"tag":257,"props":1237,"children":1238},{"style":502},[1239],{"type":124,"value":1240},"mkdir",{"type":119,"tag":257,"props":1242,"children":1243},{"style":514},[1244],{"type":124,"value":1245}," /sys/kernel/config/device-tree/overlays/my-overlay\n",{"type":119,"tag":257,"props":1247,"children":1248},{"class":259,"line":333},[1249,1253,1257,1262],{"type":119,"tag":257,"props":1250,"children":1251},{"style":502},[1252],{"type":124,"value":737},{"type":119,"tag":257,"props":1254,"children":1255},{"style":514},[1256],{"type":124,"value":1179},{"type":119,"tag":257,"props":1258,"children":1259},{"style":661},[1260],{"type":124,"value":1261}," >",{"type":119,"tag":257,"props":1263,"children":1264},{"style":514},[1265],{"type":124,"value":1266}," /sys/kernel/config/device-tree/overlays/my-overlay/dtbo\n",{"type":119,"tag":221,"props":1268,"children":1270},{"id":1269},"common-overlay-problems",[1271],{"type":124,"value":1272},"Common overlay problems",{"type":119,"tag":120,"props":1274,"children":1275},{},[1276,1281,1283,1289,1291,1297],{"type":119,"tag":147,"props":1277,"children":1278},{},[1279],{"type":124,"value":1280},"Symbols not found:",{"type":124,"value":1282}," The base DTB must be compiled with ",{"type":119,"tag":155,"props":1284,"children":1286},{"className":1285},[],[1287],{"type":124,"value":1288},"-@",{"type":124,"value":1290}," (enable symbols) for overlays to reference nodes by label. Without symbols, the overlay cannot find ",{"type":119,"tag":155,"props":1292,"children":1294},{"className":1293},[],[1295],{"type":124,"value":1296},"&uart3",{"type":124,"value":459},{"type":119,"tag":120,"props":1299,"children":1300},{},[1301,1306],{"type":119,"tag":147,"props":1302,"children":1303},{},[1304],{"type":124,"value":1305},"Overlay order matters:",{"type":124,"value":1307}," If two overlays modify the same node, the order of application determines the final state. Document the required order.",{"type":119,"tag":120,"props":1309,"children":1310},{},[1311,1316,1318,1324,1326,1332,1334,1340,1342,1348],{"type":119,"tag":147,"props":1312,"children":1313},{},[1314],{"type":124,"value":1315},"Properties not merged as expected:",{"type":124,"value":1317}," Overlays replace properties, not merge them. If the base DTB has ",{"type":119,"tag":155,"props":1319,"children":1321},{"className":1320},[],[1322],{"type":124,"value":1323},"pinctrl-0 = \u003C&pins_a>",{"type":124,"value":1325}," and the overlay sets ",{"type":119,"tag":155,"props":1327,"children":1329},{"className":1328},[],[1330],{"type":124,"value":1331},"pinctrl-0 = \u003C&pins_b>",{"type":124,"value":1333},", the result is ",{"type":119,"tag":155,"props":1335,"children":1337},{"className":1336},[],[1338],{"type":124,"value":1339},"\u003C&pins_b>",{"type":124,"value":1341},", not ",{"type":119,"tag":155,"props":1343,"children":1345},{"className":1344},[],[1346],{"type":124,"value":1347},"\u003C&pins_a &pins_b>",{"type":124,"value":459},{"type":119,"tag":127,"props":1350,"children":1352},{"id":1351},"debugging-workflow",[1353],{"type":124,"value":1354},"Debugging workflow",{"type":119,"tag":120,"props":1356,"children":1357},{},[1358],{"type":124,"value":1359},"When a peripheral does not work after porting:",{"type":119,"tag":139,"props":1361,"children":1362},{},[1363,1381,1405,1422,1439,1456,1466],{"type":119,"tag":143,"props":1364,"children":1365},{},[1366,1371,1373,1379],{"type":119,"tag":147,"props":1367,"children":1368},{},[1369],{"type":124,"value":1370},"Check status:",{"type":124,"value":1372}," Is the node enabled? (",{"type":119,"tag":155,"props":1374,"children":1376},{"className":1375},[],[1377],{"type":124,"value":1378},"fdtget board.dtb /path/to/node status",{"type":124,"value":1380},")",{"type":119,"tag":143,"props":1382,"children":1383},{},[1384,1389,1391,1396,1398,1404],{"type":119,"tag":147,"props":1385,"children":1386},{},[1387],{"type":124,"value":1388},"Check compatible:",{"type":124,"value":1390}," Does the ",{"type":119,"tag":155,"props":1392,"children":1394},{"className":1393},[],[1395],{"type":124,"value":585},{"type":124,"value":1397}," string match a driver? (",{"type":119,"tag":155,"props":1399,"children":1401},{"className":1400},[],[1402],{"type":124,"value":1403},"grep -r \"compatible_string\" drivers/",{"type":124,"value":1380},{"type":119,"tag":143,"props":1406,"children":1407},{},[1408,1413,1415,1421],{"type":119,"tag":147,"props":1409,"children":1410},{},[1411],{"type":124,"value":1412},"Check clocks:",{"type":124,"value":1414}," Is the clock enabled and correct? (runtime: ",{"type":119,"tag":155,"props":1416,"children":1418},{"className":1417},[],[1419],{"type":124,"value":1420},"/sys/kernel/debug/clk/clk_summary",{"type":124,"value":1380},{"type":119,"tag":143,"props":1423,"children":1424},{},[1425,1430,1432,1438],{"type":119,"tag":147,"props":1426,"children":1427},{},[1428],{"type":124,"value":1429},"Check pins:",{"type":124,"value":1431}," Are pins muxed correctly? (runtime: ",{"type":119,"tag":155,"props":1433,"children":1435},{"className":1434},[],[1436],{"type":124,"value":1437},"/sys/kernel/debug/pinctrl/*/pinmux-pins",{"type":124,"value":1380},{"type":119,"tag":143,"props":1440,"children":1441},{},[1442,1447,1449,1455],{"type":119,"tag":147,"props":1443,"children":1444},{},[1445],{"type":124,"value":1446},"Check interrupts:",{"type":124,"value":1448}," Is the interrupt number correct? (",{"type":119,"tag":155,"props":1450,"children":1452},{"className":1451},[],[1453],{"type":124,"value":1454},"cat /proc/interrupts",{"type":124,"value":1380},{"type":119,"tag":143,"props":1457,"children":1458},{},[1459,1464],{"type":119,"tag":147,"props":1460,"children":1461},{},[1462],{"type":124,"value":1463},"Check dmesg:",{"type":124,"value":1465}," Does the driver report a probe failure?",{"type":119,"tag":143,"props":1467,"children":1468},{},[1469,1474],{"type":119,"tag":147,"props":1470,"children":1471},{},[1472],{"type":124,"value":1473},"Check power domain:",{"type":124,"value":1475}," Is the peripheral's power domain enabled?",{"type":119,"tag":120,"props":1477,"children":1478},{},[1479],{"type":124,"value":1480},"Work through this list systematically. Most device tree bugs are found in steps 1–4.",{"type":119,"tag":127,"props":1482,"children":1484},{"id":1483},"integration-with-proteanos",[1485],{"type":124,"value":1486},"Integration with ProteanOS",{"type":119,"tag":120,"props":1488,"children":1489},{},[1490,1492,1499,1501,1507],{"type":124,"value":1491},"ProteanOS board support packages include device tree sources that follow mainline kernel conventions. The ",{"type":119,"tag":1493,"props":1494,"children":1496},"a",{"href":1495},"/doc/plat/porting/",[1497],{"type":124,"value":1498},"porting guide",{"type":124,"value":1500}," covers how to create and submit device tree files for new boards. The ",{"type":119,"tag":1493,"props":1502,"children":1504},{"href":1503},"/doc/plat/porting-checklist-bootloader-kernel-rootfs-2026/",[1505],{"type":124,"value":1506},"porting checklist",{"type":124,"value":1508}," includes device tree validation as a milestone.",{"type":119,"tag":120,"props":1510,"children":1511},{},[1512,1514,1520],{"type":124,"value":1513},"For build system integration, device tree compilation is part of the standard ",{"type":119,"tag":1493,"props":1515,"children":1517},{"href":1516},"/dev/prokit/",[1518],{"type":124,"value":1519},"ProKit",{"type":124,"value":1521}," kernel build process.",{"type":119,"tag":127,"props":1523,"children":1525},{"id":1524},"summary",[1526],{"type":124,"value":1527},"Summary",{"type":119,"tag":120,"props":1529,"children":1530},{},[1531],{"type":124,"value":1532},"Device tree debugging is detective work. The device tree is a static description interpreted by dynamic code, and the gap between what you wrote and what the kernel understands is where bugs hide. Use validation tools before boot, runtime debug files after boot, and work through the seven-step checklist when things do not work. Document your device tree as thoroughly as your code—the next person debugging it will be you, six months from now.",{"type":119,"tag":1534,"props":1535,"children":1536},"style",{},[1537],{"type":124,"value":1538},"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":269,"depth":269,"links":1540},[1541,1542,1551,1556,1561,1566,1567,1568],{"id":129,"depth":269,"text":132},{"id":216,"depth":269,"text":219,"children":1543},[1544,1546,1548,1549,1550],{"id":223,"depth":278,"text":1545},"Missing status = \"okay\"",{"id":377,"depth":278,"text":1547},"Incorrect reg addresses",{"id":403,"depth":278,"text":406},{"id":443,"depth":278,"text":446},{"id":462,"depth":278,"text":465},{"id":473,"depth":269,"text":476,"children":1552},[1553,1554,1555],{"id":479,"depth":278,"text":482},{"id":590,"depth":278,"text":593},{"id":631,"depth":278,"text":634},{"id":699,"depth":269,"text":702,"children":1557},[1558,1559,1560],{"id":705,"depth":278,"text":708},{"id":818,"depth":278,"text":821},{"id":842,"depth":278,"text":842},{"id":983,"depth":269,"text":986,"children":1562},[1563,1564,1565],{"id":1013,"depth":278,"text":1016},{"id":1124,"depth":278,"text":1127},{"id":1269,"depth":278,"text":1272},{"id":1351,"depth":269,"text":1354},{"id":1483,"depth":269,"text":1486},{"id":1524,"depth":269,"text":1527},"markdown","content:doc:plat:device-tree-debugging-overlays-validation-2026.md","content","doc/plat/device-tree-debugging-overlays-validation-2026.md","doc/plat/device-tree-debugging-overlays-validation-2026","md",1795338687540]