1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
|
.\" $OpenBSD: strip.4,v 1.11 2001/03/06 19:56:50 brad Exp $
.\"
.\" Copyright 1996 The Board of Trustees of The Leland Stanford
.\" Junior University. All Rights Reserved.
.\"
.\" Author: Jonathan Stone
.\"
.\" Permission to use, copy, modify, and distribute this
.\" software and its documentation for any purpose and without
.\" fee is hereby granted, provided that the above copyright
.\" notice and the above authorship notice appear in all copies.
.\" Stanford University makes no representations about the suitability
.\" of this software for any purpose. It is provided "as is" without
.\" express or implied warranty.
.Dd March 10, 1996
.Dt STRIP 4
.Os
.Sh NAME
.Nm strip
.\" Why doesn't this work right? mdoc(7) nor mdoc.samples(7) lists
.\" .Nd, except for a passing reference in the latter.
.Nd packet-mode network device driver for the Metricom Ricochet radio
.Sh SYNOPSIS
.\" want to write
.\" .Sy pseudo-device
.\" .Nm tun
.\" .Op Ar count
.\" so that .Nm is just "tun", but if we do that we get a line break
.\" after "pseudo-device", ick.
.Nm pseudo-device strip
.Op Ar count
.Sh DESCRIPTION
Configures
.Ar count
.Nm
interfaces, named
.Sy st Ns Ar 0 ,
.Sy st Ns Ar 1 ,
etc, into a kernel built from a config file containing the
given entry.
.Pp
Each
.Nm
interface is a pseudo-device driver for the Metricom Ricochet radio,
operating in peer-to-peer packet mode.
.Pp
The STRIP driver takes outbound network packets, encapsulates them using the
Metricom "starmode" framing, and sends the packets out an RS-232
interface to a Metricom
.Em Ricochet
radio. Packets arriving from the radio
via the serial link are decapsulated and then passed up to the local
host's networking stack.
.Pp
.Nm
is an acronym for
.Sy St Ns armode
.Sy R Ns adio
.Sy IP.
.Pp
In many ways,
the
.Nm
driver is very much like the
.Nm sl
SLIP pseudo-device driver. A
.Nm
device is attached to a tty line with
.Xr slattach 8 .
Once attached, the interface is configured via
.Xr ifconfig 8 .
The major difference between the
.Xr sl 4
SLIP pseudo-device driver and the
.Nm
driver is that SLIP works only between two hosts over
a dedicated point-to-point connection. In contrast,
.Nm
sends
packets to a frequency-hopping radio, which can address packets to
any peer Metricom radio. rather than just to a single host at the
other end of a point-to-point line. Thus, one
.Nm
pseudo-device is usually sufficient for any kernel.
.Pp
In other respects, a
.Nm
interface is rather like an Ethernet interface.
Packets are individually addressed, and subsequent packets can
be sent independently to different MAC addresses. However,
the "Star-mode" framing and MAC addressing are not in any way
compatible with Ethernet. Broadcast or multicast to more than one radio is not
possible, due to the independent frequency-hopping operation of the radios.
The interface flags
.Dv IFF_POINTOPOINT
and
.Dv IFF_BROADCAST
are not supported on
.Nm
interface.
.Pp
In other words,
.Nm
implements a multiple-access, non-broadcast device, accessed via
an RS-232 serial line, using a proprietary packet framing scheme.
.Pp
This version
.Nm
driver maps IP addresses to Metricom radio addresses using
statically configured entries in the normal routing table. These entries
map IP addresses of peer radios to the MAC-level addresses.
The exact syntax of this mapping and an example are discussed below.
The Internet Assigned Numbers Authority (IANA) has allocated an ARP
type code for use with STRIP. A future version of this driver will
support
.Xr arp 4
to obtain the IP address of reachable peer radios dynamically.
.Sh ADDRESS CONFIGURATION
This version of the STRIP driver requires static pre-configuration of
the mapping from IP addresses to radio MAC addresses.
The
.Xr route 8
command should be used to bind a peer STRIP host's radio IP address
to the peer's link-level radio address. Radio addresses are encoded
using the hex equivalent of the radio's decimal ASCII address.
For example, the following route command will
configure a routing entry to a radio with a MAC address of 1234-5678,
and an IP address 10.11.12.13:
.Pp
.br
.in 10
route add -host 10.11.12.13 -link 1:2:3:4:5:6:7:8
.br
.in 5
.Pp
Generalising from this example to other IP addresses and to other 8-digit MAC addresses
should be clear.
.Sh RADIO CONFIGURATION
The Metricom radios can auto-baud at speeds up to 38.4k baud.
At higher speeds -- 57600 or 115200 -- the radio cannot autobaud.
When running at high speeds, the radio's serial port should be
manually configured to permanently run at the desired speed.
Use a terminal emulator and the Hayes command
.Em ATS304=115200
to set the serial baudrate to the specified number (or 0 for autobaud). The command
.Em AT&w
will then save the current radio state in non-volatile memory.
.Pp
Metricom radios can operate in either "modem-emulation" mode
or in packet mode (Starmode). The
.Nm
driver automatically detects if the radio has fallen out of starmode,
and resets it back into starmode, if the baud rate was set correctly
by
.Xr slattach 8 .
.Pp
.\" Why isn't .Ss documented in mdoc(7) and mdoc.samples(7)?
.\" .Sh DIAGNOSTICS
.Sh SEE ALSO
.Xr arp 4 ,
.Xr inet 4 ,
.Xr route 8 ,
.Xr slattach 8 ,
.Xr slip 8
.Sh BUGS
Currently is IP-only. Encapsulations for AppleTalk and ARP have been defined,
but are not yet implemented in this driver.
.Pp
.Nm
has not been widely tested on a variety of lower-level tty drivers.
.P
The detection and resetting of radios that crash out of Starmode does
not always work in this version of the driver. One workaround
is to kill the
.Xr slattach
process, ifconfig the
.Nm
interface down, and then start a new slattach and rerun ifconfig.
.Sh HISTORY
.Nm
was originally developed for the Linux kernel by Stuart
Cheshire of Stanford's Operating Systems and Networking group,
as part of Mary Baker's MosquitoNet
.Sy http://mosquitonet.stanford.edu/mosquitonet.html
project.
This
.Nm
driver was ported to BSD by Jonathan Stone at Stanford's Distributed
Systems Group and first distributed with
.Nx 1.2 .
|
