/*-----------------------------------------------------------------------------*/ /* */ /* Copyright (C) 1999-2000 by Texas Instruments, Inc. All rights reserved. */ /* */ /* IMPORTANT - READ CAREFULLY BEFORE PROCEEDING TO USE SOFTWARE. */ /* */ /* This document is displayed for you to read prior to using the software */ /* and documentation. By using the software and documentation, or opening */ /* the sealed packet containing the software, or proceeding to download the */ /* software from a Bulletin Board System(BBS) or a WEB Server, you agree to */ /* abide by the following Texas Instruments License Agreement. If you choose */ /* not to agree with these provisions, promptly discontinue use of the */ /* software and documentation and return the material to the place you */ /* obtained it. */ /* */ /* *** NOTE *** */ /* */ /* The licensed materials contain MIPS Technologies, Inc. confidential */ /* information which is protected by the appropriate MIPS Technologies, Inc. */ /* license agreement. It is your responsibility to comply with these */ /* licenses. */ /* */ /* Texas Instruments License Agreement */ /* */ /* 1. License - Texas Instruments (hereinafter "TI"), grants you a license */ /* to use the software program and documentation in this package ("Licensed */ /* Materials") for Texas Instruments broadband products. */ /* */ /* 2. Restrictions - You may not reverse-assemble or reverse-compile the */ /* Licensed Materials provided in object code or executable format. You may */ /* not sublicense, transfer, assign, rent, or lease the Licensed Materials */ /* or this Agreement without written permission from TI. */ /* */ /* 3. Copyright - The Licensed Materials are copyrighted. Accordingly, you */ /* may either make one copy of the Licensed Materials for backup and/or */ /* archival purposes or copy the Licensed Materials to another medium and */ /* keep the original Licensed Materials for backup and/or archival purposes. */ /* */ /* 4. Runtime and Applications Software - You may create modified or */ /* derivative programs of software identified as Runtime Libraries or */ /* Applications Software, which, in source code form, remain subject to this */ /* Agreement, but object code versions of such derivative programs are not */ /* subject to this Agreement. */ /* */ /* 5. Warranty - TI warrants the media to be free from defects in material */ /* and workmanship and that the software will substantially conform to the */ /* related documentation for a period of ninety (90) days after the date of */ /* your purchase. TI does not warrant that the Licensed Materials will be */ /* free from error or will meet your specific requirements. */ /* */ /* 6. Remedies - If you find defects in the media or that the software does */ /* not conform to the enclosed documentation, you may return the Licensed */ /* Materials along with the purchase receipt, postage prepaid, to the */ /* following address within the warranty period and receive a refund. */ /* */ /* TEXAS INSTRUMENTS */ /* Application Specific Products, MS 8650 */ /* c/o ADAM2 Application Manager */ /* 12500 TI Boulevard */ /* Dallas, TX 75243 - U.S.A. */ /* */ /* 7. Limitations - TI makes no warranty or condition, either expressed or */ /* implied, including, but not limited to, any implied warranties of */ /* merchantability and fitness for a particular purpose, regarding the */ /* licensed materials. */ /* */ /* Neither TI nor any applicable licensor will be liable for any indirect, */ /* incidental or consequential damages, including but not limited to loss of */ /* profits. */ /* */ /* 8. Term - The license is effective until terminated. You may terminate */ /* it at any other time by destroying the program together with all copies, */ /* modifications and merged portions in any form. It also will terminate if */ /* you fail to comply with any term or condition of this Agreement. */ /* */ /* 9. Export Control - The re-export of United States origin software and */ /* documentation is subject to the U.S. Export Administration Regulations or */ /* your equivalent local regulations. Compliance with such regulations is */ /* your responsibility. */ /* */ /* *** IMPORTANT NOTICE *** */ /* */ /* Texas Instruments (TI) reserves the right to make changes to or to */ /* discontinue any semiconductor product or service identified in this */ /* publication without notice. TI advises its customers to obtain the latest */ /* version of the relevant information to verify, before placing orders, */ /* that the information being relied upon is current. */ /* */ /* TI warrants performance of its semiconductor products and related */ /* software to current specifications in accordance with TI's standard */ /* warranty. Testing and other quality control techniques are utilized to */ /* the extent TI deems necessary to support this warranty. Unless mandated */ /* by government requirements, specific testing of all parameters of each */ /* device is not necessarily performed. */ /* */ /* Please be aware that Texas Instruments products are not intended for use */ /* in life-support appliances, devices, or systems. Use of a TI product in */ /* such applications without the written approval of the appropriate TI */ /* officer is prohibited. Certain applications using semiconductor devices */ /* may involve potential risks of injury, property damage, or loss of life. */ /* In order to minimize these risks, adequate design and operating */ /* safeguards should be provided by the customer to minimize inherent or */ /* procedural hazards. Inclusion of TI products in such applications is */ /* understood to be fully at the risk of the customer using TI devices or */ /* systems. */ /* */ /* TI assumes no liability for TI applications assistance, customer product */ /* design, software performance, or infringement of patents or services */ /* described herein. Nor does TI warrant or represent that license, either */ /* expressed or implied, is granted under any patent right, copyright, mask */ /* work right, or other intellectual property right of TI covering or */ /* relating to any combination, machine, or process in which such */ /* semiconductor products or services might be or are used. */ /* */ /* All company and/or product names are trademarks and/or registered */ /* trademarks of their respective manaufacturers. */ /* */ /*-----------------------------------------------------------------------------*/ /* */ /* Now that you've gotten here you are probably serious about understanding */ /* the way Adam2 uses the flash. All flash operations are contained in this */ /* module. There are 7 interfaces to this module. FWBGetBlockSize, FWBErase, */ /* FWBOpen, FWBWriteByte, and FWBClose, FWBUnLock, FWBLock. */ /* */ /* FWBGetBlockSize(base); - returns the Flash Block size for the */ /* requested region so that all users of the */ /* flash understand the blocking factor. */ /* */ /* FWBErase(base,size,verbose); - Erases from base address of size in blocks. */ /* */ /* FWBOpen(Base); - Will always be called prior to FWBWriteByte,*/ /* and is responsible for unlocking the region */ /* and preparing for flash writes. */ /* */ /* FWBWriteByte(address,data); - Is called to write data to the flash */ /* address, remember that a FWBClose will be */ /* called prior to any use of the written data.*/ /* */ /* FWBClose() - Will complete any pending flash writes to a */ /* region, and lock the flash. */ /* */ /* FWBUnLock(base,size) - Unlocks the blocks specified */ /* */ /* FWBLock(base,size) - Lock the blocks specified */ /* */ /* The use of FWBOpen, FWBWriteByte, and FWBClose allows for efficient block */ /* writes. Remember it is possible to only get One FWBWriteByte in-between a */ /* FWBOpen and a FWBClose. */ /* */ /* During the Boot process the FWBGetBlockSize is called. This block can be */ /* called at any time, and returns the size of the flash blocks for the */ /* requested region. It is possible to have different size flash blocks in */ /* different memory regions. */ /* */ /* Any time the Kernel wishes to erase a block of flash, it will call the */ /* FWBErase routine. The routine is assumed to erase in blocks. That is */ /* FWBErase(CS0_BASE,1,0); will erase the block at CS0_BASE. The same can be */ /* said for FWBErase(CS0_BASE,FWBGetBlockSize(CS0_BASE),0); So that */ /* FWBErase(CS0_BASE,FWBGetBlockSize(CS0_BASE)+1,0); and */ /* FWBErase(CS0_BASE+1,FWBGetBlockSize(CS0_BASE),0); actually erases 2 blocks.*/ /* */ /* It is important to not that the FWBXxxxx routines must always leave the */ /* flash in a read mode. Failure to do this will result in a system hang. */ /* sys_printf() is also unuasable whilest the flash in not in a read mode */ /* */ /* And last but not least, all FWB... routines return TRUE if successfull and */ /* FALSE if unsuccessfull */ /* */ /*-----------------------------------------------------------------------------*/ #ifdef _STANDALONE #include #include #include #include #else #include "platform.h" #include "stddef.h" #include "flashop.h" #include "hw.h" #endif void _FlashErrorOut(char *str,int sts); int _FWBWriteBlock(void); int _FlashOperationComplete(bit32u adr,bit16u dat,int timeoutloops); #define MCONTENTS_OF(addr) (*((volatile unsigned short *)(addr))) #define MEM_READ16(addr) (MCONTENTS_OF(addr)) #define MEM_WRITE16(addr,val) (MCONTENTS_OF(addr) = (val)) #define FLASH_MAX_WAIT 125 #define MAXBUF 2 bit32u FWBBaseAdr,FWBBaseUnLockAdr; int FWBvalid; int FWBopen=FALSE; char FWBwdata[MAXBUF]; int FWBUnLock(bit32u adr,bit32 size) { return(TRUE); } /*Returns TRUE for success and FALSE for failure */ int FWBLock(bit32u from,bit32 size) { return(TRUE); } void UnLock(bit32u adr) { FWBBaseUnLockAdr=adr; MEM_WRITE16(adr,0x0060); MEM_WRITE16(adr,0x00D0); MEM_WRITE16(adr,0x00FF); } void Lock(void) { MEM_WRITE16(FWBBaseUnLockAdr,0x0060); MEM_WRITE16(FWBBaseUnLockAdr,0x0001); MEM_WRITE16(FWBBaseUnLockAdr,0x00FF); } int FWBGetBlockSize(bit32u base) { int itmp; base&=0x1fffffff; base|=0xa0000000; #ifdef _AVALANCHE_ /*EVM */ if ((base>=CS3_BASE)&&(base<(CS3_BASE+CS3_SIZE))) { itmp=(128*1024); /*Strata flash 8/16 bit */ if (EMIF_ASYNC_CS3&0x2) itmp*=2; /*Dual devices */ return(itmp); } #endif if ((base>=CS0_BASE)&&(base<(CS0_BASE+CS0_SIZE))) { itmp=(64*1024); /*Strata flash 8/16 bit */ if (base>=((CS0_BASE+CS0_SIZE)-(64*1024))) /* Top Boot Block */ itmp=(8*1024); if (EMIF_ASYNC_CS0&0x2) itmp*=2; /*Dual devices */ return(itmp); } return(0); } int FWBErase(bit32u base,int size,int verbose) { bit32u i,sts,blocksize,from,to; FWBopen=FALSE; if (size==0) return(0); size--; from=base; blocksize=FWBGetBlockSize(from); if (blocksize==0) { sys_printf("Invalid flash address %x\n",from); return(0); } from&=~(blocksize-1); to=base+size; blocksize=FWBGetBlockSize(to); if (blocksize==0) { sys_printf("invalid flash address %x\n",to); return(0); } to |= (blocksize-1); if (verbose) sys_printf("FlashEraseBlock(%08x,%08x);\n",from,to); for(i=from,sts=0;(itimeoutloops) { MEM_WRITE16(adr,0x00ff); /*Reset to read mode */ return(0xeeee0001); } sts=MEM_READ16(adr); if ((sts&0x0080)==0x0080) { err = (sts&0x003a); MEM_WRITE16(adr,0x00ff); /*Reset to read mode */ if (!err) { fnd=MEM_READ16(adr); if (fnd==dat) return(0); } else MEM_WRITE16(adr,0x0050); /*Reset error bits */ return(sts); } }while(1); } /* The following are for the Intel 28FXXXC3 Flash Chips */ #define FLASH_READ_CMD 0x00FF00FF #define FLASH_READ_CFG_CMD 0x00900090 #ifdef EB #define E28F160C3T 0x008988C2 #define E28F320C3T 0x008988C4 #define E28F640C3T 0x008988CC #else #define E28F160C3T 0x88C20089 #define E28F320C3T 0x88C40089 #define E28F640C3T 0x88CC0089 #endif #define MCONTENTS_OF32(addr) (*((volatile unsigned int *)(addr))) #define MEM_READ32(addr) (MCONTENTS_OF32(addr)) #define MEM_WRITE32(addr,val) (MCONTENTS_OF32(addr) = (val)) /* This function returns back a 0 if failure - no valid flash detected */ int FWBGet_flash_type() { bit32u flash_id; /* Figure out if we have the right flash chips */ MEM_WRITE32(CS0_BASE,FLASH_READ_CMD); MEM_WRITE32(CS0_BASE,FLASH_READ_CFG_CMD); flash_id = MEM_READ32(CS0_BASE); MEM_WRITE32(CS0_BASE,FLASH_READ_CMD); switch(flash_id) { case E28F160C3T: return 0x200000; case E28F320C3T: return 0x400000; case E28F640C3T: return 0x800000; default: return 0; } }