BD software release document AAA31013AAC_2006-09-14

Preseries Release Full ReleaseName of Software: Drive TI 2812-Primary Loader SCRD BRDChanges 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: EmbeddedSupercedes: AAA31013AABApprovals: 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.SignatureDate Title NameSoftware 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/05Distribution:Kokoschka, A. - OECBLee, JeaPil - OECLGKim, JeongO - OEC-SHAMiguchi, Y. - OTISchröder-Brumloop, H - OECBSRD 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 section2 - Dependencies.Approvals: Typed: Signature: Date:C. Czerwinski 9/22/06Engineer: C.CzerwinskiQuality Assurance: J. Batchelor J. Batchelor 9/22/06Release Administrator: L. Roelofs L. Roelofs 9/22/061. Deliverable MediaBACKGROUND:The Drive TI 2812 DSP Software (30924) on the GDCB platform is maintained inFLASH. To enable Otis to load and/or update the application on the target, we havedefined two loaders, a Primary (31013) and Secondary (31014). The Primary Loaderdefined 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 PrimaryLoader will enable the Drive application. The Secondary Loader maintains the download smarts (size, location, etc…) and will be contained within the tool media with theapplication.Programming the FLASHThis 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 theabove software ().Required Files:1. AAA31013AAC.out2. AAA31013AAC_PP.sdp3. AAA31013AAC_USB.sdp4. SDFlash2812.out5. Spectrum Digital’s Flash Burn UtilityRequired 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 FileNote: The default algorithm file from Spectrum Digital needs to be replaced with thefollowing 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 Utility1. Copy the required version of AAA31013AAC.out, AAA31013AAC_PP.sdp andAAA31013AAC_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.exe5. Select File->Open Project and select the folder containing the required31013_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 anerror 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.Figure 1 – JTAG Emulator SetupFor 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 and30924_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.exe5) Select File->Open Project and select the folder containing the required30924_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 anerror 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 AAA30924AABo AP130924AABo AP230924AAB• The CRC32 of the AAA31013AAC is D940EB80 if the following versions or later versions of 30924 are used:o AAA30924BAAo AAA30924CAA2. DependenciesEmbedded Burn ProceduresRuns 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 “Forverification purposes”.Why does the CRC32 result depend on the 30924 version?The CRC of the primary loader AAA31013AAC depends on 30924 because 30924 calculatesthe 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’sCode Security Module (CSM) to prevent unauthorized access to the application code. Whenthe CSM is activated, a portion of reserved memory of the DSP is changed. The primaryloader code itself is not affected since the loader code does not reside in this reserved memoryregion. However, the original CRC calculation is affected because the original CRCcalculation inadvertently includes this reserved area of memory. Versions afterAP230924AAB correct this error and now exclude this reserved memory space and thereforeexpect 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 isupgraded to AAA30924BAA, for example, the CRCs before and after the upgrade will bedifferent. If the original software AP230924AAB is then restored, AP230924AAB will reporta fault in the CRC of the primary loader AAA31013AAC. This will occur becauseAP230924AAB is expecting to see the old CRC, but it will not because the CSM wasactivated during the upgrade and is not deactivated when AP230924AAB is restored. Thefault is a log-only and will occur as a result of the software upgrade followed by the softwarerestore.3. ChangesList all the closed SCRs in this configuration (note: this information is gathered by running the Trackermacro).SCR Number: 31013 - 23Title: Reduce startup delayDescription: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 - 24Title: Update begin.asm to reflect AAA31013AAC versionDescription:Solution:Impact:The display will show AAA31013AACComponent(s) Affected:Artifacts Affected:____________________________________________________________________Total SCRs: 2Summary of All Components Affected:4. Reference DocumentsList the reference documents associated with this release.Document NumberTitle Revision 30924_CHK_GDCB.xls Drive TI 2812 DSP Software11/07/2005SOFTWARE DELIVERABLESCHECKLIST04/18/2005 31014_SDD_GDCB.doc Gen2 Modular Regenerative DriveSoftware DownloadSoftware Design Document11/07/2005 55794_SDP_GDCB.doc Drive TI 2812 DSP SoftwareSoftware Development Plan11/07/2005 30924_STPR_GDCB.doc GLOBAL DRIVES SOFTWARE TESTPROCEDURES30924_STR_GDCB.doc Drive TI2812 DSP Software11/07/2005Software Test ResultsD323_STP_GlobalDrives .doc Global Drive Control Board04/15/2005Software Test Plan5. NotesNone.。