ACL Top Unified BSP Installation Procedure
Prepared For Instrumentation Labs
CONFIDENTIAL
VERSION:
DATE :
1.01
3/6/2016
ACL Top Unified BSP Installation
Information Page
Version: 1.01
Date: 3/6/2016
Wind River Systems, Inc.
9855 Scranton Road, Building 5
San Diego, CA 92121
858-824-3100 phone
858-824-3198 fax
www.windriver.com
Wind River, the Wind River logo, Tornado, and VxWorks are registered trademarks of Wind River
Systems, Inc. Any third party trademarks referenced are the property of their respective owners.
For further information regarding Wind River trademarks, please see
http://www.windriver.com/company/terms/trademark.html
Wind River Confidential
Prepared For Instrumentation Labs
ii
1.01
3/6/2016
ACL Top Unified BSP Installation Procedure
Revision History
REVISION HISTORY
Date
Version
May 10, 2010
0.01
L. Matías
May 14,2010
0.02
L. Matías
June 10, 2010
1.00
L. Matías
November 10, 2010
1.01
L. Matías
Wind River Confidential
Prepared For Instrumentation Labs
By
Description of Change
Initial Document
Corrected versions of the application and project tar
balls sent to customer and replace Elite references
Added corrections from IL Peer Review.
Added sections supporting the secondary ELF loader
for the Octagon Systems PC-680
iii
1.01
3/6/2016
ACL Top Unified BSP Installation
Table of Contents
1
Overview ........................................................................................................................................ 5
2
Applicable Documents .................................................................................................................. 6
3
Glossary .......................................................................................................................................... 7
4
Software Installation..................................................................................................................... 8
4.1
BSP 8
4.1.1 Rebuilding bootroms ..................................................................................................................... 8
4.2 Tornado Projects..................................................................................................................................... 8
4.2.1 Rebuilding Tornado Projects ......................................................................................................... 8
4.3 ACL TOP Application ........................................................................................................................... 9
4.3.1 Rebuilding the ACL TOP Executables ......................................................................................... 9
4.4 Octagon PC-680 Secondary ELF Loader ............................................................................................ 10
4.4.1 Building the secondary loader ..................................................................................................... 10
5
Changes to the original distribution ......................................................................................... 11
5.1
5.2
5.3
BSP Files .............................................................................................................................................. 11
Project Files .......................................................................................................................................... 12
Application Files .................................................................................................................................. 13
5.3.1 Source Files .................................................................................................................................. 13
5.3.2 Build Environment Files .............................................................................................................. 14
5.3.3 Octagon PC-680 BSP files .......................................................................................................... 15
Wind River Confidential
Prepared For Instrumentation Labs
iv
1.01
3/6/2016
ACL Top Unified BSP Installation
Overview
1 Overview
This reference provides information on how to install the sources for the ACL TOP systems
supporting the unified BSP for Octagon PC-680, Ampro LB-700 and Seco ATOM boards.
It is assumed for the purposes of these procedures that you already have installed Tornado 2.2.1,
the project directories LB-700 application in the $WIND_BASE/target/proj directory and the ACL
TOP application environment. And you have a decompression utility that can handle compressed
tarballs.
The procedures depicted in this document are intended to overlay changes in the various
directories.
After finalizing the procedures in this manual you should:

have three new directories in the $WIND_BASE/target/proj (ETX_ATOM_APP_DEBUG,
etxAtomApp, etxAtomVx).

installed all modified sources to the ACL TOP application.

