mbed official / mbed-dev

mbed library sources. Supersedes mbed-src.

Dependents:   Nucleo_Hello_Encoder BLE_iBeaconScan AM1805_DEMO DISCO-F429ZI_ExportTemplate1 ... more

targets/TARGET_STM/TARGET_STM32F3/analogout_device.c@189:f392fc9709a3, 2019-02-20 (annotated)

Committer:
AnnaBridge
Date:
Wed Feb 20 22:31:08 2019 +0000
Revision:
189:f392fc9709a3
Parent:
187:0387e8f68319 
mbed library release version 165

Who changed what in which revision?

UserRevisionLine numberNew contents of line
AnnaBridge 168:9672193075cf 1 /* mbed Microcontroller Library
AnnaBridge 168:9672193075cf 2 * Copyright (c) 2015, STMicroelectronics
AnnaBridge 168:9672193075cf 3 * All rights reserved.
AnnaBridge 168:9672193075cf 4 *
AnnaBridge 168:9672193075cf 5 * Redistribution and use in source and binary forms, with or without
AnnaBridge 168:9672193075cf 6 * modification, are permitted provided that the following conditions are met:
AnnaBridge 168:9672193075cf 7 *
AnnaBridge 168:9672193075cf 8 * 1. Redistributions of source code must retain the above copyright notice,
AnnaBridge 168:9672193075cf 9 * this list of conditions and the following disclaimer.
AnnaBridge 168:9672193075cf 10 * 2. Redistributions in binary form must reproduce the above copyright notice,
AnnaBridge 168:9672193075cf 11 * this list of conditions and the following disclaimer in the documentation
AnnaBridge 168:9672193075cf 12 * and/or other materials provided with the distribution.
AnnaBridge 168:9672193075cf 13 * 3. Neither the name of STMicroelectronics nor the names of its contributors
AnnaBridge 168:9672193075cf 14 * may be used to endorse or promote products derived from this software
AnnaBridge 168:9672193075cf 15 * without specific prior written permission.
AnnaBridge 168:9672193075cf 16 *
AnnaBridge 168:9672193075cf 17 * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
AnnaBridge 168:9672193075cf 18 * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
AnnaBridge 168:9672193075cf 19 * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
AnnaBridge 168:9672193075cf 20 * DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE
AnnaBridge 168:9672193075cf 21 * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
AnnaBridge 168:9672193075cf 22 * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
AnnaBridge 168:9672193075cf 23 * SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
AnnaBridge 168:9672193075cf 24 * CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
AnnaBridge 168:9672193075cf 25 * OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
AnnaBridge 168:9672193075cf 26 * OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
AnnaBridge 168:9672193075cf 27 */
AnnaBridge 168:9672193075cf 28 #include "mbed_assert.h"
AnnaBridge 168:9672193075cf 29 #include "analogout_api.h"
AnnaBridge 168:9672193075cf 30
AnnaBridge 168:9672193075cf 31 #if DEVICE_ANALOGOUT
AnnaBridge 168:9672193075cf 32
AnnaBridge 168:9672193075cf 33 #include "cmsis.h"
AnnaBridge 168:9672193075cf 34 #include "pinmap.h"
AnnaBridge 168:9672193075cf 35 #include "mbed_error.h"
AnnaBridge 168:9672193075cf 36 #include "PeripheralPins.h"
AnnaBridge 168:9672193075cf 37
AnnaBridge 168:9672193075cf 38 // These variables are used for the "free" function
AnnaBridge 168:9672193075cf 39 static int pa4_used = 0;
AnnaBridge 168:9672193075cf 40 static int pa5_used = 0;
AnnaBridge 168:9672193075cf 41
AnnaBridge 187:0387e8f68319 42 void analogout_init(dac_t *obj, PinName pin)
AnnaBridge 187:0387e8f68319 43 {
AnnaBridge 176:447f873cad2f 44 DAC_ChannelConfTypeDef sConfig = {0};
AnnaBridge 168:9672193075cf 45
AnnaBridge 168:9672193075cf 46 // Get the peripheral name from the pin and assign it to the object
AnnaBridge 168:9672193075cf 47 obj->dac = (DACName)pinmap_peripheral(pin, PinMap_DAC);
AnnaBridge 168:9672193075cf 48 MBED_ASSERT(obj->dac != (DACName)NC);
AnnaBridge 168:9672193075cf 49
AnnaBridge 168:9672193075cf 50 // Get the pin function and assign the used channel to the object
AnnaBridge 168:9672193075cf 51 uint32_t function = pinmap_function(pin, PinMap_DAC);
AnnaBridge 168:9672193075cf 52 MBED_ASSERT(function != (uint32_t)NC);
AnnaBridge 168:9672193075cf 53
AnnaBridge 168:9672193075cf 54 // Save the channel for the write and read functions
AnnaBridge 168:9672193075cf 55 switch (STM_PIN_CHANNEL(function)) {
AnnaBridge 168:9672193075cf 56 case 1:
AnnaBridge 168:9672193075cf 57 obj->channel = DAC_CHANNEL_1;
AnnaBridge 168:9672193075cf 58 break;
AnnaBridge 168:9672193075cf 59 #if defined(DAC_CHANNEL_2)
AnnaBridge 168:9672193075cf 60 case 2:
AnnaBridge 168:9672193075cf 61 obj->channel = DAC_CHANNEL_2;
AnnaBridge 168:9672193075cf 62 break;
AnnaBridge 168:9672193075cf 63 #endif
AnnaBridge 168:9672193075cf 64 default:
AnnaBridge 168:9672193075cf 65 error("Unknown DAC channel");
AnnaBridge 168:9672193075cf 66 break;
AnnaBridge 168:9672193075cf 67 }
AnnaBridge 168:9672193075cf 68
AnnaBridge 168:9672193075cf 69 // Configure GPIO
AnnaBridge 168:9672193075cf 70 pinmap_pinout(pin, PinMap_DAC);
AnnaBridge 168:9672193075cf 71
AnnaBridge 168:9672193075cf 72 // Save the pin for future use
AnnaBridge 168:9672193075cf 73 obj->pin = pin;
AnnaBridge 168:9672193075cf 74
AnnaBridge 168:9672193075cf 75 // Enable DAC clock
AnnaBridge 168:9672193075cf 76 if (obj->dac == DAC_1) {
Anna Bridge 186:707f6e361f3e 77 __HAL_RCC_DAC1_CLK_ENABLE();
AnnaBridge 168:9672193075cf 78 }
AnnaBridge 168:9672193075cf 79 #if defined(DAC2)
AnnaBridge 168:9672193075cf 80 if (obj->dac == DAC_2) {
Anna Bridge 186:707f6e361f3e 81 __HAL_RCC_DAC2_CLK_ENABLE();
AnnaBridge 168:9672193075cf 82 }
AnnaBridge 168:9672193075cf 83 #endif
AnnaBridge 168:9672193075cf 84
AnnaBridge 168:9672193075cf 85 // Configure DAC
AnnaBridge 168:9672193075cf 86 obj->handle.Instance = (DAC_TypeDef *)(obj->dac);
AnnaBridge 176:447f873cad2f 87 obj->handle.State = HAL_DAC_STATE_RESET;
AnnaBridge 176:447f873cad2f 88
AnnaBridge 187:0387e8f68319 89 if (HAL_DAC_Init(&obj->handle) != HAL_OK) {
AnnaBridge 168:9672193075cf 90 error("HAL_DAC_Init failed");
AnnaBridge 168:9672193075cf 91 }
AnnaBridge 168:9672193075cf 92
AnnaBridge 168:9672193075cf 93 /* Enable both Buffer and Switch in the configuration,
AnnaBridge 168:9672193075cf 94 * letting HAL layer in charge of selecting either one
AnnaBridge 168:9672193075cf 95 * or the other depending on the actual DAC instance and
AnnaBridge 168:9672193075cf 96 * channel being configured.
AnnaBridge 168:9672193075cf 97 */
AnnaBridge 168:9672193075cf 98 sConfig.DAC_Trigger = DAC_TRIGGER_NONE;
AnnaBridge 168:9672193075cf 99 sConfig.DAC_OutputBuffer = DAC_OUTPUTBUFFER_ENABLE;
AnnaBridge 168:9672193075cf 100 #if defined(DAC_OUTPUTSWITCH_ENABLE)
AnnaBridge 168:9672193075cf 101 sConfig.DAC_OutputSwitch = DAC_OUTPUTSWITCH_ENABLE;
AnnaBridge 168:9672193075cf 102 #endif
AnnaBridge 168:9672193075cf 103
AnnaBridge 168:9672193075cf 104 if (pin == PA_4) {
AnnaBridge 168:9672193075cf 105 pa4_used = 1;
AnnaBridge 168:9672193075cf 106 }
AnnaBridge 168:9672193075cf 107
AnnaBridge 168:9672193075cf 108 if (pin == PA_5) {
AnnaBridge 168:9672193075cf 109 pa5_used = 1;
AnnaBridge 168:9672193075cf 110 }
AnnaBridge 168:9672193075cf 111
AnnaBridge 168:9672193075cf 112 if (HAL_DAC_ConfigChannel(&obj->handle, &sConfig, obj->channel) != HAL_OK) {
AnnaBridge 168:9672193075cf 113 error("HAL_DAC_ConfigChannel failed");
AnnaBridge 168:9672193075cf 114 }
AnnaBridge 168:9672193075cf 115
AnnaBridge 168:9672193075cf 116 analogout_write_u16(obj, 0);
AnnaBridge 168:9672193075cf 117 }
AnnaBridge 168:9672193075cf 118
AnnaBridge 187:0387e8f68319 119 void analogout_free(dac_t *obj)
AnnaBridge 187:0387e8f68319 120 {
AnnaBridge 168:9672193075cf 121 // Reset DAC and disable clock
AnnaBridge 187:0387e8f68319 122 if (obj->pin == PA_4) {
AnnaBridge 187:0387e8f68319 123 pa4_used = 0;
AnnaBridge 187:0387e8f68319 124 }
AnnaBridge 187:0387e8f68319 125 if (obj->pin == PA_5) {
AnnaBridge 187:0387e8f68319 126 pa5_used = 0;
AnnaBridge 187:0387e8f68319 127 }
AnnaBridge 168:9672193075cf 128
AnnaBridge 168:9672193075cf 129 if ((pa4_used == 0) && (pa5_used == 0)) {
Anna Bridge 186:707f6e361f3e 130 __HAL_RCC_DAC1_FORCE_RESET();
Anna Bridge 186:707f6e361f3e 131 __HAL_RCC_DAC1_RELEASE_RESET();
Anna Bridge 186:707f6e361f3e 132 __HAL_RCC_DAC1_CLK_DISABLE();
AnnaBridge 168:9672193075cf 133 }
AnnaBridge 168:9672193075cf 134
AnnaBridge 168:9672193075cf 135 #if defined(DAC2)
AnnaBridge 168:9672193075cf 136 if (obj->pin == PA_6) {
Anna Bridge 186:707f6e361f3e 137 __HAL_RCC_DAC2_FORCE_RESET();
Anna Bridge 186:707f6e361f3e 138 __HAL_RCC_DAC2_RELEASE_RESET();
Anna Bridge 186:707f6e361f3e 139 __HAL_RCC_DAC2_CLK_DISABLE();
AnnaBridge 168:9672193075cf 140 }
AnnaBridge 168:9672193075cf 141 #endif
AnnaBridge 168:9672193075cf 142
AnnaBridge 168:9672193075cf 143 // Configure GPIO
AnnaBridge 168:9672193075cf 144 pin_function(obj->pin, STM_PIN_DATA(STM_MODE_INPUT, GPIO_NOPULL, 0));
AnnaBridge 168:9672193075cf 145 }
AnnaBridge 168:9672193075cf 146
AnnaBridge 168:9672193075cf 147 #endif // DEVICE_ANALOGOUT