flashop_amd_.c

ADAM2 sources (modified by Oleg)

/*------------------------------------------------------------------------------*/
/*                                                                             	*/
/*   Copyright (C) 2000-2003 by Texas Instruments, Inc.  All rights reserved.  	*/
/*   Copyright (C) 2001-2003 Telogy Networks.	    						   	*/
/*                                                                             	*/
/*     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.     	*/
/*  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                                                     	*/
/*                                                                             	*/
/*------------------------------------------------------------------------------*/

#include "_stdio.h"
#include "flashop.h"
#include "hw.h"

void _FlashErrorOut(char *str,int sts);
int _FlashOperationComplete(bit32u adr,bit16u dat,int timeoutloops);

#define FLASH_MAX_WAIT 125

int    FWBopen=FALSE;
char   FWBwdata[2];

int FWBValid(bit32u base)
{