Enea® Linux User's Guide 4.0-docupdate1 Enea® Linux User's Guide Enea® Linux User's Guide Copyright Copyright © Enea Software AB 2014. 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, 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 trade- marks of their respective owner. Acknowledgements and Open Source License Conditions Information is found in the Release Information manual. © Enea Software AB 2014 4.0-docupdate1 ii Enea® Linux User's Guide Table of Contents 1 - Introduction ................................................................................................................ 6 1.1 - About this Manual .............................................................................................. 6 1.2 - Enea Linux and Open Source ................................................................................ 6 2 - System Requirements ................................................................................................... 8 3 - Getting Started ............................................................................................................ 9 3.1 - Download and Install Enea Linux .......................................................................... 9 3.2 - Install Packages ................................................................................................ 10 3.2.1 - Ubuntu or Debian ................................................................................... 10 3.2.2 - Fedora .................................................................................................. 10 3.2.3 - OpenSuse .............................................................................................. 10 3.2.4 - Red Hat ................................................................................................ 10 3.3 - Initialize Build Environment ................................................................................ 12 3.3.1 - Recommended: source enea-init-build-env ................................................... 12 3.3.2 - Alternative: source oe-init-build-env ........................................................... 13 3.4 - Build Enea Linux Images ................................................................................... 14 3.4.1 - Build Performance Considerations .............................................................. 14 3.5 - Run Enea Linux in QEMU ................................................................................. 15 3.6 - Use Precompiled Images ..................................................................................... 15 4 - Target Guide ............................................................................................................. 16 4.1 - Finding Out the Linux Kernel Version .................................................................. 16 4.2 - Enea Linux on QEMU ....................................................................................... 17 4.2.1 - Setup and Build Enea Linux for QEMU ...................................................... 17 4.2.2 - Run QEMU ........................................................................................... 18 4.3 - Enea Linux on EVMK2H Keystone ...................................................................... 19 4.3.1 - Setup and Build Enea Linux ..................................................................... 19 4.3.2 - tftp kernel to RAM and mount rootfs over NFS ............................................ 20 4.4 - Enea Linux on B4860QDS .................................................................................. 21 4.4.1 - Setup and Build Enea Linux ..................................................................... 21 4.4.2 - tftp kernel and rootfs to RAM ................................................................... 22 4.4.3 - tftp kernel to RAM but mount rootfs over NFS ............................................. 22 4.5 - Enea Linux on P2020RDB .................................................................................. 23 4.5.1 - Setup and Build Enea Linux ..................................................................... 23 4.5.2 - tftp kernel and rootfs to RAM ................................................................... 24 4.5.3 - tftp kernel to RAM but mount rootfs over NFS ............................................. 24 4.5.4 - Preparing for Building P2020RDB with PREEMPT_RT ................................. 24 4.5.5 - Optional: Flashing U-Boot ........................................................................ 25 4.6 - Enea Linux on P2041RDB .................................................................................. 26 4.6.1 - Setup and Build Enea Linux ..................................................................... 26 4.6.2 - tftp kernel and rootfs to RAM ................................................................... 27 4.6.3 - tftp kernel to RAM but mount rootfs over NFS ............................................. 27 4.6.4 - Preparing for Building P2041RDB with PREEMPT_RT ................................. 28 4.6.5 - Optional: Flashing U-Boot, Programming RCW, Programming FMAN .............. 28 4.7 - Enea Linux on P4080DS .................................................................................... 29 4.7.1 - Setup and Build Enea Linux ..................................................................... 29 4.7.2 - tftp kernel and rootfs to RAM ................................................................... 30 4.7.3 - tftp kernel to RAM but mount rootfs over NFS ............................................. 30 4.7.4 - Optional: Flashing U-Boot, Programming RCW, Programming FMAN .............. 31 4.8 - Enea Linux on PandaBoard ................................................................................. 32 4.8.1 - Setup and Build Enea Linux ..................................................................... 32 4.8.2 - tftp kernel and rootfs to RAM ................................................................... 33 4.8.3 - tftp kernel to RAM but mount rootfs over NFS ............................................. 33 4.9 - Enea Linux on Romley Ivy Bridge x86_64 ............................................................. 34 © Enea Software AB 2014 4.0-docupdate1 iii Enea® Linux User's Guide 4.9.1 - Setup and Build Enea Linux ..................................................................... 34 4.9.2 - Boot from USB flash memory hard disk ...................................................... 35 4.9.3 - Boot via PXE using DHCP, TFTP, and NFS servers ...................................... 35 4.9.4 - Root file system customization hints ........................................................... 36 4.10 - Enea Linux on Xilinx Zynq ZC702 ..................................................................... 37 4.10.1 - Setup and Build Enea Linux .................................................................... 37 4.10.2 - tftp kernel and rootfs to RAM ................................................................. 38 4.10.3 - tftp kernel to RAM and mount rootfs over NFS ........................................... 38 5 - Using Enea Linux ....................................................................................................... 40 5.1 - Applying Patches .............................................................................................. 40 5.2 - Layers and Adaptations ...................................................................................... 40 5.3 - Appending Recipes for a Custom Layer ................................................................. 41 5.4 - Adding a Hello World Recipe .............................................................................. 41 5.5 - Rootfs Images and Toolchains ............................................................................. 41 5.6 - Configuring Packages ......................................................................................... 43 5.6.1 - The Linux Kernel ................................................................................... 43 5.6.2 - Busybox ................................................................................................ 43 5.7 - Installing a Cross-Compilation Toolchain ..............................................................