EBEApplicationNote.md

EBE Application Note

Purpose

The purpose of this document is to explain the workflow and to provide practical examples of how to use the Enclustra Build Environment (EBE) and customize the corresponding software according to the design requirements.

Summary

This application note describes the three main parts of the Enclustra Build Environment: U-Boot, Linux kernel and root file system. It provides details on the build flow for each part, including examples on how to customize certain components according to the system requirements. In addition, references to other useful documents are included.

License

Copyright 2021 by Enclustra GmbH, Switzerland. All rights are reserved. Unauthorized duplication of this document, in whole or in part, by any means is prohibited without the prior written permission of Enclustra GmbH, Switzerland. Although Enclustra GmbH believes that the information included in this publication is correct as of the date of publication, Enclustra GmbH reserves the right to make changes at any time without notice. All information in this document is strictly confidential and may only be published by Enclustra GmbH, Switzerland. All referenced trademarks are the property of their respective owners.

Introduction

The following chapters explain how to create a custom design and how to run an EBE generated Linux on a newly created design.

The recommended way to create a custom design is to use the Enclustra Reference Designs as a starting point. The Enclustra build environment uses the pre-generated files from the reference design as default binaries.

The downloaded reference design can be modified according to the users specification. But as a first step it might be helpful to build the bitstream and all required boot files using the unmodified reference design. This ensures that the build process works as expected. Once Linux is booting using the output of the own manually generated reference design, it is up to the user to modify the design.

Table of contents

• 1 - Workflow
  • 1.1 Modules equipped with Xilinx SoC
  • 1.2 Modules equipped with Intel SoC
  • 1.3 Additional information
• 2 - U-Boot
  • 2.1 Bootloader
  • 2.2 Folder structure
  • 2.3 Configuration
  • 2.4 Device tree
  • 2.5 Command line interface
  • 2.6 Environment
  • 2.7 Boot scripts
  • 2.8 Additional information
• 3 - Linux kernel
  • 3.1 Folder structure
  • 3.2 Configuration
  • 3.3 Add an existing driver example
  • 3.4 Create and add a custom driver
  • 3.5 Device tree
  • 3.6 Additional information
• 4 - Buildroot
  • 4.1 Root file system
  • 4.2 Folder structure
  • 4.3 Configuration
  • 4.4 Toolchain
  • 4.5 File system modification
  • 4.6 Init system
  • 4.7 Create a custom application
  • 4.8 Debug a custom application
  • 4.9 Copy files to root file system
  • 4.10 Useful commands
  • 4.11 Additional information

References

• Enclustra Reference Designs

Please continue reading Chapter 1 - Workflow.