Software Releasedocument AAA31013AAC

Download as pdf or txt
Download as pdf or txt
You are on page 1of 9

Document Number: AAA31013AAC

Software Release Document Revision Date: 14-09-2006


Page 1 of 9

Preseries Release Full Release

Name of Software: Drive TI 2812-Primary Loader SCRD BRD

Changes Incorporated into this Revision:


• Drive TI 2812-Primary Loader AAC Release, changes reduce start up time and documentation updated to account
for changes to CRC32.

Parent Configuration: AAA31013AAB Software Type: Embedded

Supercedes: AAA31013AAB

Approvals: At a minimum, the Software Developer, Team/Program Leader and the Software Manager shall approve the
software release. Additional rows may be added as needed.

Title Name Signature Date


Software Developer Izard, Jeff Jeff Izard 11/09/05

Team/Program Leader Czerwinski, Chris Chris Czerwinski 11/09/05

Software Manager Olthuis, Mark Mark Olthuis N/A

Software Test Manager Stone, Jason JPB for Jason Stone 11/10/05

Software Quality Assurance Batchelor, Judy Judy Batchelor 11/10/05

Distribution:
Kokoschka, A. - OECB
Lee, JeaPil - OECLG
Kim, JeongO - OEC-SHA
Miguchi, Y. - OTI
Schröder-Brumloop, H - OECB

SRD Revisions (Instructions: Complete this section for an SRD update only (no change to the existing software code).

Date Revised: Description:


Sept. 14, 2006 Updates regarding CRC32. Update section 1; “For verification purposes” and section
2 - Dependencies.
Approvals: Typed: Signature: Date:
Engineer: C. Czerwinski C. Czerwinski 9/22/06
Quality Assurance: J. Batchelor J. Batchelor 9/22/06
Release Administrator: L. Roelofs L. Roelofs 9/22/06

Template Number: OSP00055 Unpublished Work – Copyright © Otis Elevator Company


Document Number: AAA31013AAC
Software Release Document Revision Date: 14-09-2006
Page 2 of 9

1. Deliverable Media
BACKGROUND:
The Drive TI 2812 DSP Software (30924) on the GDCB platform is maintained in
FLASH. To enable Otis to load and/or update the application on the target, we have
defined two loaders, a Primary (31013) and Secondary (31014). The Primary Loader
defined here and required on the target, will check for acceptable download options and if
detected, enable the associated tools interface. If no tool is detected, then the Primary
Loader will enable the Drive application. The Secondary Loader maintains the download
smarts (size, location, etc…) and will be contained within the tool media with the
application.

Programming the FLASH


This procedure requires Third Party Software from Spectrum Digital:
- Spectrum Digital Flash Burn Utility (SDFlash.exe version 1.60)
- Spectrum Digital SDFlash Algorithm Version 4.1
*Note: Please follow Spectrum Digital instructions for the installation of the
above software (www.spectrumdigital.com).

Required Files:
1. AAA31013AAC.out
2. AAA31013AAC_PP.sdp
3. AAA31013AAC_USB.sdp
4. SDFlash2812.out
5. Spectrum Digital’s Flash Burn Utility

Required Hardware:
1. JTAG (XDS510PP or XDS510USB)
2. Option Board (AxA26800ALH)

Please see Figure 1 for illustration of hardware connection.

Replacing Spectrum Digital Flash Burn Algorithm File


Note: The default algorithm file from Spectrum Digital needs to be replaced with the
following one, which is customized specifically for the GDCB clock frequency.
1. Copy the required version of the executable SDFlash2812.out from Pegasus onto:
C:\ti\specdig\SDFlash\myprojects\tif281x_v4_1\f2812\flash28\debug

Programming the FLASH – using the Spectrum Digital Flash Burn Utility
1. Copy the required version of AAA31013AAC.out, AAA31013AAC_PP.sdp and
AAA31013AAC_USB.sdp from Pegasus onto your local disk.
2. Power up the target processor board and/or drive.
3. Exit Code Composer Studio (CCS) if it is already running.

Template Number: OSP00055 Unpublished Work – Copyright © Otis Elevator Company


Document Number: AAA31013AAC
Software Release Document Revision Date: 14-09-2006
Page 3 of 9

4. Start Spectrum Digital Flash Burn Utility on the PC.


- The default path is: C:\ti\specdig\SDFlash\bin\SDFlash.exe
5. Select File->Open Project and select the folder containing the required
31013_xxx.sdp file:
• If using XDS510PP, select AAA31013AAC_PP.sdp.
• If using XDS510USB, select AAA31013AAC_USB.sdp.
6. Select Buffer->Coff Load.
7. Select Device->Reset.
8. Select Device->Flash.
9. Click Start. Verify the programming was successful by reading the messages. If an
error occurs between the ERASE and PROGRAM steps, follow this procedure:
a. Make sure only Erase option is checked. Click Start.
b. When complete, uncheck Erase and check Program. Click Start.
c. When complete, uncheck Program and check Verify. Click Start.
d. Verify the programming was successful by reading the messages.
10. Exit Spectrum Digital Flash Burn Utility.

Template Number: OSP00055 Unpublished Work – Copyright © Otis Elevator Company


Document Number: AAA31013AAC
Software Release Document Revision Date: 14-09-2006
Page 4 of 9

Figure 1 – JTAG Emulator Setup

For verification purposes:


Note: In order to verify the required version AAA31013AAC.out a compatible 30924.out
needs to be present on the target. If 30924.out is already present, please go to step 12. If
not, please execute the following steps in order to download the required version of
30924.out.
1) Copy the required version of the executable 30924.out, 30924_PP.sdp and
30924_USB.sdp from Pegasus onto your local disk.
2) Power up the target processor board and/or drive.
3) Exit Code Composer Studio (CCS) if it is already running.
4) Start Spectrum Digital Flash Burn Utility on the PC.
- The default path is: C:\ti\specdig\SDFlash\bin\SDFlash.exe

