From fe5e82a3ccb8250ab1f3b3013dcf1526538dc61d Mon Sep 17 00:00:00 2001 From: Karl Palsson Date: Tue, 21 May 2019 22:13:43 +0000 Subject: [PATCH] stm32: doc: dac: move to peripheral_apis. Drops all the stub dummy header files, many of which weren't even being built, and moves them to the clean peripherals_api doc section. --- lib/stm32/common/dac_common_all.c | 9 +++++---- lib/stm32/f0/Makefile | 2 +- lib/stm32/f0/dac.c | 31 ------------------------------- lib/stm32/f1/dac.c | 31 ------------------------------- lib/stm32/f2/dac.c | 31 ------------------------------- lib/stm32/f3/dac.c | 31 ------------------------------- lib/stm32/f4/dac.c | 31 ------------------------------- lib/stm32/l1/dac.c | 31 ------------------------------- 8 files changed, 6 insertions(+), 191 deletions(-) delete mode 100644 lib/stm32/f0/dac.c delete mode 100644 lib/stm32/f1/dac.c delete mode 100644 lib/stm32/f2/dac.c delete mode 100644 lib/stm32/f3/dac.c delete mode 100644 lib/stm32/f4/dac.c delete mode 100644 lib/stm32/l1/dac.c diff --git a/lib/stm32/common/dac_common_all.c b/lib/stm32/common/dac_common_all.c index a8a0daf8..5d1893c1 100644 --- a/lib/stm32/common/dac_common_all.c +++ b/lib/stm32/common/dac_common_all.c @@ -1,12 +1,13 @@ -/** @addtogroup dac_file +/** @addtogroup dac_file DAC peripheral API + * @ingroup peripheral_apis @author @htmlonly © @endhtmlonly 2012 Ken Sarkies ksarkies@internode.on.net This library supports the Digital to Analog Conversion System in the -STM32F series of ARM Cortex Microcontrollers by ST Microelectronics. +STM32 series of ARM Cortex Microcontrollers by ST Microelectronics. -The DAC is present only in a limited set of devices, notably some -of the connection line, high density and XL devices. +The DAC peripheral found on many of the devices in the STM32 lineup, +sometimes with only one channel, but normally with two channels. Two DAC channels are available, however unlike the ADC channels these are separate DAC devices controlled by the same register block. diff --git a/lib/stm32/f0/Makefile b/lib/stm32/f0/Makefile index a5883643..816f3f81 100644 --- a/lib/stm32/f0/Makefile +++ b/lib/stm32/f0/Makefile @@ -37,7 +37,7 @@ TGT_CFLAGS += $(STANDARD_FLAGS) ARFLAGS = rcs OBJS = can.o flash.o rcc.o dma.o rtc.o comparator.o \ - dac.o pwr.o gpio.o timer.o adc.o desig.o + pwr.o gpio.o timer.o adc.o desig.o OBJS += gpio_common_all.o gpio_common_f0234.o crc_common_all.o crc_v2.o \ pwr_common_v1.o iwdg_common_all.o rtc_common_l1f024.o \ diff --git a/lib/stm32/f0/dac.c b/lib/stm32/f0/dac.c deleted file mode 100644 index 55cdd62c..00000000 --- a/lib/stm32/f0/dac.c +++ /dev/null @@ -1,31 +0,0 @@ -/** @defgroup dac_file DAC - * - * @ingroup STM32F0xx - * - * @brief libopencm3 STM32F0xx DAC - * - * @version 1.0.0 - * - * @date 11 July 2013 - * - * LGPL License Terms @ref lgpl_license - */ - -/* - * This file is part of the libopencm3 project. - * - * This library is free software: you can redistribute it and/or modify - * it under the terms of the GNU Lesser General Public License as published by - * the Free Software Foundation, either version 3 of the License, or - * (at your option) any later version. - * - * This library is distributed in the hope that it will be useful, - * but WITHOUT ANY WARRANTY; without even the implied warranty of - * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the - * GNU Lesser General Public License for more details. - * - * You should have received a copy of the GNU Lesser General Public License - * along with this library. If not, see . - */ - -#include diff --git a/lib/stm32/f1/dac.c b/lib/stm32/f1/dac.c deleted file mode 100644 index fa599bb7..00000000 --- a/lib/stm32/f1/dac.c +++ /dev/null @@ -1,31 +0,0 @@ -/** @defgroup dac_file DAC - -@ingroup STM32F1xx - -@brief libopencm3 STM32F1xx DAC - -@version 1.0.0 - -@date 18 August 2012 - -LGPL License Terms @ref lgpl_license -*/ - -/* - * This file is part of the libopencm3 project. - * - * This library is free software: you can redistribute it and/or modify - * it under the terms of the GNU Lesser General Public License as published by - * the Free Software Foundation, either version 3 of the License, or - * (at your option) any later version. - * - * This library is distributed in the hope that it will be useful, - * but WITHOUT ANY WARRANTY; without even the implied warranty of - * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the - * GNU Lesser General Public License for more details. - * - * You should have received a copy of the GNU Lesser General Public License - * along with this library. If not, see . - */ - -#include diff --git a/lib/stm32/f2/dac.c b/lib/stm32/f2/dac.c deleted file mode 100644 index 635e142b..00000000 --- a/lib/stm32/f2/dac.c +++ /dev/null @@ -1,31 +0,0 @@ -/** @defgroup dac_file DAC - -@ingroup STM32F2xx - -@brief libopencm3 STM32F2xx DAC - -@version 1.0.0 - -@date 18 August 2012 - -LGPL License Terms @ref lgpl_license -*/ - -/* - * This file is part of the libopencm3 project. - * - * This library is free software: you can redistribute it and/or modify - * it under the terms of the GNU Lesser General Public License as published by - * the Free Software Foundation, either version 3 of the License, or - * (at your option) any later version. - * - * This library is distributed in the hope that it will be useful, - * but WITHOUT ANY WARRANTY; without even the implied warranty of - * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the - * GNU Lesser General Public License for more details. - * - * You should have received a copy of the GNU Lesser General Public License - * along with this library. If not, see . - */ - -#include diff --git a/lib/stm32/f3/dac.c b/lib/stm32/f3/dac.c deleted file mode 100644 index 2d8021e0..00000000 --- a/lib/stm32/f3/dac.c +++ /dev/null @@ -1,31 +0,0 @@ -/** @defgroup dac_file DAC - * - * @ingroup STM32F3xx - * - * @brief libopencm3 STM32F3xx DAC - * - * @version 1.0.0 - * - * @date 18 August 2012 - * - * LGPL License Terms @ref lgpl_license - */ - -/* - * This file is part of the libopencm3 project. - * - * This library is free software: you can redistribute it and/or modify - * it under the terms of the GNU Lesser General Public License as published by - * the Free Software Foundation, either version 3 of the License, or - * (at your option) any later version. - * - * This library is distributed in the hope that it will be useful, - * but WITHOUT ANY WARRANTY; without even the implied warranty of - * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the - * GNU Lesser General Public License for more details. - * - * You should have received a copy of the GNU Lesser General Public License - * along with this library. If not, see . - */ - -#include diff --git a/lib/stm32/f4/dac.c b/lib/stm32/f4/dac.c deleted file mode 100644 index c5397b62..00000000 --- a/lib/stm32/f4/dac.c +++ /dev/null @@ -1,31 +0,0 @@ -/** @defgroup dac_file DAC - -@ingroup STM32F4xx - -@brief libopencm3 STM32F4xx DAC - -@version 1.0.0 - -@date 18 August 2012 - -LGPL License Terms @ref lgpl_license -*/ - -/* - * This file is part of the libopencm3 project. - * - * This library is free software: you can redistribute it and/or modify - * it under the terms of the GNU Lesser General Public License as published by - * the Free Software Foundation, either version 3 of the License, or - * (at your option) any later version. - * - * This library is distributed in the hope that it will be useful, - * but WITHOUT ANY WARRANTY; without even the implied warranty of - * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the - * GNU Lesser General Public License for more details. - * - * You should have received a copy of the GNU Lesser General Public License - * along with this library. If not, see . - */ - -#include diff --git a/lib/stm32/l1/dac.c b/lib/stm32/l1/dac.c deleted file mode 100644 index ed118b4d..00000000 --- a/lib/stm32/l1/dac.c +++ /dev/null @@ -1,31 +0,0 @@ -/** @defgroup dac_file DAC - -@ingroup STM32L1xx - -@brief libopencm3 STM32L1xx DAC - -@version 1.0.0 - -@date 18 August 2012 - -LGPL License Terms @ref lgpl_license -*/ - -/* - * This file is part of the libopencm3 project. - * - * This library is free software: you can redistribute it and/or modify - * it under the terms of the GNU Lesser General Public License as published by - * the Free Software Foundation, either version 3 of the License, or - * (at your option) any later version. - * - * This library is distributed in the hope that it will be useful, - * but WITHOUT ANY WARRANTY; without even the implied warranty of - * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the - * GNU Lesser General Public License for more details. - * - * You should have received a copy of the GNU Lesser General Public License - * along with this library. If not, see . - */ - -#include