STC8x_SYSCLK.h

浏览该文件的文档.

/*-----------------------------------------------------------------------
|                            FILE DESCRIPTION                           |
-----------------------------------------------------------------------*/
/*----------------------------------------------------------------------
  - File name     : STC8Ax_SYSCLK.h
  - Author        : zeweni
  - Update date   : 2020.05.03
  - Copyright(C)  : 2020-2021 zeweni. All rights reserved.
-----------------------------------------------------------------------*/
/*------------------------------------------------------------------------
|                            COPYRIGHT NOTICE                            |
------------------------------------------------------------------------*/
/*
 * Copyright (C) 2021, zeweni (17870070675@163.com)
 
 * This file is part of 8051 ELL low-layer libraries.
 
 * 8051 ELL low-layer libraries is free software: you can redistribute 
 * it and/or modify it under the terms of the Apache-2.0 License.
 
 * 8051 ELL low-layer libraries is distributed in the hope that it will 
 * be useful,but WITHOUT ANY WARRANTY; without even the implied warranty 
 * of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the 
 * Apache-2.0 License for more details.
 
 * You should have received a copy of the Apache-2.0 License.8051 ELL 
 * low-layer libraries. If not, see <http://www.apache.org/licenses/>.
**/
/*-----------------------------------------------------------------------
|                               INCLUDES                                |
-----------------------------------------------------------------------*/
#ifndef __STC8x_SYSCLK_H_
#define __STC8x_SYSCLK_H_
 
/*--------------------------------------------------------
| @Description: ELL library core                         |
--------------------------------------------------------*/
#include "ELL_CORE.h"
 
/*--------------------------------------------------------
| @Description: STC8x MCU Register                       |
--------------------------------------------------------*/
 
#if    (PER_LIB_MCU_MUODEL == STC8Ax)
    #include "STC8Ax_REG.h"  
#elif  (PER_LIB_MCU_MUODEL == STC8Cx)
    #include "STC8Cx_REG.h"
#elif  (PER_LIB_MCU_MUODEL == STC8Fx)
    #include "STC8Fx_REG.h"
#elif  (PER_LIB_MCU_MUODEL == STC8Gx)
    #include "STC8Gx_REG.h"
#elif  (PER_LIB_MCU_MUODEL == STC8Hx)
    #include "STC8Hx_REG.h"
#endif
 
 
/*-----------------------------------------------------------------------
|                                 DATA                                  |
-----------------------------------------------------------------------*/
 
#ifndef PER_LIB_MCU_MUODEL  
    #define PER_LIB_MCU_MUODEL STC8Ax
#endif
 
#ifndef PER_LIB_SYSCLK_CTRL
    #define PER_LIB_SYSCLK_CTRL 1
#endif
 
#ifndef PER_LIB_SYSCLK_VALUE   
    #define PER_LIB_SYSCLK_VALUE 0
#endif
 
 
#ifndef PER_LIB_SYSCLK_INIT_CTRL
    #define PER_LIB_SYSCLK_INIT_CTRL 1
#endif
 
 
#ifndef PER_LIB_SYSCLK_WORK_CTRL
    #define PER_LIB_SYSCLK_WORK_CTRL 1
#endif
 
/*--------------------------------------------------------
| @Description: System clock ferquency division define   |
--------------------------------------------------------*/
 
#if  (PER_LIB_MCU_MUODEL == STC8Ax || PER_LIB_MCU_MUODEL == STC8Fx )
 
    #define     SYSCLK_DIV1     0x10
    #define     SYSCLK_DIV2     0x20
    #define     SYSCLK_DIV4     0x40
    #define     SYSCLK_DIV8     0x70
    #define    SYSCLK_DIV16     0x90
    #define    SYSCLK_DIV32     0xB0
    #define    SYSCLK_DIV64     0xD0
    #define   SYSCLK_DIV128     0xF0
 
#endif
 
typedef enum
{
    TRIM0 = 0x00, 
    TRIM1 = 0x01, 
    TRIM2 = 0x02, 
    TRIM3 = 0x03  
}   LIRCTRIM_Type;
 
 
typedef enum
{
    SCLK_OUT_P54 = 0x00, 
    SCLK_OUT_P16 = 0x01  
}   SCLKOut_Type;
 
 
typedef enum
{
    AUTO = 0x00,   
    HIRC = 0x01,   
    LIRC = 0x02,   
    #if (PER_LIB_MCU_MUODEL == STC8Hx)
        X32KSC = 0x03,  
    #endif
    XOSC = 0x04    
} MCLKSrc_Type;
 
 
#if (PER_LIB_MCU_MUODEL == STC8Cx || PER_LIB_MCU_MUODEL == STC8Gx || PER_LIB_MCU_MUODEL == STC8Hx)
 
    typedef enum
    {
        IRC_Band_20MHz = 0x00, 
        #if   (PER_LIB_MCU_MUODEL == STC8Cx || PER_LIB_MCU_MUODEL == STC8Gx)
                IRC_Band_33MHz = 0x01 
        #elif (PER_LIB_MCU_MUODEL == STC8Hx)
                IRC_Band_35MHz = 0x01 
        #endif
    }  IRCBand_Type;
    
#endif
 
#if (PER_LIB_MCU_MUODEL == STC8Hx)
    
    typedef enum
    {
        XOSC_Filter_150MHz = 0x00,
        XOSC_Filter_125MHz = 0x01,
        XOSC_Filter_66MHz  = 0x02,
        XOSC_Filter_Null   = 0x03
    }   XOSCFilter_Type;
 
#endif
 
typedef struct
{
    MCLKSrc_Type MCLKSrc;  
    uint8_t IRCTRIM;    
    LIRCTRIM_Type LIRCTRIM;  
    #if (PER_LIB_MCU_MUODEL == STC8Cx || PER_LIB_MCU_MUODEL == STC8Gx || PER_LIB_MCU_MUODEL == STC8Hx)
        IRCBand_Type  IRCBand; 
    #endif
    uint8_t MCLKDiv;  
    uint8_t SCLKDiv;  
    SCLKOut_Type SCLKOutPin; 
#if (PER_LIB_MCU_MUODEL == STC8Hx)
    XOSCFilter_Type XOSCFilter; 
#endif
 
} SYSCLK_InitType;
 
/*-----------------------------------------------------------------------
|                             API FUNCTION                              |
-----------------------------------------------------------------------*/
#if (PER_LIB_SYSCLK_CTRL == 1)
 
    #if (PER_LIB_SYSCLK_INIT_CTRL == 1)
 
        FSCSTATE SYSCLK_Init(const SYSCLK_InitType *sysClkn);
 
    #endif
 
    #if (PER_LIB_SYSCLK_WORK_CTRL == 1)
 
        uint32_t Get_SysClk_FRE(void);
 
    #endif
    
#endif
 
/*-----------------------------------------------------------------------
|                   END OF FLIE.  (C) COPYRIGHT zeweni                  |
-----------------------------------------------------------------------*/
#endif