Karl Palsson
ca479ad7d2
stm32: quadspi overhaul documentation
...
Provide all doxygen framework boilerplate.
Provide a very initial stub .c file to ensure that heirarchical headers
are pulled in properly.
2021-01-29 13:00:53 +00:00
Karl Palsson
2daef7c3ec
stm32h7: enable quadspi includes
...
Fixes: fcb030cc883ca14 which left off the include header.
2021-01-29 13:00:49 +00:00
Karl Palsson
c02ccfe47e
stm32: quadspi: restore copyright after file move
...
The f4 quadspi implementation was moved to the -v1 file, so the
copyright should have moved with it.
2021-01-29 13:00:49 +00:00
Matt Walker
0cf8a47d88
STM32H7: Add QSPI Defines
...
Move the STM32F4 QuadSPI peripheral defines to the common folder as the
F4 and H7 variants of the IP share almost all the same bits. For those
bits that are separate put them into their own headers.
2021-01-29 13:00:49 +00:00
Karl Palsson
7df670b6aa
stm32: usart: fix doxygen for h7 at least
...
The usart_common_fifos uses a very nice style of docs in the headers, so
inline help works in some editors, without having to have the source of
the library available as well. However, it means that the group
definition with the name doesn't appear until later, and then the title
is ignored. Move the description to the header definition instead.
2021-01-29 13:00:49 +00:00
Karl Palsson
5f4e2b3758
stm32:i2c-v1: eliminate doxygen warnings
...
We deprecated the defines in favour of just using the value itself, so
there's no longer a defined group to reference.
2021-01-28 00:33:07 +00:00
Karl Palsson
bcccfc4a63
stm32h7:doc: eliminate some doxygen warnings.
2021-01-28 00:32:47 +00:00
Karl Palsson
7f74d92e34
stm32:dac:doc: clarify availability on part families
2021-01-27 23:50:22 +00:00
Karl Palsson
0f1f1ebd1a
stm32:dac: Fix waveform generation apis
...
These were broken earlier, with no sane way of passing in correctly shifted
values, and didn't match examples.
Noticed while merging: https://github.com/libopencm3/libopencm3/pull/1281
2021-01-27 23:50:22 +00:00
Karl Palsson
8295d248e0
stm32:dac: new api for waveform characteristics
...
Old API required users to manually construct bit maps frm opaquely named
defines, with little help. It also was a pure OR operation, with no way
to ever clear bits.
Signed-off-by: Karl Palsson <karlp@tweak.net.au>
2021-01-27 23:50:15 +00:00
Karl Palsson
da9db7f1f5
stm32:dac: fix doxygen tags on v2
...
Trivial copy paste error.
2021-01-26 22:33:33 +00:00
Stijn Martens
f9d5fb738e
stm32: usart: add idle interrupt enable/disable
2021-01-26 10:43:23 +01:00
Karl Palsson
34a44af4e4
stm32: dac: fix doxygen parameter link
2021-01-24 22:34:10 +00:00
Karl Palsson
4576f29048
stm32g4: adc: fix doxygen grouping
...
avoids stub groups
2021-01-24 22:28:15 +00:00
Karl Palsson
59fdb61bf2
stm32: dac: doc: link data types
...
And also drop pointless whitespace and divider markers
2021-01-24 22:23:25 +00:00
Karl Palsson
3eb94bb335
stm32: dac: document: whitespace for legibility
2021-01-24 22:10:05 +00:00
Karl Palsson
4fe5103851
stm32: dac: doxygenize the registers and values
...
Not 100% complete, but far closer, mostly just tagging the existing
information properly to get it included.
2021-01-24 22:08:20 +00:00
Karl Palsson
03cfd6b1ac
stm32: dac: doxygen grouping for register bases
2021-01-24 21:38:50 +00:00
Karl Palsson
fda0282b43
stm32f0: dac: drop redundant definitions
...
we're breaking the DAC api already, so don't bother keeping f0 specific
aliases for some of the t1 triggers.
2021-01-24 21:36:21 +00:00
Ben Brewer
1ebf172bcb
stm32/dac: Update API to support multiple DACs and add v2 support
2021-01-07 15:30:51 +00:00
Kejia Hu
52781dee56
stm32g4: add SPI
...
The SPI peripheral on G4 is identical to F3, this patch copies the
header files directly from F3
2020-12-11 11:15:02 +00:00
Karl Palsson
a499ea3480
stm32: timer/dmamux: fix broken includes
...
bad Karl, you can't just _start_ using pragma on common files, and
expect it to keep working. Just finish, convert them fully to pragma.
pros: no more weird @cond boilerplate mess and trailing #endifs. easier
to follow
cons: no warning for people who deliberately try and include things in
bad orders.
2020-12-10 23:00:11 +00:00
Karl Palsson
1abb945dcd
stm32f7: flash: doxygenize existing comments.
...
Just putting it in a different place and it all gets included in the
output nicely.
2020-12-10 22:26:05 +00:00
Karl Palsson
97d5e9a403
doxygen: fix more broken groupings
2020-12-10 22:25:51 +00:00
Karl Palsson
992a4d3753
stm32: rtc: doxygenize existing docs
...
Might as well show the information we have!
2020-12-10 22:00:03 +00:00
Karl Palsson
e07f23bb70
doxygen: fix many warnings on "end of file while in group"
2020-12-10 21:51:48 +00:00
Karl Palsson
6f81e49290
stm32:crc: simplify doxygen and fix groupings
...
The @cond stuff has always been a lot of work for the rare cases of
people trying to include things by hand. Just drop it
2020-12-10 21:34:49 +00:00
Ben Brewer
e923a6fe6a
stm32g4: Add support for OPAMP
...
Move implementations into common and split into v1 and v2.
2020-12-10 16:46:24 +00:00
Karl Palsson
8435287300
stm32: dma: doxygen fixups
...
Use a single @defgroup for the "root" of a common heirarchy, and only
addtogroup for additions. This prevents an alphabetically "first" entry
from being used as the documentation for the entire group.
2020-12-02 00:04:44 +00:00
Karl Palsson
382dde5a6d
stm32f7/g4: usb: enable all classes
2020-12-01 23:37:26 +00:00
Karl Palsson
f82053000c
stm32: crs: fix doxygen
...
We need per device header includes to make the per target documentation
generation work properly. The dispatch headers are to dispatch to the
_target_ not directly to the final implementation, remember, the final
required headers for each may be multiple files, plus extra definitions!
2020-12-01 23:13:38 +00:00
Ben Brewer
98855377c6
stm32g4: Enable CRS
2020-12-01 22:41:07 +00:00
Sam Kirkham
82b4626ae3
stm32g4: Add support for USB
...
Co-authored-by: Ben Brewer <ben.brewer@codethink.co.uk>
2020-12-01 22:41:07 +00:00
Sam Kirkham
cdf235ca0c
stm32g4: Add support for ADC
...
Co-authored-by: Ben Brewer <ben.brewer@codethink.co.uk>
2020-12-01 22:41:07 +00:00
Ben Brewer
7219b32902
stm32: adc_common_v2: Make EXTSEL and ALIGN definitions per chip
...
STM32G4 uses v2 ADC but has EXTSEL and ALIGN fields modified, rather
than making a v3 ADC for these minor changes, the definitions have been
moved to the chip specific headers, so that the common code can work for
G4 onwards.
2020-12-01 22:41:02 +00:00
Sam Kirkham
b84bf6e244
stm32g4: Add support for DMA
2020-12-01 22:41:02 +00:00
Sam Kirkham
17d6660491
stm32g4: Add support for DMAMUX
...
Co-authored-by: Ben Brewer <ben.brewer@codethink.co.uk>
2020-12-01 22:41:02 +00:00
Sam Kirkham
0fbf6e8cc1
stm32g4: Add support for Timers
2020-12-01 22:41:02 +00:00
Ben Brewer
f4f75c92dd
stm32g4: Implement RCC
...
Co-authored-by: Sam Kirkham <sam.kirkham@codethink.co.uk>
2020-12-01 22:41:02 +00:00
Ben Brewer
59569bfb04
stm32g4: Implement FLASH
2020-12-01 22:41:02 +00:00
Ben Brewer
c26eab2513
stm32g4: Implement PWR
2020-12-01 22:41:02 +00:00
Karl Palsson
3afd16b5d9
README: flag the wildwest-N preview branches
...
Hey, we have a readme, let's keep it up to date?
2020-11-28 22:13:25 +00:00
Denis Feklushkin
f5192dbcb5
mk: genlink: simplify variable usage
2020-11-28 22:13:25 +00:00
Brian Viele
e41ac6ea71
stm32: added peripheral clock get helpers for all stm32 platforms.
...
Allows for abstraction for code that's dependent on knowing the source clock
for a peripheral. Implemented a few core peripherals that tend to have clock
tree differences between platforms (USART, timers, I2C, SPI).
2020-11-28 22:13:25 +00:00
Kevin Stefanik
df55d45cc1
pac55xx: add usart definitions and basic support code.
2020-11-28 22:13:25 +00:00
Kevin Stefanik
253a091936
pac55xx: adding memctl for flash/sram access, and clock/pll configuration functions.
...
Merge-conflict: took _prior_ verision of CCS_MUXSELR_MASK_PIN as
bracketing of (pin) seemed more correct!
2020-11-28 22:13:25 +00:00
Kevin Stefanik
245761f894
pac55xx: implemented CAN module interface for qorvo pac55xx.
2020-11-28 22:13:25 +00:00
Karl Palsson
cb83273416
stm32: dcmi: drop redundant @ingroups
...
@ingroup is only needed if you want to assign a doxygen group to
something other than the naturally containing outer group.
2020-11-28 22:13:25 +00:00
Karl Palsson
daf99b9b76
stm32: dcmi: hook up doxygen again
...
We still need stub .c files as we're using shared common files, so .d
tracking doesn't work. It lets us setup basic introductory text anyway,
and there will be .c files eventually, so acceptable.
2020-11-28 22:13:25 +00:00
Nikolai Smolyaninov
071d4680ec
stm32f4/7: DCMI: extract common registers
...
And enable for the f7
Originally filed as: https://github.com/libopencm3/libopencm3/pull/1208
Rviewed-by: Karl Palsson <karlp@tweak.net.au>
2020-11-28 22:13:25 +00:00