(no commit message)
authorIvailo <Ivailo@web>
Mon, 10 Jan 2011 10:52:22 +0000 (02:52 -0800)
committerCharlie <root@leaf.dragonflybsd.org>
Mon, 10 Jan 2011 10:52:22 +0000 (02:52 -0800)
docs/docs/newhandbook/serial_communications/index.mdwn

index ecb6ae1..7c11151 100644 (file)
@@ -1102,7 +1102,6 @@ and the modem has not accepted a call yet, this means that `getty` has completed
 If you do not see any `getty` processes waiting to open the desired `ttyd`***N****** port, double-check your entries in `/etc/ttys` to see if there are any mistakes there. Also, check the log file `/var/log/messages` to see if there are any log messages from `init` or `getty` regarding any problems. If there are any messages, triple-check the configuration files `/etc/ttys` and `/etc/gettytab`, as well as the appropriate device special files `/dev/ttydN`, for any mistakes, missing entries, or missing device special files.
 
 
-
 #### 18.3.6.2 Try Dialing In 
 
 
@@ -1110,23 +1109,343 @@ If you do not see any `getty` processes waiting to open the desired `ttyd`***N**
 Try dialing into the system; be sure to use 8 bits, no parity, and 1 stop bit on the remote system. If you do not get a prompt right away, or get garbage, try pressing Enter about once per second. If you still do not see a login: prompt after a while, try sending a `BREAK`. If you are using a high-speed modem to do the dialing, try dialing again after locking the dialing modem's interface speed (via `AT&amp;B1` on a U.S. Robotics Sportster modem, for example).
 
 
-If you still cannot get a login: prompt, check `/etc/gettytab` again and double-check that
+If you dial but the modem on the DragonFly system will not answer, make sure that the modem is configured to answer the phone when DTR is asserted. If the modem seems to be configured correctly, verify that the DTR line is asserted by checking the modem's indicator lights (if it has any).
+
+
 
