Abdessamad El Abbassi / mbed-src-temp

mbed library sources

Fork of mbed-src by mbed official

targets/cmsis/TARGET_STM/TARGET_NUCLEO_L152RE/stm32l1xx_dbgmcu.c@106:ced8cbb51063, 2014-02-26 (annotated)

Committer:
mbed_official
Date:
Wed Feb 26 09:45:12 2014 +0000
Revision:
106:ced8cbb51063
Parent:
80:66393a7b209d 
Synchronized with git revision 4222735eff5868389433f0e9271976b39c8115cd



Full URL: https://github.com/mbedmicro/mbed/commit/4222735eff5868389433f0e9271976b39c8115cd/



[NUCLEO_xxx] Update STM32CubeF4 driver V1.0.0 + update license

Who changed what in which revision?

UserRevisionLine numberNew contents of line
mbed_official 76:aeb1df146756 1 /**
mbed_official 76:aeb1df146756 2 ******************************************************************************
mbed_official 76:aeb1df146756 3 * @file stm32l1xx_dbgmcu.c
mbed_official 76:aeb1df146756 4 * @author MCD Application Team
mbed_official 80:66393a7b209d 5 * @version V1.3.0
mbed_official 80:66393a7b209d 6 * @date 31-January-2014
mbed_official 76:aeb1df146756 7 * @brief This file provides all the DBGMCU firmware functions.
mbed_official 76:aeb1df146756 8 ******************************************************************************
mbed_official 76:aeb1df146756 9 * @attention
mbed_official 76:aeb1df146756 10 *
mbed_official 106:ced8cbb51063 11 * <h2><center>&copy; COPYRIGHT(c) 2014 STMicroelectronics</center></h2>
mbed_official 76:aeb1df146756 12 *
mbed_official 106:ced8cbb51063 13 * Redistribution and use in source and binary forms, with or without modification,
mbed_official 106:ced8cbb51063 14 * are permitted provided that the following conditions are met:
mbed_official 106:ced8cbb51063 15 * 1. Redistributions of source code must retain the above copyright notice,
mbed_official 106:ced8cbb51063 16 * this list of conditions and the following disclaimer.
mbed_official 106:ced8cbb51063 17 * 2. Redistributions in binary form must reproduce the above copyright notice,
mbed_official 106:ced8cbb51063 18 * this list of conditions and the following disclaimer in the documentation
mbed_official 106:ced8cbb51063 19 * and/or other materials provided with the distribution.
mbed_official 106:ced8cbb51063 20 * 3. Neither the name of STMicroelectronics nor the names of its contributors
mbed_official 106:ced8cbb51063 21 * may be used to endorse or promote products derived from this software
mbed_official 106:ced8cbb51063 22 * without specific prior written permission.
mbed_official 76:aeb1df146756 23 *
mbed_official 106:ced8cbb51063 24 * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
mbed_official 106:ced8cbb51063 25 * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
mbed_official 106:ced8cbb51063 26 * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
mbed_official 106:ced8cbb51063 27 * DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE
mbed_official 106:ced8cbb51063 28 * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
mbed_official 106:ced8cbb51063 29 * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
mbed_official 106:ced8cbb51063 30 * SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
mbed_official 106:ced8cbb51063 31 * CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
mbed_official 106:ced8cbb51063 32 * OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
mbed_official 106:ced8cbb51063 33 * OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
mbed_official 76:aeb1df146756 34 *
mbed_official 76:aeb1df146756 35 ******************************************************************************
mbed_official 76:aeb1df146756 36 */
mbed_official 76:aeb1df146756 37
mbed_official 76:aeb1df146756 38 /* Includes ------------------------------------------------------------------*/
mbed_official 76:aeb1df146756 39 #include "stm32l1xx_dbgmcu.h"
mbed_official 76:aeb1df146756 40
mbed_official 76:aeb1df146756 41 /** @addtogroup STM32L1xx_StdPeriph_Driver
mbed_official 76:aeb1df146756 42 * @{
mbed_official 76:aeb1df146756 43 */
mbed_official 76:aeb1df146756 44
mbed_official 76:aeb1df146756 45 /** @defgroup DBGMCU
mbed_official 76:aeb1df146756 46 * @brief DBGMCU driver modules
mbed_official 76:aeb1df146756 47 * @{
mbed_official 76:aeb1df146756 48 */
mbed_official 76:aeb1df146756 49
mbed_official 76:aeb1df146756 50 /* Private typedef -----------------------------------------------------------*/
mbed_official 76:aeb1df146756 51 /* Private define ------------------------------------------------------------*/
mbed_official 76:aeb1df146756 52 #define IDCODE_DEVID_MASK ((uint32_t)0x00000FFF)
mbed_official 76:aeb1df146756 53
mbed_official 76:aeb1df146756 54 /* Private macro -------------------------------------------------------------*/
mbed_official 76:aeb1df146756 55 /* Private variables ---------------------------------------------------------*/
mbed_official 76:aeb1df146756 56 /* Private function prototypes -----------------------------------------------*/
mbed_official 76:aeb1df146756 57 /* Private functions ---------------------------------------------------------*/
mbed_official 76:aeb1df146756 58
mbed_official 76:aeb1df146756 59 /** @defgroup DBGMCU_Private_Functions
mbed_official 76:aeb1df146756 60 * @{
mbed_official 76:aeb1df146756 61 */
mbed_official 76:aeb1df146756 62
mbed_official 76:aeb1df146756 63 /**
mbed_official 76:aeb1df146756 64 * @brief Returns the device revision identifier.
mbed_official 76:aeb1df146756 65 * @param None
mbed_official 76:aeb1df146756 66 * @retval Device revision identifier
mbed_official 76:aeb1df146756 67 */
mbed_official 76:aeb1df146756 68 uint32_t DBGMCU_GetREVID(void)
mbed_official 76:aeb1df146756 69 {
mbed_official 76:aeb1df146756 70 return(DBGMCU->IDCODE >> 16);
mbed_official 76:aeb1df146756 71 }
mbed_official 76:aeb1df146756 72
mbed_official 76:aeb1df146756 73 /**
mbed_official 76:aeb1df146756 74 * @brief Returns the device identifier.
mbed_official 76:aeb1df146756 75 * @param None
mbed_official 76:aeb1df146756 76 * @retval Device identifier
mbed_official 76:aeb1df146756 77 */
mbed_official 76:aeb1df146756 78 uint32_t DBGMCU_GetDEVID(void)
mbed_official 76:aeb1df146756 79 {
mbed_official 76:aeb1df146756 80 return(DBGMCU->IDCODE & IDCODE_DEVID_MASK);
mbed_official 76:aeb1df146756 81 }
mbed_official 76:aeb1df146756 82
mbed_official 76:aeb1df146756 83 /**
mbed_official 76:aeb1df146756 84 * @brief Configures low power mode behavior when the MCU is in Debug mode.
mbed_official 76:aeb1df146756 85 * @param DBGMCU_Periph: specifies the low power mode.
mbed_official 76:aeb1df146756 86 * This parameter can be any combination of the following values:
mbed_official 76:aeb1df146756 87 * @arg DBGMCU_SLEEP: Keep debugger connection during SLEEP mode
mbed_official 76:aeb1df146756 88 * @arg DBGMCU_STOP: Keep debugger connection during STOP mode
mbed_official 76:aeb1df146756 89 * @arg DBGMCU_STANDBY: Keep debugger connection during STANDBY mode
mbed_official 76:aeb1df146756 90 * @param NewState: new state of the specified low power mode in Debug mode.
mbed_official 76:aeb1df146756 91 * This parameter can be: ENABLE or DISABLE.
mbed_official 76:aeb1df146756 92 * @retval None
mbed_official 76:aeb1df146756 93 */
mbed_official 76:aeb1df146756 94 void DBGMCU_Config(uint32_t DBGMCU_Periph, FunctionalState NewState)
mbed_official 76:aeb1df146756 95 {
mbed_official 76:aeb1df146756 96 /* Check the parameters */
mbed_official 76:aeb1df146756 97 assert_param(IS_DBGMCU_PERIPH(DBGMCU_Periph));
mbed_official 76:aeb1df146756 98 assert_param(IS_FUNCTIONAL_STATE(NewState));
mbed_official 76:aeb1df146756 99
mbed_official 76:aeb1df146756 100 if (NewState != DISABLE)
mbed_official 76:aeb1df146756 101 {
mbed_official 76:aeb1df146756 102 DBGMCU->CR |= DBGMCU_Periph;
mbed_official 76:aeb1df146756 103 }
mbed_official 76:aeb1df146756 104 else
mbed_official 76:aeb1df146756 105 {
mbed_official 76:aeb1df146756 106 DBGMCU->CR &= ~DBGMCU_Periph;
mbed_official 76:aeb1df146756 107 }
mbed_official 76:aeb1df146756 108 }
mbed_official 76:aeb1df146756 109
mbed_official 76:aeb1df146756 110
mbed_official 76:aeb1df146756 111 /**
mbed_official 76:aeb1df146756 112 * @brief Configures APB1 peripheral behavior when the MCU is in Debug mode.
mbed_official 76:aeb1df146756 113 * @param DBGMCU_Periph: specifies the APB1 peripheral.
mbed_official 76:aeb1df146756 114 * This parameter can be any combination of the following values:
mbed_official 76:aeb1df146756 115 * @arg DBGMCU_TIM2_STOP: TIM2 counter stopped when Core is halted
mbed_official 76:aeb1df146756 116 * @arg DBGMCU_TIM3_STOP: TIM3 counter stopped when Core is halted
mbed_official 76:aeb1df146756 117 * @arg DBGMCU_TIM4_STOP: TIM4 counter stopped when Core is halted
mbed_official 76:aeb1df146756 118 * @arg DBGMCU_TIM5_STOP: TIM5 counter stopped when Core is halted
mbed_official 76:aeb1df146756 119 * @arg DBGMCU_TIM6_STOP: TIM6 counter stopped when Core is halted
mbed_official 76:aeb1df146756 120 * @arg DBGMCU_TIM7_STOP: TIM7 counter stopped when Core is halted
mbed_official 76:aeb1df146756 121 * @arg DBGMCU_RTC_STOP:
mbed_official 76:aeb1df146756 122 * + On STM32L1xx Medium-density devices: RTC Wakeup counter stopped when
mbed_official 76:aeb1df146756 123 * Core is halted.
mbed_official 76:aeb1df146756 124 * + On STM32L1xx High-density and Medium-density Plus devices: RTC Calendar
mbed_official 76:aeb1df146756 125 * and Wakeup counter stopped when Core is halted.
mbed_official 76:aeb1df146756 126 * @arg DBGMCU_WWDG_STOP: Debug WWDG stopped when Core is halted
mbed_official 76:aeb1df146756 127 * @arg DBGMCU_IWDG_STOP: Debug IWDG stopped when Core is halted
mbed_official 76:aeb1df146756 128 * @arg DBGMCU_I2C1_SMBUS_TIMEOUT: I2C1 SMBUS timeout mode stopped when Core is
mbed_official 76:aeb1df146756 129 * halted
mbed_official 76:aeb1df146756 130 * @arg DBGMCU_I2C2_SMBUS_TIMEOUT: I2C2 SMBUS timeout mode stopped when Core is
mbed_official 76:aeb1df146756 131 * halted
mbed_official 76:aeb1df146756 132 * @param NewState: new state of the specified APB1 peripheral in Debug mode.
mbed_official 76:aeb1df146756 133 * This parameter can be: ENABLE or DISABLE.
mbed_official 76:aeb1df146756 134 * @retval None
mbed_official 76:aeb1df146756 135 */
mbed_official 76:aeb1df146756 136 void DBGMCU_APB1PeriphConfig(uint32_t DBGMCU_Periph, FunctionalState NewState)
mbed_official 76:aeb1df146756 137 {
mbed_official 76:aeb1df146756 138 /* Check the parameters */
mbed_official 76:aeb1df146756 139 assert_param(IS_DBGMCU_APB1PERIPH(DBGMCU_Periph));
mbed_official 76:aeb1df146756 140 assert_param(IS_FUNCTIONAL_STATE(NewState));
mbed_official 76:aeb1df146756 141
mbed_official 76:aeb1df146756 142 if (NewState != DISABLE)
mbed_official 76:aeb1df146756 143 {
mbed_official 76:aeb1df146756 144 DBGMCU->APB1FZ |= DBGMCU_Periph;
mbed_official 76:aeb1df146756 145 }
mbed_official 76:aeb1df146756 146 else
mbed_official 76:aeb1df146756 147 {
mbed_official 76:aeb1df146756 148 DBGMCU->APB1FZ &= ~DBGMCU_Periph;
mbed_official 76:aeb1df146756 149 }
mbed_official 76:aeb1df146756 150 }
mbed_official 76:aeb1df146756 151
mbed_official 76:aeb1df146756 152 /**
mbed_official 76:aeb1df146756 153 * @brief Configures APB2 peripheral behavior when the MCU is in Debug mode.
mbed_official 76:aeb1df146756 154 * @param DBGMCU_Periph: specifies the APB2 peripheral.
mbed_official 76:aeb1df146756 155 * This parameter can be any combination of the following values:
mbed_official 76:aeb1df146756 156 * @arg DBGMCU_TIM9_STOP: TIM9 counter stopped when Core is halted
mbed_official 76:aeb1df146756 157 * @arg DBGMCU_TIM10_STOP: TIM10 counter stopped when Core is halted
mbed_official 76:aeb1df146756 158 * @arg DBGMCU_TIM11_STOP: TIM11 counter stopped when Core is halted
mbed_official 76:aeb1df146756 159 * @param NewState: new state of the specified APB2 peripheral in Debug mode.
mbed_official 76:aeb1df146756 160 * This parameter can be: ENABLE or DISABLE.
mbed_official 76:aeb1df146756 161 * @retval None
mbed_official 76:aeb1df146756 162 */
mbed_official 76:aeb1df146756 163 void DBGMCU_APB2PeriphConfig(uint32_t DBGMCU_Periph, FunctionalState NewState)
mbed_official 76:aeb1df146756 164 {
mbed_official 76:aeb1df146756 165 /* Check the parameters */
mbed_official 76:aeb1df146756 166 assert_param(IS_DBGMCU_APB2PERIPH(DBGMCU_Periph));
mbed_official 76:aeb1df146756 167 assert_param(IS_FUNCTIONAL_STATE(NewState));
mbed_official 76:aeb1df146756 168
mbed_official 76:aeb1df146756 169 if (NewState != DISABLE)
mbed_official 76:aeb1df146756 170 {
mbed_official 76:aeb1df146756 171 DBGMCU->APB2FZ |= DBGMCU_Periph;
mbed_official 76:aeb1df146756 172 }
mbed_official 76:aeb1df146756 173 else
mbed_official 76:aeb1df146756 174 {
mbed_official 76:aeb1df146756 175 DBGMCU->APB2FZ &= ~DBGMCU_Periph;
mbed_official 76:aeb1df146756 176 }
mbed_official 76:aeb1df146756 177 }
mbed_official 76:aeb1df146756 178
mbed_official 76:aeb1df146756 179 /**
mbed_official 76:aeb1df146756 180 * @}
mbed_official 76:aeb1df146756 181 */
mbed_official 76:aeb1df146756 182
mbed_official 76:aeb1df146756 183 /**
mbed_official 76:aeb1df146756 184 * @}
mbed_official 76:aeb1df146756 185 */
mbed_official 76:aeb1df146756 186
mbed_official 76:aeb1df146756 187 /**
mbed_official 76:aeb1df146756 188 * @}
mbed_official 76:aeb1df146756 189 */
mbed_official 76:aeb1df146756 190
mbed_official 76:aeb1df146756 191 /************************ (C) COPYRIGHT STMicroelectronics *****END OF FILE****/