Mercurial > emacs

changeset 95882:6ecce57aa149

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
Daniel Engeler <engeler at gmail.com> emacs.texi, misc.texi: Add documentation about serial port access.
author Glenn Morris <rgm@gnu.org>
date Fri, 13 Jun 2008 08:06:41 +0000
parents 17f08c967105
children 37aeb92752e7
files doc/emacs/ChangeLog doc/emacs/emacs.texi doc/emacs/misc.texi
diffstat 3 files changed, 37 insertions(+), 1 deletions(-) [+]
line wrap: on
line diff
--- a/doc/emacs/ChangeLog	Fri Jun 13 08:05:52 2008 +0000
+++ b/doc/emacs/ChangeLog	Fri Jun 13 08:06:41 2008 +0000
@@ -1,3 +1,7 @@
+2008-06-13  Daniel Engeler  <engeler@gmail.com>
+
+	* emacs.texi, misc.texi: Add documentation about serial port access.
+
 2008-06-13  Glenn Morris  <rgm@gnu.org>
 
 	* emacs-xtra.texi, emacs.texi: Update Back-Cover text per maintain.info.
--- a/doc/emacs/emacs.texi	Fri Jun 13 08:05:52 2008 +0000
+++ b/doc/emacs/emacs.texi	Fri Jun 13 08:06:41 2008 +0000
@@ -864,6 +864,7 @@
 * Term Mode::           Special Emacs commands used in Term mode.
 * Paging in Term::      Paging in the terminal emulator.
 * Remote Host::		Connecting to another computer.
+* Serial Terminal::     Connecting to a serial port.
 
 Using Emacs as a Server
 
--- a/doc/emacs/misc.texi	Fri Jun 13 08:05:52 2008 +0000
+++ b/doc/emacs/misc.texi	Fri Jun 13 08:06:41 2008 +0000
@@ -350,6 +350,7 @@
 * Term Mode::              Special Emacs commands used in Term mode.
 * Paging in Term::         Paging in the terminal emulator.
 * Remote Host::            Connecting to another computer.
+* Serial Terminal::        Connecting to a serial port.
 @end menu
 
 @node Single Shell
@@ -1076,7 +1077,10 @@
 appearance of the window matches what it would be on a real terminal.
 You can actually run Emacs inside an Emacs Term window.
 
-   The file name used to load the subshell is determined the same way
+  You can use Term mode to communicate with a device connected to a
+serial port of your computer, see @ref{Serial Terminal}.
+
+  The file name used to load the subshell is determined the same way
 as for Shell mode.  To make multiple terminal emulators, rename the
 buffer @samp{*terminal*} to something different using @kbd{M-x
 rename-uniquely}, just as with Shell mode.
@@ -1232,6 +1236,33 @@
 
 @end ignore
 
+@node Serial Terminal
+@subsection Serial Terminal
+@cindex terminal, serial
+@findex serial-term
+
+  If you have a device connected to a serial port of your computer,
+you can use Emacs to communicate with it.  @kbd{M-x serial-term} will
+ask you for a serial port name and speed and will then open a new
+window in @ref{Term Mode}.
+
+  The speed of the serial port is measured in bits per second.  The
+most common speed is 9600 bits per second.  You can change the speed
+interactively by clicking on the mode line.
+
+  A serial port can be configured even more by clicking on ``8N1'' in
+the mode line.  By default, a serial port is configured as ``8N1'',
+which means that each byte consists of 8 data bits, No parity check
+bit, and 1 stopbit.
+
+  When you have opened the serial port connection, you will see output
+from the device in the window.  Also, what you type in the window is
+sent to the device.
+
+  If the speed or the configuration is wrong, you cannot communicate
+with your device and will probably only see garbage output in the
+window.
+
 @node Emacs Server, Printing, Shell, Top
 @section Using Emacs as a Server
 @pindex emacsclient