1 *************************************************************************************
2 * FILE PURPOSE: Readme File on for Eve Loader application and How to build the app
3 * and use the same.
4 ************************************************************************************
5 * FILE NAME: README.txt
6 * Copyright (C) 2018, Texas Instruments, Inc.
7 *************************************************************************************
9 Introduction
10 ************
11 This document provides the details of the EvE loader application and how to build the
12 application and execute the same on AM572x/4x
14 Software Legacy Notes
15 ---------------------
16 The purpose of this application is to provide a application demo that uses the sbl library
17 for loading the application into EVE Core of AM572x/4x. This example is limited only to
18 support EVE loader through M4 and verifying that the EVE is loaded successfully through
19 MPU core.
21 NOTE:
22 *****
23 Currently the application is supported only in Linux platform.
24 It can be extended to Windows but need to follow some additional steps to generate the
25 firmware.
27 Building EVE Loader Application
28 -------------------------------
29 The application can only be built inside the sbl folder with a single command as follows.
30 For Linux:
31 make eveLoader SOC=AM572x BOARD=idkAM572x
32 make eveLoader SOC=AM574x BOARD=iskAM574x
34 The build library will be located in the following location.
35 <pdk_install_path_am57xx>/packages/ti/boot/sbl/lib/<SOC>/m4/release/sbl_lib.aem4
36 SOC= AM572x or AM574x
38 Breif on EVE Loader Application
39 *******************************
40 eve1MulticoreApp:
41 ----------------
42 The eve1Multicore app is a mail box application which waits on to receive a message from
43 the Master core and send back the message to the Master core. This way the application
44 verifies that the EVE is loaded successfully.
45 This application is build and the binary is generated through the Multicoregen sbl tool.
46 The binary is converted into a header file with hex value. (eve_firmware.h)
48 ipu1EveLoaderApp:
49 ----------------
50 The ipu1EveLoader app will use the firmware header file (eve_firmware.h) as an array and
51 parses the firmware image. The application will determine the number of EVE core firmware
52 is available and reset the EVE core(s). The firmware is loaded into the respective core(s)
53 which will be determined by the firmware header with the core ID.
55 MpuMulticoreApp:
56 ---------------
57 The mpuMulticoreApp is a mailbox application which is a master core. The application sends
58 the message to the slave core(s) and waits to receive the message from them.
60 The mpuM4EveLoader will create a multicore app by combining the mpuMulticoreApp and
61 ipu1EveLoaderApp into a single app. This app is generated in the following location.
62 <pdk_install_path_am57xx>/packages/ti/boot/sbl/binary/<Board>/example/mpuM4EVELoaderApp/bin/app
63 <Board>= idkAM572x or idkAM574x
64 The app shall be copied into the SD card along with the MLO. The SD card is then inserted into
65 the IDK board and power on the board. Ensure the SD boot mode is set.