+If you have gone over everything several times and it still does not work, take a break and come back to it later. If it still does not work, perhaps you can send an electronic mail message to the [DragonFly User related mailing list](http://leaf.dragonflybsd.org/mailarchive/) describing your modem and your problem, and the good folks on the list will try to help.
 
+***
+## 18.4 Dial-out Service 
 
-* The initial capability name specified in `/etc/ttys` for the line matches a name of a capability in `/etc/gettytab`
 
 
-* Each `nx=` entry matches another `gettytab` capability name
+The following are tips for getting your host to be able to connect over the modem to another computer. This is appropriate for establishing a terminal session with a remote host.
 
 
-* Each `tc=` entry matches another `gettytab` capability name
 
+This is useful to log onto a BBS.
 
-If you dial but the modem on the DragonFly system will not answer, make sure that the modem is configured to answer the phone when DTR is asserted. If the modem seems to be configured correctly, verify that the DTR line is asserted by checking the modem's indicator lights (if it has any).
 
 
+This kind of connection can be extremely helpful to get a file on the Internet if you have problems with PPP. If you need to FTP something and PPP is broken, use the terminal session to FTP it. Then use zmodem to transfer it to your machine.
+
+
+
+### 18.4.1 My Stock Hayes Modem Is Not Supported, What Can I Do? 
+
+
+
+Actually, the manual page for `tip` is out of date. There is a generic Hayes dialer already built in. Just use `at=hayes` in your `/etc/remote` file.
+
+
+
+The Hayes driver is not smart enough to recognize some of the advanced features of newer modems--messages like `BUSY`, `NO DIALTONE`, or `CONNECT 115200` will just confuse it. You should turn those messages off when you use `tip` (using `ATX0&amp;W`).
+
+
+
+Also, the dial timeout for `tip` is 60 seconds. Your modem should use something less, or else tip will think there is a communication problem. Try `ATS7=45&amp;W`.
+
+
+
+ **Note:** As shipped, `tip` does not yet support Hayes modems fully. The solution is to edit the file `tipconf.h` in the directory `/usr/src/usr.bin/tip/tip`. Obviously you need the source distribution to do this.
+
+
+
+Edit the line `#define HAYES 0` to `#define HAYES 1`. Then `make` and `make install`. Everything works nicely after that.
+
+
+
+### 18.4.2 How Am I Expected to Enter These AT Commands? 
+
+
+
+Make what is called a ***direct*** entry in your `/etc/remote` file. For example, if your modem is hooked up to the first serial port, `/dev/cuaa0`, then put in the following line:
+
+
+
+    
+
+    cuaa0:dv#/dev/cuaa0:br#19200:panone
+
+
+
+
+
+Use the highest bps rate your modem supports in the br capability. Then, type `tip cuaa0` and you will be connected to your modem.
+
+
+
+If there is no `/dev/cuaa0` on your system, do this:
+
+
+
+    
+
+    # cd /dev
+
+    # sh MAKEDEV cuaa0
+
+
+
+
+
+Or use `cu` as `root` with the following command:
+
+
+
+    
+
+    # cu -l`***line***` -s`***speed***`
+
+
+
+
+
+`***line***` is the serial port (e.g.`/dev/cuaa0`) and `***speed***` is the speed (e.g.`57600`). When you are done entering the AT commands hit  **~.**  to exit.
+
+
+
+### 18.4.3 The `@` Sign for the pn Capability Does Not Work! 
+
+
+
+The `@` sign in the phone number capability tells tip to look in `/etc/phones` for a phone number. But the `@` sign is also a special character in capability files like `/etc/remote`. Escape it with a backslash:
+
+
+
+    
+
+    pn=\@
+
+
+
+
+
+### 18.4.4 How Can I Dial a Phone Number on the Command Line? 
+
+
+
+Put what is called a ***generic*** entry in your `/etc/remote` file. For example:
+
+
+
+    
+
+    tip115200|Dial any phone number at 115200 bps:\
+
+            :dv#/dev/cuaa0:br#115200:athayes:pa=none:du:
+
+    tip57600|Dial any phone number at 57600 bps:\
+
+            :dv#/dev/cuaa0:br#57600:athayes:pa=none:du:
+
+
+
+
+
+Then you can do things like:
+
+
+
+    
+
+    # tip -115200 5551234
+
+
+
+
+
+If you prefer `cu` over `tip`, use a generic `cu` entry:
+
+
+
+    
+
+    cu115200|Use cu to dial any number at 115200bps:\
+
+            :dv#/dev/cuaa1:br#57600:athayes:pa=none:du:
+
+
+
+
+
+and type:
+
+
+
+    
+
+    # cu 5551234 -s 115200
+
 
-If you have gone over everything several times and it still does not work, take a break and come back to it later. If it still does not work, perhaps you can send an electronic mail message to the [DragonFly User related mailing list](http://leaf.dragonflybsd.org/mailarchive/) describing your modem and your problem, and the good folks on the list will try to help.
+
+
+
+### 18.4.5 Do I Have to Type in the bps Rate Every Time I Do That? 
+
+
+
+Put in an entry for `tip1200` or `cu1200`, but go ahead and use whatever bps rate is appropriate with the br capability. `tip` thinks a good default is 1200 bps which is why it looks for a `tip1200` entry. You do not have to use 1200 bps, though.
+
+
+
+### 18.4.6 I Access a Number of Hosts Through a Terminal Server 
+
+
+
+Rather than waiting until you are connected and typing `CONNECT &lt;host&gt;` each time, use tip's `cm` capability. For example, these entries in `/etc/remote`:
+
+
+
+    
+
+    pain|pain.deep13.com|Forrester's machine:\
+
+            :cm#CONNECT pain\n:tcdeep13:
+
+    muffin|muffin.deep13.com|Frank's machine:\
+
+            :cm#CONNECT muffin\n:tcdeep13:
+
+    deep13:Gizmonics Institute terminal server:\
+
+            :dv#/dev/cuaa2:br#38400:athayes:du:pa=none:pn=5551234:
+
+
+
+
+
+will let you type `tip pain` or `tip muffin` to connect to the hosts pain or muffin, and `tip deep13` to get to the terminal server.
+
+
+
+### 18.4.7 Can Tip Try More Than One Line for Each Site? 
+
+
+
+This is often a problem where a university has several modem lines and several thousand students trying to use them.
+
+
+
+Make an entry for your university in `/etc/remote` and use `@` for the `pn` capability:
+
+
+
+    
+
+    big-university:\
+
+            :pn#\@:tcdialout
+
+    dialout:\
+
+            :dv#/dev/cuaa3:br#9600:atcourier:du:pa=none:
+
+
+
+
+
+Then, list the phone numbers for the university in `/etc/phones`:
+
+
+
+    
+
+    big-university 5551111
+
+    big-university 5551112
+
+    big-university 5551113
+
+    big-university 5551114
+
+
+
+
+
+`tip` will try each one in the listed order, then give up. If you want to keep retrying, run `tip` in a while loop.
+
+
+
+### 18.4.8 Why Do I Have to Hit  **Ctrl** + **P**  Twice to Send  **Ctrl** + **P**  Once? 
+
+
+
+ **Ctrl** + **P**  is the default ***force*** character, used to tell `tip` that the next character is literal data. You can set the force character to any other character with the `~s` escape, which means ***set a variable.***
+
+
+
+Type `~sforce=`***single-char****** followed by a newline. `***single-char***` is any single character. If you leave out `***single-char***`, then the force character is the nul character, which you can get by typing  **Ctrl** + **2**  or  **Ctrl** + **Space** . A pretty good value for `***single-char***` is  **Shift** + **Ctrl** + **6** , which is only used on some terminal servers.
+
+
+
+You can have the force character be whatever you want by specifying the following in your `$HOME/.tiprc` file:
+
+
+
+    
+
+    force=&lt;single-char&gt;
+
+
+
+
+
+### 18.4.9 Suddenly Everything I Type Is in Upper Case?? 
+
+
+
+You must have pressed  **Ctrl** + **A** , `tip`'s ***raise character,*** specially designed for people with broken caps-lock keys. Use `~s` as above and set the variable `raisechar` to something reasonable. In fact, you can set it to the same as the force character, if you never expect to use either of these features.
+
+
+
+Here is a sample .tiprc file perfect for  **Emacs**  users who need to type  **Ctrl** + **2**  and  **Ctrl** + **A**  a lot:
+
+
+
+    
+
+    force=^^
+
+    raisechar=^^
+
+
+
+
+
+The ^^ is  **Shift** + **Ctrl** + **6** .
+
+
+
+### 18.4.10 How Can I Do File Transfers with `tip`? 
+
+
+If you are talking to another UNIX® system, you can send and receive files with `~p` (put) and `~t` (take). These commands run `cat` and `echo` on the remote system to accept and send files. The syntax is:
+
+
+
+`~p` local-file [remote-file]
+
+
+
+`~t` remote-file [local-file]
+
+
+
+There is no error checking, so you probably should use another protocol, like zmodem.
+
+
+
+### 18.4.11 How Can I Run zmodem with `tip`? 
+
+
+
+To receive files, start the sending program on the remote end. Then, type `~C rz` to begin receiving them locally.
+
+
+
+To send files, start the receiving program on the remote end. Then, type `~C sz `***files****** to send them to the remote system.
 
 ***
+