diff options
author | Gregory Nutt <gnutt@nuttx.org> | 2014-12-15 19:01:40 -0600 |
---|---|---|
committer | Gregory Nutt <gnutt@nuttx.org> | 2014-12-15 19:01:40 -0600 |
commit | 15c6fe6c0ab549ba13f40e052a807e33dacc7ee9 (patch) | |
tree | 723fe289f18ab36c390b27d5083ac561f99ee89f /nuttx/drivers | |
parent | 698fba65113ac33982c9fb9b5d7f9399682ec21e (diff) | |
download | px4-nuttx-15c6fe6c0ab549ba13f40e052a807e33dacc7ee9.tar.gz px4-nuttx-15c6fe6c0ab549ba13f40e052a807e33dacc7ee9.tar.bz2 px4-nuttx-15c6fe6c0ab549ba13f40e052a807e33dacc7ee9.zip |
Update README files
Diffstat (limited to 'nuttx/drivers')
-rw-r--r-- | nuttx/drivers/README.txt | 58 | ||||
-rw-r--r-- | nuttx/drivers/syslog/README.txt | 16 |
2 files changed, 55 insertions, 19 deletions
diff --git a/nuttx/drivers/README.txt b/nuttx/drivers/README.txt index df5d13fef..8ec893995 100644 --- a/nuttx/drivers/README.txt +++ b/nuttx/drivers/README.txt @@ -36,23 +36,18 @@ ramdisk.c a block driver that can be mounted as a files system. See include/nuttx/fs/ramdisk.h. -ramlog.c - This is a driver that was intended to support debugging output, - aka syslogging, when the normal serial output is not available. - For example, if you are using a telnet or USB serial console, - the debug output will get lost. - - This driver is similar to a pipe in that it saves the debugging - output in a FIFO in RAM. It differs from a pipe in numerous - details as needed to support logging. - - This driver is built when CONFIG_RAMLOG is defined in the Nuttx - configuration. +timer.c + Provides the "upper half" for a generic timer driver. See + include/nuttx/timer.h for more information. rwbuffer.c A facility that can be use by any block driver in-order to add writing buffering and read-ahead buffering. +watchdog.c + Provides the "upper half" for a generic watchdog driver. See + include/nuttx/watchdog.h for more information. + Subdirectories of this directory: ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ @@ -62,16 +57,35 @@ analog/ well as drivers for Digital to Analog Conversion (DAC). See include/nuttx/analog/*.h for registration information. +audio/ + Audio device drivers. See include/nuttx/audio/audio.h for interface + definitions. See also the audio subsystem at nuttx/audio/. + bch/ Contains logic that may be used to convert a block driver into a character driver. This is the complementary conversion as that performed by loop.c. See include/nuttx/fs/fs.h for registration information. +eeprom/ + An EEPROM is a form of Memory Technology Device (see drivers/mtd). + EEPROMs are non-volatile memory like FLASH, but differ in underlying + memory technology and differ in usage in many respects: They may not + be organized into blocks (at least from the standpoint of the user) + and it is not necessary to erase the EEPROM memory before re-writing + it. In addition, EEPROMs tend to be much smaller than FLASH parts, + usually only a few kilobytes vs megabytes for FLASH. EEPROM tends to + be used to retain a small amount of device configuration information; + FLASH tends to be used for program or massive data storage. For these + reasons, it may not be convenient to use the more complex MTD + interface but instead use the simple character interface provided by + the EEPROM drivers. + input/ - This directory holds implementations of input device drivers. - This includes such things as touchscreen and keypad drivers. - See include/nuttx/input/*.h for registration information. + This directory holds implementations of human input device drivers. + This includes such things as mouse, touchscreen, joystick, keyboard + and keypad drivers. See include/nuttx/input/*.h for registration + information. lcd/ Drivers for parallel and serial LCD and OLED type devices. These @@ -106,7 +120,10 @@ power/ drivers are not active. sensors/ - Drivers for various sensors + Drivers for various sensors. A sensor driver differs little from + other types of drivers other than they are use to provide measuresments + of things in envionment like temperatore, orientation, acceleration, + altitude, direction, position, etc. sercomm/ Sercomm is the transport used by osmocom-bb that runs on top of serial. @@ -123,12 +140,21 @@ serial/ some TTY-like functionality and are commonly used (but not required for) the NuttX system console. See also include/nuttx/serial/serial.h +spi/ + SPI drivers. See include/nuttx/spi.h + +syslog/ + System logging devices. See include/syslog.h and include/nuttx/syslog/syslog.h + usbdev/ USB device drivers. See also include/nuttx/usb/usbdev.h usbhost/ USB host drivers. See also include/nuttx/usb/usbhost.h +video/ + Video-related drivers. See inlude/nuttx/video/. + wireless/ Drivers for various wireless devices. diff --git a/nuttx/drivers/syslog/README.txt b/nuttx/drivers/syslog/README.txt index 26fb43adf..2d0445992 100644 --- a/nuttx/drivers/syslog/README.txt +++ b/nuttx/drivers/syslog/README.txt @@ -29,9 +29,19 @@ Those custom SYSLOG drivers reside in this directory. ramlog.c -------- The RAM logging driver is a driver that was intended to support debugging - output (syslogging) when the normal serial output is not available. For - example, if you are using a telnet or USB serial console, the debug - output will get lost. + output (aka, syslogging). It might be used when the normal serial output + is not available. For example, if you are using a Telnet or USB serial + console, the debug output will get lost since the USB Telnet session does + not use the serial console. + + The RAM logginc driver is also useful when debug output on the serial + console would interfere with performance or with usability. The debug + output is write to RAM very quickly and so interferes less with realtime + performance. And since the output does not appear on the serial console + until you want it to, it does not interfere with the usability of the + serial console. The NuttShell (NSH), for eample, supports a 'dmesg' + command that can be used to dump the buffered output when you want to + see it. The RAM logging driver is similar to a pipe in that it saves the debugging output in a FIFO in RAM. It differs from a pipe in numerous |