{"docs":[{"id":152,"title":"Bringing Up Android on Custom Hardware: Kernel, Vendor Image and Treble","heading":"Bringing Up Android on Custom Hardware: Kernel, Vendor Image and Treble","subheading":null,"category":"Device Drivers","body":{"root":{"type":"root","children":[{"type":"heading","tag":"h3","version":1,"children":[{"type":"text","text":"The order that works","version":1}]},{"type":"paragraph","version":1,"children":[{"type":"text","text":"Start with a serial console and get the bootloader loading the kernel with your device tree and its overlays. Then load the vendor modules for storage, power, display and input, and confirm each one probes cleanly before moving up. Only when the kernel is stable is it worth chasing init, HAL and framework problems.","version":1}]},{"type":"paragraph","version":1,"children":[{"type":"text","text":"Keep board configuration in its own device directory, ship drivers as modules that use only symbols in the KMI, and boot a generic system image on the board early. If the GSI boots and passes basic tests, the Treble boundary is sound.","version":1}]}],"direction":"ltr","format":"","indent":0,"version":1}},"tags":"Device Drivers, Android, GKI, Board Bring-Up","cardCta":{"label":null,"link":null},"pageCta":{"label":"Talk to AAVICO engineering","link":"/contact"},"excerpt":"Getting Android running on a new board means getting the kernel, the vendor image and the Treble boundary right. Here is the order the work happens in and where it goes wrong.","featuredImage":null,"type":"Blog","readTime":"3 min read","publishedAt":"2026-11-15T19:23:00.000Z","heroImage":null,"introText":"An Android device is not one software image but several: a bootloader, a kernel with vendor modules, a vendor image with HALs and firmware, and a system image built from the Android Open Source Project. On current releases the core kernel is the Generic Kernel Image from Google, and board-specific code lives in modules and vendor partitions.","metrics":[{"id":"bringing-up-android-on-custom-hardware-kernel-ve-metric-1","value":"GKI","label":"Generic Kernel Image: a kernel built by Google from the Android Common Kernel and shared across devices.","icon":null},{"id":"bringing-up-android-on-custom-hardware-kernel-ve-metric-2","value":"KMI","label":"Kernel Module Interface: the symbols vendor modules may use, stable within a GKI generation.","icon":null},{"id":"bringing-up-android-on-custom-hardware-kernel-ve-metric-3","value":"GSI","label":"Generic System Image: an AOSP system image used to prove the vendor side meets Treble.","icon":null},{"id":"bringing-up-android-on-custom-hardware-kernel-ve-metric-4","value":"VTS","label":"Vendor Test Suite: checks that the vendor implementation honours its HAL and kernel interfaces.","icon":null}],"gallery":[],"challenge":{"root":{"type":"root","children":[{"type":"paragraph","version":1,"children":[{"type":"text","text":"Most projects start from the SoC vendor board support package, which carries the bootloader, kernel modules, HALs and device configuration for a reference board. Patching it until the new board boots is tempting, but core kernel changes will not survive GKI, and edits scattered through the tree make every Android update a merge exercise.","version":1}]},{"type":"paragraph","version":1,"children":[{"type":"text","text":"Bring-up also fails quietly. A missing firmware file, a wrong device tree property or an SELinux denial can leave the board in a boot loop with little on screen to explain why.","version":1}]}],"direction":"ltr","format":"","indent":0,"version":1}},"blockquote":{"quote":"Treat the generic parts as fixed and put every board difference on the vendor side; that is what keeps the next Android update affordable.","author":"","role":"AAVICO Engineering"},"supportImage1":null,"deliverables":{"root":{"type":"root","children":[{"type":"paragraph","version":1,"children":[{"type":"text","text":"Agree the target Android release and kernel version with the SoC vendor, since together they fix the GKI and KMI rules that apply.","version":1}]},{"type":"paragraph","version":1,"children":[{"type":"text","text":"Bring up kernel and modules on a serial console, then HALs, then the framework.","version":1}]},{"type":"paragraph","version":1,"children":[{"type":"text","text":"Run VTS and boot a generic system image early, and keep running them as drivers are added, not only before release.","version":1}]}],"direction":"ltr","format":"","indent":0,"version":1}},"results":[{"id":"bringing-up-android-on-custom-hardware-kernel-ve-result-1","title":"Clean Layering","description":"Board-specific code lives in modules and vendor partitions, not in patches to generic code."},{"id":"bringing-up-android-on-custom-hardware-kernel-ve-result-2","title":"Faster Updates","description":"A sound Treble boundary lets a newer system image run without rebuilding the vendor side."},{"id":"bringing-up-android-on-custom-hardware-kernel-ve-result-3","title":"Predictable Bring-Up","description":"Problems are found layer by layer, with a console showing where boot stops."},{"id":"bringing-up-android-on-custom-hardware-kernel-ve-result-4","title":"Test Coverage","description":"Vendor tests catch interface breaks before they reach a release build."}],"lookingAhead":{"root":{"type":"root","children":[{"type":"paragraph","version":1,"children":[{"type":"text","text":"If the product needs Google Mobile Services, licensing and compatibility testing go through agreements with Google. Plan for that separately from AOSP bring-up.","version":1}]},{"type":"paragraph","version":1,"children":[{"type":"text","text":"Settle verified boot, keys and the update mechanism during bring-up; retrofitting them changes partition layouts.","version":1}]}],"direction":"ltr","format":"","indent":0,"version":1}},"supportImage2":null,"testimonial":{"quote":null,"author":null,"role":null,"photo":null},"challengesSolved":[{"id":"bringing-up-android-on-custom-hardware-kernel-ve-challenge-1","title":"Core kernel patches that block a move to GKI","description":null,"icon":null},{"id":"bringing-up-android-on-custom-hardware-kernel-ve-challenge-2","title":"Boot loops with no console to diagnose them","description":null,"icon":null},{"id":"bringing-up-android-on-custom-hardware-kernel-ve-challenge-3","title":"Vendor changes scattered across the AOSP tree","description":null,"icon":null},{"id":"bringing-up-android-on-custom-hardware-kernel-ve-challenge-4","title":"Treble breaks discovered at final testing","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}