lowlvl.h

CF卡读卡程序

/*
; ***********************************************************************
; *             Intel Corporation                                       *
; *             Copyright (C) Intel Corporation 1994-97                 *
; *             All Rights Reserved.                                    *
; ***********************************************************************
; ***********************************************************************
;    INTEL OEM SOFTWARE LICENSE AGREEMENT
;
; BY USING THIS SOFTWARE, YOU ARE AGREEING TO BE BOUND BY THE TERMS OF THIS 
; AGREEMENT.  DO NOT USE THE SOFTWARE UNTIL YOU HAVE CAREFULLY READ AND AGREED 
; TO THE FOLLOWING TERMS AND CONDITIONS.  IF YOU DO NOT AGREE TO THE TERMS OF
; THIS AGREEMENT, PROMPTLY RETURN THE SOFTWARE PACKAGE AND ANY ACCOMPANYING
; ITEMS. YOU MUST BE AN ORIGINAL EQUIPMENT MANUFACTURER ("OEM") SYSTEM
; DEVELOPER TO ACQUIRE ANY RIGHTS IN THE SOFTWARE UNDER THIS LICENSE AGREEMENT.
;
; LICENSE: Intel Corporation ("Intel") grants you the non-exclusive and
; royalty-free right to use the enclosed software program ("Software") in
; source code form on the terms set forth below.  You will not use, copy,
; modify, rent, sell or transfer the Software or any portion thereof, except
; as provided in this Agreement.
;
; OEM System Developers may:
;
; 1. Copy the Software for support, backup or archival purposes;
; 2. Install or distribute the Software in object code form only;
; 3. Modify and/or use Software source code that Intel directly ships to you
;    as an OEM;
; 4. Allow authorized contractors ("Subcontractors") engaged by You for the
;    sole purpose of product development work to have access to the Software
;    solely for that purpose.  Subcontractors do NOT acquire any of the OEM
;    rights to the Software provided in this Agreement;
; 5. Install, use, modify, distribute, and/or make or have made derivative
;    works based on the Software ("Derivatives") subject to the terms and
;    conditions in this Agreement.
;
; RESTRICTIONS:
; YOU WILL NOT:
;
; 1.  Copy, disclose or distribute the Software, in whole or in part, except 
;     as provided for in this Agreement;
; 2.  Remove or modify the "Compatibility" module, if any,  in the Software or
;     in any Derivative work,
; 3.  Decompile or reverse engineer any Software  delivered in object code form.
; 
; TRANSFER:  Except as provided above, you may not transfer or disclose the
; Software to another party .
;
; OWNERSHIP AND COPYRIGHT OF SOFTWARE: Title to the Software and all copies
; thereof remain with Intel.  The Software is copyrighted and is protected by
; United States and international copyright laws.  You will not remove the
; copyright notice from the Software.  You agree to prevent any unauthorized
; copying of the Software.
;
; DERIVATIVE WORK: You will not be required to provide Intel with a copy of the
; source or object code for any Derivatives created by You.   You are authorized
; to use, market, sell, and/or distribute Derivatives, other than any source
; code for the Software, at your own risk and expense. Title to Derivatives,
; other than the portion of the Derivative consisting of any of the Software,
; shall remain with you.
;
; CONFIDENTIALITY: You will maintain the confidentiality of the source code for
; the Software with at least the same degree of care that you use to protect
; your own confidential and proprietary information, but with no less than a
; reasonable degree under the circumstances. Disclosure will only be made to
; Your employees on a need-to-know basis. Subject to the licenses granted
; hereunder, You agree to maintain the Software source code and all other
; proprietary information relating to the Software in confidence and shall not
; disclose to others any such source code or other Intel proprietary information
; relating to the Software. Any Subcontractors to whom you disclose the source
; code for the Software must sign a written confidentiality agreement which
; contains terms regarding the Software no less restrictive than those set forth
; in this Agreement.
;
; DUAL MEDIA SOFTWARE:  If the Software package contains multiple media, you
; may only use the medium appropriate for your system.
; 
; WARRANTY:  The Software is provided "AS IS". Intel warrants that the media on
; which the Software is furnished will be free from defects in material and
; workmanship for a period of one (1) year from the date of purchase.  Upon
; return of such defective media, Intel's entire liability and your exclusive
; remedy shall be the replacement of the Software.
; 
; THE ABOVE WARRANTIES ARE THE ONLY WARRANTIES OF ANY KIND GIVEN BY INTEL UNDER
; THIS AGREEMENT. INTEL SPECIFICALLY DISCLAIMS ANY OTHER WARRANTIES, EXPRESS OR
; IMPLIED, INCLUDING WARRANTIES OF MERCHANTABILITY, NONINFRINGEMENT OR FITNESS
; FOR ANY PARTICULAR PURPOSE.
;
; LIMITATION OF LIABILITY:    NEITHER INTEL NOR ITS VENDORS OR AGENTS SHALL BE
; LIABLE FOR ANY LOSS OF PROFITS, LOSS OF USE, LOSS OF DATA, INTERRUPTION OF
; BUSINESS, NOR FOR INDIRECT, SPECIAL, INCIDENTAL OR CONSEQUENTIAL DAMAGES OF
; ANY KIND WHETHER UNDER THIS AGREEMENT OR OTHERWISE, EVEN IF ADVISED OF THE
; POSSIBILITY OF SUCH DAMAGES.
;
; TERMINATION OF THIS LICENSE:  Intel reserves the right to conduct or have
; conducted audits to verify your compliance with this Agreement.  Intel may
; terminate this Agreement at any time if you are in breach of any of its terms
; and conditions.  Upon termination, you will immediately destroy, and certify
; in writing the destruction of, the Software or return all copies of the
; Software and documentation to Intel.
;
; U.S. GOVERNMENT RESTRICTED RIGHTS:  The Software and documentation were
; developed at private expense and are provided with "RESTRICTED RIGHTS".
; Use, duplication or disclosure by the Government is subject to restrictions
; as set forth in FAR52.227-14 and DFAR252.227-7013 et seq. or its successor.
;
; EXPORT LAWS:  You agree that the distribution and export/re-export of the
; Software is in compliance with the laws, regulations, orders or other
; restrictions of the U.S. Export Administration Regulations.
;
; APPLICABLE LAW:  This Agreement is governed by the laws of the State of
; Delaware and the United States, including patent and copyright laws.  Any
; claim arising out of this Agreement will be brought in Santa Clara County,
; California.
;*************************************************************************
*/


