aboutsummaryrefslogtreecommitdiffstats
path: root/source/libmaple/api/stm32.rst
diff options
context:
space:
mode:
authorMarti Bolivar <mbolivar@leaflabs.com>2011-08-22 23:37:16 -0400
committerMarti Bolivar <mbolivar@leaflabs.com>2011-08-22 23:37:16 -0400
commitc6ba836ad1fbda247d9622b2f372a0c9c0cdbfd9 (patch)
tree7fe0def72ce810256d903557909fc9462b8ac9fb /source/libmaple/api/stm32.rst
parent6a6a7c31c3b1a920a73dbc1f11dc502de7e776cd (diff)
downloadlibrambutan-c6ba836ad1fbda247d9622b2f372a0c9c0cdbfd9.tar.gz
librambutan-c6ba836ad1fbda247d9622b2f372a0c9c0cdbfd9.zip
Better document libmaple proper APIs.
Instead of using doxygenfile, add finely-grained documentation for each libmaple proper header that we guarantee an API for. These new files are in keeping with the template provided in /tmpl/libmaple-proper-page.rst.tmpl. Breathe still has to be taught how to do doxygenunion to get some of this right, but I'm committing this now in anticipation of that happening.
Diffstat (limited to 'source/libmaple/api/stm32.rst')
-rw-r--r--source/libmaple/api/stm32.rst15
1 files changed, 11 insertions, 4 deletions
diff --git a/source/libmaple/api/stm32.rst b/source/libmaple/api/stm32.rst
index 2784540..82280bb 100644
--- a/source/libmaple/api/stm32.rst
+++ b/source/libmaple/api/stm32.rst
@@ -4,9 +4,16 @@
``stm32.h``
===========
-[Stub] support.
+General STM32-specific definitions. This file is currently somewhat
+incomplete, but it will form the future basis for MCU-specific (rather
+than board-specific, which belongs in :ref:`Wirish
+<libmaple-vs-wirish>`) configuration.
-Library Documentation
----------------------
+Defines
+-------
-.. doxygenfile:: stm32.h
+.. doxygendefine:: PCLK1
+.. doxygendefine:: PCLK2
+.. doxygendefine:: NR_INTERRUPTS
+.. doxygendefine:: NR_GPIO_PORTS
+.. doxygendefine:: DELAY_US_MULT