Yocto Project Board Support Package Developer's Guide

Scott Rifenbark

Scotty's Documentation Services, INC

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

  • This version of the Yocto Project Board Support Package (BSP) Developer's Guide is for the 2.7 release of the Yocto Project. To be sure you have the latest version of the manual for this release, go to the Yocto Project documentation page and select the manual from that site. Manuals from the site are more up-to-date than manuals derived from the Yocto Project released TAR files.

  • If you located this manual through a web search, the version of the manual might not be the one you want (e.g. the search might have returned a manual much older than the Yocto Project version with which you are working). You can see all Yocto Project major releases by visiting the Releases page. If you need a version of this manual for a different Yocto Project release, visit the Yocto Project documentation page and select the manual set by using the "ACTIVE RELEASES DOCUMENTATION" or "DOCUMENTS ARCHIVE" pull-down menus.

  • To report any inaccuracies or problems with this manual, send an email to the Yocto Project discussion group at yocto@yoctoproject.com or log into the freenode #yocto channel.

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.
Revision 2.4 October 2017
Released with the Yocto Project 2.4 Release.
Revision 2.5 May 2018
Released with the Yocto Project 2.5 Release.
Revision 2.6 November 2018
Released with the Yocto Project 2.6 Release.
Revision 2.7 TBD
Released with the Yocto Project 2.7 Release.

Table of Contents

1. Board Support Packages (BSP) - Developer's Guide
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