jnand_msg.h

QUALCOMM JNAND DRIVER

#ifndef __JNAND_MSG_H__
#define __JNAND_MSG_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_msg.h#1 $ $DateTime: 2003/02/06 15:47:46 $ $Author: pingguan $

when       who     what, where, why
--------   ---     ----------------------------------------------------------
02/06/03   pg      Moved from ASWP402 server to ASWP401 server.
07/05/02   drh     Created.
===========================================================================*/

/* -----------------------------------------------------------------------
** Include files for debug print output
** ----------------------------------------------------------------------- */

/* ABSOLUTELY do not bring in <stdio.h> or it will attempt to link
 * in code that will cause the link to fail on target.  May be OK
 * when compiling for off target unit test */
#if defined(NOISY) || defined(TNOISY)
#ifdef UNIX_UNIT_TEST
#error code not present
#else
extern int printf(const char *fmt,...);
#endif /* UNIX_UNIT_TEST */
#endif /* NOISY || TNOISY */


/* -----------------------------------------------------------------------
** Macros for debug print output
** ----------------------------------------------------------------------- */
#ifdef NOISY
#define MSG_HIGH(x,a,b,c) /**/
#define DPRINTF(x) printf x
#else
#define MSG_HIGH(x,a,b,c) /**/
#define DPRINTF(x) /**/
#endif /* NOISY */

#ifdef TNOISY
#define TPRINTF(level, x) if (TNOISY >= level) {printf x;}
#else
#define TPRINTF(level, x) /**/
#endif /* NOISY */

#endif /* __JNAND_MSG_H__ */