#ifndef LOWLVL_H
#define LOWLVL_H

#include "library.h"

/* Compile options for CFI Optional Features
   This includes Block Locking/Unlocking */
#define CFI_OPTIONAL TRUE
#define CFI_ERASE_REGIONS TRUE

#if CFI_ERASE_REGIONS
#define MAX_ERASE_REGIONS  4
#endif

typedef struct media_struct {
   DWORD   media_size;
#if !CFI_ERASE_REGIONS   
   DWORD   block_size;
   WORD    number_blocks;
#else
   BYTE   number_regions;
   DWORD  number_blocks[MAX_ERASE_REGIONS];
   DWORD  block_size[MAX_ERASE_REGIONS];
#endif
   
   BYTE    media_type;
   BYTE    manuf_id;
   BYTE    device_id;
} MEDIA_INFO;

/********************************************************************
 * The media type field in the media info structure above
 * has several bit fields to indicate information about
 * the media. They are defined as follows:
 *
 * Any unused bit fields should remain zero.
 * Bit fields:
 *
 *  Bit 7      Bit 6    Bit 5    Bit 4    Bit 3    Bit 2    Bit 1    Bit 0
 *  -----------------------------------------------------------------------
 * | Unused | Unused | Unused | Unused | Unused | Write  | No     | SRAM   |
 * |        |        |        |        |        | Protect| Erase  | Card   |
 * |        |        |        |        |        | On     | Suspend|        |
 *  -----------------------------------------------------------------------
 *
 * Bit 7 = Unused (Set to zero)
 * Bit 6 = Unused (Set to zero)
 * Bit 5 = Unused (Set to zero)
 * Bit 4 = Unused (Set to zero)
 * Bit 3 = Unused (Set to zero)
 * Bit 2 = 1 if write protect is on, 0 if write protect is off
 * Bit 1 = 1 if erase suspend is unsupported, 0 if supported
 * Bit 0 = 1 if SRAM card, 0 if other (flash)
 **************************************************************************/
