Wind River Linux
Total Page:16
File Type:pdf, Size:1020Kb
Wind River Linux USER'S GUIDE 5.0.1 Copyright Notice Copyright © 2014 Wind River Systems, Inc. All rights reserved. No part of this publication may be reproduced or transmitted in any form or by any means without the prior written permission of Wind River Systems, Inc. Wind River, Tornado, and VxWorks are registered trademarks of Wind River Systems, Inc. The Wind River logo is a trademark of Wind River Systems, Inc. Any third-party trademarks referenced are the property of their respective owners. For further information regarding Wind River trademarks, please see: www.windriver.com/company/terms/trademark.html This product may include software licensed to Wind River by third parties. Relevant notices (if any) are provided in your product installation at one of the following locations: installDir/product_name/3rd_party_licensor_notice.pdf installDir/legal-notices/ Wind River may refer to third-party documentation by listing publications or providing links to third-party Web sites for informational purposes. Wind River accepts no responsibility for the information provided in such third-party documentation. Corporate Headquarters Wind River 500 Wind River Way Alameda, CA 94501-1153 U.S.A. Toll free (U.S.A.): 800-545-WIND Telephone: 510-748-4100 Facsimile: 510-749-2010 For additional contact information, see the Wind River Web site: www.windriver.com For information on how to contact Customer Support, see: www.windriver.com/support 15 Jan 2014 Contents PART I: INTRODUCTION 1 Overview .................................................................................................................. 15 Wind River Linux Overview ............................................................................................... 15 Kernel and File System Components ................................................................. 16 Supported Run-time Boards ............................................................................... 18 Optional Add-on Products .................................................................................. 20 Product Updates ................................................................................................. 22 2 Run-time Software Configuration and Deployment Workflow ........................... 27 3 Development Environment .................................................................................... 29 Directory Structure ............................................................................................................. 29 Metadata ............................................................................................................................ 32 Configuration Files and Platform Projects ......................................................................... 33 Assigning Empty Values in BitBake Configuration Files ..................................... 38 README Files in the Development Environment ............................................................. 39 Viewing a Specific README File in the Installation ........................................... 39 Cloning a Layer to View Installation README Files .......................................... 40 Viewing All Installation README Files in a Web Browser ................................. 40 4 Build Environment .................................................................................................. 41 About the Project Directory ............................................................................................... 41 Creating a Project Directory .............................................................................................. 42 Directory Structure for Platform Projects ........................................................................... 43 Feature Templates in the Project Directory ........................................................ 47 Kernel Configuration Fragments in the Project Directory ................................... 51 Viewing Template Descriptions .......................................................................... 54 About the layers/local Directory ......................................................................... 54 About README Files in the Build Environment ................................................................ 56 Adding a Layer to a Platform Project to View README Files ............................ 56 Adding All Layers to a Platform Project to View All README Files ................... 57 PART II: PLATFORM PROJECT IMAGE DEVELOPMENT iii Wind River Linux User's Guide, 5.0.1 5 Configuration and Build ........................................................................................ 61 Introduction ........................................................................................................................ 61 About Creating the Platform Project Build Directory .......................................... 62 About Configuring a Platform Project Image ...................................................... 62 Initializing the Wind River Linux Environment .................................................... 63 About the Configure Script ................................................................................. 63 About Building Platform Project Images ............................................................................ 72 About the make Command ................................................................................ 72 Yocto Project Equivalent make Commands ........................................................ 73 About Build Logs ................................................................................................ 75 Build-Time Optimizations ................................................................................................... 76 Examples of Configuring and Building .............................................................................. 77 Configuring and Building a Complete Run-time ................................................. 77 Commands for Building a Kernel Only ............................................................... 78 Configuring and Building a Flash-capable Run-time .......................................... 78 Configuring and Building a Debug-capable Run-time ........................................ 79 Building a Target Package ................................................................................. 80 About Creating Custom Configurations Using rootfs.cfg ................................................... 80 About the rootfs.cfg File ..................................................................................... 82 About New Custom rootfs Configuration ............................................................ 84 EGLIBC File Systems ........................................................................................................ 85 Creating and Customizing EGLIBC Platform Project Images ............................. 86 EGLIBC Option Mapping Reference .................................................................. 88 6 Localization ............................................................................................................. 91 About Localization ............................................................................................................. 91 Determining which Locales are Available ........................................................... 91 Setting Localization ............................................................................................ 93 7 Portability ................................................................................................................ 95 About Platform Project Portability ...................................................................................... 95 Copying or Moving a Platform Project .............................................................................. 96 Updating a Platform Project to a New Wind River Linux Installation Location ................... 96 8 Layers ...................................................................................................................... 99 About Layers ...................................................................................................................... 99 Layers Included in a Standard Installation ........................................................................ 100 Installed Layers vs. Custom Layers .................................................................................. 102 Layer Structure by Layer Type .......................................................................................... 103 About Layer Processing and Configuration ....................................................................... 105 About Processing a Project Configuration ......................................................... 105 Creating a New Layer ........................................................................................ 106 iv Contents Enabling a Layer ................................................................................................ 107 Disabling a Layer ................................................................................................ 108 9 Recipes .................................................................................................................... 109 About Recipes ................................................................................................................... 109 A Sample Application Recipe File .....................................................................