teralytic / mbed-dev

mbed library sources. Supersedes mbed-src.

Fork of mbed by teralytic

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

Committer:
bogdanm
Date:
Thu Oct 01 15:25:22 2015 +0300
Revision:
0:9b334a45a8ff
Child:
144:ef7eb2e8f9f7
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) 2015, 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 MBED_ASSERT(obj->pwm != (PWMName)NC);
bogdanm 0:9b334a45a8ff 46
bogdanm 0:9b334a45a8ff 47 // Get the pin function and assign the used channel to the object
bogdanm 0:9b334a45a8ff 48 uint32_t function = pinmap_function(pin, PinMap_PWM);
bogdanm 0:9b334a45a8ff 49 MBED_ASSERT(function != (uint32_t)NC);
bogdanm 0:9b334a45a8ff 50 obj->channel = STM_PIN_CHANNEL(function);
bogdanm 0:9b334a45a8ff 51 obj->inverted = STM_PIN_INVERTED(function);
bogdanm 0:9b334a45a8ff 52
bogdanm 0:9b334a45a8ff 53 // Enable TIM clock
bogdanm 0:9b334a45a8ff 54 if (obj->pwm == PWM_2) __TIM2_CLK_ENABLE();
bogdanm 0:9b334a45a8ff 55 #if defined(TIM3_BASE)
bogdanm 0:9b334a45a8ff 56 if (obj->pwm == PWM_3) __TIM3_CLK_ENABLE();
bogdanm 0:9b334a45a8ff 57 #endif
bogdanm 0:9b334a45a8ff 58 if (obj->pwm == PWM_21) __TIM21_CLK_ENABLE();
bogdanm 0:9b334a45a8ff 59 if (obj->pwm == PWM_22) __TIM22_CLK_ENABLE();
bogdanm 0:9b334a45a8ff 60
bogdanm 0:9b334a45a8ff 61 // Configure GPIO
bogdanm 0:9b334a45a8ff 62 pinmap_pinout(pin, PinMap_PWM);
bogdanm 0:9b334a45a8ff 63
bogdanm 0:9b334a45a8ff 64 obj->pin = pin;
bogdanm 0:9b334a45a8ff 65 obj->period = 0;
bogdanm 0:9b334a45a8ff 66 obj->pulse = 0;
bogdanm 0:9b334a45a8ff 67
bogdanm 0:9b334a45a8ff 68 pwmout_period_us(obj, 20000); // 20 ms per default
bogdanm 0:9b334a45a8ff 69 }
bogdanm 0:9b334a45a8ff 70
bogdanm 0:9b334a45a8ff 71 void pwmout_free(pwmout_t* obj)
bogdanm 0:9b334a45a8ff 72 {
bogdanm 0:9b334a45a8ff 73 // Configure GPIO
bogdanm 0:9b334a45a8ff 74 pin_function(obj->pin, STM_PIN_DATA(STM_MODE_INPUT, GPIO_NOPULL, 0));
bogdanm 0:9b334a45a8ff 75 }
bogdanm 0:9b334a45a8ff 76
bogdanm 0:9b334a45a8ff 77 void pwmout_write(pwmout_t* obj, float value)
bogdanm 0:9b334a45a8ff 78 {
bogdanm 0:9b334a45a8ff 79 TIM_OC_InitTypeDef sConfig;
bogdanm 0:9b334a45a8ff 80 int channel = 0;
bogdanm 0:9b334a45a8ff 81
bogdanm 0:9b334a45a8ff 82 TimHandle.Instance = (TIM_TypeDef *)(obj->pwm);
bogdanm 0:9b334a45a8ff 83
bogdanm 0:9b334a45a8ff 84 if (value < (float)0.0) {
bogdanm 0:9b334a45a8ff 85 value = 0.0;
bogdanm 0:9b334a45a8ff 86 } else if (value > (float)1.0) {
bogdanm 0:9b334a45a8ff 87 value = 1.0;
bogdanm 0:9b334a45a8ff 88 }
bogdanm 0:9b334a45a8ff 89
bogdanm 0:9b334a45a8ff 90 obj->pulse = (uint32_t)((float)obj->period * value);
bogdanm 0:9b334a45a8ff 91
bogdanm 0:9b334a45a8ff 92 // Configure channels
bogdanm 0:9b334a45a8ff 93 sConfig.OCMode = TIM_OCMODE_PWM1;
bogdanm 0:9b334a45a8ff 94 sConfig.Pulse = obj->pulse;
bogdanm 0:9b334a45a8ff 95 sConfig.OCPolarity = TIM_OCPOLARITY_HIGH;
bogdanm 0:9b334a45a8ff 96 sConfig.OCFastMode = TIM_OCFAST_ENABLE;
bogdanm 0:9b334a45a8ff 97
bogdanm 0:9b334a45a8ff 98 switch (obj->channel) {
bogdanm 0:9b334a45a8ff 99 case 1:
bogdanm 0:9b334a45a8ff 100 channel = TIM_CHANNEL_1;
bogdanm 0:9b334a45a8ff 101 break;
bogdanm 0:9b334a45a8ff 102 case 2:
bogdanm 0:9b334a45a8ff 103 channel = TIM_CHANNEL_2;
bogdanm 0:9b334a45a8ff 104 break;
bogdanm 0:9b334a45a8ff 105 case 3:
bogdanm 0:9b334a45a8ff 106 channel = TIM_CHANNEL_3;
bogdanm 0:9b334a45a8ff 107 break;
bogdanm 0:9b334a45a8ff 108 case 4:
bogdanm 0:9b334a45a8ff 109 channel = TIM_CHANNEL_4;
bogdanm 0:9b334a45a8ff 110 break;
bogdanm 0:9b334a45a8ff 111 default:
bogdanm 0:9b334a45a8ff 112 return;
bogdanm 0:9b334a45a8ff 113 }
bogdanm 0:9b334a45a8ff 114
bogdanm 0:9b334a45a8ff 115 if (HAL_TIM_PWM_ConfigChannel(&TimHandle, &sConfig, channel) != HAL_OK) {
bogdanm 0:9b334a45a8ff 116 error("Cannot initialize PWM");
bogdanm 0:9b334a45a8ff 117 }
bogdanm 0:9b334a45a8ff 118
bogdanm 0:9b334a45a8ff 119 HAL_TIM_PWM_Start(&TimHandle, channel);
bogdanm 0:9b334a45a8ff 120 }
bogdanm 0:9b334a45a8ff 121
bogdanm 0:9b334a45a8ff 122 float pwmout_read(pwmout_t* obj)
bogdanm 0:9b334a45a8ff 123 {
bogdanm 0:9b334a45a8ff 124 float value = 0;
bogdanm 0:9b334a45a8ff 125 if (obj->period > 0) {
bogdanm 0:9b334a45a8ff 126 value = (float)(obj->pulse) / (float)(obj->period);
bogdanm 0:9b334a45a8ff 127 }
bogdanm 0:9b334a45a8ff 128 return ((value > (float)1.0) ? (float)(1.0) : (value));
bogdanm 0:9b334a45a8ff 129 }
bogdanm 0:9b334a45a8ff 130
bogdanm 0:9b334a45a8ff 131 void pwmout_period(pwmout_t* obj, float seconds)
bogdanm 0:9b334a45a8ff 132 {
bogdanm 0:9b334a45a8ff 133 pwmout_period_us(obj, seconds * 1000000.0f);
bogdanm 0:9b334a45a8ff 134 }
bogdanm 0:9b334a45a8ff 135
bogdanm 0:9b334a45a8ff 136 void pwmout_period_ms(pwmout_t* obj, int ms)
bogdanm 0:9b334a45a8ff 137 {
bogdanm 0:9b334a45a8ff 138 pwmout_period_us(obj, ms * 1000);
bogdanm 0:9b334a45a8ff 139 }
bogdanm 0:9b334a45a8ff 140
bogdanm 0:9b334a45a8ff 141 void pwmout_period_us(pwmout_t* obj, int us)
bogdanm 0:9b334a45a8ff 142 {
bogdanm 0:9b334a45a8ff 143 TimHandle.Instance = (TIM_TypeDef *)(obj->pwm);
bogdanm 0:9b334a45a8ff 144
bogdanm 0:9b334a45a8ff 145 float dc = pwmout_read(obj);
bogdanm 0:9b334a45a8ff 146
bogdanm 0:9b334a45a8ff 147 __HAL_TIM_DISABLE(&TimHandle);
bogdanm 0:9b334a45a8ff 148
bogdanm 0:9b334a45a8ff 149 TimHandle.Init.Period = us - 1;
bogdanm 0:9b334a45a8ff 150 TimHandle.Init.Prescaler = (uint16_t)(SystemCoreClock / 1000000) - 1; // 1 us tick
bogdanm 0:9b334a45a8ff 151 TimHandle.Init.ClockDivision = 0;
bogdanm 0:9b334a45a8ff 152 TimHandle.Init.CounterMode = TIM_COUNTERMODE_UP;
bogdanm 0:9b334a45a8ff 153
bogdanm 0:9b334a45a8ff 154 if (HAL_TIM_PWM_Init(&TimHandle) != HAL_OK) {
bogdanm 0:9b334a45a8ff 155 error("Cannot initialize PWM");
bogdanm 0:9b334a45a8ff 156 }
bogdanm 0:9b334a45a8ff 157
bogdanm 0:9b334a45a8ff 158 // Set duty cycle again
bogdanm 0:9b334a45a8ff 159 pwmout_write(obj, dc);
bogdanm 0:9b334a45a8ff 160
bogdanm 0:9b334a45a8ff 161 // Save for future use
bogdanm 0:9b334a45a8ff 162 obj->period = us;
bogdanm 0:9b334a45a8ff 163
bogdanm 0:9b334a45a8ff 164 __HAL_TIM_ENABLE(&TimHandle);
bogdanm 0:9b334a45a8ff 165 }
bogdanm 0:9b334a45a8ff 166
bogdanm 0:9b334a45a8ff 167 void pwmout_pulsewidth(pwmout_t* obj, float seconds)
bogdanm 0:9b334a45a8ff 168 {
bogdanm 0:9b334a45a8ff 169 pwmout_pulsewidth_us(obj, seconds * 1000000.0f);
bogdanm 0:9b334a45a8ff 170 }
bogdanm 0:9b334a45a8ff 171
bogdanm 0:9b334a45a8ff 172 void pwmout_pulsewidth_ms(pwmout_t* obj, int ms)
bogdanm 0:9b334a45a8ff 173 {
bogdanm 0:9b334a45a8ff 174 pwmout_pulsewidth_us(obj, ms * 1000);
bogdanm 0:9b334a45a8ff 175 }
bogdanm 0:9b334a45a8ff 176
bogdanm 0:9b334a45a8ff 177 void pwmout_pulsewidth_us(pwmout_t* obj, int us)
bogdanm 0:9b334a45a8ff 178 {
bogdanm 0:9b334a45a8ff 179 float value = (float)us / (float)obj->period;
bogdanm 0:9b334a45a8ff 180 pwmout_write(obj, value);
bogdanm 0:9b334a45a8ff 181 }
bogdanm 0:9b334a45a8ff 182
bogdanm 0:9b334a45a8ff 183 #endif