SPNZ210s
Hercules™ F021
Flash APIErrataLiterature Number: SPNZ210
July 2013
Contents1All Errata Listed With Software Version Numbers ...................................................................
42Revision History .................................................................................................................
53Known Design Exceptions to Function Specifications .............................................................
52
Table of ContentsSPNZ210 – July 2013
Submit Documentation FeedbackCopyright © 2013, Texas Instruments Incorporated
www.ti.comList of Tables1
Overview .....................................................................................................................
42
Revision History .............................................................................................................
53
Known Design Exceptions to Function Specifications .................................................................
5SPNZ210 – July 2013
List of Tables3
Submit Documentation FeedbackCopyright © 2013, Texas Instruments Incorporated
ErrataSPNZ210 – July 2013Hercules™ F021 Flash APIThis document describes the known exceptions to the functional specifications for the software.
1All Errata Listed With Software Version NumbersTable 1. OverviewAdvisory IDv01.50.00v01.51.00v02.00.00v02.00.01SDOCM00086402
X
-
-
-
SDOCM00086405
X
-
NA
NA
SDOCM00094147
X
X
-
-
SDOCM00102084
NA
NA
X
-
SDOCM00102399
-
-
X
-
LEGEND: X = Advisory applies to this version, NA = Not Applicable to this version of the library, - = Advisory does not affect this
version
4
Hercules™ F021 Flash APISPNZ210 – July 2013
Submit Documentation FeedbackCopyright © 2013, Texas Instruments Incorporated
www.ti.comRevision History2Revision HistoryThis software errata revision history highlights the technical changes made from the previous to the
current revision.
Table 2. Revision HistoryAdvisory Changes in Advisory ListAdvisory IDSDOCM00086402, SDOCM00086405, SDOCM00094147, SDOCM00102084,
Added advisory(s)
SDOCM00102399
Removed advisory(s)
None
Modified advisory(s)
None
Other
None
3Known Design Exceptions to Function SpecificationsTable 3. Known Design Exceptions to Function SpecificationsTitle ......................................................................................................................................
PageSDOCM00086402 — Fapi_doMarginRead() does not read all requested data ..................................................
6SDOCM00086405 — Fapi_UserDefinedFunctions.c needs FSM unlock/lock sequence for FSM_SECTOR/1/2 writes ....
7SDOCM00094147 — Incorrect read in Verify functions in ECC regions on LE devices ........................................
8SDOCM00102084 — Typo in CGT.CCS.H in GNU attribute check................................................................
9SDOCM00102399 — FEDACSDIS and FEDACSDIS2 are missing from Fapi_FmcRegistersType definition..............
10SPNZ210 – July 2013
Hercules™ F021 Flash API5
Submit Documentation FeedbackCopyright © 2013, Texas Instruments Incorporated
SDOCM00086402 — Fapi_doMarginRead() does not read all requested datawww.ti.comSDOCM00086402Fapi_doMarginRead() does not read all requested dataSeverityS2 - Major
Expected BehaviorTo read all data for the given range.
IssueThe function Fapi_doMarginRead() only returns 3/4 of the data requested on ECC
regions.
ConditionsUsing this function on ECC region will exhibit this behavior.
ImplicationsWrong data or invalid reads may occur.
Workaround(s)None
6
Hercules™ F021 Flash APISPNZ210 – July 2013
Submit Documentation FeedbackCopyright © 2013, Texas Instruments Incorporated
www.ti.comSDOCM00086405 — Fapi_UserDefinedFunctions.c needs FSM unlock/lock sequence for FSM_SECTOR/1/2writesSDOCM00086405Fapi_UserDefinedFunctions.c needs FSM unlock/lock sequence for
FSM_SECTOR/1/2 writesSeverityS3 - Minor
Expected BehaviorSet sectors enabled for programming and erasing.
IssueThe example versions of the user defined functions Fapi_setupEepromSectorEnable()
and Fapi_setupBankSectorEnable() does not show unlock the registers
FSM_SECTOR/1/2.
ConditionsWhen trying to do an erase a bank after it has already been erased once after power on
reset.
ImplicationsThe bank will not erase.
Workaround(s)As this is intended for the customer to modify, the unlock code can be added by them.
Fapi_GlobalInit.m_poFlashControlRegisters-
>FsmWrEna.FSM_WR_ENA_BITS.WR_ENA
= 0x5U;
/* Unlock the regtisters */
Fapi_GlobalInit.m_poFlashControlRegisters-
>FsmWrEna.FSM_WR_ENA_BITS.WR_ENA
= 0x2U; /* Lock the registers */
SPNZ210 – July 2013
Hercules™ F021 Flash API7
Submit Documentation FeedbackCopyright © 2013, Texas Instruments Incorporated
SDOCM00094147 — Incorrect read in Verify functions in ECC regions on LE deviceswww.ti.comSDOCM00094147Incorrect read in Verify functions in ECC regions on LE devicesSeverityS2 - Major
Expected BehaviorVerification will work on ECC regions on Little Endian devices.
IssueThe read functions, Fapi_doVerify(), Fapi_doPsaVerify(), and Fapi_calculatePsa() will fail
on Little Endian devices in the ECC regions do to a byte swap issue.
ConditionsWhen trying to use the functions Fapi_doVerify(), Fapi_doPsaVerify(), and
Fapi_calculatePsa() on ECC regions on Little Endian devices.
ImplicationsThis will cause false failures for Fapi_doVerify() and Fapi_doPsaVerify() and cause
incorrect return value for Fapi_calculatePsa() on ECC regions on Little Endian devices.
Workaround(s)For the function Fapi_doVerify(), use the byte variant Fapi_doVerifyByByte().
For the functions Fapi_doPsaVerify() and Fapi_calculatePsa(), none.
8
Hercules™ F021 Flash APISPNZ210 – July 2013
Submit Documentation FeedbackCopyright © 2013, Texas Instruments Incorporated
www.ti.comSDOCM00102084 — Typo in CGT.CCS.H in GNU attribute checkSDOCM00102084Typo in CGT.CCS.H in GNU attribute checkSeverityS3 - Minor
Expected Behaviorif --gcc option is enabled, ATTRIBUTE_PACKED will be defined.
IssueIn this code segment in CGT.CCS.h, __TI_GNU_ATTRIBUTE_SUPPORT__ is missing
the R:
#if defined(__TI_GNU_ATTIBUTE_SUPPORT__)
/* --gcc option enabled so we can specify this */
#define ATTRIBUTE_PACKED
__attribute__((packed))
#else
ConditionsOn CCS compilers, ATTRIBUTE_PACKED will always be an empty definition.
ImplicationsOn builds expecting --gcc option to use attributes defined in code, enums will not be
packed if the compile option to pack enums is not explicitly set.
Workaround(s)Add the R to __TI_GNU_ATTIBUTE_SUPPORT__.
SPNZ210 – July 2013
Hercules™ F021 Flash API9
Submit Documentation FeedbackCopyright © 2013, Texas Instruments Incorporated
SDOCM00102399 — FEDACSDIS and FEDACSDIS2 are missing from Fapi_FmcRegistersType definitionwww.ti.comSDOCM00102399FEDACSDIS and FEDACSDIS2 are missing from Fapi_FmcRegistersType definitionSeverityS3 - Minor
Expected BehaviorIt is expected theat Fapi_FmcRegistersType contains all registers defined in the devices
TRM and SPNA148/
IssueIn the register update for v2.00.00, these registers were unintentionally removed.
ConditionsThe registers do not exist in the Fapi_FmcRegistersType.
ImplicationsUser cannot reference the FEDACSDIS and FEDACSDIS2 registers through the API
reference.
Workaround(s)Directly address the registers.
10
Hercules™ F021 Flash APISPNZ210 – July 2013
Submit Documentation FeedbackCopyright © 2013, Texas Instruments Incorporated
IMPORTANT NOTICETexas Instruments Incorporated and its subsidiaries (TI) reserve the right to make corrections, enhancements, improvements and other
changes to its semiconductor products and services per JESD46, latest issue, and to discontinue any product or service per JESD48, latest
issue. Buyers should obtain the latest relevant information before placing orders and should verify that such information is current and
complete. All semiconductor products (also referred to herein as “components”) are sold subject to TI’s terms and conditions of sale
supplied at the time of order acknowledgment.
TI warrants performance of its components to the specifications applicable at the time of sale, in accordance with the warranty in TI’s terms
and conditions of sale of semiconductor products. Testing and other quality control techniques are used to the extent TI deems necessary
to support this warranty. Except where mandated by applicable law, testing of all parameters of each component is not necessarily
performed.
TI assumes no liability for applications assistance or the design of Buyers’ products. Buyers are responsible for their products and
applications using TI components. To minimize the risks associated with Buyers’ products and applications, Buyers should provide
adequate design and operating safeguards.
TI does not warrant or represent that any license, either express or implied, is granted under any patent right, copyright, mask work right, or
other intellectual property right relating to any combination, machine, or process in which TI components or services are used. Information
published by TI regarding third-party products or services does not constitute a license to use such products or services or a warranty or
endorsement thereof. Use of such information may require a license from a third party under the patents or other intellectual property of the
third party, or a license from TI under the patents or other intellectual property of TI.
Reproduction of significant portions of TI information in TI data books or data sheets is permissible only if reproduction is without alteration
and is accompanied by all associated warranties, conditions, limitations, and notices. TI is not responsible or liable for such altered
documentation. Information of third parties may be subject to additional restrictions.
Resale of TI components or services with statements different from or beyond the parameters stated by TI for that component or service
voids all express and any implied warranties for the associated TI component or service and is an unfair and deceptive business practice.
TI is not responsible or liable for any such statements.
Buyer acknowledges and agrees that it is solely responsible for compliance with all legal, regulatory and safety-related requirements
concerning its products, and any use of TI components in its applications, notwithstanding any applications-related information or support
that may be provided by TI. Buyer represents and agrees that it has all the necessary expertise to create and implement safeguards which
anticipate dangerous consequences of failures, monitor failures and their consequences, lessen the likelihood of failures that might cause
harm and take appropriate remedial actions. Buyer will fully indemnify TI and its representatives against any damages arising out of the use
of any TI components in safety-critical applications.
In some cases, TI components may be promoted specifically to facilitate safety-related applications. With such components, TI’s goal is to
help enable customers to design and create their own end-product solutions that meet applicable functional safety standards and
requirements. Nonetheless, such components are subject to these terms.
No TI components are authorized for use in FDA Class III (or similar life-critical medical equipment) unless authorized officers of the parties
have executed a special agreement specifically governing such use.
Only those TI components which TI has specifically designated as military grade or “enhanced plastic” are designed and intended for use in
military/aerospace applications or environments. Buyer acknowledges and agrees that any military or aerospace use of TI components
which have
not been so designated is solely at the Buyer's risk, and that Buyer is solely responsible for compliance with all legal and
regulatory requirements in connection with such use.
TI has specifically designated certain components as meeting ISO/TS16949 requirements, mainly for automotive use. In any case of use of
non-designated products, TI will not be responsible for any failure to meet ISO/TS16949.
ProductsApplicationsAudio
www.ti.com/audioAutomotive and Transportation
www.ti.com/automotiveAmplifiers
amplifier.ti.comCommunications and Telecom
www.ti.com/communicationsData Converters
dataconverter.ti.comComputers and Peripherals
www.ti.com/computersDLP® Products
www.dlp.comConsumer Electronics
www.ti.com/consumer-appsDSP
dsp.ti.comEnergy and Lighting
www.ti.com/energyClocks and Timers
www.ti.com/clocksIndustrial
www.ti.com/industrialInterface
interface.ti.comMedical
www.ti.com/medicalLogic
logic.ti.comSecurity
www.ti.com/securityPower Mgmt
power.ti.comSpace, Avionics and Defense
www.ti.com/space-avionics-defenseMicrocontrollers
microcontroller.ti.comVideo and Imaging
www.ti.com/videoRFID
www.ti-rfid.comOMAP Applications Processors
www.ti.com/omapTI E2E Communitye2e.ti.comWireless Connectivity
www.ti.com/wirelessconnectivityMailing Address: Texas Instruments, Post Office Box 655303, Dallas, Texas 75265
Copyright © 2013, Texas Instruments Incorporated
Document Outline