Library for the Data Flash Access Layer 32-/16-bit Single
Contents
1. NEC User s Manual Library for the Data Flash Access Layer 32 16 bit Single Chip Microcontroller Document No U18400EE1VOUMOO Date Published September 2006 NEC Electronics Corporation 2006 Printed in Germany NOTES FOR CMOS DEVICES VOLTAGE APPLICATION WAVEFORM AT INPUT PIN Waveform distortion due to input noise or a reflected wave may cause malfunction If the input of the CMOS device stays in the area between Vit MAX and Vin MIN due to noise etc the device may malfunction Take care to prevent chattering noise from entering the device when the input level is fixed and also in the transition period when the input level passes through the area between ViL MAX and Vin MIN HANDLING OF UNUSED INPUT PINS Unconnected CMOS device inputs can be cause of malfunction If an input pin is unconnected it is possible that an internal input level may be generated due to noise etc causing malfunction CMOS devices behave differently than Bipolar or NMOS devices Input levels of CMOS devices must be fixed high or low by using pull up or pull down circuitry Each unused pin should be connected to Voo or GND via a resistor if there is a possibility that it will be an output pin All handling related to unused pins must be judged separately for each device and according to related specifications governing the device PRECAUTION AGAINST ESD A strong electric field when exposed to a MOS device can cause destruction of the gate2. 1 block 2 blocks 4 blocks 8 blocks 1 block 2 blocks Blank Check 4 blocks 8 blocks 1 block 1st word fail Blank Check Backwards 1 block 1st word found found on 1000h found on 2000h not found 0x4000 Verify Data Search Note Write fail measurement with max specified retries User s Manual U18400EE1VOUMOO MEMO 24 User s Manual U18400EE1VOUMOO
3. NEC Electronics products listed in this document or any other liability arising from the use of such products No license express implied or otherwise is granted under any patents copyrights or other intellectual property rights of NEC Electronics or others Descriptions of circuits software and other related information in this document are provided for illustrative purposes in semiconductor product operation and application examples The incorporation of these circuits software and information in the design of a customer s equipment shall be done under the full responsibility of the customer NEC Electronics assumes no responsibility for any losses incurred by customers or third parties arising from the use of these circuits software and information While NEC Electronics endeavors to enhance the quality reliability and safety of NEC Electronics products customers agree and acknowledge that the possibility of defects thereof cannot be eliminated entirely To minimize risks of damage to property or injury including death to persons arising from defects in NEC Electronics products customers must incorporate sufficient safety measures in their design such as redundancy fire containment and anti failure features NEC Electronics products are classified into the following three quality grades Standard Special and Specific The Specific quality grade applies only to NEC Electronics products developed based on a customer designated
4. address information bits 8 31 and the macro DFALIB_GETERR to extract the error information bits 0 7 User s Manual U18400EE1VOUMOO 19 Chapter 3 DFALib API 3 2 7 Status Check Library call u32 DFALib_StatusCheck void Function description Performs a check on the status of the ongoing Flash operation Required parameters none Returned value The returned value consists of two parts bit 0 7 contain the status itself whereas bits 8 31 contains an address DFALIB_OK No error occurred and the operation of which the status has been checked completed successfully Please refer to the description of the function which initiated the operation to determine the status of the address part DFALIB_BUSY The operation of which the status has been checked is not yet finished and further status checks are required The address part does not contain valid data DFALIB_ERR_FLASHPROCn n 0x00 0x04 The operation of which the status has been checked finished with an error The address part contains the address at which the operation failed Please refer to the description of the function which initiated the operation to determine the status of the address part The header file DFALib h provides macro definitions to extract the address and the error information from the return value Use the macro DFALIB_GETADD to extract the address information bits 8 31 and the macro DFALIB_GETERR to extract the error information bit
5. the macro DFALIB_GETADD to extract the address information bits 8 31 and the macro DFALIB_GETERR to extract the error information bits 0 7 18 User s Manual U18400EE1VOUMOO 3 2 6 Erase Library call u32 DFALib_Erase Function description Chapter 3 DFALib API u32 blockNoStart u32 blockNoEnd Erases the blocks defined by the parameter of the function Required parameters blockNoStart blockNoEnd Returned value DFALIB_OK DFALIB_ERR_FLOW DFALIB_ERR_PARAMETER This is the block number number of the block within the Data Flash e g 0 at which the erase starts Block number up to which including this block the erase opera tion should be performed Bits 0 7 return the following errorcodes while the bits 8 31 are undefined The returned value indicates that the background operation is started lt does not show the status of the operation itself as this will be returned by the DFALib_StatusCheck command only A previous flash operation is not yet finished Please call the DAFLIB_StatusCheck command until the flash operation is fin ished then start the new flash operation The call parameter does not contain valid data A wrong combination of start and end block is being used The call parameter does not contain valid data The header file DFALib h provides macro definitions to extract the address and the error information from the return value Use the macro DFALIB_GETADD to extract the
6. afe mode must not be applied as it will leave the flash in an undefined state when the clock is stopped For details on the power safe modes please refer to the appropriate chapter of the device UM Caution Please read all chapters of the users manual carefully and follow exactly the given sequences and recommendations This is required in order to make full use of the high level of security and safety provided by the devices 10 User s Manual U18400EE1VOUMO0 Chapter 2 DFALib Usage 2 1 Status check Background operation As the Flash operations take some time a dedicated hardware will automatically perform the required tasks in the background without CPU interaction required However it has to be checked if those oper ations are finished This check has to be performed by the application The DFALib functions will return immediately after the Flash operation was initiated allowing the user to perform other tasks while the flash operation is being executed in background by dedicated hardware In order to check the status of the operation the DFALib_StatusCheck 3 2 7 Status Check on page 20 command has to be used Note The device internal hardware will ensure the Flash is in a safe state after the operation was finished Thus there are no timing requirements on the usage of the status check Figure 2 1 Principle Flow of a DFALib Function Call E g DFALib_Write addSrc addDest length End return error Re
7. corresponding bit of the ID those ID bits are compared during the search whereas bits which equal 1 mask the corresponding ID bits and prohibits a comparison of those ID bits User s Manual U18400EE1VOUMOO Chapter 3 DFALib API Returned value Bits 0 7 return the following errorcodes while the bits 8 31 are undefined DFALIB_OK The returned value indicates that the background operation is started It does not show the status of the operation itself as this will be returned by the DFALib_StatusCheck command only DFALIB_ERR_FLOW A previous flash operation is not yet finished Please call the DAFLIB_StatusCheck command until the flash operation is fin ished then start the new flash operation The call parameter does not contain valid data DFALIB_ERR_PARAMETER A wrong combination of start and end block is being used The call parameter does not contain valid data The header file DFALib h provides macro definitions to extract the address and the error information from the return value Use the macro DFALIB_GETADD to extract the address information bits 8 31 and the macro DFALIB_GETERR to extract the error information bits 0 7 3 2 4 Write Library call u32 DFALib_Write void addSrc void addDest u32 length Function description Data can be written in series of 1 or 4 words In case the number of words to be written is 1 a single write operation is performed 4 words are written sequentially In case of 0 le
8. ddress information bits 8 31 and the macro DFALIB_GETERR to extract the error information bits 0 7 User s Manual U18400EE1VOUMOO 15 3 2 3 ID Search Chapter 3 DFALib API This function is only available on Data Flash Library call u32 DFALib_SearchlD Function description u32 startBlk u32 endBlk u32 ID u32 mask The given ID value is searched within the address range defined by start and end block The search operation stops at the first match where the ID and the ID_Tag match The mask allows to limit the compare operation to a chosen number of bits Example With an ID 0xD D7D3D D5Dg D7Dg and a mask OxOOOOFFFF data of the structure 0xD D5D3D4xxxx and a written ID Tag would be found with D representing a defined value of 4 bit and x any value Figure 3 1 Principle of the ID Search Function 87654321h 12345678h 12345678h 12345678h ABCDEFOOh AB45278Fh Only on these addresses the value overlayed by the mask is compared with the ID Required parameters startBlk endBlk ID mask 16 This is the block number number of the block within the Data Flash e g 0 at which the ID search starts Block number up to which including this block the ID search operation should be performed Defines the ID which is being searched Only bits which are not masked by the mask parameter are relevant for the search Mask for the ID Bits which equal 0 unmask the
9. ena 9 1 2 Application Note c osi si ai pa A a Sa 9 1 3 Internal Verify ccc caza oara ca a AA A a aaa eA ee 9 1 4 Limitations cc 2 3 ie ae ee ea a Sa at a e at Sa a ie eee a la e ee aa 10 Chapter 2 DFALib Usage n sine te ac aa ai ca ea a a ia a e 11 2 1 Status check Background operation mean eee 11 2 2 Data Flash Interrupt ccn eee eee enma eee eens 12 2 3 Library Software ia resah bet eee oaia Be ee ae eee ncat a E ata ed 12 2 3 1 Supported compilers 0 00 ccc tenes 12 2 3 2 Files required for the DFALID 0 0 ea 12 2 4 Section Handling eee eee eee mame nana ana 12 Chapter 3 DEALID API sasea RRA RAR a a Ba ala 2436 13 9 1 A E E AAA ariei Baa n aria ioan E EP oa aia o zi load ee Ola ta An 13 3 2 Operational Functions nenea ee 14 3 2 1 Blank Check Backwards ccn e 14 3 2 2 Blank Chekenn enny aci aa ae ons ed Aa ea E EATA tees 15 3 2 3 ISR ms se ie ha ine atac De ee ot pata aia ae tea a ta a aca 16 3 2 4 NO 17 3 2 5 Internal Verify cats teas eine senha ea E ge de Deta e Adee ee te 18 3 2 6 Erase in dena A aoe te ede A eee aa da 19 3 2 7 status Check sind sc rita E tea a boo whet eed Ge atat d 20 3 3 Service FUNCtIONS di Se ne Sas tee oR oie e Tees ate vee 21 3 3 1 Library Version tiara Gage Pe a A ui a Sa Pe Mew a 21 Chapter 4 Electrical Specification 000 cece eee 23 User s Manual U18400EE1VOUMOO 7 F
10. igure 2 1 Figure 3 1 List of Figures Principle Flow of a DFALib Function Call mm neam aaa aa Principle of the ID Search Function mmm enma ana enma aa User s Manual U18400EE1VOUMOO Chapter1 Overview This document describes the usage of the Library for the Data Flash Access Layer DFALib for NEC s microcontroller with embedded single voltage data flash In order to perform low level operation erase write on this data flash NEC offers the data flash access layer software DFALib Using this DFALib also higher sophisticated EEPROM emulation can be realized NEC has prepared an application note U18005EE1V1ANO0 to provide an example how such an EEPROM emulation could be done Anyhow also other customer approaches can be realized based on this DFALib considering the specified data flash features and operating conditions 1 1 Naming Convention Data Flash A dedicated flash macro including features supporting efficient EEPROM emulation Data Word A data word always refers to a 32 bit value as this is the smallest write unit ID_Tag The ID_Tag is an additional information stored in a separate area of the data flash It consists of a single bit This ID_Tag assists the hardware supported search for these data words provided by the data flash For each data word in the Data Flash an ID_Tag exist Those ID_Tags can be set independently of each other DFALib Software layer performing the basic
11. n the Data Flash at which the blank check should start Bits 0 7 return the following errorcodes while the bits 8 31 are undefined The returned value indicates that the background operation is started It does not show the status of the operation itself as this will be returned by the DFALib_StatusCheck command only A previous flash operation is not yet finished Please call the DAFLIB_StatusCheck command until the flash operation is fin ished then start the new flash operation The call parameter does not contain valid data The call parameter does not contain valid data The header file DFALib h provides macro definitions to extract the address and the error information from the return value Use the macro DFALIB_GETADD to extract the address information bits 8 31 and the macro DFALIB_GETERR to extract the error information bits 0 7 User s Manual U18400EE1VOUMOO 3 2 2 Blank Check Library call u32 DFALib_BlankCheck Function description Chapter 3 DFALib API u32 blockNoStart u32 blockNoEnd u32 offset Checks if the blocks defined by the parameter of the function call are blank The blank check opera tion starts at the lower most address and continues with increasing addresses e g address O gt address 4 gt address 8 Note The Blank Check Backwards 3 2 1 Blank Check Backwards on page 14 shall be used to find out if a given range of the flash is blank The DFALib_BlankCheck is implemen
12. ngth the 32 data bits are written in one step automatically followed by the write of the ID Tag Required parameters addSrc Source address of data to be written to the Flash addDest Destination address in Flash at which the data are to be written The address is the offset in the Flash itself thus for Data Flash the lower most address is 0x00000000 length Number of words to be written The write size for Data without ID_Tag has to be either 1 or 4 words If a data word with ID_Tag is to be written the size passed to the function has to be O This will then write 1 data word with the ID_Tag User s Manual U18400EE1VOUMOO 17 Returned value DFALIB_OK DFALIB_ERR_FLOW DFALIB_ERR_PARAMETER Chapter 3 DFALib API Bits 0 7 return the following errorcodes while the bits 8 31 are undefined The returned value indicates that the background operation is started It does not show the status of the operation itself as this will be returned by the DFALib_StatusCheck command only A previous flash operation is not yet finished Please call the DAFLIB_StatusCheck command until the flash operation is fin ished then start the new flash operation The call parameter does not contain valid data The call parameter does not contain valid data The header file DFALib h provides macro definitions to extract the address and the error information from the return value Use the macro DFALIB_GETADD to extract the address information bi
13. nics Taiwan Ltd 7F No 363 Fu Shing North Road Taipei Taiwan R O C Tel 02 8175 9600 http www tw necel com NEC Electronics Singapore Pte Ltd 238A Thomson Road 12 08 Novena Square Singapore 307684 Tel 6253 8311 http www sg necel com G06 8A All other product brand or trade names used in this pamphlet are the trademarks or registered trademarks of their respective owners Product specifications are subject to change without notice To ensure that you have the latest product data please contact your local NEC Electronics sales office User s Manual U18400EE1VOUMOO The information in this document is current as of September 2006 The information is subject to change without notice For actual design in refer to the latest publications of NEC Electronics data sheets or data books etc for the most up to date specifications of NEC Electronics products Not all products and or types are available in every country Please check with an NEC Electronics sales representative for availability and additional information No part of this document may be copied or reproduced in any form or by any means without the prior written consent of NEC Electronics NEC Electronics assumes no responsibility for any errors that may appear in this document NEC Electronics does not assume any liability for infringement of patents copyrights or other intellectual property rights of third parties by or arising from the use of
14. operation of the data flash 1 2 Application Note The application note of the EEPROM emulation is prepared to support the development environments of the companies Green Hills GHS IAR and NEC It includes the source code of the DFALib together with the EEEPROM Emulation library EEELib and applications programs using an installer tool allow ing to select the appropriate environment 1 3 Internal Verify The internal verify is a function to check the condition of all flash cells within the checked range margin check If an internal verify passes successfully the full specified data retention is ensured under the specified operating conditions It is important to notice that this function does not actively modify the conditions of the flash cells but only confirms the correct status Note As the execution time of this function during which the Data Flash is not accessible is rather long it is desired to have as few as possible internal verify operation Also as the EEPROM emulation is causing a frequent rewrite of the data sets the data will not reach an age as it would be the case for program code Due to those conditions a different implementation of the internal verify might be chosen For support on finding an optimized implementation of the internal verify please contact the NEC support at flash_support eu necel com User s Manual U18400EE1VOUMOO 9 Chapter1 Overview 1 4 Limitations e During data flash operation power s
15. orts compilers from GHS IAR and NEC Pre compiled libraries according to this document are compiled and tested with one dedicated compiler version and dedicated compiler switches that are explicitly listed up in the release package The user application must be compiled according not to interfere with these settings 2 3 2 Files required for the DFALib root nec_types h NEC types convention DFALib h Header file containing function prototypes and error definitions DFALib DFALib o Precompiled DFALib object file The source code of the DFALib will be provided as an application note Please refer to 1 2 Application Note on page 9 for details 2 4 Section Handling The following sections are DFA library related e DFALib_ Text DFALib_TextRAM This is DFALib code This section is executed from code flash Note The above named section have to be added to the projects linker file 12 Users Manual U18400EE1VOUMOO Chapter 3 DFALib API The Data Flash Access library provides two types of user functions e Operational functions Operational functions control the basic flash operations like Read Write Blankcheck e Service functions Providing service information to the user 3 1 Used Types The available error states are Error Name Description The returned value indicates that the background operation is started It DFALIB_OK does not show the status of the operation itself as this will be returned by the DFALib_Stat
16. over Office Podbielskistrasse 166 B 30177 Hannover Tel 0511 33 40 2 0 Munich Office Werner Eckert Strasse 9 81829 Munchen Tel 0 89 92 10 03 0 Stuttgart Office Industriestrasse 3 70565 Stuttgart Tel 0 711 99 01 0 0 United Kingdom Branch Cygnus House Sunrise Parkway Linford Wood Milton Keynes MK14 6NP U K Tel 01908 691 133 Succursale Francaise 9 rue Paul Dautier B P 52180 78142 Velizy Villacoublay C dex France Tel 01 3067 5800 Sucursal en Espa a Juan Esplandiu 15 28007 Madrid Spain Tel 091 504 2787 Tyskland Filial Taby Centrum Entrance S 7th floor 18322 T by Sweden Tel 08 638 72 00 Filiale Italiana Via Fabio Filzi 25 A 20124 Milano Italy Tel 02 667541 Branch The Netherlands Steijgerweg 6 5616 HS Eindhoven The Netherlands Tel 040 265 40 10 Asia amp Oceania NEC Electronics China Co Ltd 7th Floor Quantum Plaza No 27 ZhiChunLu Haidian District Beijing 100083 P R China Tel 010 8235 1155 http www cn necel com NEC Electronics Shanghai Ltd Room 2509 2510 Bank of China Tower 200 Yincheng Road Central Pudong New Area Shanghai P R China P C 200120 Tel 021 5888 5400 http www cn necel com NEC Electronics Hong Kong Ltd 12 F Cityplaza 4 12 Taikoo Wan Road Hong Kong Tel 2886 9318 http www hk necel com Seoul Branch 11F Samik Lavied or Bldg 720 2 Yeoksam Dong Kangnam Ku Seoul 135 080 Korea Tel 02 558 3737 NEC Electro
17. oxide and ultimately degrade the device operation Steps must be taken to stop generation of static electricity as much as possible and quickly dissipate it when it has occurred Environmental control must be adequate When it is dry a humidifier should be used It is recommended to avoid using insulators that easily build up static electricity Semiconductor devices must be stored and transported in an anti static container static shielding bag or conductive material All test and measurement tools including work benches and floors should be grounded The operator should be grounded using a wrist strap Semiconductor devices must not be touched with bare hands Similar precautions need to be taken for PW boards with mounted semiconductor devices STATUS BEFORE INITIALIZATION Power on does not necessarily define the initial status of a MOS device Immediately after the power source is turned ON devices with reset functions have not yet been initialized Hence power on does not guarantee output pin levels I O settings or contents of registers A device is not initialized until the reset signal is received A reset operation must be executed immediately after power on for devices with reset functions POWER ON OFF SEQUENCE In the case of a device that uses different power supplies for the internal operation and external interface as a rule switch on the external power supply after switching on the internal power supply When switching the power s
18. quality assurance program for a specific application The recommended applications of an NEC Electronics product depend on its quality grade as indicated below Customers must check the quality grade of each NEC Electronics product before using it in a particular application Standard Computers office equipment communications equipment test and measurement equipment audio and visual equipment home electronic appliances machine tools personal electronic equipment and industrial robots Special Transportation equipment automobiles trains ships etc traffic control systems anti disaster systems anti crime systems safety equipment and medical equipment not specifically designed for life support Specific Aircraft aerospace equipment submersible repeaters nuclear reactor control systems life support systems and medical equipment for life support etc The quality grade of NEC Electronics products is Standard unless otherwise expressly specified in NEC Electronics data sheets or data books etc If customers wish to use NEC Electronics products in applications not intended by NEC Electronics they must contact an NEC Electronics sales representative in advance to determine NEC Electronics willingness to support a given application Note 1 NEC Electronics as used in this statement means NEC Electronics Corporation and also includes its majority owned subsidiaries 2 NEC Electronics products means any p
19. roduct developed or manufactured by or for NEC Electronics as defined above M8E 02 11 1 User s Manual U18400EE1VOUMOO Readers Purpose Organization Legend Introduction This Users Manual is intended for users who want to understand the func tionality of the Library for the Data Flash Access Layer for devices of the V850 core family This User s Manual explains the background and handling of the Library for the Data Flash Access Layer This User s Manual contains the major sections e Data Flash Access Library Usage e Data Flash Access Library API Symbols and notation are used as follows Weight in data notation Left is high order column right is low order column Active low notation xxx pin or signal name is over scored or xxx slash before signal name Memory map address High order at high stage and low order at low stage Note Explanation of Note in the text Caution Information requiring particular attention Remark Supplementary explanation to the text Numeric notation Binary XXXX or XXXB Decimal XXXX Hexadecimal XXXXH or Ox XXXX Prefixes representing powers of 2 address space memory capacity K kilo 210 1024 M mega 220 1024 1 048 576 G giga 2 1024 1 073 741 824 User s Manual U18400EE1VOUMOO 5 User s Manual U18400EE1VOUMOO Table of Contents Chapter 1 OVervieW voii o A epee eee 9 1 1 NamingConventi0N oocoococcocnnn eee eee ame aane
20. s 0 7 Notes 1 20 Each function can only be completed during the execution of the DFALib_StatusCheck thus it is mandatory to execute this command after each function except DFALib_LibVersion The DFALib_StatusCheck has to be called as long as the flash programming hardware is operating and the return value is DFALIB_BUSY As soon as the operation is finished the next DFALib_StatusCheck will return the result of the operation and also automatically reset the flash programming hardware The user appli cation has to use this return value as any further DFALib_StatusCheck will not return the status of the operation anymore since the hardware has been reset by the previous function call User s Manual U18400EE1VOUMOO Chapter 3 DFALib API 3 3 Service Functions 3 3 1 Library Version Library call u32 DFALib_LibVersion void Function description This function returns the version of the library Required parameters none Returned value u32 Version of the library User s Manual U18400EE1VOUMOO 21 MEMO 22 User s Manual U18400EE1VOUMOO Chapter 4 Electrical Specification Timing Characteristics Ta 40 to 125 C Vop EVpp BVpp 4 0 lt AVpero lt 5 5 V Ves EVgs BVes AVss 0 V C 50 pF fxx 48 MHz Parameter Conditions 1block 2 blocks 4 blocks 8 blocks 1 word pass 4 words pass 1 word fail Note 4 words last word fail Note
21. ted for using in a reasonable time frame after erase operation After that the Blank Check may fail Required parameters blockNoStart blockNoEnd offset Returned value DFALIB_OK DFALIB_ERR_FLOW DFALIB_ERR_PARAMETER This is the block number number of the blocks within the Data Flash e g 0 at which the blank check starts Block number up to which including this block the blank check operation shall be performed Offset is an word boundary address within the give block range at which the blank check should start This parameter is useful to determine if the Flash is still empty above from address point of view a given address where data have already been written Bits 0 7 return the following errorcodes while the bits 8 31 are undefined The returned value indicates that the background operation is started lt does not show the status of the operation itself as this will be returned by the DFALib_StatusCheck command only A previous flash operation is not yet finished Please call the DAFLIB_StatusCheck command until the flash operation is fin ished then start the new flash operation The call parameter does not contain valid data A wrong combination of start and end block is being used The call parameter does not contain valid data The header file DFALib h provides macro definitions to extract the address and the error information from the return value Use the macro DFALIB_GETADD to extract the a
22. ts 8 31 and the macro DFALIB_GETERR to extract the error information bits 0 7 3 2 5 Internal Verify Library call u32 DFALib_IVerify Function description u32 blockNoStart u32 blockNoEnd Performs an internal verify on the specified blocks The internal verify checks if all flash cells within the blocks still have enough read margin to have the full specified data retention time Required parameters blockNoStart blockNoEnd Returned value DFALIB_OK DFALIB_ERR_FLOW DFALIB_ERR_PARAMETER This is the block number number of the block within the Data Flash e g 0 at which the internal verify starts Block number up to which including this block the internal verify operation should be performed Bits 0 7 return the following errorcodes while the bits 8 31 are undefined The returned value indicates that the background operation is started It does not show the status of the operation itself as this will be returned by the DFALib_StatusCheck command only A previous flash operation is not yet finished Please call the DAFLIB_StatusCheck command until the flash operation is fin ished then start the new flash operation The call parameter does not contain valid data A wrong combination of start and end block is being used The call parameter does not contain valid data The header file DFALib h provides macro definitions to extract the address and the error information from the return value Use
23. turn value DFALIB_OK E g DFALib_StatusCheck Return value DFALIB_BUSY End return error Return value DFALIB_OK End return OK User s Manual U18400EE1VOUMOO 11 Chapter 2 DFALib Usage 2 2 Data Flash Interrupt In polling mode the DFALib_StatusCheck is frequently called by the application With support of the device specific interrupt upon data flash operation completion that frequent call to the DFALib_StatusCheck is not necessary as the DFALib_StatusCheck should be called in the interrupt context Note For details on the interrupt please refer to the appropriate chapter of the device The availability of the interrupt depends on the delivery package s compile options 2 3 Library Software The DFALib is delivered as a pre compiled version Due to that some compile time configurations in the sourcecode are fixed Configuration Description The Flash background operations e g Flash erase need some time DFALib Status check Before continuing with any Flash related operation the SW need to check the end of the Flash operation The Flash block size of the used device is set with this parameter Current implementations is 2 kBytes 0x800 DFALIB_FLASH_BLOCK_SIZE Please check the delivery package regarding the setting of these configurations Please also refer to the application note of the DFALib 2 3 1 Supported compilers General code from the application note supp
24. upply off as a rule switch off the external power supply and then the internal power supply Use of the reverse power on off sequences may result in the application of an overvoltage to the internal elements of the device causing malfunction and degradation of internal elements due to the passage of an abnormal current The correct power on off sequence must be judged separately for each device and according to related specifications governing the device INPUT OF SIGNAL DURING POWER OFF STATE Do not input signals or an I O pull up power supply while the device is not powered The current injection that results from input of such a signal or I O pull up power supply may cause malfunction and the abnormal current that passes in the device at this time may cause degradation of internal elements Input of signals during the power off state must be judged separately for each device and according to related specifications governing the device User s Manual U18400EE1VOUMOO For further information please contact NEC Electronics Corporation 1753 Shimonumabe Nakahara ku Kawasaki Kanagawa 211 8668 Japan Tel 044 435 5111 http www necel com America NEC Electronics America Inc 2880 Scott Blvd Santa Clara CA 95050 2554 U S A Tel 408 588 6000 800 366 9782 http www am necel com Europe NEC Electronics Europe GmbH Arcadiastrasse 10 40472 Dusseldorf Germany Tel 0211 65030 http www eu necel com Han
25. usCheck command only A previous flash operation is not yet finished Please call the DFALIB_ERR_FLOW DAFLIB_StatusCheck command until the flash operation is finished then start the new flash operation DFALIB_ERR_PARAMETER The call parameter does not contain valid data The operation of which the status has been checked is not yet finished DFALIB_BUSY and further status checks are required The address part does not contain valid data n 0x00 0x04 The operation of which the status has been checked fin ished with an error DFALIB_ERR_FLASHPROCn The address part contains the address at which the operation failed Please refer to the description of the function which initiated the operation to determine the status of the address part User s Manual U18400EE1VOUMOO 13 3 2 Operational Functions 3 2 1 Blank Check Backwards Library call u32 DFALib_BlankCheckBW Function description Checks if a single block is blank The checked area is calculated based on the passed address The blank check starts at the given address and continues on decreasing address until the beginning of the block is reached or a non blank word is detected e g with address 8 the following addresses would be checked Chapter 3 DFALib API u32 startAdd address 8 gt address 4 gt address 0 Required parameters startAdd Returned value 14 DFALIB_OK DFALIB_ERR_FLOW DFALIB_ERR_PARAMETER Address withi
Download Pdf Manuals
Related Search