jnand_bib.h

QUALCOMM JNAND DRIVER

#ifndef __JNAND_BIB_H__
#define __JNAND_BIB_H__
/*====*====*====*====*====*====*====*====*====*====*====*====*====*====*====*

          Flash Programming Plug-In for Lauterbach JTAG/ICD TRACE32

GENERAL DESCRIPTION

  This program is essentially a plug-in for Lauterbach JTAG ICD TRACE32
  Debugger FLASH command. The programming can be achieved in two different 
  modes: emulator controlled or target controlled. The emulator controlled
  programming needs no program running on the target, but is slow
  (typically about 1 to 5 KBytes/sec). The target controlled programming 
  requires a user designed FLASH programming routine (and hence this plug-in)
  to be available on the target. This plug-in is called by TRACE32 with 
  appropriate parameters to program FLASH devices. The advantage of this
  method is the higher programming speed and more flexibility in the 
  implementation of the programming algorithm.

  To use the plug-in, see the PRACTICE file JNAND.CMM.  It not only uses
  the built-in FLASH.* commands, but also pokes the parameter buffer with
  extended command codes that we need in order to do initialization and
  finalization.
  
  In order for the Debugger to get control back after the plug-in completes,  
  a breakpoint is assumed to be in place after the last instruction
  executed in the plug-in.

EXTERNALIZED FUNCTIONS

INITIALIZATION AND SEQUENCING REQUIREMENTS
  
  Must place a breakpoint right after the last instruction in the plug-in
  in order for the Debugger to get back control.

  Copyright (c) 2002 by QUALCOMM Incorporated.  All Rights Reserved.
*====*====*====*====*====*====*====*====*====*====*====*====*====*====*====*/


/*===========================================================================

                        EDIT HISTORY FOR MODULE

  This section contains comments describing changes made to the module.
  Notice that changes are listed in reverse chronological order.

  $Header: //depot/asic/MSMSHARED/tools/jnand/jnand_bib.h#2 $ $DateTime: 2003/03/06 11:09:41 $ $Author: dionh $

when       who     what, where, why
--------   ---     ----------------------------------------------------------
03/04/03   drh     Changes for new spanless boot method.
02/06/03   pg      Moved from ASWP402 server to ASWP401 server.
07/09/02   drh     Remove extra header line
07/05/02   drh     Created.
===========================================================================*/
/*====*====*====*====*====*====*====*====*====*====*====*====*====*====*====*

             Flash Programming Support via Lauterbach JTAG ICD

GENERAL DESCRIPTION
  This file is a header file describing the Boot Information Block
  for Cougar NAND flash

EXTERNALIZED FUNCTIONS
  None.

INITIALIZATION AND SEQUENCING REQUIREMENTS
  

  Copyright (c) 2002 by QUALCOMM Incorporated.  All Rights Reserved.
*====*====*====*====*====*====*====*====*====*====*====*====*====*====*====*/


#define MAGIC1 0x48E3DB5e
#define MAGIC2 0xEE55AA73

#define BIB_VERSION 2

struct boot_info_block {
  uint32          magic1;      /* MAGIC1 */
  uint32          magic2;      /* MAGIC2 */
  uint32	        version;     /* BIB version number */
  uint32	        startaddr;   /* Start address in RAM */
  uint32          length;      /* length of image */
  uint32          crc;         /* CRC of image */
};

#endif /* __JNAND_BIB_H__ */