18c2ecf20Sopenharmony_ci.. SPDX-License-Identifier: GPL-2.0
28c2ecf20Sopenharmony_ci
38c2ecf20Sopenharmony_ci================
48c2ecf20Sopenharmony_ciFrame Relay (FR)
58c2ecf20Sopenharmony_ci================
68c2ecf20Sopenharmony_ci
78c2ecf20Sopenharmony_ciFrame Relay (FR) support for linux is built into a two tiered system of device
88c2ecf20Sopenharmony_cidrivers.  The upper layer implements RFC1490 FR specification, and uses the
98c2ecf20Sopenharmony_ciData Link Connection Identifier (DLCI) as its hardware address.  Usually these
108c2ecf20Sopenharmony_ciare assigned by your network supplier, they give you the number/numbers of
118c2ecf20Sopenharmony_cithe Virtual Connections (VC) assigned to you.
128c2ecf20Sopenharmony_ci
138c2ecf20Sopenharmony_ciEach DLCI is a point-to-point link between your machine and a remote one.
148c2ecf20Sopenharmony_ciAs such, a separate device is needed to accommodate the routing.  Within the
158c2ecf20Sopenharmony_cinet-tools archives is 'dlcicfg'.  This program will communicate with the
168c2ecf20Sopenharmony_cibase "DLCI" device, and create new net devices named 'dlci00', 'dlci01'...
178c2ecf20Sopenharmony_ciThe configuration script will ask you how many DLCIs you need, as well as
188c2ecf20Sopenharmony_cihow many DLCIs you want to assign to each Frame Relay Access Device (FRAD).
198c2ecf20Sopenharmony_ci
208c2ecf20Sopenharmony_ciThe DLCI uses a number of function calls to communicate with the FRAD, all
218c2ecf20Sopenharmony_ciof which are stored in the FRAD's private data area.  assoc/deassoc,
228c2ecf20Sopenharmony_ciactivate/deactivate and dlci_config.  The DLCI supplies a receive function
238c2ecf20Sopenharmony_cito the FRAD to accept incoming packets.
248c2ecf20Sopenharmony_ci
258c2ecf20Sopenharmony_ciWith this initial offering, only 1 FRAD driver is available.  With many thanks
268c2ecf20Sopenharmony_cito Sangoma Technologies, David Mandelstam & Gene Kozin, the S502A, S502E &
278c2ecf20Sopenharmony_ciS508 are supported.  This driver is currently set up for only FR, but as
288c2ecf20Sopenharmony_ciSangoma makes more firmware modules available, it can be updated to provide
298c2ecf20Sopenharmony_cithem as well.
308c2ecf20Sopenharmony_ci
318c2ecf20Sopenharmony_ciConfiguration of the FRAD makes use of another net-tools program, 'fradcfg'.
328c2ecf20Sopenharmony_ciThis program makes use of a configuration file (which dlcicfg can also read)
338c2ecf20Sopenharmony_cito specify the types of boards to be configured as FRADs, as well as perform
348c2ecf20Sopenharmony_ciany board specific configuration.  The Sangoma module of fradcfg loads the
358c2ecf20Sopenharmony_ciFR firmware into the card, sets the irq/port/memory information, and provides
368c2ecf20Sopenharmony_cian initial configuration.
378c2ecf20Sopenharmony_ci
388c2ecf20Sopenharmony_ciAdditional FRAD device drivers can be added as hardware is available.
398c2ecf20Sopenharmony_ci
408c2ecf20Sopenharmony_ciAt this time, the dlcicfg and fradcfg programs have not been incorporated into
418c2ecf20Sopenharmony_cithe net-tools distribution.  They can be found at ftp.invlogic.com, in
428c2ecf20Sopenharmony_ci/pub/linux.  Note that with OS/2 FTPD, you end up in /pub by default, so just
438c2ecf20Sopenharmony_ciuse 'cd linux'.  v0.10 is for use on pre-2.0.3 and earlier, v0.15 is for
448c2ecf20Sopenharmony_cipre-2.0.4 and later.
45