Template Number: OSP00055 Unpublished Work – Copyright © Otis Elevator Company


Document Number: AAA31013AAC
Software Release Document Revision Date: 14-09-2006
Page 5 of 9

5) Select File->Open Project and select the folder containing the required
30924_xxx.sdp file:
• If using XDS510PP, select 30924_PP.sdp.
• If using XDS510USB, select 30924_USB.sdp.
6) Select Buffer->Coff Load.
7) Select Device->Reset.
8) Select Device->Flash.
9) Click Start. Verify the programming was successful by reading the messages. If an
error occurs between the ERASE and PROGRAM steps, follow this procedure:
• Make sure only Erase option is checked. Click Start.
• When complete, uncheck Erase and check Program. Click Start.
• When complete, uncheck Program and check Verify. Click Start.
• Verify the programming was successful by reading the messages.
10) Exit Spectrum Digital Flash Burn Utility.
11) Power up the target or drive.
12) Using the Service Tool, go to menu M418 if a 422 Interface is being use or M218
(M18 if locally connected) for a CAN interface. Navigate through this menu until
the Primary Loader CRC is being displayed.
13) Verify the CRC32 of the AAA31013AAC as follows:
• The CRC32 of the AAA31013AAC is 1A349C4B if the following versions
of 30924 are used:
o AAA30924AAB
o AP130924AAB
o AP230924AAB

• The CRC32 of the AAA31013AAC is D940EB80 if the following versions


or later versions of 30924 are used:
o AAA30924BAA
o AAA30924CAA

Template Number: OSP00055 Unpublished Work – Copyright © Otis Elevator Company


Document Number: AAA31013AAC
Software Release Document Revision Date: 14-09-2006
Page 6 of 9

2. Dependencies
Embedded Burn Procedures

Runs on PC Board
• PC board assembly AAA26800AKT is required for this software.
Installation Dependencies
• This software will run with AAA30924AAB, AAA31014AAC.

