lib/main/STM32F4/Drivers/STM32F4xx_StdPeriph_Driver/src/stm32f4xx_dbgmcu.c

   1 /**
   2   ******************************************************************************
   3   * @file    stm32f4xx_dbgmcu.c
   4   * @author  MCD Application Team
   5   * @version V1.7.1
   6   * @date    20-May-2016
   7   * @brief   This file provides all the DBGMCU firmware functions.
   8   ******************************************************************************
   9   * @attention
  10   *
  11   * <h2><center>&copy; COPYRIGHT 2016 STMicroelectronics</center></h2>
  12   *
  13   * Licensed under MCD-ST Liberty SW License Agreement V2, (the "License");
  14   * You may not use this file except in compliance with the License.
  15   * You may obtain a copy of the License at:
  16   *
  17   *        http://www.st.com/software_license_agreement_liberty_v2
  18   *
  19   * Unless required by applicable law or agreed to in writing, software
  20   * distributed under the License is distributed on an "AS IS" BASIS,
  21   * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
  22   * See the License for the specific language governing permissions and
  23   * limitations under the License.
  24   *
  25   ******************************************************************************
  26   */
  27
  28 /* Includes ------------------------------------------------------------------*/
  29 #include "stm32f4xx_dbgmcu.h"
  30
  31 /** @addtogroup STM32F4xx_StdPeriph_Driver
  32   * @{
  33   */
  34
  35 /** @defgroup DBGMCU
  36   * @brief DBGMCU driver modules
  37   * @{
  38   */
  39
  40 /* Private typedef -----------------------------------------------------------*/
  41 /* Private define ------------------------------------------------------------*/
  42 #define IDCODE_DEVID_MASK    ((uint32_t)0x00000FFF)
  43
  44 /* Private macro -------------------------------------------------------------*/
  45 /* Private variables ---------------------------------------------------------*/
  46 /* Private function prototypes -----------------------------------------------*/
  47 /* Private functions ---------------------------------------------------------*/
  48
  49 /** @defgroup DBGMCU_Private_Functions
  50   * @{
  51   */
  52
  53 /**
  54   * @brief  Returns the device revision identifier.
  55   * @param  None
  56   * @retval Device revision identifier
  57   */
  58 uint32_t DBGMCU_GetREVID(void)
  59 {
  60    return(DBGMCU->IDCODE >> 16);
  61 }
  62
  63 /**
  64   * @brief  Returns the device identifier.
  65   * @param  None
  66   * @retval Device identifier
  67   */
  68 uint32_t DBGMCU_GetDEVID(void)
  69 {
  70    return(DBGMCU->IDCODE & IDCODE_DEVID_MASK);
  71 }
  72
  73 /**
  74   * @brief  Configures low power mode behavior when the MCU is in Debug mode.
  75   * @param  DBGMCU_Periph: specifies the low power mode.
  76   *   This parameter can be any combination of the following values:
  77   *     @arg DBGMCU_SLEEP: Keep debugger connection during SLEEP mode
  78   *     @arg DBGMCU_STOP: Keep debugger connection during STOP mode
  79   *     @arg DBGMCU_STANDBY: Keep debugger connection during STANDBY mode
  80   * @param  NewState: new state of the specified low power mode in Debug mode.
  81   *   This parameter can be: ENABLE or DISABLE.
  82   * @retval None
  83   */
  84 void DBGMCU_Config(uint32_t DBGMCU_Periph, FunctionalState NewState)
  85 {
  86   /* Check the parameters */
  87   assert_param(IS_DBGMCU_PERIPH(DBGMCU_Periph));
  88   assert_param(IS_FUNCTIONAL_STATE(NewState));
  89   if (NewState != DISABLE)
  90   {
  91     DBGMCU->CR |= DBGMCU_Periph;
  92   }
  93   else
  94   {
  95     DBGMCU->CR &= ~DBGMCU_Periph;
  96   }
  97 }
  98
  99 /**
 100   * @brief  Configures APB1 peripheral behavior when the MCU is in Debug mode.
 101   * @param  DBGMCU_Periph: specifies the APB1 peripheral.
 102   *   This parameter can be any combination of the following values:
 103   *     @arg DBGMCU_TIM2_STOP: TIM2 counter stopped when Core is halted
 104   *     @arg DBGMCU_TIM3_STOP: TIM3 counter stopped when Core is halted
 105   *     @arg DBGMCU_TIM4_STOP: TIM4 counter stopped when Core is halted
 106   *     @arg DBGMCU_TIM5_STOP: TIM5 counter stopped when Core is halted
 107   *     @arg DBGMCU_TIM6_STOP: TIM6 counter stopped when Core is halted
 108   *     @arg DBGMCU_TIM7_STOP: TIM7 counter stopped when Core is halted
 109   *     @arg DBGMCU_TIM12_STOP: TIM12 counter stopped when Core is halted
 110   *     @arg DBGMCU_TIM13_STOP: TIM13 counter stopped when Core is halted
 111   *     @arg DBGMCU_TIM14_STOP: TIM14 counter stopped when Core is halted
 112   *     @arg DBGMCU_RTC_STOP: RTC Calendar and Wakeup counter stopped when Core is halted.
 113   *     @arg DBGMCU_WWDG_STOP: Debug WWDG stopped when Core is halted
 114   *     @arg DBGMCU_IWDG_STOP: Debug IWDG stopped when Core is halted
 115   *     @arg DBGMCU_I2C1_SMBUS_TIMEOUT: I2C1 SMBUS timeout mode stopped when Core is halted
 116   *     @arg DBGMCU_I2C2_SMBUS_TIMEOUT: I2C2 SMBUS timeout mode stopped when Core is halted
 117   *     @arg DBGMCU_I2C3_SMBUS_TIMEOUT: I2C3 SMBUS timeout mode stopped when Core is halted
 118   *     @arg DBGMCU_CAN2_STOP: Debug CAN1 stopped when Core is halted
 119   *     @arg DBGMCU_CAN1_STOP: Debug CAN2 stopped when Core is halted
 120   *   This parameter can be: ENABLE or DISABLE.
 121   * @retval None
 122   */
 123 void DBGMCU_APB1PeriphConfig(uint32_t DBGMCU_Periph, FunctionalState NewState)
 124 {
 125   /* Check the parameters */
 126   assert_param(IS_DBGMCU_APB1PERIPH(DBGMCU_Periph));
 127   assert_param(IS_FUNCTIONAL_STATE(NewState));
 128
 129   if (NewState != DISABLE)
 130   {
 131     DBGMCU->APB1FZ |= DBGMCU_Periph;
 132   }
 133   else
 134   {
 135     DBGMCU->APB1FZ &= ~DBGMCU_Periph;
 136   }
 137 }
 138
 139 /**
 140   * @brief  Configures APB2 peripheral behavior when the MCU is in Debug mode.
 141   * @param  DBGMCU_Periph: specifies the APB2 peripheral.
 142   *   This parameter can be any combination of the following values:
 143   *     @arg DBGMCU_TIM1_STOP: TIM1 counter stopped when Core is halted
 144   *     @arg DBGMCU_TIM8_STOP: TIM8 counter stopped when Core is halted
 145   *     @arg DBGMCU_TIM9_STOP: TIM9 counter stopped when Core is halted
 146   *     @arg DBGMCU_TIM10_STOP: TIM10 counter stopped when Core is halted
 147   *     @arg DBGMCU_TIM11_STOP: TIM11 counter stopped when Core is halted
 148   * @param  NewState: new state of the specified peripheral in Debug mode.
 149   *   This parameter can be: ENABLE or DISABLE.
 150   * @retval None
 151   */
 152 void DBGMCU_APB2PeriphConfig(uint32_t DBGMCU_Periph, FunctionalState NewState)
 153 {
 154   /* Check the parameters */
 155   assert_param(IS_DBGMCU_APB2PERIPH(DBGMCU_Periph));
 156   assert_param(IS_FUNCTIONAL_STATE(NewState));
 157
 158   if (NewState != DISABLE)
 159   {
 160     DBGMCU->APB2FZ |= DBGMCU_Periph;
 161   }
 162   else
 163   {
 164     DBGMCU->APB2FZ &= ~DBGMCU_Periph;
 165   }
 166 }
 167
 168 /**
 169   * @}
 170   */
 171
 172 /**
 173   * @}
 174   */
 175
 176 /**
 177   * @}
 178   */
 179
 180 /************************ (C) COPYRIGHT STMicroelectronics *****END OF FILE****/