modified the build environment to use Wind Rive make utilities instead of pcvs builder.
There are three new Tornado projects introduced with this code drop:
ETX_ATOM_VX – Creates a VxWorks image that contains VxWorks Target Shell and
Validation Test Suite (VTS) support only. This project is buildable from the Tornado
environment. Its purpose is to enable H/W and S/W developers to manually exercise
components on the boards using software primitives in the resulting MST-TOPSW-LB700.out
file.
ETX_ATOM_APP_DEBUG – Creates a combined VxWorks and application image. This is an
ACL TOP executable that enables the VxWorks target shell. Its purpose is to enable H/W and
S/W developers to access the ACL TOP Master application using software primitives in the
resulting MST-TOPSW-LB700.out file.
ETX_ATOM_APP - Creates a combined VxWorks and application image. This is an ACL
TOP executable, which requites the host shell to interact with.
Wind River Confidential
Prepared For Instrumentation Labs
5
1.01
3/6/2016
ACL Top Unified BSP Installation
Applicable Documents
2 Applicable Documents
The following documents are referenced within:
No.
1.
2.
3.
4.
Document
ACL
1 TOP Unified BSP Operating
Manual
Version
Scope
0.01
Contains deviations from the standard PC
target.nr file applicable to the ACL Top unified
BSP including bootrom creation.
2
3
4
Wind River Confidential
Prepared For Instrumentation Labs
6
1.01
3/6/2016
ACL Top Unified BSP Installation
Glossary
3 Glossary
For this document, the following terms and abbreviations apply:
Term
BSP
CF
H/W
IL
S/W
VTS
Definition
Board Support Package which provides abstraction between the H/W and low level
functionality required by the operating system
Compact FLASH
Hardware
Instrumentation Laboratories
Software
Validation Test Suite
Wind River Confidential
Prepared For Instrumentation Labs
7
1.01
3/6/2016
ACL Top Unified BSP Installation
Software Installation
4 Software Installation
4.1
BSP
The file tornadoBspFiles_v101.gz contains the unified BSP files. This is a compressed
tarball file. Decompress this file to the $WIND_BASE/target/config directory.
Upon extraction you should have the directory
$WIND_BASE/target/config/lbEtxAtomN270. The directory already contains a usable
bootrom.
4.1.1
Rebuilding bootroms
If you need to rebuild the bootrom and or create a new CF Card, please refer to the ACL
TOP Unified BSP Operating Manual document.
4.2
Tornado Projects
Before you install make sure your $WIND_BASE/target/proj directory already has the
project directories for the LB system (LB_700_App and LB_700_VX).
The file tornadoProjFiles_v105.gz contains the unified project directories alone with the
applicable changes to support all the projects. This is a compressed tarball file. Decompress
this file to the $WIND_BASE. Upon extraction you should have the three new directories:
$WIND_BASE/target/proj/ETX_ATOM_APP_DEBUG, $WIND_BASE/target/proj/
etxAtomApp, and $WIND_BASE/target/proj/etxAtomVx.
Upon extraction, each of these directories will contain the file MST-TOPSW-LB700.out
for each type of the build.
4.2.1
Rebuilding Tornado Projects
The MST-TOPSW-LB700.out file for the $WIND_BASE/target/proj/etxAtomVx directory
could be found in its default subdirectory. This file should be built from the Tornado
environment.
The MST-TOPSW-LB700.out file for the
$WIND_BASE/target/proj/ETX_ATOM_APP_DEBUG and $WIND_BASE/target/proj/
etxAtomApp directories are built when the application is built.
Wind River Confidential
Prepared For Instrumentation Labs
8
1.01
3/6/2016
ACL Top Unified BSP Installation
4.3
Software Installation
ACL TOP Application
Before you install the application’s “patches”, make sure you check out the application into
its corresponding directory. This part of the installation may require merging of the source
files as the code base delivered to Wind River, may not be at the same version as the
current application. Only the AM/Master directory had changes for this delivery.
Two files comprise this update appSrcFiles_v103.gz and appOtherFiles_v101.gz. The first
contains all the sources and header files that required modification, the second contains all
the build environment files modified to support the Wind River make environment instead
of the pvcsbuild environment.
Decompress both files at the directory containing the AM subdirectory.
4.3.1
Rebuilding the ACL TOP Executables
Before you can build the ACL TOP Executables, make sure that you follow the
procedures in the sections BSP and Tornado Projects. The application build assumes that
both the projects and the BSP are in the appropriate locations.
4.3.1.1
Procedure

Open a DOS shell and execute the command “<WIND_BASE>\host\x86win32\torVars”, where <WIND_BASE> is the base directory of the Tornado
2.2.1 installation.

Go to the <AppDir>/AM/Master/src directory, where <AppDir> is the
pathname of the location of the ACL TOP sources.

