Guideline: How to build AMSS source code?

linhnc1@viettel.com.vn

History:01/02/2010 - Make Draft05/02/2010 – Release 1.006/02/2010 – Updated

Content

• What is in the Package?• Software tools• Download and install tools• Build• Notes

(notes: This guideline base on M6290AKPRZL340135, others build also the same)

WHAT IS IN THE PACKAGE?

What is in the Package?

• AMSS 6290 Release 3.4.0135 • Software number –HY11-VM333-41• Build –M6290AKPRZL340135• File – HY11-VM333-41.zip • Location– \\Server\Software_Workshare\Projects\VT1000\

Releases\AMSS for BMP\M6290AKPVZL340135\

What is in the Package?

• Subdirectories– \bsp–Board Support Package– \build\ms – Trace32 JTAG script for building, build image, and log– \data – Source code for data services– \drivers – Drivers for LCD, peripherals, etc.– \modem – AMSS source code– \platform – Iguana, libraries– \romboot – Boot loaders, from PBL to OEMSBL– \services – Source code for services such as Bluetooth®, Qtv™, etc.– \tools – Code for Flash operations

SOFTWARE TOOLS WINDOWS PLATFORM

Software tools - RVCT

• ARM® C compiler –RVCT 2.2.1 (build 593)• Perl version 5.6.1 • make (GNU) version 3.81• GCC version 3.4.4• Cygwin version 1.5.25• QPST™version 2.7.301 or later

DOWNLOAD AND INSTALL TOOLS

Download and install

• RVCT 2.2 can be purchased from Advanced RISC Machines 4 Ltd., located at www.arm.com

• To run a build without further modifications, specify the path C:\Apps\ARM as the RVDS install root directory

• Root folder for Cygwin and Perl is C:\• Coexistence with other RVDS versions– Uninstall previous ARM tools (ADS or RVDS)– Install ARM RVDS 2.2 on the path

Download and install

• Perl can be downloaded from http://www.activestate.com/

• GNU make can be downloaded from http://sources.redhat.com/cygwin/

Download and install

• All install package could found on \\Server\Software_Workshare\General Tools\Build Env\

• Install Cygwin with full install option• Check cygwin version: uname.exe –r• Check Make GNU: make –v• Check GCC: gcc –v• Check Perl: perl -v

Download and install

• After install RVDS, go to \\Server\Software_Workshare\General Tools\Build Env\RVDS\win_32-pentium\

• Copy all file in this folder to RVCT folder C:\Apps\ARM\RVCT\Programs\2.2\503\win_32-pentium\

• To get the license of RVDS build 616, please come to my desk.

BUILD AND DOWNLOAD

Build• Install Cygwin(with libraries) or Perl and make separately• Set up the build environment

– Open a DOS window– Change directory C:\HY11-VM333-41\build\ms– Copy RVCT221P593ECMake.bat from server to \build\ms (\\Server\

Software_Workshare\General Tools\Build Env\RVDS\)– Execute RVCT221P593ECMake.bat –This sets up the path to add RVDS

2.2, Perl, and GNUWIN32

• Build All– Continue in the same DOS window– Execute <Build-ID>.cmd – Windows shell script, which invokes make

with the appropriate command line arguments for the build– Related object files are created in C:\HY11-VM333-41\build\ms\

<Build-ID>– Build log is created in build<Build-ID>.log

Images

• Images – Image location• C:\HY11-VM333-41\build\ms\<Build-ID>.elf• C:\HY11-VM333-41\build\ms\bin\<Build-ID> (mbn

files)

– JTAG scripts location• C:\HY11-VM333-41\build\ms

Download – Using QPST• A working build should already be loaded on the target. A working build is,

by definition, one that boots up, starts power-up execution without crashing, and communicates through to the QPST server.

• Connect the target to the QPST software download client through USB, and select the Multi-image tab from the first screen.

• This prompts for the Image Folder directory, which is C:\HY11-VM333-41\build\ms\<Build-ID>, where <Build-ID> is the five-letter build identifier without the version number, e.g., KPVBL.

• Check the Trusted mode checkbox. This is done because the AMSS supports only secure boot architecture.

• Click START to begin loading.

NOTES

Notes

• Reference documents– Quick start guide

• 80-VN004-1_B_AMSS6290_Quick_Start_Guide.pdf

– Release notes of build 2.4.0135• 80-VG936-50_A_M6290AKPRZL240135.pdf

• Make sure your setting RVDS path, Cygwin, Perl are correct!– To check, open \build\ms\ RVCT221P593ECMake.bat

• Build progress will take approximate 1.5 hour for first build, next build will take a few minute depend on your modification

Thank you