RYUICHI NAKAYAMA / mbed-dev

Important changes to repositories hosted on mbed.com

Mbed hosted mercurial repositories are deprecated and are due to be permanently deleted in July 2026.

To keep a copy of this software download the repository Zip archive or clone locally using Mercurial.

It is also possible to export all your personal repositories from the account settings page.

Fork of mbed-dev by mbed official

targets/hal/TARGET_STM/TARGET_STM32F0/pwmout_api.c@0:9b334a45a8ff, 2015-10-01 (annotated)

Committer:
bogdanm
Date:
Thu Oct 01 15:25:22 2015 +0300
Revision:
0:9b334a45a8ff
Child:
5:ac9f6c2c45e8
Initial commit on mbed-dev



Replaces mbed-src (now inactive)

Who changed what in which revision?

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