text: /**
    ******************************************************************************
    * @file    stm32f30x_dbgmcu.c
    * @author  MCD Application Team
    * @version V1.2.2
    * @date    27-February-2015
    * @brief   This file provides firmware functions to manage the following 
    *          functionalities of the Debug MCU (DBGMCU) peripheral:
    *           + Device and Revision ID management
    *           + Peripherals Configuration
    ******************************************************************************
    * @attention
    *
    * <h2><center>&copy; COPYRIGHT 2015 STMicroelectronics</center></h2>
    *
    * Licensed under MCD-ST Liberty SW License Agreement V2, (the "License");
    * You may not use this file except in compliance with the License.
    * You may obtain a copy of the License at:
    *
    *        http://www.st.com/software_license_agreement_liberty_v2
    *
    * Unless required by applicable law or agreed to in writing, software 
    * distributed under the License is distributed on an "AS IS" BASIS, 
    * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
    * See the License for the specific language governing permissions and
    * limitations under the License.
    *
    ******************************************************************************
    */
  
  /* Includes ------------------------------------------------------------------*/
  #include "stm32f30x_dbgmcu.h"
  
  /** @addtogroup STM32F30x_StdPeriph_Driver
    * @{
    */
  
  /** @defgroup DBGMCU 
    * @brief DBGMCU driver modules
    * @{
    */ 
  
  /* Private typedef -----------------------------------------------------------*/
  /* Private define ------------------------------------------------------------*/
  #define IDCODE_DEVID_MASK    ((uint32_t)0x00000FFF)
  
  /* Private macro -------------------------------------------------------------*/
  /* Private variables ---------------------------------------------------------*/
  /* Private function prototypes -----------------------------------------------*/
  /* Private functions ---------------------------------------------------------*/
  
  /** @defgroup DBGMCU_Private_Functions
    * @{
    */ 
  
  /** @defgroup DBGMCU_Group1 Device and Revision ID management functions
   *  @brief   Device and Revision ID management functions
   *
  @verbatim
    ==============================================================================
              ##### Device and Revision ID management functions #####
    ==============================================================================
  
  @endverbatim
    * @{
    */
  
  /**
    * @brief  Returns the device revision identifier.
    * @param  None
    * @retval Device revision identifier
    */
  uint32_t DBGMCU_GetREVID(void)
  {
     return(DBGMCU->IDCODE >> 16);
  }
  
  /**
    * @brief   Returns the device identifier.
    * @param  None
    * @retval Device identifier
    */
  uint32_t DBGMCU_GetDEVID(void)
  {
     return(DBGMCU->IDCODE & IDCODE_DEVID_MASK);
  }
  
  /**
    * @}
    */
    
  /** @defgroup DBGMCU_Group2 Peripherals Configuration functions
   *  @brief   Peripherals Configuration
   *
  @verbatim
    ==============================================================================
                 ##### Peripherals Configuration functions #####
    ==============================================================================
  
  @endverbatim
    * @{
    */
  
  /**
    * @brief  Configures low power mode behavior when the MCU is in Debug mode.
    * @param  DBGMCU_Periph: specifies the low power mode.
    *   This parameter can be any combination of the following values:
    *     @arg DBGMCU_SLEEP: Keep debugger connection during SLEEP mode.              
    *     @arg DBGMCU_STOP: Keep debugger connection during STOP mode.               
    *     @arg DBGMCU_STANDBY: Keep debugger connection during STANDBY mode.        
    * @param  NewState: new state of the specified low power mode in Debug mode.
    *   This parameter can be: ENABLE or DISABLE.
    * @retval None
    */
  void DBGMCU_Config(uint32_t DBGMCU_Periph, FunctionalState NewState)
  {
    /* Check the parameters */
    assert_param(IS_DBGMCU_PERIPH(DBGMCU_Periph));
    assert_param(IS_FUNCTIONAL_STATE(NewState));
    if (NewState != DISABLE)
    {
      DBGMCU->CR |= DBGMCU_Periph;
    }
    else
    {
      DBGMCU->CR &= ~DBGMCU_Periph;
    }
  }
  
  /**
    * @brief  Configures APB1 peripheral behavior when the MCU is in Debug mode.
    * @param  DBGMCU_Periph: specifies the APB1 peripheral.
    *   This parameter can be any combination of the following values:        
    *     @arg DBGMCU_TIM2_STOP: TIM2 counter stopped when Core is halted.          
    *     @arg DBGMCU_TIM3_STOP: TIM3 counter stopped when Core is halted.          
    *     @arg DBGMCU_TIM4_STOP: TIM4 counter stopped when Core is halted.
    *     @arg DBGMCU_TIM6_STOP: TIM6 counter stopped when Core is halted.          
    *     @arg DBGMCU_TIM7_STOP: TIM7 counter stopped when Core is halted.
    *     @arg DBGMCU_RTC_STOP: RTC Calendar and Wakeup counter are stopped when 
    *          Core is halted. 
    *     @arg DBGMCU_WWDG_STOP: Debug WWDG stopped when Core is halted.
    *     @arg DBGMCU_IWDG_STOP: Debug IWDG stopped when Core is halted.        
    *     @arg DBGMCU_I2C1_SMBUS_TIMEOUT: I2C1 SMBUS timeout mode stopped when 
    *          Core is halted.
    *     @arg DBGMCU_I2C2_SMBUS_TIMEOUT: I2C2 SMBUS timeout mode stopped when 
    *          Core is halted.
    *     @arg DBGMCU_CAN1_STOP: Debug CAN2 stopped when Core is halted.  
    *     @arg DBGMCU_I2C3_SMBUS_TIMEOUT: I2C3 SMBUS timeout mode stopped when 
    *          Core is halted.      
    * @param  NewState: new state of the specified APB1 peripheral in Debug mode.
    *         This parameter can be: ENABLE or DISABLE.
    * @retval None
    */
  void DBGMCU_APB1PeriphConfig(uint32_t DBGMCU_Periph, FunctionalState NewState)
  {
    /* Check the parameters */
    assert_param(IS_DBGMCU_APB1PERIPH(DBGMCU_Periph));
    assert_param(IS_FUNCTIONAL_STATE(NewState));
  
    if (NewState != DISABLE)
    {
      DBGMCU->APB1FZ |= DBGMCU_Periph;
    }
    else
    {
      DBGMCU->APB1FZ &= ~DBGMCU_Periph;
    }
  }
  
  /**
    * @brief  Configures APB2 peripheral behavior when the MCU is in Debug mode.
    * @param  DBGMCU_Periph: specifies the APB2 peripheral.
    *   This parameter can be any combination of the following values:       
    *     @arg DBGMCU_TIM1_STOP: TIM1 counter stopped when Core is halted.   
    *     @arg DBGMCU_TIM8_STOP: TIM8 counter stopped when Core is halted. 
    *     @arg DBGMCU_TIM15_STOP: TIM15 counter stopped when Core is halted.                
    *     @arg DBGMCU_TIM16_STOP: TIM16 counter stopped when Core is halted.
    *     @arg DBGMCU_TIM17_STOP: TIM17 counter stopped when Core is halted.   
    *     @arg DBGMCU_TIM20_STOP: TIM20 counter stopped when Core is halted.   
    * @param  NewState: new state of the specified APB2 peripheral in Debug mode.
    *         This parameter can be: ENABLE or DISABLE.
    * @retval None
    */
  void DBGMCU_APB2PeriphConfig(uint32_t DBGMCU_Periph, FunctionalState NewState)
  {
    /* Check the parameters */
    assert_param(IS_DBGMCU_APB2PERIPH(DBGMCU_Periph));
    assert_param(IS_FUNCTIONAL_STATE(NewState));
  
    if (NewState != DISABLE)
    {
      DBGMCU->APB2FZ |= DBGMCU_Periph;
    }
    else
    {
      DBGMCU->APB2FZ &= ~DBGMCU_Periph;
    }
  }
  
  /**
    * @}
    */ 
  
  /**
    * @}
    */ 
  
  /**
    * @}
    */ 
  
  /**
    * @}
    */ 
    
  /************************ (C) COPYRIGHT STMicroelectronics *****END OF FILE****/
  