OpenEmbedded User Manual .pdf

OpenEmbedded User Manual

OpenEmbedded Team

OpenEmbedded User Manual

by OpenEmbedded Team

Copyright © 2006, 2007, 2008, 2009 Holger Hans Peter FreytherKoen KooiDetlef VollmannJamie LenehanMarcin

JuszkiewiczRolf Leggewie

This work is licensed under the Creative Commons Attribution License. To view a copy of this license, visit

http://creativecommons.org/licenses/by/2.0/ or send a letter to Creative Commons, 559 Nathan Abbott Way, Stanford, California 94305, USA.

Table of Contents

2.2.1. Downloading a BitBake release .....................................................................................2

2.3. Getting OpenEmbedded..............................................................................................................3

2.3.1. Checking Out OpenEmbedded With Git ........................................................................3

2.3.2. Updating OpenEmbedded ..............................................................................................3

2.3.3. Changing Branches.........................................................................................................3

2.4. Configuring OpenEmbedded.......................................................................................................4

2.4.1. Environment Setup .........................................................................................................4

2.4.2. Local Configuration........................................................................................................5

2.5. Building Software .......................................................................................................................5

2.5.1. Useful Target Recipes.....................................................................................................7

4.1. Debian package naming ...........................................................................................................13

4.2. Shared Library handling (shlibs) ..............................................................................................13

4.3. BitBake Collections .................................................................................................................13

4.4. Task-base ..................................................................................................................................13

4.5. Overrides ..................................................................................................................................14

5. Common Use-cases/tasks.....................................................................................................................15

5.1. Creating a new Distribution ......................................................................................................15

5.2. Adding a new Machine .............................................................................................................15

5.3. Adding a new Package ..............................................................................................................16

5.3.1. building from unstable source code..............................................................................16

5.8. Creating and Using a Qt Embedded SDK.................................................................................19

5.8.1. Creating the SDK .........................................................................................................20

5.8.2. Using the Qt Embedded SDK.......................................................................................20

iii

6. Comparing............................................................................................................................................22

6.1. buildroot....................................................................................................................................22

6.2. crosstool ....................................................................................................................................22

6.3. handmade ..................................................................................................................................22

7. Using bitbake and OpenEmbedded ...................................................................................................23

7.1. Introduction...............................................................................................................................23

7.2. Configuration ............................................................................................................................24

7.7.1. devshell via inherit........................................................................................................38

7.7.2. devshell addon..............................................................................................................39

7.7.3. Working in the devshell................................................................................................40

7.8. Patching and patch management...............................................................................................40

8. Recipes ..................................................................................................................................................41

8.1. Introduction...............................................................................................................................41

8.2. Syntax of recipes.......................................................................................................................41

8.3. Recipe naming: Names, versions and releases..........................................................................45

8.4. Variables....................................................................................................................................47

8.5. Header .......................................................................................................................................48

8.7.5. FILESPATH/FILESDIR: Finding local files ................................................................54

8.8. Basic examples..........................................................................................................................56

8.8.1. Hello world...................................................................................................................56

8.8.2. An autotools package ...................................................................................................60

8.9. Dependencies: What’s needed to build and/or run the package?..............................................61

8.10. Methods: Built-in methods to make your life easier...............................................................62

8.11. Packaging: Defining packages and their contents...................................................................65

8.11.1. Philosophy ..................................................................................................................66

8.11.2. Default packages and files..........................................................................................67

8.11.3. Wildcards....................................................................................................................69

8.14. Staging: Making includes and libraries available for building................................................76

8.15. Autoconf: All about autotools.................................................................................................78

iv

8.16. Installation scripts: Running scripts during package installation and/or removal ..................78

8.17. Configuration files...................................................................................................................81

8.18. Package relationships..............................................................................................................82

8.19. Fakeroot: Dealing with the need for "root".............................................................................83

8.20. Native: Packages for the build host.........................................................................................83

8.21. Development: Strategies for developing recipes.....................................................................83

8.22. Advanced versioning: How to deal with rc and pre versions..................................................84

8.23. Require/include: Reusing recipe contents...............................................................................84

8.24. Python: Advanced functionality with python..........................................................................86

8.25. Preferences: How to disable packages....................................................................................89

8.26. Initscripts: How to handle daemons........................................................................................90

8.27. Alternatives: How to handle the same command in multiple packages..................................90

8.29. Miscellaneous..........................................................................................................................93

9. Reference ..............................................................................................................................................95

9.1. autotools class ...........................................................................................................................95

9.1.1. oe_runconf / autotools_do_configure...........................................................................95

9.1.2. Presetting autoconf variables (the site file)...................................................................96

9.2. binconfig class...........................................................................................................................97

9.3. Directories: Installation variables .............................................................................................98

9.4. Directories: Staging variables ...................................................................................................99

9.5. distutils class ...........................................................................................................................101

9.6. fakeroot (device node handling)..............................................................................................102

9.7.3. Image types.................................................................................................................109

9.7.4. Package feeds .............................................................................................................109

9.8. Image types .............................................................................................................................110

9.8.1. Defining images..........................................................................................................110

9.8.2. Available image types.................................................................................................111

9.8.3. Custom image types ...................................................................................................116

9.9. pkgconfig class........................................................................................................................116

9.10. rootfs_ipkg class ...................................................................................................................117

9.11. SECTION variable: Package category..................................................................................119

9.12. siteinfo class..........................................................................................................................123

v