csl_emifbhal.h

Ti C6416 上对FLASH操作得范例程序

  #define  EMIFB_SDCTL_RFEN_OF(x)       _VALUEOF(x)
  #define  EMIFB_SDCTL_RFEN_DISABLE     0x00000000u
  #define  EMIFB_SDCTL_RFEN_ENABLE      0x00000001u

  #define _EMIFB_SDCTL_INIT_MASK        0x01000000u
  #define _EMIFB_SDCTL_INIT_SHIFT       0x00000018u
  #define  EMIFB_SDCTL_INIT_DEFAULT     0x00000001u
  #define  EMIFB_SDCTL_INIT_OF(x)       _VALUEOF(x)
  #define  EMIFB_SDCTL_INIT_NO          0x00000000u
  #define  EMIFB_SDCTL_INIT_YES         0x00000001u

  #define _EMIFB_SDCTL_TRCD_MASK        0x00F00000u
  #define _EMIFB_SDCTL_TRCD_SHIFT       0x00000014u
  #define  EMIFB_SDCTL_TRCD_DEFAULT     0x00000004u
  #define  EMIFB_SDCTL_TRCD_OF(x)       _VALUEOF(x)

  #define _EMIFB_SDCTL_TRP_MASK         0x000F0000u
  #define _EMIFB_SDCTL_TRP_SHIFT        0x00000010u
  #define  EMIFB_SDCTL_TRP_DEFAULT      0x00000008u
  #define  EMIFB_SDCTL_TRP_OF(x)        _VALUEOF(x)

  #define _EMIFB_SDCTL_TRC_MASK         0x0000F000u
  #define _EMIFB_SDCTL_TRC_SHIFT        0x0000000Cu
  #define  EMIFB_SDCTL_TRC_DEFAULT      0x0000000Fu
  #define  EMIFB_SDCTL_TRC_OF(x)        _VALUEOF(x)

  #define  EMIFB_SDCTL_OF(x)            _VALUEOF(x)

  #define EMIFB_SDCTL_DEFAULT (Uint32)( \
     _PER_FDEFAULT(EMIFB,SDCTL,SDBSZ)\
    |_PER_FDEFAULT(EMIFB,SDCTL,SDRSZ)\
    |_PER_FDEFAULT(EMIFB,SDCTL,SDCSZ)\
    |_PER_FDEFAULT(EMIFB,SDCTL,RFEN)\
    |_PER_FDEFAULT(EMIFB,SDCTL,INIT)\
    |_PER_FDEFAULT(EMIFB,SDCTL,TRCD)\
    |_PER_FDEFAULT(EMIFB,SDCTL,TRP)\
    |_PER_FDEFAULT(EMIFB,SDCTL,TRC)\
  )

  #define EMIFB_SDCTL_RMK(sdbsz,sdrsz,sdcsz,rfen,init,trcd,trp,trc) (Uint32)(\
     _PER_FMK(EMIFB,SDCTL,SDBSZ,sdbsz)\
    |_PER_FMK(EMIFB,SDCTL,SDRSZ,sdrsz)\
    |_PER_FMK(EMIFB,SDCTL,SDCSZ,sdcsz)\
    |_PER_FMK(EMIFB,SDCTL,RFEN,rfen)\
    |_PER_FMK(EMIFB,SDCTL,INIT,init)\
    |_PER_FMK(EMIFB,SDCTL,TRCD,trcd)\
    |_PER_FMK(EMIFB,SDCTL,TRP,trp)\
    |_PER_FMK(EMIFB,SDCTL,TRC,trc)\
  )

  #define _EMIFB_SDCTL_FGET(FIELD)\
    _PER_FGET(_EMIFB_SDCTL_ADDR,EMIFB,SDCTL,##FIELD)

  #define _EMIFB_SDCTL_FSET(FIELD,field)\
    _PER_FSET(_EMIFB_SDCTL_ADDR,EMIFB,SDCTL,##FIELD,field)

  #define _EMIFB_SDCTL_FSETS(FIELD,SYM)\
    _PER_FSETS(_EMIFB_SDCTL_ADDR,EMIFB,SDCTL,##FIELD,##SYM)


/******************************************************************************\
* _____________________
* |                   |
* |  S D T I M        |
* |___________________|
*
* SDTIM   - SDRAM timing register
*
* FIELDS (msb -> lsb)
* (rw) XRFR
* (r)  CNTR
* (rw) PERIOD
*
\******************************************************************************/
  #define _EMIFB_SDTIM_OFFSET           7

  #define _EMIFB_SDTIM_ADDR             0x01A8001Cu

  #define _EMIFB_SDTIM_XRFR_MASK        0x03000000u
  #define _EMIFB_SDTIM_XRFR_SHIFT       0x00000018u
  #define  EMIFB_SDTIM_XRFR_DEFAULT     0x00000000u
  #define  EMIFB_SDTIM_XRFR_OF(x)       _VALUEOF(x)

  #define _EMIFB_SDTIM_CNTR_MASK        0x00FFF000u
  #define _EMIFB_SDTIM_CNTR_SHIFT       0x0000000Cu
  #define  EMIFB_SDTIM_CNTR_DEFAULT     0x000005DCu
  #define  EMIFB_SDTIM_CNTR_OF(x)       _VALUEOF(x)
  
  #define _EMIFB_SDTIM_PERIOD_MASK      0x00000FFFu
  #define _EMIFB_SDTIM_PERIOD_SHIFT     0x00000000u
  #define  EMIFB_SDTIM_PERIOD_DEFAULT   0x000005DCu
  #define  EMIFB_SDTIM_PERIOD_OF(x)     _VALUEOF(x)

  #define  EMIFB_SDTIM_OF(x)            _VALUEOF(x)

  #define EMIFB_SDTIM_DEFAULT (Uint32)( \
     _PER_FDEFAULT(EMIFB,SDTIM,XRFR)\
    |_PER_FDEFAULT(EMIFB,SDTIM,CNTR)\
    |_PER_FDEFAULT(EMIFB,SDTIM,PERIOD)\
  )

  #define EMIFB_SDTIM_RMK(xrfr,period) (Uint32)(\
     _PER_FMK(EMIFB,SDTIM,XRFR,xrfr)\
    |_PER_FMK(EMIFB,SDTIM,PERIOD,period)\
  )

  #define _EMIFB_SDTIM_FGET(FIELD)\
    _PER_FGET(_EMIFB_SDTIM_ADDR,EMIFB,SDTIM,##FIELD)

  #define _EMIFB_SDTIM_FSET(FIELD,field)\
    _PER_FSET(_EMIFB_SDTIM_ADDR,EMIFB,SDTIM,##FIELD,field)

  #define _EMIFB_SDTIM_FSETS(FIELD,SYM)\
    _PER_FSETS(_EMIFB_SDTIM_ADDR,EMIFB,SDTIM,##FIELD,##SYM)


/******************************************************************************\
* _____________________
* |                   |
* |  S D E X T        |
* |___________________|
*
* SDEXT   - SDRAM extension register
*
* FIELDS (msb -> lsb)
* (rw) WR2RD
* (rw) WR2DEAC
* (rw) WR2WR
* (rw) R2WDQM
* (rw) RD2WR
* (rw) RD2DEAC
* (rw) RD2RD
* (rw) THZP
* (rw) TWR
* (rw) TRRD
* (rw) TRAS
* (rw) TCL
*
\******************************************************************************/
  #define _EMIFB_SDEXT_OFFSET           8

  #define _EMIFB_SDEXT_ADDR             0x01A80020u

  #define _EMIFB_SDEXT_WR2RD_MASK       0x00100000u
  #define _EMIFB_SDEXT_WR2RD_SHIFT      0x00000014u
  #define  EMIFB_SDEXT_WR2RD_DEFAULT    0x00000001u
  #define  EMIFB_SDEXT_WR2RD_OF(x)      _VALUEOF(x)

  #define _EMIFB_SDEXT_WR2DEAC_MASK     0x000C0000u
  #define _EMIFB_SDEXT_WR2DEAC_SHIFT    0x00000012u
  #define  EMIFB_SDEXT_WR2DEAC_DEFAULT  0x00000001u
  #define  EMIFB_SDEXT_WR2DEAC_OF(x)    _VALUEOF(x)

  #define _EMIFB_SDEXT_WR2WR_MASK       0x00020000u
  #define _EMIFB_SDEXT_WR2WR_SHIFT      0x00000011u
  #define  EMIFB_SDEXT_WR2WR_DEFAULT    0x00000001u
  #define  EMIFB_SDEXT_WR2WR_OF(x)      _VALUEOF(x)

  #define _EMIFB_SDEXT_R2WDQM_MASK      0x00018000u
  #define _EMIFB_SDEXT_R2WDQM_SHIFT     0x0000000Fu
  #define  EMIFB_SDEXT_R2WDQM_DEFAULT   0x00000002u
  #define  EMIFB_SDEXT_R2WDQM_OF(x)     _VALUEOF(x)

  #define _EMIFB_SDEXT_RD2WR_MASK       0x00007000u
  #define _EMIFB_SDEXT_RD2WR_SHIFT      0x0000000Cu
  #define  EMIFB_SDEXT_RD2WR_DEFAULT    0x00000005u
  #define  EMIFB_SDEXT_RD2WR_OF(x)      _VALUEOF(x)

  #define _EMIFB_SDEXT_RD2DEAC_MASK     0x00000C00u
  #define _EMIFB_SDEXT_RD2DEAC_SHIFT    0x0000000Au
  #define  EMIFB_SDEXT_RD2DEAC_DEFAULT  0x00000003u
  #define  EMIFB_SDEXT_RD2DEAC_OF(x)    _VALUEOF(x)

  #define _EMIFB_SDEXT_RD2RD_MASK       0x00000200u
  #define _EMIFB_SDEXT_RD2RD_SHIFT      0x00000009u
  #define  EMIFB_SDEXT_RD2RD_DEFAULT    0x00000001u
  #define  EMIFB_SDEXT_RD2RD_OF(x)      _VALUEOF(x)

  #define _EMIFB_SDEXT_THZP_MASK        0x00000180u
  #define _EMIFB_SDEXT_THZP_SHIFT       0x00000007u
  #define  EMIFB_SDEXT_THZP_DEFAULT     0x00000002u
  #define  EMIFB_SDEXT_THZP_OF(x)       _VALUEOF(x)

  #define _EMIFB_SDEXT_TWR_MASK         0x00000060u
  #define _EMIFB_SDEXT_TWR_SHIFT        0x00000005u
  #define  EMIFB_SDEXT_TWR_DEFAULT      0x00000001u
  #define  EMIFB_SDEXT_TWR_OF(x)        _VALUEOF(x)

  #define _EMIFB_SDEXT_TRRD_MASK        0x00000010u
  #define _EMIFB_SDEXT_TRRD_SHIFT       0x00000004u
  #define  EMIFB_SDEXT_TRRD_DEFAULT     0x00000001u
  #define  EMIFB_SDEXT_TRRD_OF(x)       _VALUEOF(x)

  #define _EMIFB_SDEXT_TRAS_MASK        0x0000000Eu
  #define _EMIFB_SDEXT_TRAS_SHIFT       0x00000001u
  #define  EMIFB_SDEXT_TRAS_DEFAULT     0x00000007u
  #define  EMIFB_SDEXT_TRAS_OF(x)       _VALUEOF(x)

  #define _EMIFB_SDEXT_TCL_MASK         0x00000001u
  #define _EMIFB_SDEXT_TCL_SHIFT        0x00000000u
  #define  EMIFB_SDEXT_TCL_DEFAULT      0x00000001u
  #define  EMIFB_SDEXT_TCL_OF(x)        _VALUEOF(x)

  #define  EMIFB_SDEXT_OF(x)            _VALUEOF(x)

  #define EMIFB_SDEXT_DEFAULT (Uint32)( \
     _PER_FDEFAULT(EMIFB,SDEXT,WR2RD)\
    |_PER_FDEFAULT(EMIFB,SDEXT,WR2DEAC)\
    |_PER_FDEFAULT(EMIFB,SDEXT,WR2WR)\
    |_PER_FDEFAULT(EMIFB,SDEXT,R2WDQM)\
    |_PER_FDEFAULT(EMIFB,SDEXT,RD2WR)\
    |_PER_FDEFAULT(EMIFB,SDEXT,RD2DEAC)\
    |_PER_FDEFAULT(EMIFB,SDEXT,RD2RD)\
    |_PER_FDEFAULT(EMIFB,SDEXT,THZP)\
    |_PER_FDEFAULT(EMIFB,SDEXT,TWR)\
    |_PER_FDEFAULT(EMIFB,SDEXT,TRRD)\
    |_PER_FDEFAULT(EMIFB,SDEXT,TRAS)\
    |_PER_FDEFAULT(EMIFB,SDEXT,TCL)\
  )

  #define EMIFB_SDEXT_RMK(wr2rd,wr2deac,wr2wr,r2wdqm,rd2wr,rd2deac,\
    rd2rd,thzp,twr,trrd,tras,tcl) (Uint32)( \
     _PER_FMK(EMIFB,SDEXT,WR2RD,wr2rd)\
    |_PER_FMK(EMIFB,SDEXT,WR2DEAC,wr2deac)\
    |_PER_FMK(EMIFB,SDEXT,WR2WR,wr2wr)\
    |_PER_FMK(EMIFB,SDEXT,R2WDQM,r2wdqm)\
    |_PER_FMK(EMIFB,SDEXT,RD2WR,rd2wr)\
    |_PER_FMK(EMIFB,SDEXT,RD2DEAC,rd2deac)\
    |_PER_FMK(EMIFB,SDEXT,RD2RD,rd2rd)\
    |_PER_FMK(EMIFB,SDEXT,THZP,thzp)\
    |_PER_FMK(EMIFB,SDEXT,TWR,twr)\
    |_PER_FMK(EMIFB,SDEXT,TRRD,trrd)\
    |_PER_FMK(EMIFB,SDEXT,TRAS,tras)\
    |_PER_FMK(EMIFB,SDEXT,TCL,tcl)\
  )

  #define _EMIFB_SDEXT_FGET(FIELD)\
    _PER_FGET(_EMIFB_SDEXT_ADDR,EMIFB,SDEXT,##FIELD)

  #define _EMIFB_SDEXT_FSET(FIELD,field)\
    _PER_FSET(_EMIFB_SDEXT_ADDR,EMIFB,SDEXT,##FIELD,field)

  #define _EMIFB_SDEXT_FSETS(FIELD,SYM)\
    _PER_FSETS(_EMIFB_SDEXT_ADDR,EMIFB,SDEXT,##FIELD,##SYM)

/******************************************************************************\
* _____________________
* |                   |
* |  C E x S E C      |
* |___________________|
*
* CESEC0 - CE space secondary control register 0
* CESEC1 - CE space secondary control register 1
* CESEC2 - CE space secondary control register 2
* CESEC3 - CE space secondary control register 3
*
* FIELDS (msb -> lsb)
* (rw) SNCCLK
* (rw) RENEN
* (rw) CEEXT
* (rw) SYNCWL
* (rw) SYNCRL
*
\******************************************************************************/
  #define _EMIFB_CESEC0_OFFSET          18
  #define _EMIFB_CESEC1_OFFSET          17
  #define _EMIFB_CESEC2_OFFSET          20
  #define _EMIFB_CESEC3_OFFSET          21

  #define _EMIFB_CESEC0_ADDR            0x01A80048u
  #define _EMIFB_CESEC1_ADDR            0x01A80044u
  #define _EMIFB_CESEC2_ADDR            0x01A80050u
  #define _EMIFB_CESEC3_ADDR            0x01A80054u

  #define _EMIFB_CESEC_SNCCLK_MASK      0x00000040u
  #define _EMIFB_CESEC_SNCCLK_SHIFT     0x00000006u
  #define  EMIFB_CESEC_SNCCLK_DEFAULT   0x00000000u
  #define  EMIFB_CESEC_SNCCLK_OF(x)     _VALUEOF(x)
  #define  EMIFB_CESEC_SNCCLK_ECLKOUT1  0x00000000u 
  #define  EMIFB_CESEC_SNCCLK_ECLKOUT2  0x00000001u 

  #define _EMIFB_CESEC_RENEN_MASK       0x00000020u
  #define _EMIFB_CESEC_RENEN_SHIFT      0x00000005u
  #define  EMIFB_CESEC_RENEN_DEFAULT    0x00000000u
  #define  EMIFB_CESEC_RENEN_OF(x)      _VALUEOF(x)
  #define  EMIFB_CESEC_RENEN_ADS        0x00000000u 
  #define  EMIFB_CESEC_RENEN_READ       0x00000001u 

  #define _EMIFB_CESEC_CEEXT_MASK       0x00000010u
  #define _EMIFB_CESEC_CEEXT_SHIFT      0x00000004u
  #define  EMIFB_CESEC_CEEXT_DEFAULT    0x00000000u
  #define  EMIFB_CESEC_CEEXT_OF(x)      _VALUEOF(x)
  #define  EMIFB_CESEC_CEEXT_INACTIVE   0x00000000u 
  #define  EMIFB_CESEC_CEEXT_ACTIVE     0x00000001u 

  #define _EMIFB_CESEC_SYNCWL_MASK      0x0000000Cu
  #define _EMIFB_CESEC_SYNCWL_SHIFT     0x00000002u
  #define  EMIFB_CESEC_SYNCWL_DEFAULT   0x00000000u
  #define  EMIFB_CESEC_SYNCWL_OF(x)     _VALUEOF(x)
  #define  EMIFB_CESEC_SYNCWL_0CYCLE    0x00000000u 
  #define  EMIFB_CESEC_SYNCWL_1CYCLE    0x00000001u 
  #define  EMIFB_CESEC_SYNCWL_2CYCLE    0x00000002u 
  #define  EMIFB_CESEC_SYNCWL_3CYCLE    0x00000003u 

  #define _EMIFB_CESEC_SYNCRL_MASK      0x00000003u
  #define _EMIFB_CESEC_SYNCRL_SHIFT     0x00000000u
  #define  EMIFB_CESEC_SYNCRL_DEFAULT   0x00000002u
  #define  EMIFB_CESEC_SYNCRL_OF(x)     _VALUEOF(x)
  #define  EMIFB_CESEC_SYNCRL_0CYCLE    0x00000000u 
  #define  EMIFB_CESEC_SYNCRL_1CYCLE    0x00000001u 
  #define  EMIFB_CESEC_SYNCRL_2CYCLE    0x00000002u 
  #define  EMIFB_CESEC_SYNCRL_3CYCLE    0x00000003u 

  #define  EMIFB_CESEC_OF(x)            _VALUEOF(x)

  #define EMIFB_CESEC_DEFAULT (Uint32)( \
     _PER_FDEFAULT(EMIFB,CESEC,SNCCLK)\
    |_PER_FDEFAULT(EMIFB,CESEC,RENEN)\
    |_PER_FDEFAULT(EMIFB,CESEC,CEEXT)\
    |_PER_FDEFAULT(EMIFB,CESEC,SYNCWL)\
    |_PER_FDEFAULT(EMIFB,CESEC,SYNCRL)\
  )

  #define EMIFB_CESEC_RMK(sncclk,renen,ceext,syncwl,syncrl)\
    (Uint32)( \
     _PER_FMK(EMIFB,CESEC,SNCCLK,sncclk)\
    |_PER_FMK(EMIFB,CESEC,RENEN,renen)\
    |_PER_FMK(EMIFB,CESEC,CEEXT,ceext)\
    |_PER_FMK(EMIFB,CESEC,SYNCWL,syncwl)\
    |_PER_FMK(EMIFB,CESEC,SYNCRL,syncrl)\
  )

  #define _EMIFB_CESEC_FGET(N,FIELD)\
    _PER_FGET(_EMIFB_CESEC##N##_ADDR,EMIFB,CESEC,##FIELD)

  #define _EMIFB_CESEC_FSET(N,FIELD,f)\
    _PER_FSET(_EMIFB_CESEC##N##_ADDR,EMIFB,CESEC,##FIELD,f)

  #define _EMIFB_CESEC_FSETS(N,FIELD,SYM)\
    _PER_FSETS(_EMIFB_CESEC##N##_ADDR,EMIFB,CESEC,##FIELD,##SYM)

  #define _EMIFB_CESEC0_FGET(FIELD) _EMIFB_CESEC_FGET(0,##FIELD)
  #define _EMIFB_CESEC1_FGET(FIELD) _EMIFB_CESEC_FGET(1,##FIELD)
  #define _EMIFB_CESEC2_FGET(FIELD) _EMIFB_CESEC_FGET(2,##FIELD)
  #define _EMIFB_CESEC3_FGET(FIELD) _EMIFB_CESEC_FGET(3,##FIELD)

  #define _EMIFB_CESEC0_FSET(FIELD,f) _EMIFB_CESEC_FSET(0,##FIELD,f)
  #define _EMIFB_CESEC1_FSET(FIELD,f) _EMIFB_CESEC_FSET(1,##FIELD,f)
  #define _EMIFB_CESEC2_FSET(FIELD,f) _EMIFB_CESEC_FSET(2,##FIELD,f)
  #define _EMIFB_CESEC3_FSET(FIELD,f) _EMIFB_CESEC_FSET(3,##FIELD,f)

  #define _EMIFB_CESEC0_FSETS(FIELD,SYM) _EMIFB_CESEC_FSETS(0,##FIELD,##SYM)
  #define _EMIFB_CESEC1_FSETS(FIELD,SYM) _EMIFB_CESEC_FSETS(1,##FIELD,##SYM)
  #define _EMIFB_CESEC2_FSETS(FIELD,SYM) _EMIFB_CESEC_FSETS(2,##FIELD,##SYM)
  #define _EMIFB_CESEC3_FSETS(FIELD,SYM) _EMIFB_CESEC_FSETS(3,##FIELD,##SYM)


/******************************************************************************\
* _____________________
* |                   |
* |  P D T C T L      |
* |___________________|
*
* PDTCTL   - Peripheral device transfer (PDT) control
*
* FIELDS (msb -> lsb)
* (rw) PDTWL
* (rw) PDTRL
*
\******************************************************************************/
  #define _EMIFA_PDTCTL_OFFSET          16 

  #define _EMIFA_PDTCTL_ADDR            0x01A80040u

  #define _EMIFA_PDTCTL_PDTWL_MASK      0x0000000Cu
  #define _EMIFA_PDTCTL_PDTWL_SHIFT     0x00000002u
  #define  EMIFA_PDTCTL_PDTWL_DEFAULT   0x00000000u
  #define  EMIFA_PDTCTL_PDTWL_OF(x)     _VALUEOF(x)
  #define  EMIFA_PDTCTL_PDTWL_0CYCLE    0x00000000u
  #define  EMIFA_PDTCTL_PDTWL_1CYCLE    0x00000001u
  #define  EMIFA_PDTCTL_PDTWL_2CYCLE    0x00000002u
  #define  EMIFA_PDTCTL_PDTWL_3CYCLE    0x00000003u
   
  #define _EMIFA_PDTCTL_PDTRL_MASK      0x000C0003u
  #define _EMIFA_PDTCTL_PDTRL_SHIFT     0x00000000u
  #define  EMIFA_PDTCTL_PDTRL_DEFAULT   0x00000000u
  #define  EMIFA_PDTCTL_PDTRL_OF(x)     _VALUEOF(x)
  #define  EMIFA_PDTCTL_PDTRL_0CYCLE    0x00000000u
  #define  EMIFA_PDTCTL_PDTRL_1CYCLE    0x00000001u
  #define  EMIFA_PDTCTL_PDTRL_2CYCLE    0x00000002u
  #define  EMIFA_PDTCTL_PDTRL_3CYCLE    0x00000003u


  #define EMIFA_PDTCTL_DEFAULT (Uint32)( \
     _PER_FDEFAULT(EMIFA,PDTCTL,PDTWL)\
    |_PER_FDEFAULT(EMIFA,PDTCTL,PDTRL)\
  )

  #define EMIFA_PDTCTL_RMK(pdtwl,pdtrl) (Uint32)( \
     _PER_FMK(EMIFA,PDTCTL,PDTWL,pdtwl)\
    |_PER_FMK(EMIFA,PDTCTL,PDTRL,pdtrl)\
  )

  #define _EMIFA_PDTCTL_FGET(FIELD)\
    _PER_FGET(_EMIFA_PDTCTL_ADDR,EMIFA,PDTCTL,##FIELD)

  #define _EMIFA_PDTCTL_FSET(FIELD,field)\
    _PER_FSET(_EMIFA_PDTCTL_ADDR,EMIFA,PDTCTL,##FIELD,field)

  #define _EMIFA_PDTCTL_FSETS(FIELD,SYM)\
    _PER_FSETS(_EMIFA_PDTCTL_ADDR,EMIFA,PDTCTL,##FIELD,##SYM)


   
#endif /* EMIFB_SUPPORT */

#endif /* _CSL_EMIFBHAL_H_ */
/******************************************************************************\
* End of csl_emifhal.h
\******************************************************************************/