{"docs":[{"id":147,"title":"What Goes Into a Board Support Package","heading":"What Goes Into a Board Support Package","subheading":null,"category":"Embedded Linux","body":{"root":{"type":"root","children":[{"type":"heading","tag":"h3","version":1,"children":[{"type":"text","text":"What a complete BSP includes","version":1}]},{"type":"paragraph","version":1,"children":[{"type":"text","text":"At the bottom is the boot chain: a first-stage loader that initialises DRAM, often the U-Boot SPL, and the main bootloader that loads the kernel. Above that sit the kernel source with any board patches, a kernel configuration, a device tree for the board and any out-of-tree drivers or firmware files the peripherals need.","version":1}]},{"type":"paragraph","version":1,"children":[{"type":"text","text":"A usable BSP also includes the means to build and deploy it: build recipes or scripts, a flashing method for the factory and a record of what was tested. On a microcontroller the term covers the equivalent pieces: start-up code, clock and pin configuration, linker script and drivers.","version":1}]}],"direction":"ltr","format":"","indent":0,"version":1}},"tags":"Embedded Linux, BSP, Bootloader","cardCta":{"label":null,"link":null},"pageCta":{"label":"Talk to AAVICO engineering","link":"/contact"},"excerpt":"A board support package is everything that makes an operating system run on one specific board. Knowing its parts makes it easier to scope, review and maintain.","featuredImage":null,"type":"Blog","readTime":"3 min read","publishedAt":"2026-11-15T19:58:00.000Z","heroImage":null,"introText":"A processor vendor supplies software that runs on its evaluation board. A product board has different memory, power and peripherals, and the board support package fills the gap. For embedded Linux it covers the bootloader, the kernel and its configuration, the hardware description and the tools to build and flash the result. This article sets out what a complete BSP contains.","metrics":[{"id":"what-goes-into-a-board-support-package-metric-1","value":"U-Boot","label":"The most widely used open-source bootloader for embedded Linux boards.","icon":null},{"id":"what-goes-into-a-board-support-package-metric-2","value":"Device tree","label":"The data structure that tells the Linux kernel what hardware the board has.","icon":null},{"id":"what-goes-into-a-board-support-package-metric-3","value":"Defconfig","label":"A saved kernel or bootloader configuration that rebuilds the same setup every time.","icon":null},{"id":"what-goes-into-a-board-support-package-metric-4","value":"BSP layer","label":"In Yocto, a BSP is packaged as a layer holding the machine configuration and board recipes.","icon":null}],"gallery":[],"challenge":{"root":{"type":"root","children":[{"type":"paragraph","version":1,"children":[{"type":"text","text":"A BSP is often treated as the vendor’s reference software with a few edits. Those edits accumulate as untracked patches on a fixed kernel version, and when a security fix or a new feature needs a newer kernel, nobody can say exactly what was changed or why.","version":1}]},{"type":"paragraph","version":1,"children":[{"type":"text","text":"Gaps show up late. Memory timing that works on most boards but not all, a regulator enabled too late, or a missing display driver can each stall a project just when application work should start.","version":1}]}],"direction":"ltr","format":"","indent":0,"version":1}},"blockquote":{"quote":"Treat the BSP as a product in its own right, with its own source control, tests and maintenance plan.","author":"","role":"AAVICO Engineering"},"supportImage1":null,"deliverables":{"root":{"type":"root","children":[{"type":"paragraph","version":1,"children":[{"type":"text","text":"Start from the vendor BSP for the processor, and list every difference between the evaluation board and yours: memory, boot media, power and peripherals.","version":1}]},{"type":"paragraph","version":1,"children":[{"type":"text","text":"Adapt the bootloader and memory configuration first, then the device tree and kernel configuration, bringing up one interface at a time.","version":1}]},{"type":"paragraph","version":1,"children":[{"type":"text","text":"Keep every change as a tracked patch or layer in version control, and record which kernel and bootloader versions the BSP is based on.","version":1}]}],"direction":"ltr","format":"","indent":0,"version":1}},"results":[{"id":"what-goes-into-a-board-support-package-result-1","title":"Bootable Hardware","description":"The board runs a maintained kernel with every interface working."},{"id":"what-goes-into-a-board-support-package-result-2","title":"Maintainability","description":"Tracked changes can be carried onto newer kernels for security fixes."},{"id":"what-goes-into-a-board-support-package-result-3","title":"Reproducible Builds","description":"Anyone on the team can rebuild the exact image that shipped."},{"id":"what-goes-into-a-board-support-package-result-4","title":"Clean Handover","description":"Application developers start on a stable, documented platform."}],"lookingAhead":{"root":{"type":"root","children":[{"type":"paragraph","version":1,"children":[{"type":"text","text":"Prefer drivers that are already in the mainline kernel. Out-of-tree drivers have to be carried forward by hand at every kernel update.","version":1}]},{"type":"paragraph","version":1,"children":[{"type":"text","text":"Check the vendor’s kernel support plan before choosing the processor. A BSP tied to an old kernel limits the supported life of the product.","version":1}]}],"direction":"ltr","format":"","indent":0,"version":1}},"supportImage2":null,"testimonial":{"quote":null,"author":null,"role":null,"photo":null},"challengesSolved":[{"id":"what-goes-into-a-board-support-package-challenge-1","title":"Untracked patches on an old vendor kernel","description":null,"icon":null},{"id":"what-goes-into-a-board-support-package-challenge-2","title":"Boards that fail with marginal memory settings","description":null,"icon":null},{"id":"what-goes-into-a-board-support-package-challenge-3","title":"No record of how the shipped image was built","description":null,"icon":null},{"id":"what-goes-into-a-board-support-package-challenge-4","title":"Drivers that block every kernel upgrade","description":null,"icon":null}],"relatedPosts":[],"contactUs":{"show":true},"updatedAt":"2026-11-15T17:32:32.682Z","createdAt":"2026-11-15T17:32:32.682Z"}],"hasNextPage":false,"hasPrevPage":false,"limit":10,"nextPage":null,"page":1,"pagingCounter":1,"prevPage":null,"totalDocs":1,"totalPages":1}