Execute the command clean_lb700 to clean up any remnants of the old
pvcsbuild files.

Execute the command build_lb700 to do a clean build of the application. This
command will rebuild all the libraries that make up the application, generate the
appImage.o relocatable. The file appImage.o will be copied to the directories
$WIND_BASE/target/proj/ETX_ATOM_APP_DEBUG and
$WIND_BASE/target/proj/etxAtomApp and the make for each directory will be
called. Upon completion the before mentioned directories will have the file
MST-TOPSW-LB700.out, which is the ACL TOP executable for all the
systems.
Wind River Confidential
Prepared For Instrumentation Labs
9
1.01
3/6/2016
ACL Top Unified BSP Installation
4.4
Software Installation
Octagon PC-680 Secondary ELF Loader
The boot loader programmed into the Octagon PC-680 boards is only capable of loading
a.out-formatted files at memory offset 0x10800. The new unified application is an ELF
formatted file that loads at 0x30800. To bridge the format and loading gaps a secondary
loader has been created.
The file pc-680BspFiles_v101.gz contains the files that were modified to allow the creation
of ELD secondary loader. This is a compressed tar ball file. Decompress this file to the
$WIND_BASE of your Tornado 2.0 (VxWorks 5.4.x) distribution. Upon extraction you’re
your Octagon pc-680 BSP will be updated with the required files.
4.4.1
Building the secondary loader
The secondary ELF loader will replace the current application (MST-TOPSW.out). Upon
execution it will automatically search on the server for the unified application (MSTTOPSW-LB700.out), load the file and transfer the execution to it.
If you are required to modify or rebuild the secondary ELF loader perform the steps
described on the following section.
4.4.1.1
Procedure

Open a DOS command shell

Source %WIND_BASE%\host\x86-win32\bin\torVars.bat

Change directory to %WIND_BASE%\target\config\pc-680

Build VxWorks
make SECLOAD=1 vxWorks

