Imperas Installation and Getting Started Guide
Total Page:16
File Type:pdf, Size:1020Kb
Imperas Installation and Getting Started Guide This document explains how to install and get started with the OVPsim simulator / models and the Imperas professional products under Linux and Windows. Imperas Software Limited Imperas Buildings, North Weston, Thame, Oxfordshire, OX9 2HA, UK [email protected] Author: Imperas Version: 2.3.10 Filename: Imperas_Installation_and_Getting_Started.doc Project: Imperas / Open Virtual Platforms Installation and Getting Started Last Saved: Tuesday, 26 January 2021 Keywords: Installation, Getting Started, Linux, Windows, Licensing © 2021 Imperas Software Limited www.imperas.com/www.OVPWorld.org Imperas Installation and Getting Started Guide Copyright Notice Copyright © 2021 Imperas Software Limited All rights reserved. This software and documentation contain information that is the property of Imperas Software Limited. The software and documentation are furnished under a license agreement and may be used or copied only in accordance with the terms of the license agreement. No part of the software and documentation may be reproduced, transmitted, or translated, in any form or by any means, electronic, mechanical, manual, optical, or otherwise, without prior written permission of Imperas Software Limited, or as expressly provided by the license agreement. Right to Copy Documentation The license agreement with Imperas permits licensee to make copies of the documentation for its internal use only. Each copy shall include all copyrights, trademarks, service marks, and proprietary rights notices, if any. Destination Control Statement All technical data contained in this publication is subject to the export control laws of the United States of America. Disclosure to nationals of other countries contrary to United States law is prohibited. It is the reader’s responsibility to determine the applicable regulations and to comply with them. Disclaimer IMPERAS SOFTWARE LIMITED AND ITS LICENSORS MAKE NO WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, WITH REGARD TO THIS MATERIAL, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE. © 2021 Imperas Software Limited www.imperas.com/www.OVPworld.org Page 2 of 111 . Imperas Installation and Getting Started Guide Table of Contents 1 Preface......................................................................................................................... 7 2 Introduction................................................................................................................. 7 3 Hardware and Software Requirements ....................................................................... 8 3.1 Operating System................................................................................................ 8 3.2 Hardware............................................................................................................. 8 3.3 Host Compiler Versions...................................................................................... 8 4 Installation................................................................................................................... 9 4.1 Installation Tutorial Video.................................................................................. 9 4.2 Packages.............................................................................................................. 9 4.2.1 OVPsim........................................................................................................... 9 4.2.2 Imperas Developer........................................................................................ 10 4.2.3 Imperas Advanced Multicore Software Development Kit............................ 10 4.3 Access and Download of Installation Packages................................................ 11 4.3.1 Login............................................................................................................. 11 4.3.2 Download the Appropriate Package ............................................................. 11 4.3.3 Package Selection ......................................................................................... 11 4.4 Installing Under Linux...................................................................................... 13 4.5 Installing Under Windows ................................................................................ 15 4.6 Setting up the Environment .............................................................................. 17 4.6.1 Required Environment.................................................................................. 17 4.6.2 Additional Environment................................................................................ 18 4.6.3 Script to Setup Required Environment ......................................................... 18 4.6.4 Script to Select Simulator Runtime............................................................... 19 4.6.5 Script to Select Personality ........................................................................... 19 4.6.6 Explicit Environment Configuration............................................................. 20 4.6.7 Internet Access Via a Proxy Server .............................................................. 23 5 Setting up Licensing ................................................................................................. 25 5.1 OVPsim Node Locked License keys ................................................................ 25 5.1.1 Obtaining the computer hostname and Host ID............................................ 25 5.1.2 Setup License File......................................................................................... 26 5.2 Imperas Floating Licenses ................................................................................ 27 5.2.1 Obtaining the computer hostname and Host ID............................................ 27 5.2.2 Starting the License Server ........................................................................... 27 5.2.3 License Queuing ........................................................................................... 28 6 Windows Development Environment....................................................................... 29 6.1 Introduction....................................................................................................... 29 6.2 MSYS2 / MinGW Environment ....................................................................... 29 6.2.1 Obtaining MSYS2......................................................................................... 29 6.2.2 Install Utilities............................................................................................... 34 6.2.3 Install Host Toolchains ................................................................................. 35 6.2.4 Environment.................................................................................................. 36 6.2.5 Completion and test of MSYS/MinGW installation..................................... 40 7 Additional Toolchain Packages ................................................................................ 43 © 2021 Imperas Software Limited www.imperas.com/www.OVPworld.org Page 3 of 111 . Imperas Installation and Getting Started Guide 7.1 Application Cross Compiler Toolchains........................................................... 43 7.2 Peripheral Simulation Engine (PSE) Toolchain ............................................... 45 8 Getting Started .......................................................................................................... 46 8.1 ISS Tutorial Video ............................................................................................ 46 8.2 Check Installation ............................................................................................. 46 8.2.1 Simulator Execution...................................................................................... 46 8.2.2 iGen Installation............................................................................................ 48 8.2.3 Harness Installation....................................................................................... 49 8.2.4 MPD Installation........................................................................................... 50 8.2.5 eGui Installation............................................................................................ 52 8.3 Build Environment............................................................................................ 53 8.3.1 Introduction................................................................................................... 53 8.3.2 Standard Makefiles ....................................................................................... 55 8.3.3 Build Output Selection.................................................................................. 55 8.3.4 VLNV Component Library........................................................................... 56 8.4 Hello World Example ....................................................................................... 61 8.4.1 Compiling an application.............................................................................. 61 8.4.2 Running the simulation using the ISS........................................................... 62 8.4.3 Execute example using provided script ........................................................ 63 8.4.4 Creating a Virtual Platform Tutorial Video.................................................. 63 8.4.5 Creating and Simulating with a