Limitation for Use


• Not compatible with AAA31014AAA or AAA31014AAB and AAA30924AAA
• The CRC32 of AAA31013AAC depends on the version of 30924 being used. Please read the
paragraphs below for the reason and its impact, as well the previous section “For
verification purposes”.
Why does the CRC32 result depend on the 30924 version?
The CRC of the primary loader AAA31013AAC depends on 30924 because 30924 calculates
the CRC and there is a change in how the CRC is calculated after version AP230924AAB.
The reason why the CRC changed is because versions after AP230924AAB activate the DSP’s
Code Security Module (CSM) to prevent unauthorized access to the application code. When
the CSM is activated, a portion of reserved memory of the DSP is changed. The primary
loader code itself is not affected since the loader code does not reside in this reserved memory
region. However, the original CRC calculation is affected because the original CRC
calculation inadvertently includes this reserved area of memory. Versions after
AP230924AAB correct this error and now exclude this reserved memory space and therefore
expect to see a new CRC result.

What is the impact of having different CRC32s?


If a drive is configured with AAA31013AAC and AP230924AAB and the software is
upgraded to AAA30924BAA, for example, the CRCs before and after the upgrade will be
different. If the original software AP230924AAB is then restored, AP230924AAB will report
a fault in the CRC of the primary loader AAA31013AAC. This will occur because
AP230924AAB is expecting to see the old CRC, but it will not because the CSM was
activated during the upgrade and is not deactivated when AP230924AAB is restored. The
fault is a log-only and will occur as a result of the software upgrade followed by the software
restore.

Template Number: OSP00055 Unpublished Work – Copyright © Otis Elevator Company


Document Number: AAA31013AAC
Software Release Document Revision Date: 14-09-2006
Page 7 of 9

3. Changes
List all the closed SCRs in this configuration (note: this information is gathered by running the Tracker
macro).

SCR Number: 31013 - 23


Title: Reduce startup delay

Description:
Time for starting 30924 Application is too long.
The time from RESET to 30924 transmitting CAN startup message must be reduce to less than 5.0 seconds.

Solution:
Changed AppValid() to not perform CRC32.
Changed RunSvt() to wait only 0.2 seconds before sending prompt to PC, and to wait only 0.2 seconds for
response from PC.

Impact:

Component(s) Affected:

Artifacts Affected:

____________________________________________________________________

SCR Number: 31013 - 24


Title: Update begin.asm to reflect AAA31013AAC version

Description:

Solution:

Impact:
The display will show AAA31013AAC

Component(s) Affected:

Artifacts Affected:

____________________________________________________________________

Total SCRs: 2

Summary of All Components Affected:

Template Number: OSP00055 Unpublished Work – Copyright © Otis Elevator Company


Document Number: AAA31013AAC
Software Release Document Revision Date: 14-09-2006
Page 8 of 9

4. Reference Documents
List the reference documents associated with this release.

Document Number
Title Revision
30924_CHK_GDCB.xls Drive TI 2812 DSP Software 11/07/2005
SOFTWARE DELIVERABLES
CHECKLIST
31014_SDD_GDCB.doc Gen2 Modular Regenerative Drive 04/18/2005
Software Download
Software Design Document
55794_SDP_GDCB.doc Drive TI 2812 DSP Software 11/07/2005
Software Development Plan
30924_STPR_GDCB.doc GLOBAL DRIVES SOFTWARE TEST 11/07/2005
PROCEDURES
30924_STR_GDCB.doc Drive TI2812 DSP Software 11/07/2005
Software Test Results
D323_STP_GlobalDrives .doc Global Drive Control Board 04/15/2005
Software Test Plan

Template Number: OSP00055 Unpublished Work – Copyright © Otis Elevator Company


Document Number: AAA31013AAC
Software Release Document Revision Date: 14-09-2006
Page 9 of 9

5. Notes
None.

Template Number: OSP00055 Unpublished Work – Copyright © Otis Elevator Company

You might also like