Yocto Project Board Support Package Developer's Guide

Saul Wold

Intel Corporation

Richard Purdie

Linux Foundation

Permission is granted to copy, distribute and/or modify this document under the terms of the Creative Commons Attribution-Share Alike 2.0 UK: England & Wales as published by Creative Commons.

Manual Notes

  • For the latest version of the Yocto Project Board Support Package (BSP) Developer's Guide associated with this Yocto Project release (version 2.3), see the Yocto Project Board Support Package (BSP) Developer's Guide from the Yocto Project documentation page.

  • This version of the manual is version 2.3. For later releases of the Yocto Project (if they exist), go to the Yocto Project documentation page and use the drop-down "Active Releases" button and choose the Yocto Project version for which you want the manual.

  • For an in-development version of the Yocto Project Board Support Package (BSP) Developer's Guide, see http://www.yoctoproject.org/docs/latest/bsp-guide/bsp-guide.html.

Revision History
Revision 0.9 24 November 2010
The initial document draft released with the Yocto Project 0.9 Release.
Revision 1.0 6 April 2011
Released with the Yocto Project 1.0 Release.
Revision 1.0.1 23 May 2011
Released with the Yocto Project 1.0.1 Release.
Revision 1.1 6 October 2011
Released with the Yocto Project 1.1 Release.
Revision 1.2 April 2012
Released with the Yocto Project 1.2 Release.
Revision 1.3 October 2012
Released with the Yocto Project 1.3 Release.
Revision 1.4 April 2013
Released with the Yocto Project 1.4 Release.
Revision 1.5 October 2013
Released with the Yocto Project 1.5 Release.
Revision 1.5.1 January 2014
Released with the Yocto Project 1.5.1 Release.
Revision 1.6 April 2014
Released with the Yocto Project 1.6 Release.
Revision 1.7 October 2014
Released with the Yocto Project 1.7 Release.
Revision 1.8 April 2015
Released with the Yocto Project 1.8 Release.
Revision 2.0 October 2015
Released with the Yocto Project 2.0 Release.
Revision 2.1 April 2016
Released with the Yocto Project 2.1 Release.
Revision 2.2 October 2016
Released with the Yocto Project 2.2 Release.
Revision 2.3 May 2017
Released with the Yocto Project 2.3 Release.

Table of Contents

1. Board Support Packages (BSP) - Developer's Guide
1.1. BSP Layers
1.2. Example Filesystem Layout
1.2.1. License Files
1.2.2. README File
1.2.3. README.sources File
1.2.4. Pre-built User Binaries
1.2.5. Layer Configuration File
1.2.6. Hardware Configuration Options
1.2.7. Miscellaneous BSP-Specific Recipe Files
1.2.8. Display Support Files
1.2.9. Linux Kernel Configuration
1.3. Requirements and Recommendations for Released BSPs
1.3.1. Released BSP Requirements
1.3.2. Released BSP Recommendations
1.4. Customizing a Recipe for a BSP
1.5. BSP Licensing Considerations
1.6. Using the Yocto Project's BSP Tools
1.6.1. Common Features
1.6.2. Creating a new BSP Layer Using the yocto-bsp Script
1.6.3. Managing Kernel Patches and Config Items with yocto-kernel