mbed official / mbed-src

mbed library sources

Dependents:   Encrypted my_mbed lklk CyaSSL_DTLS_Cellular ... more

Superseded

This library was superseded by mbed-dev - https://os.mbed.com/users/mbed_official/code/mbed-dev/.

Development branch of the mbed library sources. This library is kept in synch with the latest changes from the mbed SDK and it is not guaranteed to work.

If you are looking for a stable and tested release, please import one of the official mbed library releases:

Import librarymbed

The official Mbed 2 C/C++ SDK provides the software platform and libraries to build your applications.

Last commit 20 Feb 2019 by mbed official

targets/hal/TARGET_STM/TARGET_STM32F7/pwmout_api.c@573:ad23fe03a082, 2015-06-19 (annotated)

Committer:
mbed_official
Date:
Fri Jun 19 09:15:11 2015 +0100
Revision:
573:ad23fe03a082
Child:
582:a89625bcd809
Synchronized with git revision d47834cd4d729e5b36b4c1ad4650f8b8f6a9ab86



Full URL: https://github.com/mbedmicro/mbed/commit/d47834cd4d729e5b36b4c1ad4650f8b8f6a9ab86/



DISCO_F746NG - Add new target

Who changed what in which revision?

UserRevisionLine numberNew contents of line
mbed_official 573:ad23fe03a082 1 /* mbed Microcontroller Library
mbed_official 573:ad23fe03a082 2 *******************************************************************************
mbed_official 573:ad23fe03a082 3 * Copyright (c) 2015, STMicroelectronics
mbed_official 573:ad23fe03a082 4 * All rights reserved.
mbed_official 573:ad23fe03a082 5 *
mbed_official 573:ad23fe03a082 6 * Redistribution and use in source and binary forms, with or without
mbed_official 573:ad23fe03a082 7 * modification, are permitted provided that the following conditions are met:
mbed_official 573:ad23fe03a082 8 *
mbed_official 573:ad23fe03a082 9 * 1. Redistributions of source code must retain the above copyright notice,
mbed_official 573:ad23fe03a082 10 * this list of conditions and the following disclaimer.
mbed_official 573:ad23fe03a082 11 * 2. Redistributions in binary form must reproduce the above copyright notice,
mbed_official 573:ad23fe03a082 12 * this list of conditions and the following disclaimer in the documentation
mbed_official 573:ad23fe03a082 13 * and/or other materials provided with the distribution.
mbed_official 573:ad23fe03a082 14 * 3. Neither the name of STMicroelectronics nor the names of its contributors
mbed_official 573:ad23fe03a082 15 * may be used to endorse or promote products derived from this software
mbed_official 573:ad23fe03a082 16 * without specific prior written permission.
mbed_official 573:ad23fe03a082 17 *
mbed_official 573:ad23fe03a082 18 * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
mbed_official 573:ad23fe03a082 19 * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
mbed_official 573:ad23fe03a082 20 * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
mbed_official 573:ad23fe03a082 21 * DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE
mbed_official 573:ad23fe03a082 22 * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
mbed_official 573:ad23fe03a082 23 * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
mbed_official 573:ad23fe03a082 24 * SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
mbed_official 573:ad23fe03a082 25 * CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
mbed_official 573:ad23fe03a082 26 * OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
mbed_official 573:ad23fe03a082 27 * OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
mbed_official 573:ad23fe03a082 28 *******************************************************************************
mbed_official 573:ad23fe03a082 29 */
mbed_official 573:ad23fe03a082 30 #include "pwmout_api.h"
mbed_official 573:ad23fe03a082 31
mbed_official 573:ad23fe03a082 32 #if DEVICE_PWMOUT
mbed_official 573:ad23fe03a082 33
mbed_official 573:ad23fe03a082 34 #include "cmsis.h"
mbed_official 573:ad23fe03a082 35 #include "pinmap.h"
mbed_official 573:ad23fe03a082 36 #include "mbed_error.h"
mbed_official 573:ad23fe03a082 37 #include "PeripheralPins.h"
mbed_official 573:ad23fe03a082 38
mbed_official 573:ad23fe03a082 39 static TIM_HandleTypeDef TimHandle;
mbed_official 573:ad23fe03a082 40
mbed_official 573:ad23fe03a082 41 void pwmout_init(pwmout_t* obj, PinName pin)
mbed_official 573:ad23fe03a082 42 {
mbed_official 573:ad23fe03a082 43 // Get the peripheral name from the pin and assign it to the object
mbed_official 573:ad23fe03a082 44 obj->pwm = (PWMName)pinmap_peripheral(pin, PinMap_PWM);
mbed_official 573:ad23fe03a082 45
mbed_official 573:ad23fe03a082 46 // Get the functions (timer channel, (non)inverted) from the pin and assign it to the object
mbed_official 573:ad23fe03a082 47 uint32_t function = pinmap_function(pin, PinMap_PWM);
mbed_official 573:ad23fe03a082 48 MBED_ASSERT(function != (uint32_t)NC);
mbed_official 573:ad23fe03a082 49 obj->channel = STM_PIN_CHANNEL(function);
mbed_official 573:ad23fe03a082 50 obj->inverted = STM_PIN_INVERTED(function);
mbed_official 573:ad23fe03a082 51
mbed_official 573:ad23fe03a082 52 if (obj->pwm == (PWMName)NC) {
mbed_official 573:ad23fe03a082 53 error("PWM error: pinout mapping failed.");
mbed_official 573:ad23fe03a082 54 }
mbed_official 573:ad23fe03a082 55
mbed_official 573:ad23fe03a082 56 // Enable TIM clock
mbed_official 573:ad23fe03a082 57 if (obj->pwm == PWM_1) __TIM1_CLK_ENABLE();
mbed_official 573:ad23fe03a082 58 if (obj->pwm == PWM_2) __TIM2_CLK_ENABLE();
mbed_official 573:ad23fe03a082 59 if (obj->pwm == PWM_3) __TIM3_CLK_ENABLE();
mbed_official 573:ad23fe03a082 60 if (obj->pwm == PWM_4) __TIM4_CLK_ENABLE();
mbed_official 573:ad23fe03a082 61 #if defined(TIM8_BASE)
mbed_official 573:ad23fe03a082 62 if (obj->pwm == PWM_8) __TIM8_CLK_ENABLE();
mbed_official 573:ad23fe03a082 63 #endif
mbed_official 573:ad23fe03a082 64 if (obj->pwm == PWM_9) __TIM9_CLK_ENABLE();
mbed_official 573:ad23fe03a082 65 if (obj->pwm == PWM_10) __TIM10_CLK_ENABLE();
mbed_official 573:ad23fe03a082 66 if (obj->pwm == PWM_11) __TIM11_CLK_ENABLE();
mbed_official 573:ad23fe03a082 67 #if defined(TIM13_BASE)
mbed_official 573:ad23fe03a082 68 if (obj->pwm == PWM_13) __TIM13_CLK_ENABLE();
mbed_official 573:ad23fe03a082 69 #endif
mbed_official 573:ad23fe03a082 70 #if defined(TIM14_BASE)
mbed_official 573:ad23fe03a082 71 if (obj->pwm == PWM_14) __TIM14_CLK_ENABLE();
mbed_official 573:ad23fe03a082 72 #endif
mbed_official 573:ad23fe03a082 73
mbed_official 573:ad23fe03a082 74 // Configure GPIO
mbed_official 573:ad23fe03a082 75 pinmap_pinout(pin, PinMap_PWM);
mbed_official 573:ad23fe03a082 76
mbed_official 573:ad23fe03a082 77 obj->pin = pin;
mbed_official 573:ad23fe03a082 78 obj->period = 0;
mbed_official 573:ad23fe03a082 79 obj->pulse = 0;
mbed_official 573:ad23fe03a082 80
mbed_official 573:ad23fe03a082 81 pwmout_period_us(obj, 20000); // 20 ms per default
mbed_official 573:ad23fe03a082 82 }
mbed_official 573:ad23fe03a082 83
mbed_official 573:ad23fe03a082 84 void pwmout_free(pwmout_t* obj)
mbed_official 573:ad23fe03a082 85 {
mbed_official 573:ad23fe03a082 86 // Configure GPIO
mbed_official 573:ad23fe03a082 87 pin_function(obj->pin, STM_PIN_DATA(STM_MODE_INPUT, GPIO_NOPULL, 0));
mbed_official 573:ad23fe03a082 88 }
mbed_official 573:ad23fe03a082 89
mbed_official 573:ad23fe03a082 90 void pwmout_write(pwmout_t* obj, float value)
mbed_official 573:ad23fe03a082 91 {
mbed_official 573:ad23fe03a082 92 TIM_OC_InitTypeDef sConfig;
mbed_official 573:ad23fe03a082 93 int channel = 0;
mbed_official 573:ad23fe03a082 94 int complementary_channel = 0;
mbed_official 573:ad23fe03a082 95
mbed_official 573:ad23fe03a082 96 TimHandle.Instance = (TIM_TypeDef *)(obj->pwm);
mbed_official 573:ad23fe03a082 97
mbed_official 573:ad23fe03a082 98 if (value < (float)0.0) {
mbed_official 573:ad23fe03a082 99 value = 0.0;
mbed_official 573:ad23fe03a082 100 } else if (value > (float)1.0) {
mbed_official 573:ad23fe03a082 101 value = 1.0;
mbed_official 573:ad23fe03a082 102 }
mbed_official 573:ad23fe03a082 103
mbed_official 573:ad23fe03a082 104 obj->pulse = (uint32_t)((float)obj->period * value);
mbed_official 573:ad23fe03a082 105
mbed_official 573:ad23fe03a082 106 // Configure channels
mbed_official 573:ad23fe03a082 107 sConfig.OCMode = TIM_OCMODE_PWM1;
mbed_official 573:ad23fe03a082 108 sConfig.Pulse = obj->pulse;
mbed_official 573:ad23fe03a082 109 sConfig.OCPolarity = TIM_OCPOLARITY_HIGH;
mbed_official 573:ad23fe03a082 110 sConfig.OCNPolarity = TIM_OCNPOLARITY_HIGH;
mbed_official 573:ad23fe03a082 111 sConfig.OCFastMode = TIM_OCFAST_DISABLE;
mbed_official 573:ad23fe03a082 112 sConfig.OCIdleState = TIM_OCIDLESTATE_RESET;
mbed_official 573:ad23fe03a082 113 sConfig.OCNIdleState = TIM_OCNIDLESTATE_RESET;
mbed_official 573:ad23fe03a082 114
mbed_official 573:ad23fe03a082 115 complementary_channel = obj->inverted;
mbed_official 573:ad23fe03a082 116 switch (obj->channel) {
mbed_official 573:ad23fe03a082 117
mbed_official 573:ad23fe03a082 118 case 1:
mbed_official 573:ad23fe03a082 119 channel = TIM_CHANNEL_1;
mbed_official 573:ad23fe03a082 120 break;
mbed_official 573:ad23fe03a082 121
mbed_official 573:ad23fe03a082 122 case 2:
mbed_official 573:ad23fe03a082 123 channel = TIM_CHANNEL_2;
mbed_official 573:ad23fe03a082 124 break;
mbed_official 573:ad23fe03a082 125
mbed_official 573:ad23fe03a082 126 case 3:
mbed_official 573:ad23fe03a082 127 channel = TIM_CHANNEL_3;
mbed_official 573:ad23fe03a082 128 break;
mbed_official 573:ad23fe03a082 129
mbed_official 573:ad23fe03a082 130 case 4:
mbed_official 573:ad23fe03a082 131 channel = TIM_CHANNEL_4;
mbed_official 573:ad23fe03a082 132 break;
mbed_official 573:ad23fe03a082 133
mbed_official 573:ad23fe03a082 134 default:
mbed_official 573:ad23fe03a082 135 return;
mbed_official 573:ad23fe03a082 136 }
mbed_official 573:ad23fe03a082 137
mbed_official 573:ad23fe03a082 138 HAL_TIM_PWM_ConfigChannel(&TimHandle, &sConfig, channel);
mbed_official 573:ad23fe03a082 139 if (complementary_channel) {
mbed_official 573:ad23fe03a082 140 HAL_TIMEx_PWMN_Start(&TimHandle, channel);
mbed_official 573:ad23fe03a082 141 } else {
mbed_official 573:ad23fe03a082 142 HAL_TIM_PWM_Start(&TimHandle, channel);
mbed_official 573:ad23fe03a082 143 }
mbed_official 573:ad23fe03a082 144 }
mbed_official 573:ad23fe03a082 145
mbed_official 573:ad23fe03a082 146 float pwmout_read(pwmout_t* obj)
mbed_official 573:ad23fe03a082 147 {
mbed_official 573:ad23fe03a082 148 float value = 0;
mbed_official 573:ad23fe03a082 149 if (obj->period > 0) {
mbed_official 573:ad23fe03a082 150 value = (float)(obj->pulse) / (float)(obj->period);
mbed_official 573:ad23fe03a082 151 }
mbed_official 573:ad23fe03a082 152 return ((value > (float)1.0) ? (float)(1.0) : (value));
mbed_official 573:ad23fe03a082 153 }
mbed_official 573:ad23fe03a082 154
mbed_official 573:ad23fe03a082 155 void pwmout_period(pwmout_t* obj, float seconds)
mbed_official 573:ad23fe03a082 156 {
mbed_official 573:ad23fe03a082 157 pwmout_period_us(obj, seconds * 1000000.0f);
mbed_official 573:ad23fe03a082 158 }
mbed_official 573:ad23fe03a082 159
mbed_official 573:ad23fe03a082 160 void pwmout_period_ms(pwmout_t* obj, int ms)
mbed_official 573:ad23fe03a082 161 {
mbed_official 573:ad23fe03a082 162 pwmout_period_us(obj, ms * 1000);
mbed_official 573:ad23fe03a082 163 }
mbed_official 573:ad23fe03a082 164
mbed_official 573:ad23fe03a082 165 void pwmout_period_us(pwmout_t* obj, int us)
mbed_official 573:ad23fe03a082 166 {
mbed_official 573:ad23fe03a082 167 TimHandle.Instance = (TIM_TypeDef *)(obj->pwm);
mbed_official 573:ad23fe03a082 168 RCC_ClkInitTypeDef RCC_ClkInitStruct;
mbed_official 573:ad23fe03a082 169 uint32_t PclkFreq;
mbed_official 573:ad23fe03a082 170 uint32_t APBxCLKDivider;
mbed_official 573:ad23fe03a082 171 float dc = pwmout_read(obj);
mbed_official 573:ad23fe03a082 172
mbed_official 573:ad23fe03a082 173 __HAL_TIM_DISABLE(&TimHandle);
mbed_official 573:ad23fe03a082 174
mbed_official 573:ad23fe03a082 175 // Update the SystemCoreClock variable
mbed_official 573:ad23fe03a082 176 SystemCoreClockUpdate();
mbed_official 573:ad23fe03a082 177
mbed_official 573:ad23fe03a082 178 HAL_RCC_GetClockConfig(&RCC_ClkInitStruct, &PclkFreq);
mbed_official 573:ad23fe03a082 179
mbed_official 573:ad23fe03a082 180 switch (obj->pwm) {
mbed_official 573:ad23fe03a082 181
mbed_official 573:ad23fe03a082 182 case PWM_1:
mbed_official 573:ad23fe03a082 183 PclkFreq = HAL_RCC_GetPCLK2Freq();
mbed_official 573:ad23fe03a082 184 APBxCLKDivider = RCC_ClkInitStruct.APB2CLKDivider;
mbed_official 573:ad23fe03a082 185 break;
mbed_official 573:ad23fe03a082 186
mbed_official 573:ad23fe03a082 187 case PWM_2:
mbed_official 573:ad23fe03a082 188 PclkFreq = HAL_RCC_GetPCLK1Freq();
mbed_official 573:ad23fe03a082 189 APBxCLKDivider = RCC_ClkInitStruct.APB1CLKDivider;
mbed_official 573:ad23fe03a082 190 break;
mbed_official 573:ad23fe03a082 191
mbed_official 573:ad23fe03a082 192 case PWM_3:
mbed_official 573:ad23fe03a082 193 PclkFreq = HAL_RCC_GetPCLK1Freq();
mbed_official 573:ad23fe03a082 194 APBxCLKDivider = RCC_ClkInitStruct.APB1CLKDivider;
mbed_official 573:ad23fe03a082 195 break;
mbed_official 573:ad23fe03a082 196
mbed_official 573:ad23fe03a082 197 case PWM_4:
mbed_official 573:ad23fe03a082 198 PclkFreq = HAL_RCC_GetPCLK1Freq();
mbed_official 573:ad23fe03a082 199 APBxCLKDivider = RCC_ClkInitStruct.APB1CLKDivider;
mbed_official 573:ad23fe03a082 200 break;
mbed_official 573:ad23fe03a082 201
mbed_official 573:ad23fe03a082 202 #if defined(TIM8_BASE)
mbed_official 573:ad23fe03a082 203 case PWM_8:
mbed_official 573:ad23fe03a082 204 PclkFreq = HAL_RCC_GetPCLK2Freq();
mbed_official 573:ad23fe03a082 205 APBxCLKDivider = RCC_ClkInitStruct.APB2CLKDivider;
mbed_official 573:ad23fe03a082 206 break;
mbed_official 573:ad23fe03a082 207 #endif
mbed_official 573:ad23fe03a082 208
mbed_official 573:ad23fe03a082 209 case PWM_9:
mbed_official 573:ad23fe03a082 210 PclkFreq = HAL_RCC_GetPCLK2Freq();
mbed_official 573:ad23fe03a082 211 APBxCLKDivider = RCC_ClkInitStruct.APB2CLKDivider;
mbed_official 573:ad23fe03a082 212 break;
mbed_official 573:ad23fe03a082 213
mbed_official 573:ad23fe03a082 214 case PWM_10:
mbed_official 573:ad23fe03a082 215 PclkFreq = HAL_RCC_GetPCLK2Freq();
mbed_official 573:ad23fe03a082 216 APBxCLKDivider = RCC_ClkInitStruct.APB2CLKDivider;
mbed_official 573:ad23fe03a082 217 break;
mbed_official 573:ad23fe03a082 218
mbed_official 573:ad23fe03a082 219 case PWM_11:
mbed_official 573:ad23fe03a082 220 PclkFreq = HAL_RCC_GetPCLK2Freq();
mbed_official 573:ad23fe03a082 221 APBxCLKDivider = RCC_ClkInitStruct.APB2CLKDivider;
mbed_official 573:ad23fe03a082 222 break;
mbed_official 573:ad23fe03a082 223
mbed_official 573:ad23fe03a082 224 #if defined(TIM13_BASE)
mbed_official 573:ad23fe03a082 225 case PWM_13:
mbed_official 573:ad23fe03a082 226 PclkFreq = HAL_RCC_GetPCLK1Freq();
mbed_official 573:ad23fe03a082 227 APBxCLKDivider = RCC_ClkInitStruct.APB1CLKDivider;
mbed_official 573:ad23fe03a082 228 break;
mbed_official 573:ad23fe03a082 229 #endif
mbed_official 573:ad23fe03a082 230
mbed_official 573:ad23fe03a082 231 #if defined(TIM14_BASE)
mbed_official 573:ad23fe03a082 232 case PWM_14:
mbed_official 573:ad23fe03a082 233 PclkFreq = HAL_RCC_GetPCLK1Freq();
mbed_official 573:ad23fe03a082 234 APBxCLKDivider = RCC_ClkInitStruct.APB1CLKDivider;
mbed_official 573:ad23fe03a082 235 break;
mbed_official 573:ad23fe03a082 236 #endif
mbed_official 573:ad23fe03a082 237
mbed_official 573:ad23fe03a082 238 default:
mbed_official 573:ad23fe03a082 239 return;
mbed_official 573:ad23fe03a082 240 }
mbed_official 573:ad23fe03a082 241
mbed_official 573:ad23fe03a082 242 TimHandle.Init.Period = us - 1;
mbed_official 573:ad23fe03a082 243 if (APBxCLKDivider == RCC_HCLK_DIV1)
mbed_official 573:ad23fe03a082 244 TimHandle.Init.Prescaler = (uint16_t)((PclkFreq*2) / 1000000) - 1; // 1 µs tick
mbed_official 573:ad23fe03a082 245 else
mbed_official 573:ad23fe03a082 246 TimHandle.Init.Prescaler = (uint16_t)((PclkFreq) / 1000000) - 1; // 1 µs tick
mbed_official 573:ad23fe03a082 247 TimHandle.Init.ClockDivision = 0;
mbed_official 573:ad23fe03a082 248 TimHandle.Init.CounterMode = TIM_COUNTERMODE_UP;
mbed_official 573:ad23fe03a082 249 HAL_TIM_PWM_Init(&TimHandle);
mbed_official 573:ad23fe03a082 250
mbed_official 573:ad23fe03a082 251 // Set duty cycle again
mbed_official 573:ad23fe03a082 252 pwmout_write(obj, dc);
mbed_official 573:ad23fe03a082 253
mbed_official 573:ad23fe03a082 254 // Save for future use
mbed_official 573:ad23fe03a082 255 obj->period = us;
mbed_official 573:ad23fe03a082 256
mbed_official 573:ad23fe03a082 257 __HAL_TIM_ENABLE(&TimHandle);
mbed_official 573:ad23fe03a082 258 }
mbed_official 573:ad23fe03a082 259
mbed_official 573:ad23fe03a082 260 void pwmout_pulsewidth(pwmout_t* obj, float seconds)
mbed_official 573:ad23fe03a082 261 {
mbed_official 573:ad23fe03a082 262 pwmout_pulsewidth_us(obj, seconds * 1000000.0f);
mbed_official 573:ad23fe03a082 263 }
mbed_official 573:ad23fe03a082 264
mbed_official 573:ad23fe03a082 265 void pwmout_pulsewidth_ms(pwmout_t* obj, int ms)
mbed_official 573:ad23fe03a082 266 {
mbed_official 573:ad23fe03a082 267 pwmout_pulsewidth_us(obj, ms * 1000);
mbed_official 573:ad23fe03a082 268 }
mbed_official 573:ad23fe03a082 269
mbed_official 573:ad23fe03a082 270 void pwmout_pulsewidth_us(pwmout_t* obj, int us)
mbed_official 573:ad23fe03a082 271 {
mbed_official 573:ad23fe03a082 272 float value = (float)us / (float)obj->period;
mbed_official 573:ad23fe03a082 273 pwmout_write(obj, value);
mbed_official 573:ad23fe03a082 274 }
mbed_official 573:ad23fe03a082 275
mbed_official 573:ad23fe03a082 276 #endif