Rename the VxWorks image to MST-TOPSW.out
move vxWorks MST-TOPSW.out
Wind River Confidential
Prepared For Instrumentation Labs
10
1.01
3/6/2016
ACL Top Unified BSP Installation
Changes to the original distribution
5 Changes to the original distribution
Changes were made to the product files in three areas. First a new BSP for Tornado 2.2.1 has been
created. Second, additional Tornado projects have been added to the existing one for the LB-700.
Last, application files have been modified.
5.1
BSP Files
./lbEtxAtomN270/00bsp.cdf
./lbEtxAtomN270/00html.cdf
./lbEtxAtomN270/11usb.cdf
./lbEtxAtomN270/MST-TOPSW-LB700.out
./lbEtxAtomN270/Makefile
./lbEtxAtomN270/README
./lbEtxAtomN270/bcm57xxEnd.c
./lbEtxAtomN270/bcm57xxEnd.h
./lbEtxAtomN270/bootConfig.c
./lbEtxAtomN270/bootrom
./lbEtxAtomN270/bootrom.sys
./lbEtxAtomN270/byteNvRam.c
./lbEtxAtomN270/config.h
./lbEtxAtomN270/configHtml.h
./lbEtxAtomN270/configInum.h
./lbEtxAtomN270/configNet.h
./lbEtxAtomN270/dec21x40End.c
./lbEtxAtomN270/dec21x40End.h
./lbEtxAtomN270/i8250Sio.c
./lbEtxAtomN270/i8250Sio.h
./lbEtxAtomN270/mkboot.c
./lbEtxAtomN270/ns16550Sio.c
./lbEtxAtomN270/ns16552Sio.h
./lbEtxAtomN270/pc.h
./lbEtxAtomN270/pciCfgIntStub.c
./lbEtxAtomN270/pciCfgStub.c
./lbEtxAtomN270/queueLib.c
./lbEtxAtomN270/queueLib.h
./lbEtxAtomN270/romInit.h
./lbEtxAtomN270/romInit.s
./lbEtxAtomN270/romcard.s
./lbEtxAtomN270/rtl81x9End.c
./lbEtxAtomN270/rtl81x9End.h
./lbEtxAtomN270/sysALib.s
./lbEtxAtomN270/sysBcm57xxEnd.c
./lbEtxAtomN270/sysDec21x40End.c
./lbEtxAtomN270/sysEl3c90xEnd.c
./lbEtxAtomN270/sysElt3c509End.c
./lbEtxAtomN270/sysFei82557End.c
./lbEtxAtomN270/sysGei82543End.c
./lbEtxAtomN270/sysLib.c
./lbEtxAtomN270/sysLn97xEnd.c
./lbEtxAtomN270/sysNe2000End.c
./lbEtxAtomN270/sysNet.c
Wind River Confidential
Prepared For Instrumentation Labs
11
1.01
3/6/2016
ACL Top Unified BSP Installation
Changes to the original distribution
./lbEtxAtomN270/sysNetif.c
./lbEtxAtomN270/sysNvRam.c
./lbEtxAtomN270/sysRtl81x9End.c
./lbEtxAtomN270/sysScsi.c
./lbEtxAtomN270/sysSerial.c
./lbEtxAtomN270/sysTffs.c
./lbEtxAtomN270/sysUltraEnd.c
./lbEtxAtomN270/sysWindML.c
./lbEtxAtomN270/target.nr
./lbEtxAtomN270/usbEnum.c
./lbEtxAtomN270/usbPciStub.c
./lbEtxAtomN270/usrPcConsole.c
./lbEtxAtomN270/usrSerial.c
./lbEtxAtomN270/usr_Config.c
./lbEtxAtomN270/BlasterBlasteeWindows/blasteeTCP.exe
./lbEtxAtomN270/BlasterBlasteeWindows/blasteeUDP.exe
./lbEtxAtomN270/BlasterBlasteeWindows/blasterTCP.exe
./lbEtxAtomN270/BlasterBlasteeWindows/blasterUDP.exe
./lbEtxAtomN270/vesa_fb/pcbios.c
./lbEtxAtomN270/vesa_fb/pcbios.h
./lbEtxAtomN270/vesa_fb/pcvbe.c
./lbEtxAtomN270/vesa_fb/pcvbe.h
./lbEtxAtomN270/vesa_fb/romInit.h
./lbEtxAtomN270/vtsLogs/BlasterBlasteeTCP(Windows).txt
./lbEtxAtomN270/vtsLogs/BlasterBlasteeTCP(vxWorks).txt
./lbEtxAtomN270/vtsLogs/BlasterBlasteeUDP(Windows).txt
./lbEtxAtomN270/vtsLogs/BlasterBlasteeUDP(vxWorks).txt
./lbEtxAtomN270/vtsLogs/bspValidationLog.3948
./lbEtxAtomN270/vtsLogs/bspValidationLog.3948_screenDump
./lbEtxAtomN270/vtsLogs/bspValidationLog.5376
./lbEtxAtomN270/vtsLogs/bspValidationLog.5376_screenDump
./lbEtxAtomN270/vtsLogs/fsTestOutput.txt
./lbEtxAtomN270/vtsLogs/./lbEtxAtomN270.T1
5.2
Project Files
./Target/proj/AclTopMasterWs.wsp
./Target/proj/ETX_ATOM_APP_DEBUG/ETX_ATOM_APP_DEBUG.wpj
./Target/proj/ETX_ATOM_APP_DEBUG/MST-TOPSW-LB700.out
./Target/proj/ETX_ATOM_APP_DEBUG/Makefile
./Target/proj/ETX_ATOM_APP_DEBUG/ctdt.c
./Target/proj/ETX_ATOM_APP_DEBUG/linkSyms.c
./Target/proj/ETX_ATOM_APP_DEBUG/prjComps.h
./Target/proj/ETX_ATOM_APP_DEBUG/prjConfig.c
./Target/proj/ETX_ATOM_APP_DEBUG/prjObjs.lst
./Target/proj/ETX_ATOM_APP_DEBUG/prjParams.h
./Target/proj/ETX_ATOM_APP_DEBUG/usrAppInit.c
./Target/proj/ETX_ATOM_APP_DEBUG/vxWorks
./Target/proj/LB_700_App/LB_700_APP.wpj
./Target/proj/LB_700_App/Makefile
./Target/proj/LB_700_App/linkSyms.c
./Target/proj/LB_700_App/prjComps.h
./Target/proj/LB_700_App/prjConfig.c
./Target/proj/LB_700_App/prjParams.h
./Target/proj/LB_700_VX/LB_700_VX.wpj
./Target/proj/LB_700_VX/Makefile
Wind River Confidential
Prepared For Instrumentation Labs
12
1.01
3/6/2016
ACL Top Unified BSP Installation
Changes to the original distribution
./Target/proj/LB_700_VX/linkSyms.c
./Target/proj/LB_700_VX/prjComps.h
./Target/proj/LB_700_VX/prjConfig.c
./Target/proj/LB_700_VX/prjParams.h
./Target/proj/LB_700_VX/default/symTbl.c
./Target/proj/LB_700_VX/default/vxWorks
./Target/proj/etxAtomApp/ETX_ATOM_APP.wpj
./Target/proj/etxAtomApp/MST-TOPSW-LB700.out
./Target/proj/etxAtomApp/Makefile
./Target/proj/etxAtomApp/ctdt.c
./Target/proj/etxAtomApp/linkSyms.c
./Target/proj/etxAtomApp/prjComps.h
./Target/proj/etxAtomApp/prjConfig.c
./Target/proj/etxAtomApp/prjObjs.lst
./Target/proj/etxAtomApp/prjParams.h
./Target/proj/etxAtomApp/symTbl.c
./Target/proj/etxAtomApp/usrAppInit.c
./Target/proj/etxAtomApp/vxWorks
./Target/proj/etxAtomVx/ETX_ATOM_VX.wpj
./Target/proj/etxAtomVx/Makefile
./Target/proj/etxAtomVx/blasteeTCPvx.c
./Target/proj/etxAtomVx/blasteeUDPvx.c
./Target/proj/etxAtomVx/blasterTCPvx.c
./Target/proj/etxAtomVx/blasterUDPvx.c
./Target/proj/etxAtomVx/fsTest.c
./Target/proj/etxAtomVx/linkSyms.c
./Target/proj/etxAtomVx/mkboot.c
./Target/proj/etxAtomVx/pkLib.c
./Target/proj/etxAtomVx/prjComps.h
./Target/proj/etxAtomVx/prjConfig.c
./Target/proj/etxAtomVx/prjObjs.lst
./Target/proj/etxAtomVx/prjParams.h
./Target/proj/etxAtomVx/usrAppInit.c
./Target/proj/etxAtomVx/default/MST-TOPSW-LB700.out
./Target/proj/etxAtomVx/default/MST-TOPSW.out
./Target/proj/etxAtomVx/default/ctdt.c
./Target/proj/etxAtomVx/default/symTbl.c
./Target/proj/etxAtomVx/default/vxWorks
5.3
5.3.1
Application Files
Source Files
./AM/Master/Src/CtrlComm/CtrlComm.cpp
./AM/Master/Src/CtrlComm/CtrlProg.cpp
./AM/Master/Src/CtrlComm/IPCCANH_82527.CPP
./AM/Master/Src/CtrlComm/IPCCANH_XILINX.CPP
./AM/Master/Src/Diagnostic/CDiagSensors.cpp
./AM/Master/Src/EH/exhmain.cpp
./AM/Master/Src/FMon/CAVROcomm.cpp
./AM/Master/Src/FMon/CAVROcomm.h
./AM/Master/Src/FMon/CAVROport.cpp
./AM/Master/Src/FMon/CAVROtx.cpp
./AM/Master/Src/FMon/CFluidContainer.CPP
Wind River Confidential
Prepared For Instrumentation Labs
13
1.01
3/6/2016
ACL Top Unified BSP Installation
Changes to the original distribution
./AM/Master/Src/FMon/CFluidDevice.cpp
./AM/Master/Src/FMon/rs232.h
./AM/Master/Src/Inc/APPVER.H
./AM/Master/Src/Inc/CCoverLock.h
./AM/Master/Src/Inc/CtrlComm.h
./AM/Master/Src/Inc/Digio.h
./AM/Master/Src/Inc/IPCCAN_82527.H
./AM/Master/Src/Inc/IPCCAN_Abstract.H
./AM/Master/Src/Inc/IPCCAN_XILINX.H
./AM/Master/Src/Inc/OS.H
./AM/Master/Src/JobMgr/CJob.cpp
./AM/Master/Src/MMgmt/CRackMaterialsAllocate.cpp
./AM/Master/Src/MMgmt/CRackMaterialsReading.cpp
./AM/Master/Src/OS/CTASK.CPP
./AM/Master/Src/SCH/CCuvette.cpp
./AM/Master/Src/SCH/CDet.cpp
./AM/Master/Src/SCH/CScheduler.cpp
./AM/Master/Src/Safety/CCoverLock.cpp
./AM/Master/Src/Safety/CCoverSensor.cpp
./AM/Master/Src/Safety/CSafetyMgr_Irq.cpp
./AM/Master/Src/StUp/cinstrument.cpp
./AM/Master/Src/StUp/mstrapp.cpp
./AM/Master/Src/UT/CSharedOutPort.cpp
./AM/Master/Src/UT/trace.cpp
./AM/Master/Src/Waste/CWasteAccumulator.cpp
./AM/Master/Src/Waste/CWasteContainer.cpp
./AM/Master/Src/Waste/CWastePump.cpp
5.3.2
Build Environment Files
./AM/Master/Src/Build_LB700.bat
./AM/Master/Src/Build_PC680.bat
./AM/Master/Src/Clean_LB700.bat
./AM/Master/Src/defs.project
./AM/Master/Src/defs.vxApp
./AM/Master/Src/defs.x86-win32
./AM/Master/Src/grand_make_template.mak
./AM/Master/Src/library_template.mak
./AM/Master/Src/master.bld
./AM/Master/Src/master.mak
./AM/Master/Src/rules.project
./AM/Master/Src/rules.vxApp
./AM/Master/Src/rules.x86-win32
./AM/Master/Src/CMComm/cmcomm.mak
./AM/Master/Src/CtrlComm/ctrlcomm.mak
./AM/Master/Src/Cuvettes/Cuvettes.mak
./AM/Master/Src/Diagnostic/diagnostic.mak
./AM/Master/Src/EH/eh.mak
./AM/Master/Src/FMon/fmon.mak
./AM/Master/Src/JobMgr/JobMgr.mak
./AM/Master/Src/LasAlqMgr/LasAlqMgr.mak
./AM/Master/Src/MMgmt/MMgmt.mak
./AM/Master/Src/OS/os.mak
./AM/Master/Src/SCH/sch.mak
./AM/Master/Src/SWTest/SWTest.mak
./AM/Master/Src/Safety/safety.mak
./AM/Master/Src/Sample/Sample.mak
Wind River Confidential
Prepared For Instrumentation Labs
14
1.01
3/6/2016
ACL Top Unified BSP Installation
Changes to the original distribution
./AM/Master/Src/StUp/StUp.mak
./AM/Master/Src/TDef/TDef.mak
./AM/Master/Src/Thermal/Thermal.mak
./AM/Master/Src/UT/ut.mak
./AM/Master/Src/Waste/waste.mak
./AM/Master/UnitTest/defs.project
./AM/Master/UnitTest/defs.vxApp
./AM/Master/UnitTest/defs.x86-win32
./AM/Master/UnitTest/master.bld
./AM/Master/UnitTest/rules.project
./AM/Master/UnitTest/rules.vxApp
./AM/Master/UnitTest/UT/utUnitTest.mak
5.3.3
Octagon PC-680 BSP files
./Target/config/pc-680/config.h
./Target/config/pc-680/elf.h
./Target/config/pc-680/elfLoad.c
./Target/config/pc-680/elftypes.h
./Target/config/pc-680/makefile
./Target/config/pc-680/secbootline.h
./Target/config/pc-680/sysLib.c
./Target/config/pc-680/MST-TOPSW.out
Wind River Confidential
Prepared For Instrumentation Labs
15
1.01
3/6/2016