aboutsummaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorMarti Bolivar <mbolivar@leaflabs.com>2012-05-08 12:28:14 -0400
committerMarti Bolivar <mbolivar@leaflabs.com>2012-05-16 13:23:38 -0400
commit723bcc9ea549be77e9d5c23ae160ede322c6cb2e (patch)
tree7b23670873c7608436c7dbcc1047955d30bda91f
parentb0933e4255bc66adb138c7bb82b5730b23048f5a (diff)
downloadlibrambutan-723bcc9ea549be77e9d5c23ae160ede322c6cb2e.tar.gz
librambutan-723bcc9ea549be77e9d5c23ae160ede322c6cb2e.zip
stm32.rst: Add more flesh.
Change the title so it fits in the sidebar better. Add introductory paragraphs to set the tone for what goes in here. Other additions as needed by imminent changes to other documents. Signed-off-by: Marti Bolivar <mbolivar@leaflabs.com>
-rw-r--r--source/stm32.rst44
1 files changed, 36 insertions, 8 deletions
diff --git a/source/stm32.rst b/source/stm32.rst
index bbfa1fc..d918655 100644
--- a/source/stm32.rst
+++ b/source/stm32.rst
@@ -1,11 +1,29 @@
.. _stm32:
-Introduction to the STM32
-=========================
-
-.. FIXME [v0.0.13] Stub.
-
-Stub. To fill in:
+Introduction to STM32
+=====================
+
+.. FIXME [v0.0.13] Stub page.
+
+Every Maple board is powered by an STM32 microcontroller (the chip
+which controls all of the pins). Once you're comfortable using your
+Maple, you'll probably start to get curious about what's going on
+under the hood. This page is a good place to begin. It includes an
+overview of the STM32, and helps you make sense of the sometimes
+dizzying array of features, libraries, and documentation that are
+available to you.
+
+The world of the STM32 is a big one, and it's only getting bigger.
+With literally thousands of pages of manuals, datasheets, application
+notes, etc. available for every STM32 microcontroller, and a huge
+variety of categories and subcategories of STM32s available to choose
+from, it's easy to get confused or feel daunted about getting started.
+Don't panic! We've got `your towel
+<http://en.wikipedia.org/wiki/Know_where_one%27s_towel_is#Knowing_where_one.27s_towel_is>`_
+right here.
+
+.. contents:: Contents
+ :local:
.. _stm32-general:
@@ -22,6 +40,16 @@ General Information
reference manual for each board is always documented in that board's
hardware page.
+.. _stm32-series:
+.. _stm32-series-f1-lines:
+
+STM32 Series
+------------
+
+- Describe families, F1 lines, etc.
+
+- Describe how a product name tells you what you need
+
ST's Documentation
------------------
@@ -51,8 +79,8 @@ the) the :ref:`timers <timers>` have capture/compare registers, the
.. _stm32-libmaple-support:
-``libmaple``\ 's STM32 support
-------------------------------
+``libmaple`` STM32 support
+--------------------------
- Descriptions of libmaple's present support for the STM32 line
(i.e. currently performance-line only; update when the F2 branch is