Chapter 1. Board Support Packages (BSP) - Developer's Guide

Table of Contents

1.1. BSP Layers
1.2. Preparing Your Build Host to Work With BSP Layers
1.3. Example Filesystem Layout
1.3.1. License Files
1.3.2. README File
1.3.3. README.sources File
1.3.4. Pre-built User Binaries
1.3.5. Layer Configuration File
1.3.6. Hardware Configuration Options
1.3.7. Miscellaneous BSP-Specific Recipe Files
1.3.8. Display Support Files
1.3.9. Linux Kernel Configuration
1.4. Developing a Board Support Package (BSP)
1.5. Requirements and Recommendations for Released BSPs
1.5.1. Released BSP Requirements
1.5.2. Released BSP Recommendations
1.6. Customizing a Recipe for a BSP
1.7. BSP Licensing Considerations
1.8. Creating a new BSP Layer Using the bitbake-layers Script
1.8.1. BSP Layer Configuration Example
1.8.2. BSP Machine Configuration Example
1.8.3. BSP Kernel Recipe Example

A Board Support Package (BSP) is a collection of information that defines how to support a particular hardware device, set of devices, or hardware platform. The BSP includes information about the hardware features present on the device and kernel configuration information along with any additional hardware drivers required. The BSP also lists any additional software components required in addition to a generic Linux software stack for both essential and optional platform features.

This guide presents information about BSP Layers, defines a structure for components so that BSPs follow a commonly understood layout, discusses how to customize a recipe for a BSP, addresses BSP licensing, and provides information that shows you how to create a BSP Layer using the bitbake-layers tool.