diff options
| author | gdisirio <gdisirio@35acf78f-673a-0410-8e92-d51de3d6d3f4> | 2009-06-01 17:52:34 +0000 |
|---|---|---|
| committer | gdisirio <gdisirio@35acf78f-673a-0410-8e92-d51de3d6d3f4> | 2009-06-01 17:52:34 +0000 |
| commit | 0da4e6e067db019f455b43a3391a1510f517d2cf (patch) | |
| tree | 01aaf653d065aefc074532a5f665c36ccf79fd9e /docs/src | |
| parent | a83063db261921df93594ae43bd9d568298f3361 (diff) | |
| download | ChibiOS-0da4e6e067db019f455b43a3391a1510f517d2cf.tar.gz ChibiOS-0da4e6e067db019f455b43a3391a1510f517d2cf.tar.bz2 ChibiOS-0da4e6e067db019f455b43a3391a1510f517d2cf.zip | |
Added abstract I/O ports driver header file and documentation. Implementations are missing.
git-svn-id: svn://svn.code.sf.net/p/chibios/svn/trunk@1003 35acf78f-673a-0410-8e92-d51de3d6d3f4
Diffstat (limited to 'docs/src')
| -rw-r--r-- | docs/src/main.dox | 80 |
1 files changed, 65 insertions, 15 deletions
diff --git a/docs/src/main.dox b/docs/src/main.dox index 0bcd4969f..a969854f4 100644 --- a/docs/src/main.dox +++ b/docs/src/main.dox @@ -355,6 +355,69 @@ */
/**
+ * @defgroup IOPorts Abstract I/O Ports
+ * @brief Abstract digital I/O ports.
+ * @details This module defines an abstract interface for digital I/O ports.
+ * Note that no code is present, I/O ports are just a set of macros that must
+ * be implemented by a low level I/O port driver.<br>
+ * Currently the I/O ports interface does not handle physical port programming
+ * like direction, pull up/down resistors etc. The interface only allows input
+ * and output operations but this may change in future releases.
+ * This system has the advantage to make the access to I/O ports platform
+ * independent from the implementation logic.
+ *
+ * <h2>Implementation Rules</h2>
+ * In implementing an I/O port low level driver there are some rules that
+ * should be respected.
+ *
+ * <h3>Write on input pads</h3>
+ * The behavior is not specified but there are implementations better than
+ * others, this is the list of possible implementations, preferred options
+ * are on top:
+ * -# The written value is not actually output but latched, should the pads
+ * be reprogrammed as outputs the value would be in effect.
+ * -# The write operation is ignored.
+ * -# The write operation has side effects, as example disabling/enabling
+ * pull up/down resistors or changing the pad direction. This scenario is
+ * discouraged, please try to avoid this scenario.
+ * .
+ * <h3>Read from output pads</h3>
+ * The behavior is not specified but there are implementations better than
+ * others, this is the list of possible implementations, preferred options
+ * are on top:
+ * -# The actual pads states are read (not the output latch).
+ * -# The output latch value is read (regardless of the actual pads states).
+ * -# Unspecified, please try to avoid this scenario.
+ * .
+ * <h3>Writing unused or unimplemented port bits</h3>
+ * The behavior is not specified.
+ *
+ * <h3>Reading from unused or unimplemented port bits</h3>
+ * The behavior is not specified.
+ *
+ * <h3>Reading or writing on pins associated to other functionalities</h3>
+ * The behavior is not specified.
+ *
+ * @ingroup IO
+ */
+
+/**
+ * @defgroup Channels Abstract I/O Channels
+ * @brief Abstract I/O Channels.
+ * @details This module defines an abstract interface for I/O channels. Note
+ * that no code is present, I/O channels are just abstract classes-like
+ * structures, you should look at the systems as to a set of abstract C++
+ * classes (even if written in C). Specific device drivers can use/extend
+ * the interfaces and implement them.<br>
+ * This system has the advantage to make the access to channels
+ * independent from the implementation logic. As example, an I/O channel
+ * interface can hide the access to a serial driver, to a networking socket
+ * and so on.
+ *
+ * @ingroup IO
+ */
+
+/**
* @defgroup IOQueues I/O Queues
* @brief I/O queues.
* @details ChibiOS/RT supports several kinds of queues. The queues are mostly
@@ -373,25 +436,11 @@ * .
* In order to use the I/O queues the @p CH_USE_QUEUES option must
* be specified in @p chconf.h.<br>
+ *
* @ingroup IO
*/
/**
- * @defgroup Channels Abstract I/O Channels
- * @brief Abstract I/O Channels.
- * @details This module defines an abstract interface for I/O channels. Note
- * that no code is present, I/O channels are just abstract classes-like
- * structures, you should look at the systems as to a set of abstract C++
- * classes (even if written in C). Specific device drivers can use/extend
- * the interfaces and implement them.<br>
- * This system has the advantage to make the access to channels
- * independent from the implementation logic. As example, an I/O channel
- * interface can hide the access to a serial driver, to a networking socket
- * and so on.
- * @ingroup IO
- */
-
-/**
* @defgroup Serial Serial Drivers
* @brief Generic Serial Drivers.
* @details This module implements a generic full duplex serial driver. The
@@ -403,6 +452,7 @@ * interrupt service routines much easier.<br>
* In order to use the serial full duplex driver the
* @p CH_USE_SERIAL_FULLDUPLEX option must be specified in @p chconf.h.
+ *
* @ingroup IO
*/
|