Jeroen van Zoeren / 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.

Dependents:   Ophaalbrug-dev

Fork of mbed-dev by mbed official

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

Committer:
bogdanm
Date:
Thu Oct 01 15:25:22 2015 +0300
Revision:
0:9b334a45a8ff
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 {
bogdanm 0:9b334a45a8ff 43 // Get the peripheral name from the pin and assign it to the object
bogdanm 0:9b334a45a8ff 44 obj->pwm = (PWMName)pinmap_peripheral(pin, PinMap_PWM);
bogdanm 0:9b334a45a8ff 45
bogdanm 0:9b334a45a8ff 46 if (obj->pwm == (PWMName)NC) {
bogdanm 0:9b334a45a8ff 47 error("PWM error: pinout mapping failed.");
bogdanm 0:9b334a45a8ff 48 }
bogdanm 0:9b334a45a8ff 49
bogdanm 0:9b334a45a8ff 50 // Enable TIM clock
bogdanm 0:9b334a45a8ff 51 if (obj->pwm == PWM_2) __TIM2_CLK_ENABLE();
bogdanm 0:9b334a45a8ff 52 if (obj->pwm == PWM_3) __TIM3_CLK_ENABLE();
bogdanm 0:9b334a45a8ff 53 if (obj->pwm == PWM_4) __TIM4_CLK_ENABLE();
bogdanm 0:9b334a45a8ff 54 if (obj->pwm == PWM_5) __TIM5_CLK_ENABLE();
bogdanm 0:9b334a45a8ff 55 if (obj->pwm == PWM_9) __TIM9_CLK_ENABLE();
bogdanm 0:9b334a45a8ff 56 if (obj->pwm == PWM_10) __TIM10_CLK_ENABLE();
bogdanm 0:9b334a45a8ff 57 if (obj->pwm == PWM_11) __TIM11_CLK_ENABLE();
bogdanm 0:9b334a45a8ff 58
bogdanm 0:9b334a45a8ff 59 // Configure GPIO
bogdanm 0:9b334a45a8ff 60 pinmap_pinout(pin, PinMap_PWM);
bogdanm 0:9b334a45a8ff 61
bogdanm 0:9b334a45a8ff 62 obj->pin = pin;
bogdanm 0:9b334a45a8ff 63 obj->period = 0;
bogdanm 0:9b334a45a8ff 64 obj->pulse = 0;
bogdanm 0:9b334a45a8ff 65
bogdanm 0:9b334a45a8ff 66 pwmout_period_us(obj, 20000); // 20 ms per default
bogdanm 0:9b334a45a8ff 67 }
bogdanm 0:9b334a45a8ff 68
bogdanm 0:9b334a45a8ff 69 void pwmout_free(pwmout_t* obj)
bogdanm 0:9b334a45a8ff 70 {
bogdanm 0:9b334a45a8ff 71 // Configure GPIO
bogdanm 0:9b334a45a8ff 72 pin_function(obj->pin, STM_PIN_DATA(STM_MODE_INPUT, GPIO_NOPULL, 0));
bogdanm 0:9b334a45a8ff 73 }
bogdanm 0:9b334a45a8ff 74
bogdanm 0:9b334a45a8ff 75 void pwmout_write(pwmout_t* obj, float value)
bogdanm 0:9b334a45a8ff 76 {
bogdanm 0:9b334a45a8ff 77 TIM_OC_InitTypeDef sConfig;
bogdanm 0:9b334a45a8ff 78 int channel = 0;
bogdanm 0:9b334a45a8ff 79
bogdanm 0:9b334a45a8ff 80 TimHandle.Instance = (TIM_TypeDef *)(obj->pwm);
bogdanm 0:9b334a45a8ff 81
bogdanm 0:9b334a45a8ff 82 if (value < (float)0.0) {
bogdanm 0:9b334a45a8ff 83 value = 0.0;
bogdanm 0:9b334a45a8ff 84 } else if (value > (float)1.0) {
bogdanm 0:9b334a45a8ff 85 value = 1.0;
bogdanm 0:9b334a45a8ff 86 }
bogdanm 0:9b334a45a8ff 87
bogdanm 0:9b334a45a8ff 88 obj->pulse = (uint32_t)((float)obj->period * value);
bogdanm 0:9b334a45a8ff 89
bogdanm 0:9b334a45a8ff 90 // Configure channels
bogdanm 0:9b334a45a8ff 91 sConfig.OCMode = TIM_OCMODE_PWM1;
bogdanm 0:9b334a45a8ff 92 sConfig.Pulse = obj->pulse;
bogdanm 0:9b334a45a8ff 93 sConfig.OCPolarity = TIM_OCPOLARITY_HIGH;
bogdanm 0:9b334a45a8ff 94 sConfig.OCFastMode = TIM_OCFAST_ENABLE;
bogdanm 0:9b334a45a8ff 95
bogdanm 0:9b334a45a8ff 96 switch (obj->pin) {
bogdanm 0:9b334a45a8ff 97 // Channels 1
bogdanm 0:9b334a45a8ff 98 case PA_6:
bogdanm 0:9b334a45a8ff 99 case PB_4:
bogdanm 0:9b334a45a8ff 100 case PB_6:
bogdanm 0:9b334a45a8ff 101 case PB_12:
bogdanm 0:9b334a45a8ff 102 case PB_13:
bogdanm 0:9b334a45a8ff 103 case PB_15:
bogdanm 0:9b334a45a8ff 104 case PC_6:
bogdanm 0:9b334a45a8ff 105 channel = TIM_CHANNEL_1;
bogdanm 0:9b334a45a8ff 106 break;
bogdanm 0:9b334a45a8ff 107 // Channels 2
bogdanm 0:9b334a45a8ff 108 case PA_1:
bogdanm 0:9b334a45a8ff 109 case PA_7:
bogdanm 0:9b334a45a8ff 110 case PB_3:
bogdanm 0:9b334a45a8ff 111 case PB_5:
bogdanm 0:9b334a45a8ff 112 case PB_7:
bogdanm 0:9b334a45a8ff 113 case PB_14:
bogdanm 0:9b334a45a8ff 114 case PC_7:
bogdanm 0:9b334a45a8ff 115 channel = TIM_CHANNEL_2;
bogdanm 0:9b334a45a8ff 116 break;
bogdanm 0:9b334a45a8ff 117 // Channels 3
bogdanm 0:9b334a45a8ff 118 case PA_2:
bogdanm 0:9b334a45a8ff 119 case PB_0:
bogdanm 0:9b334a45a8ff 120 case PB_8:
bogdanm 0:9b334a45a8ff 121 case PB_10:
bogdanm 0:9b334a45a8ff 122 case PC_8:
bogdanm 0:9b334a45a8ff 123 channel = TIM_CHANNEL_3;
bogdanm 0:9b334a45a8ff 124 break;
bogdanm 0:9b334a45a8ff 125 // Channels 4
bogdanm 0:9b334a45a8ff 126 case PA_3:
bogdanm 0:9b334a45a8ff 127 case PB_1:
bogdanm 0:9b334a45a8ff 128 case PB_9:
bogdanm 0:9b334a45a8ff 129 case PB_11:
bogdanm 0:9b334a45a8ff 130 case PC_9:
bogdanm 0:9b334a45a8ff 131 channel = TIM_CHANNEL_4;
bogdanm 0:9b334a45a8ff 132 break;
bogdanm 0:9b334a45a8ff 133 default:
bogdanm 0:9b334a45a8ff 134 return;
bogdanm 0:9b334a45a8ff 135 }
bogdanm 0:9b334a45a8ff 136
bogdanm 0:9b334a45a8ff 137 HAL_TIM_PWM_ConfigChannel(&TimHandle, &sConfig, channel);
bogdanm 0:9b334a45a8ff 138 HAL_TIM_PWM_Start(&TimHandle, channel);
bogdanm 0:9b334a45a8ff 139 }
bogdanm 0:9b334a45a8ff 140
bogdanm 0:9b334a45a8ff 141 float pwmout_read(pwmout_t* obj)
bogdanm 0:9b334a45a8ff 142 {
bogdanm 0:9b334a45a8ff 143 float value = 0;
bogdanm 0:9b334a45a8ff 144 if (obj->period > 0) {
bogdanm 0:9b334a45a8ff 145 value = (float)(obj->pulse) / (float)(obj->period);
bogdanm 0:9b334a45a8ff 146 }
bogdanm 0:9b334a45a8ff 147 return ((value > (float)1.0) ? (float)(1.0) : (value));
bogdanm 0:9b334a45a8ff 148 }
bogdanm 0:9b334a45a8ff 149
bogdanm 0:9b334a45a8ff 150 void pwmout_period(pwmout_t* obj, float seconds)
bogdanm 0:9b334a45a8ff 151 {
bogdanm 0:9b334a45a8ff 152 pwmout_period_us(obj, seconds * 1000000.0f);
bogdanm 0:9b334a45a8ff 153 }
bogdanm 0:9b334a45a8ff 154
bogdanm 0:9b334a45a8ff 155 void pwmout_period_ms(pwmout_t* obj, int ms)
bogdanm 0:9b334a45a8ff 156 {
bogdanm 0:9b334a45a8ff 157 pwmout_period_us(obj, ms * 1000);
bogdanm 0:9b334a45a8ff 158 }
bogdanm 0:9b334a45a8ff 159
bogdanm 0:9b334a45a8ff 160 void pwmout_period_us(pwmout_t* obj, int us)
bogdanm 0:9b334a45a8ff 161 {
bogdanm 0:9b334a45a8ff 162 TimHandle.Instance = (TIM_TypeDef *)(obj->pwm);
bogdanm 0:9b334a45a8ff 163
bogdanm 0:9b334a45a8ff 164 float dc = pwmout_read(obj);
bogdanm 0:9b334a45a8ff 165
bogdanm 0:9b334a45a8ff 166 __HAL_TIM_DISABLE(&TimHandle);
bogdanm 0:9b334a45a8ff 167
bogdanm 0:9b334a45a8ff 168 SystemCoreClockUpdate();
bogdanm 0:9b334a45a8ff 169
bogdanm 0:9b334a45a8ff 170 TimHandle.Init.Period = us - 1;
bogdanm 0:9b334a45a8ff 171 TimHandle.Init.Prescaler = (uint16_t)(SystemCoreClock / 1000000) - 1; // 1 us tick
bogdanm 0:9b334a45a8ff 172 TimHandle.Init.ClockDivision = 0;
bogdanm 0:9b334a45a8ff 173 TimHandle.Init.CounterMode = TIM_COUNTERMODE_UP;
bogdanm 0:9b334a45a8ff 174 HAL_TIM_PWM_Init(&TimHandle);
bogdanm 0:9b334a45a8ff 175
bogdanm 0:9b334a45a8ff 176 // Set duty cycle again
bogdanm 0:9b334a45a8ff 177 pwmout_write(obj, dc);
bogdanm 0:9b334a45a8ff 178
bogdanm 0:9b334a45a8ff 179 // Save for future use
bogdanm 0:9b334a45a8ff 180 obj->period = us;
bogdanm 0:9b334a45a8ff 181
bogdanm 0:9b334a45a8ff 182 __HAL_TIM_ENABLE(&TimHandle);
bogdanm 0:9b334a45a8ff 183 }
bogdanm 0:9b334a45a8ff 184
bogdanm 0:9b334a45a8ff 185 void pwmout_pulsewidth(pwmout_t* obj, float seconds)
bogdanm 0:9b334a45a8ff 186 {
bogdanm 0:9b334a45a8ff 187 pwmout_pulsewidth_us(obj, seconds * 1000000.0f);
bogdanm 0:9b334a45a8ff 188 }
bogdanm 0:9b334a45a8ff 189
bogdanm 0:9b334a45a8ff 190 void pwmout_pulsewidth_ms(pwmout_t* obj, int ms)
bogdanm 0:9b334a45a8ff 191 {
bogdanm 0:9b334a45a8ff 192 pwmout_pulsewidth_us(obj, ms * 1000);
bogdanm 0:9b334a45a8ff 193 }
bogdanm 0:9b334a45a8ff 194
bogdanm 0:9b334a45a8ff 195 void pwmout_pulsewidth_us(pwmout_t* obj, int us)
bogdanm 0:9b334a45a8ff 196 {
bogdanm 0:9b334a45a8ff 197 float value = (float)us / (float)obj->period;
bogdanm 0:9b334a45a8ff 198 pwmout_write(obj, value);
bogdanm 0:9b334a45a8ff 199 }
bogdanm 0:9b334a45a8ff 200
bogdanm 0:9b334a45a8ff 201 #endif