boothw.h

在高通的手机平台下,一个下载手机.bin文件到手机的flash中的工具,包含PC端的程序代码和运行在基带处理器中的代码.

#ifndef BOOTHW_H
#define BOOTHW_H
/*====*====*====*====*====*====*====*====*====*====*====*====*====*====*====*

      B O O T  H A R D W A R E  I N I T I A L I Z A T I O N   H E A D E R

GENERAL DESCRIPTION
  This header file contains the definitions of the MSM2.x memory and peripheral
  control hardware registers and reserved memory locations.

Copyright (c) 1991-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:   L:/src/asw/MSM6000/vcs/boothw.h_v   1.1   20 Mar 2002 19:32:54   hromero  $

when       who     what, where, why
--------   ---     ----------------------------------------------------------
11/21/00   rmd     Renamed boot_hw_chipxn_clk_init() to clk_regime_chipxn_clk_init()
                   and moved prototype to the clk regime code.
11/10/00   rmd     Modified boot_hw_tlmm_shadow() and boot_hw_chipxn_clk_init()
                   so that they contain all the initialization necessary 
                   without the need of any extra code.
10/17/00   rmd     Replaced #include "boothwi_5105" with #include BOOTHW_MSM_H
                   where BOOTHW_MSM_H is defined in msmhw.h.
10/16/00   rmd     Moved Bit definitions to msm5105bits.h.
                   Moved Wait State, Clk, Memory config, .. information to 
                   boothwi_5105.h.
                   Added boot_hw_chipxn_clk_init(), boot_hw_msm_wt_st_cfg() and 
                   boot_hw_tlmm_shadow prototypes.
10/10/00   rmd     Added the option to have 1 or 2 RAM chips in 8 bit or 16 bit mode
10/09/00   rmd     Moved initialization code from boot_hw_tlmm_init() to macros
                   so that it can be shared with other modules.
09/06/00   rmd     Updated register values to reflect the changes from MSM5105.
08/28/00   rmd     Moved KICK_WATCHDOG to boothw.h, renamed it BOOTHW_KICK_WATCHDOG.
08/24/00   jcw     Added prototype of boot_hw_ctrl_init
05/26/99   ts      Added a chech for RUIM_DRIVER_TIME_TEST to enable the debug
                   chip select.
04/02/00   sm      Added FEATURE_STEREO_DAC support.
01/27/00   tc      Added TRAMP_INT_TIMING_TEST support.
12/09/99   mk      Increased ROM2_HWORD_WAIT to 3 for ICE mode to support
                   (used in the EFS/VR appl.).
11/30/99   mk      Using FEATURE_NATIVE_MODE for both JTAG and NATIVE modes.
10/27/99   jc      Enable GP_CS if TIMETEST is defined.
10/04/99   mk      Changed to support MSM3100 family ASICs only.
09/26/99   mk      Added FEATURE_JTAG_2MC_MODE support.
09/23/99   jc      Added FEATURE_EFS support.
09/17/99   mk      Introduced FEATURE_USB.
09/16/99   mk      Deleted obsolete PRODUCTION_SURF2000_xxx definitions.
09/13/99   jc      Added PRODUCTION_SURF2000_REV2 for CRF3100 use w no EXTERNAL_CODEC
09/11/99   mk      Modified for MSM3100 REV2.
                   Renamed T_MSM31_xxx to FEATURE_2M_JTAG_MODE, FEATURE_NATIVE_MODE.
08/20/99   mk      ARM2.5 compiler update.
08/12/99   mk      Added MSM3100 JTAG support for 2M (FEATURE_DS enabled)
                   builds.
08/02/99   jc      Added TLMM functions for gpio function sel registers 0,1
07/15/99   mk      Added all defs for MSM3100 _CTL4, _CTL5, _CTL6 registers
                   and bits.
05/12/99   mk      Added initial MSM3100 support.
12/10/98   dnn     Changed #ifdef FEATURE_SLEEP_32KHZ to FEATURE_SLEEP_SLOW_CLOCK
                   Added define for Sleep Oscillator Gain setting of 01
12/08/98   bgc     Added T_MSM3 conditionals for TG==T_Q
11/11/98   mdd     Removed dependency on TG==T_G -- not needed for MSM3
09/16/98   dnn     Added define used for sleep oscillator.
09/14/98   ih,rcn  Added 32kHz sleep support.
           ajn,dnn
09/13/98   hcg     Moved well-known location definitions to target specific
                   header file.
08/08/98   hcg     Changed RAM interrupt vector locations.
08/04/98   hcg     Changed mobile model number location after moving check.
07/30/98   hcg     Changed application entry point after moving check segment.
07/28/98   udp     Fixed logical error in BSIZER_CTL2, would only affect PCS6 RD CNT
07/20/98   udp/cly Removed Panther ref's, fixed if defined to use TG.
04/08/96   dna     Renamed to proc_good_frames() to be consistent.
02/28/96   dna     Created module from parts of diagp.c

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

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

                     INCLUDE FILES FOR MODULE

===========================================================================*/
#include  "msm.h"
#include  BOOTHW_MSM_H

/*----------------------------------------------------------------------------
------------------------------------------------------------------------------
  ASB Register Defines
------------------------------------------------------------------------------
----------------------------------------------------------------------------*/

/*===========================================================================
                      FUNCTION DECLARATIONS

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

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

  FUNCTION boot_hw_ctrl_init()

  DESCRIPTION
    Initializes MSM control registers to enable access to the entire
    target ROM and RAM address space.

  PARAMETERS
    None.

  DEPENDENCIES
    None.

  RETURN VALUE
    None.

  SIDE EFFECTS
    The MSM chip is initialized.
===========================================================================*/
void boot_hw_ctrl_init(void);

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

  FUNCTION boot_hw_tlmm_shadow()

  DESCRIPTION
        This function initializes each register that needs to be 
    initialized to enable several gpios to a specific mode.

        This function uses MSM_OUTHM/ASB_OUTHM macro to keep a shadow of 
    the registers written. MSM_OUTHM/ASB_OUTHM macro calls functions within 
    (rex_int_lock() & rex_int_free()). As a result, this function uses the 
    stack which is undesirable within the boot code. Use this function for 
    external code and not within the boot code.
    
  PARAMETERS
    None.
    
  DEPENDENCIES
    None.
        
  RETURN VALUE
    None.    

  SIDE EFFECTS
    It uses the stack

===========================================================================*/
void boot_hw_tlmm_shadow(void);

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

  FUNCTION boot_hw_mem_wt_st_cfg()

  DESCRIPTION
    Setup MSM5105 memory wait states.

  PARAMETERS
    None.

  DEPENDENCIES

  RETURN VALUE
    None.

  SIDE EFFECTS
    None.

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

void boot_hw_mem_wt_st_cfg(void);

#endif /*BOOTHW_H*/