Enea® Linux User's Guide Release Version 8.1 Profile rt-8.1 Enea® Linux User's Guide Enea® Linux User's Guide: Release Version 8.1 Copyright Copyright © Enea Software AB 2019. This User Documentation consists of confidential information and is protected by Trade Secret Law. This notice of copyright does not indicate any actual or intended publication of this information. Except to the extent expressly stipulated in any software license agreement covering this User Documentation and/or corresponding software, no part of this User Documentation may be reproduced, transmitted, stored in a retrieval system, or translated, in any form or by any means, without the prior written permission of Enea Software AB. However, permission to print copies for personal use is hereby granted. Disclaimer The information in this User Documentation is subject to change without notice, and unless stipulated in any software license agreement covering this User Documentation and/or corresponding software, should not be construed as a commitment of Enea Software AB. Trademarks Enea®, Enea OSE®, and Polyhedra® are the registered trademarks of Enea AB and its subsidiaries. Enea OSE®ck, Enea OSE® Epsilon, Enea® Element, Enea® Optima, Enea® Linux, Enea® LINX, Enea® LWRT, Enea® Accelerator, Polyhedra® Flash DBMS, Polyhedra® Lite, Enea® dSPEED, Enea® NFV Access, Accelerating Network Convergence™, Device Software Optimized™, and Embedded for Leaders™ are unregistered trademarks of Enea AB or its subsidiaries. Any other company, product or service names mentioned in this document are the registered or unregistered trademarks of their respective owner. Acknowledgements and Open Source License Conditions Detailed information is found in the Open Source Report(s) provided with this Release. © Enea Software AB 2019 Profile rt-8.1 ii Enea® Linux User's Guide Table of Contents 1 - Preface ....................................................................................................................... 4 1.1 - The Purpose of this Guide .................................................................................... 4 2 - Introduction ................................................................................................................ 6 3 - Prerequisites and Requirements .................................................................................... 7 3.1 - Git Configuration ................................................................................................ 7 3.2 - Host Packages .................................................................................................... 7 3.2.1 - Using Pre-Build Binaries ........................................................................... 7 3.2.2 - Required Packages for the Host Development System ...................................... 7 3.3 - Default Shell Configuration .................................................................................. 7 4 - Getting Enea Linux ...................................................................................................... 9 4.1 - Getting Pre-Built Binaries ..................................................................................... 9 4.2 - Getting the Sources ............................................................................................. 9 4.2.1 - Get access to git.enea.com ......................................................................... 9 4.2.2 - Get Sources ........................................................................................... 10 5 - Using Enea Linux ....................................................................................................... 11 5.1 - Building Enea Linux .......................................................................................... 11 5.1.1 - Building Real-Time images ....................................................................... 11 5.1.2 - Building the SDK ................................................................................... 12 5.2 - Booting Enea Linux ........................................................................................... 13 5.2.1 - Booting via PXE .................................................................................... 13 5.2.2 - Boot from RAM ..................................................................................... 14 5.2.3 - Boot from SD card .................................................................................. 14 5.3 - Customizing Enea Linux ..................................................................................... 15 5.3.1 - Layers and Adaptations ............................................................................ 15 5.3.2 - Adding a Recipe ..................................................................................... 17 5.3.3 - Configuring Packages via Recipes .............................................................. 17 5.3.4 - Building with Commercial Licenses ........................................................... 17 5.4 - Installing the Enea Linux SDK ............................................................................ 18 5.5 - Using Package Management ................................................................................ 19 5.5.1 - RPM Package Management (RPM Packages) ............................................... 19 6 - Application Development ............................................................................................ 21 6.1 - Cross-Compiling Applications ............................................................................. 21 6.2 - Cross-Compiling Kernel modules ......................................................................... 21 6.3 - Add an Application using devtool ........................................................................ 22 7 - Using Eclipse ............................................................................................................. 25 7.1 - Installing Oxygen Eclipse IDE ............................................................................. 25 7.2 - Installing Yocto Plugins ..................................................................................... 25 7.3 - Setting up a TCF Connection from Eclipse ............................................................. 25 7.4 - Developing Applications in Eclipse ...................................................................... 26 7.4.1 - Cross-Compiling from Eclipse ................................................................... 26 7.4.2 - Debugging Applications from Eclipse ......................................................... 27 7.4.3 - Debugging Multi-Process Applications from Eclipse ...................................... 30 7.4.4 - Using the Postmortem Debugger ................................................................ 31 7.5 - Debugging the Linux Kernel in Eclipse ................................................................. 32 7.6 - Workarounds .................................................................................................... 34 7.6.1 - Run/Debug Configuration Not Created ........................................................ 34 8 - Real-Time in Enea Linux ............................................................................................ 35 8.1 - Benchmark ....................................................................................................... 35 8.1.1 - Benchmark Details .................................................................................. 35 8.1.2 - Stress Testcases ...................................................................................... 35 © Enea Software AB 2019 Profile rt-8.1 iii Enea® Linux User's Guide 1. Preface 1. Preface 1.1 The Purpose of this Guide This guide is intended for all Enea Linux developers who want to configure and build customized Linux kernel images for embedded system targets, but also for developers who want to build and run applications in Enea Linux. Note Always read the README files and the Release Information before this User's Guide. The recommended order of operations for developers are: 1. Receive information from Enea and read the initial documentation online. 2. Update the development host with the needed packages, then download and install Enea Linux. 3. Download and install the Cross-Compilation Toolchain. 4. Start developing your own Enea Linux applications or building your own Enea Linux images. It is assumed that the reader of this User's Guide has a deep knowledge about Linux, how to configure the Linux kernel, and knows how to use the Yocto build system. The variety of information provided in this guide can serve as a quick start introduction to the standards and best practices we share with the Linux community. In this spirit, Enea provides training courses1. With this Enea Linux release you have a verified and easy to install board support package for a number of supported hardware types. The board support package includes a set of prebuilt utilities, accessible and setup to rapidly reach your objectives as a developer. In this regard, the support package contains a Linux kernel and root file system, a Software Development Kit (SDK) which includes the cross-compilation toolchain, a variety of tools and scripts for development and customization, and if opted for, a user-friendly Eclipse version with an integrated development environment. The documentation for Enea Linux consists of generic and distribution-specific documents. The generic documents are common for several Enea Linux distributions. The main documents