#define SRAM_MASK             0x01
#define NO_ERASE_SUSPEND_MASK 0x02
#define WRITE_PROTECT_ON_MASK 0x04

#define FALCON FALSE

/*                      */
/*  Function Prototypes */
/*                      */
/*                      */
WORD FlashDevStatus(DWORD);
WORD FlashDevEraseBlock(DWORD);
WORD FlashDevCompatCheck(MEDIA_INFO *);
WORD FlashDevRead(DWORD,DWORD,BYTE_PTR);
WORD FlashDevWrite(DWORD,DWORD,BYTE_PTR);
void FlashDevResume(void);
void FlashDevSuspend(void);
void FlashDevClearStatus(DWORD);
WORD Initialization(DWORD);
void Terminate(void);
void clearregs(void);
WORD           Search(DWORD,DWORD, WORD,WORD,WORD, WORD);

void     PowerDownSocket(WORD socket);
void     PowerUpSocket(WORD socket,WORD vpp);

WORD     SlideMemoryWindow(DWORD);

/* This typedef is only used in the LOWLVL.C and TABLE.C */
typedef struct
{
   WORD     Device_JEDEC;
   WORD     DeviceBlocks;
#if SEGMENTED
   VOID_PTR DeviceRead;
   VOID_PTR DeviceWrite;
   VOID_PTR DeviceErase;
#if ERASE_BACKGROUND
   VOID_PTR DeviceStatus;
   VOID_PTR DeviceSuspend;
   VOID_PTR DeviceResume;
#endif
#else
   DWORD DeviceRead;
   DWORD DeviceWrite;
   DWORD DeviceErase;
#if ERASE_BACKGROUND
   DWORD DeviceStatus;
   DWORD DeviceSuspend;
   DWORD DeviceResume;
#endif
#endif
   DWORD DeviceSize;
   DWORD DeviceBlockSize;
   WORD DeviceCapabilities;
}DEVICE_TABLE;

typedef struct
{
   WORD     CommandSetID;
   WORD     Reserved;
#if SEGMENTED
   VOID_PTR DeviceRead;
   VOID_PTR DeviceWrite;
   VOID_PTR DeviceErase;
#if ERASE_BACKGROUND
   VOID_PTR DeviceStatus;
   VOID_PTR DeviceSuspend;
   VOID_PTR DeviceResume;
#endif
#if CFI_OPTIONAL
   VOID_PTR DeviceLock;
   VOID_PTR DeviceUnlock;
   VOID_PTR DeviceChipErase;
   VOID_PTR DeviceConfigureStatus;
#endif
#else
   DWORD DeviceRead;
   DWORD DeviceWrite;
   DWORD DeviceErase;
#if ERASE_BACKGROUND
   DWORD DeviceStatus;
   DWORD DeviceSuspend;
   DWORD DeviceResume;
#endif
#if CFI_OPTIONAL
   DWORD DeviceLock;
   DWORD DeviceUnlock;
   DWORD DeviceChipErase;
   DWORD DeviceConfigureStatus;
#endif
#endif
}CFI_TABLE;

#endif /* LOWLVL_H */