aboutsummaryrefslogtreecommitdiffstats
path: root/docs/source/external-interrupts.rst
diff options
context:
space:
mode:
authorMarti Bolivar <mbolivar@leaflabs.com>2011-06-11 19:25:29 -0400
committerMarti Bolivar <mbolivar@leaflabs.com>2011-06-11 20:05:33 -0400
commit0c2b3c667bf157dc2344e3dbc2aae0e11e37387b (patch)
tree3008ee192c80f17f640ebdeb870442e78415ce6b /docs/source/external-interrupts.rst
parentd4b576fcadecf66b7b754af7d204bb6f3b4a9830 (diff)
downloadlibrambutan-0c2b3c667bf157dc2344e3dbc2aae0e11e37387b.tar.gz
librambutan-0c2b3c667bf157dc2344e3dbc2aae0e11e37387b.zip
Remove reST documentation, attendant updates.
The documentation covers topics not specifically relevant to libmaple, so it doesn't make sense for it to be part of the libmaple source distribution. Delete the docs/ tree, and prepare libmaple for use with the new leaflabs-docs repo, which will contain the docs from now on. * README: update to reflect this change * support/doxygen/Doxyfile: This is the old docs/Doxyfile * Makefile: Add a doxygen target * wirish/comm/HardwareSerial.h: fix reference to docs/. The comment informing maintainers that the HardwareSerial interface is documented by hand refers to the docs/ tree, which no longer exists. Update it to refer to the separate leaflabs-docs repository. * support/scripts/copy-to-ide: No longer build the documentation
Diffstat (limited to 'docs/source/external-interrupts.rst')
-rw-r--r--docs/source/external-interrupts.rst76
1 files changed, 0 insertions, 76 deletions
diff --git a/docs/source/external-interrupts.rst b/docs/source/external-interrupts.rst
deleted file mode 100644
index 9089d77..0000000
--- a/docs/source/external-interrupts.rst
+++ /dev/null
@@ -1,76 +0,0 @@
-.. highlight:: cpp
-
-.. _external-interrupts:
-
-External Interrupts
-===================
-
-External interrupts can be used to make a voltage change on a pin
-cause a function to be called. Each :ref:`GPIO pin <gpio>` can be
-used to detect transitions, such as when the voltage goes from
-:ref:`LOW <lang-constants-low>` to :ref:`HIGH <lang-constants-high>`,
-or from ``HIGH`` to ``LOW``. This can be used to avoid checking for
-changes on a pin "manually" by waiting in a loop until the pin
-changes.
-
-.. _contents: Contents
- :local:
-
-Overview
---------
-
-External interrupts are often used to detect when events happen
-outside of the Maple. These can be used to tell Maple when events
-happen, such as when a sensor has data ready to be read, or when a
-button has been pushed. When such an event happens, an interrupt is
-raised, and the Maple stops whatever it was doing to react to it by
-calling a function (called an *interrupt handler*) which you specify
-using :ref:`lang-attachinterrupt`.
-
-.. _external-interrupts-exti-line:
-
-Every pin can generate an external interrupt, but there are some
-restrictions. At most 16 different external interrupts can be used at
-one time. Further, you can't just pick any 16 pins to use. This is
-because every pin on the Maple connects to what is called an *EXTI
-line*, and only one pin per EXTI line can be used for external
-interrupts at a time [#fextisports]_.
-
-.. TODO [0.0.12] Maple Native links
-
-The EXTI Line Pin Map for your board lists which pins connect to which
-EXTI lines:
-
-* :ref:`Maple <maple-exti-map>`
-* :ref:`Maple RET6 Edition <maple-ret6-exti-map>`
-* :ref:`Maple Mini <maple-mini-exti-map>`
-
-.. note::
-
- You should set the :ref:`pin mode <lang-pinmode>` of your desired
- pin to an input mode (e.g. ``INPUT``, ``INPUT_PULLUP``,
- ``INPUT_PULLDOWN``).
-
-Function Reference
-------------------
-
-- :ref:`attachInterrupt() <lang-attachinterrupt>`
-- :ref:`detachInterrupt() <lang-detachinterrupt>`
-
-Recommended Reading
--------------------
-
-* ST manual `RM0008
- <http://www.st.com/stonline/products/literature/rm/13902.pdf>`_
- (PDF), Chapter 9, "General-purpose and alternate-function I/Os", and
- Chapter 10, "Interrupts and Events".
-
-.. rubric:: Footnotes
-
-.. [#fextisports] The underlying reason for this restriction is that
- the external interrupt lines on the STM32 are shared between
- :ref:`GPIO ports <gpio-ports>`. There can be only one external
- interrupt on each GPIO bit, out of all of the ports. That is, if
- PA4 has an external interrupt on it, then PB4 can't have one, too.
- Since the GPIO bit numbers only go from 0 to 15, there can only be
- 16 external interrupts at a time.