~ [ source navigation ] ~ [ diff markup ] ~ [ identifier search ] ~ [ freetext search ] ~ [ file search ] ~

Linux Cross Reference
Linux/Documentation/networking/soundmodem.txt

Version: ~ [ 2.4.0 ] ~
Architecture: ~ [ i386 ] ~ [ alpha ] ~ [ m68k ] ~ [ mips ] ~ [ ppc ] ~ [ sparc ] ~ [ sparc64 ] ~

  1              LINUX DRIVER FOR SOUNDCARDS AS AX.25 MODEMS
  2 
  3        Thomas M. Sailer, HB9JNX/AE4WA, <sailer@ife.ee.ethz.ch>
  4 
  5 This driver allows either SoundBlaster (sbc) or Windows Sound System (wss)
  6 compatible soundcards to be used as either 1200 baud AFSK or 9600 baud FSK
  7 AX.25 packet radio modems. Only half duplex operation is supported; an
  8 attempt to include full duplex support failed because the hardware did
  9 not support it (it appeared that the card only provides one DMA channel,
 10 although the codec chip would support two channels). The driver needs
 11 some processing power! A 66 MHz 486 DX2 is a minimum requirement.  Otherwise
 12 interactive performance of the computer may become sluggish. This driver
 13 does *not* support telephone modem standards, it is intended for radio
 14 use only.
 15 
 16 
 17 The Interface of the driver
 18 
 19 The driver provides kernel network drivers named sm[0-3]. sethdlc 
 20 from the ax25 utilities may be used to set driver states etc. Users
 21 of userland AX.25 stacks may use the net2kiss utility (also available
 22 in the ax25 utilities package) to convert packets of a network interface
 23 to a KISS stream on a pseudo tty. There's also a patch available from
 24 me for WAMPES which allows attaching a kernel network interface directly.
 25 
 26 
 27 Configuring the driver
 28 
 29 Some sound cards need to be initialized before they operate in either
 30 SoundBlaster or WSS compatibility mode. The driver does _NOT_ do this;
 31 you may use the standard linux sound driver to initialize the soundcard;
 32 compile it as a module, and do
 33   insmod sound
 34   rmmod sound
 35 The soundcard should then be initialized correctly. If this does not help,
 36 you'll have to write your own initialization utility.
 37 
 38 Every time the driver is inserted into the kernel, it has to know which
 39 modems it should access at which ports. This can be done with the setbaycom
 40 utility. If you are only using one modem, you can also configure the
 41 driver from the insmod command line (or by means of an option line in
 42 /etc/modules.conf).
 43 
 44 Examples:
 45   insmod soundmodem mode="sbc:afsk1200" iobase=0x220 irq=5 dma=1
 46   sethdlc -i sm0 -p mode "sbc:afsk1200" io 0x220 irq 5 dma 1
 47 
 48 Both lines configure the first port to drive a soundblaster card
 49 in 1200 baud AFSK mode.
 50 
 51 The channel access parameters can be set with sethdlc -a or kissparms.
 52 Note that both utilities interpret the values slightly different.
 53 
 54 
 55 Input and output levels
 56 
 57 It is important that the input and output levels are adjusted properly.
 58 There are two utilities, available in the ax25 utilities distribution,
 59 to facilitate this: smmixer and smdiag. smdiag allows you to display
 60 the input signal in an oscilloscope like display or an eye diagram.
 61 smmixer allows you to adjust input/output levels. See the respective
 62 man pages.
 63 
 64 
 65 Transmitter keying
 66 
 67 Since soundcards do not have a DC coupled output; PTT keying options include
 68 the following:
 69 * VOX circuitry
 70 * Serial port pin
 71 * Parallel port pin
 72 * MPU401 MIDI output via a retriggerable monoflop.
 73 Circuit schematics may be found at
 74 http://www.ife.ee.ethz.ch/~sailer/pcf/ptt_circ/ptt.html.
 75 
 76 
 77 Compatibility with the rest of the Linux kernel
 78 
 79 The sound driver and the soundcard modem driver compete for the same
 80 hardware resources. Of course only one driver can access a given
 81 interface at a time. Worse yet, the sound driver grabs the soundcard
 82 at startup time. Therefore the soundcard modem driver subsequently won't
 83 be able to access the soundcard. You might therefore find it necessary to
 84 unload the sound driver before using the soundcard modem driver.
 85 
 86 
 87 
 88 vy 73s de
 89 Tom Sailer, sailer@ife.ee.ethz.ch
 90 hb9jnx @ hb9w.ampr.org

~ [ source navigation ] ~ [ diff markup ] ~ [ identifier search ] ~ [ freetext search ] ~ [ file search ] ~

This page was automatically generated by the LXR engine.
Visit the LXR main site for more information.