LinuxHam - User contributions [en]

Debian

2019-08-03T22:29:30Z

Irl: Created page with "The Debian Hamradio Team packages libax25, ax25-apps and ax25-tools for Debian. == Kernel Support == libax25 relies on in-kernel support for hamradio protocols. This require..."

The Debian Hamradio Team packages libax25, ax25-apps and ax25-tools for Debian.

== Kernel Support ==

libax25 relies on in-kernel support for hamradio protocols. This requires the following config options:

CONFIG_HAMRADIO=y
CONFIG_AX25=m
CONFIG_NETROM=m
CONFIG_ROSE=m

Support for this in Debian looks like (based on the presence of the above options in the architecture specific configuration file in the latest source package):

{|
! Architecture
! HAMRADIO
! AX25
! NETROM
! ROSE
! Bug(s)
|-
| alpha
| y
| y
| y
| y
|
|-
| amd64
| y
| y
| y
| y
|
|- style="background-color: red;"
| arm64
| n
| n
| n
| n
| #920651
|-
| armel (marvell)
| y
| y
| y
| y
|
|- style="background-color: red;"
| armel (rpi)
| n
| n
| n
| n
|
|- style="background-color: red;"
| armhf
| n
| n
| n
| n
|
|- style="background-color: red;"
| hppa
| n
| n
| n
| n
|
|- style="background-color: red;"
| i386
| n
| n
| n
| n
|
|- style="background-color: red;"
| ia64
| y
| n
| n
| n
|
|- style="background-color: red;"
| m68k
| n
| n
| n
| n
|
|- style="background-color: red;"
| powerpc
| n
| n
| n
| n
|
|- style="background-color: red;"
| riscv64
| n
| n
| n
| n
|
|- style="background-color: red;"
| s390x
| n
| n
| n
| n
|
|}

This is not all the architectures that kernels are built for, but it's pretty clear from this table that there's no point building libax25 on a whole bunch of architectures because the kernel support was never there. In particular, people have complained about it not working on the Pi. Maybe we can make life easier for Pi users by just enabling this.

BBS, Mail and Telnet

2015-03-26T16:18:19Z

Irl: fix link

== List of BBS Software ==

* [[DPTNT Terminal and DPBOX BBS]] - a suite of programs that provide BBS and Terminal programs for Linux
* [[LBBS - Linux BBS message gateway]] - a BBS package that works with the native AX.25 kernel code or with the Wampes package
* [[N0ARY Packet BBS]] - a packet BBS
* [[Packet Cluster Node Software]] - a PacketCluster like system running on Linux

== List of Node Software ==

* [[node]]
* [[JNOS]]
* [[NOS]]
* [[TNOS]] - a NOS derivative available for both DOS and Linux
* [[URONode]]

== List of Tools ==

This is a list of tools that are useful for dealing with BBS, mail and telnet using AX.25:

* [[7Plus]] - Uuencode-like file coder for BBS Send and Forward of binary files
* [[MBL/RLI message to NNTP and email converter]] - a tool to convert incoming MBL/RLI messages into either NNTP or RFC-822 formatted mail messages

[[Category:Packet Radio]]
[[Category:AX.25]]

APRS

2015-03-26T16:13:30Z

Irl: Added some info about APRS and links to useful websites

'''APRS''' (Automatic Position Reporting System) is an automated system for reporting the position of a system based on [[GPS]] and the [[AX.25]] protocol. It was developped by Bob Bruninga, [http://www.qrz.com/wb4apr WB4APR].

The [http://www.aprs.org/doc/APRS101.PDF APRS protocol specification] gives a good starting point for describing APRS: "Fundamentally, APRS is a packet communications protocol for disseminating live data to everyone on a network in real time. Its most visual feature is the combination of packet radio with the Global Positioning System (GPS) satellite network, enabling radio amateurs to automatically display the positions of radio stations and other objects on maps on a PC. Other features not directly related to position reporting are supported, such as weather station reporting, direction finding and messaging."

APRS is a good data mode to get started with as it has a very low barrier to entry. You can begin with just some software on your PC, a VHF handheld and two audio cables between them. APRS infrastructure on VHF is common in most areas and so unlike voice communication, you're likely to be able to find a station to send your packets to and confirm your station is working. At first it can seem that APRS is incredibly simple, but later you'll discover it also has a lot of features that make it incredibly powerful as a mode to operate, or as a mode to compliment other modes.

== Client Software ==
[[Xastir]] http://www.xastir.org

== Digipeater Software ==
[[Digi_Ned]] http://diginet.pe1mew.nl

[[javAPRSSrvr]] http://www.aprs-is.net/javaprssrvr/

== I-Gate Software ==
[[Xastir]] http://www.xastir.org

[[javAPRSSrvr]] http://www.aprs-is.net/javaprssrvr/

== APRS-IS Server Software ==
[[javAPRSSrvr]] http://www.aprs-is.net/javaprssrvr/

== External Links ==

=== Official Websites ===

* [http://www.aprs.org/ APRS Home Page] by Bob Bruninga WB4APR
* [http://aprs-is.net/ APRS-IS Home Page] by Peter Loveall AE5PL
* [http://info.aprs.net The APRS Wiki]

=== Group and Network Websites ===

* [http://robust-packet.net/ Robust Packet Network] (APRS and other packet on HF)
* [https://kypn.wordpress.com/ Kentucky Packet Network]

=== Other Websites ===

* [http://wa8lmf.net/aprs/index.htm WA8LMF's APRS Pages]
* [http://www.george-smart.co.uk/wiki/APRS M1GEO's APRS Pages]
* [http://www.g4ilo.com/aprs.html G4ILO's APRS Pages]

=== Mailing Lists ===

* [http://www.tapr.org/mailman/listinfo/aprssig TAPR APRS Mailing List]

Packet Radio

2015-03-26T16:03:48Z

Irl:

BBS, Mail and Telnet

2015-03-26T16:02:29Z

Irl: Created page with " == List of BBS Software == * DPTNT Terminal and DPBOX BBS - a suite of programs that provide BBS and Terminal programs for Linux * LBBS - Linux BBS message gateway -..."

== List of BBS Software ==

* [[DPTNT Terminal and DPBOX BBS - a suite of programs that provide BBS and Terminal programs for Linux]]
* [[LBBS - Linux BBS message gateway]] - a BBS package that works with the native AX.25 kernel code or with the Wampes package
* [[N0ARY Packet BBS]] - a packet BBS
* [[Packet Cluster Node Software]] - a PacketCluster like system running on Linux

== List of Node Software ==

* [[node]]
* [[JNOS]]
* [[NOS]]
* [[TNOS]] - a NOS derivative available for both DOS and Linux
* [[URONode]]

== List of Tools ==

This is a list of tools that are useful for dealing with BBS, mail and telnet using AX.25:

* [[7Plus]] - Uuencode-like file coder for BBS Send and Forward of binary files
* [[MBL/RLI message to NNTP and email converter]] - a tool to convert incoming MBL/RLI messages into either NNTP or RFC-822 formatted mail messages

[[Category:Packet Radio]]
[[Category:AX.25]]

Packet Radio

2015-03-26T15:55:38Z

Irl: /* Common AX.25 Applications */

The term '''packet radio''' is generally used to mean the same as [[AX.25]], although other packet based protocols may also be used. Applications may use AX.25 frames directly, or they may encapsulate their traffic in [[TCP/IP]]. For quite a while now regular distributions of the open source Linux operating system have included AX.25 networking support in the kernel.

A comprehensive guide for using AX.25 with Linux is available as part of [http://www.tldp.org/ The Linux Documentation Project]: [http://www.tldp.org/HOWTO/AX25-HOWTO/ Linux Amateur Radio AX.25 HOWTO V2.0] (although this does contain outdated information, last updated 2001-09-19) and a German translation of this guide (V1.6-2, last updated 1999-07-08) is available [http://www.linuxhaven.de/dlhp/HOWTO/DE-AX25-HOWTO.html here].

The essential tools you need for configuring AX.25 on linux can be found in [[ax25-tools]] and a set of useful applications can be found in [[ax25-apps]]. If you would like to develop applications using AX.25 on Linux, [[libax25]] provides a set of useful functions to make this easier.

== Common AX.25 Applications ==

* [[APRS]]
* [[Chat (AX.25)|Chat]]
* [[BBS, Mail and Telnet]]
* [[TCP/IP over AX.25]]
* [[AX.25 Tools|Tools]]

== Related Pages and Links ==

''Note: This needs to be organised.''

Here's a list of packet-related Linux sites and software packages:

* [http://www.swiss-artg.ch/xnet/ (X)Net-Software] german site
* [http://www.nordlink.org/thenetnode/tnn.htm TheNetNode-Software] german site
* [[monax25]]
* [[splitscreen]]
* [[talk-ax25]]
* [[7Plus]]
* [[TNOS]]
* [[N0ARY Packet BBS]]
* [[LBBS - Linux BBS message gateway]]
* [[MBL/RLI message to NNTP and email converter]]
* [[BBSGATE]] - RFC 822 compatible ampr smtp/nntp Gateway <-> BBS
* [[Packet Cluster Node Software]]
* [[Single Floppy disk AX.25 router]]
* [[DPTNT Terminal and DPBOX BBS]]
* [[IPIP encapsulation daemon]]
* [[AXIP encapsulation daemon]]
* [[Ping-Pong Convers Server software]]
* [[RSPF Daemon]]
* [[Michael Westfall's ttylink Daemon]]
* [[Craig Small's ttylink Daemon]]

== See also ==
* http://radio.linux.org.au/ Hamsoft Database, a vast directory of amateur radio software of all kinds for Linux.

[[Category:Packet Radio]]
[[Category:AX.25]]
[[Category:Portal]]

AX.25 Tools

2015-03-26T15:54:11Z

Irl:

''This page lists a series of tools available for AX.25 on Linux. For the software package, see [[ax25-tools]].''

In the categories below are a series of tools for working with [[AX.25]] on Linux.

== Configuration Tools ==

* [[ax25-tools]] - essential tools for configuring AX.25 on Linux

== Diagnostic Tools ==

* [[monax25]] - provides a number of utilities for collecting statistics on AX.25 channel usage

== Infrastructure Tools ==

* [[AXIP encapsulation daemon]] - encapsulates AX.25 packets in IPv4 allowing transmission over the Internet
* [[IPIP encapsulation daemon]] - encapsulates IPv4 packets in IPv4 allowing transmission over the Internet
* [[RSPF Daemon]] - Radio Shortest Path First routing daemon for Linux
* [[Single Floppy disk AX.25 router]] - a single floppy disk to allow a PC to act as an AX.25/IP router

[[Category:AX.25]]
[[Category:Packet Radio]]

Chat (AX.25)

2015-03-26T15:49:58Z

Irl: /* List of Software */ - missed another one

AX.25 can be used to encapsulate chat messages to other AX.25 users. Chat functions may also be built into [[Telnet (AX.25)|telnet]] applications or [[Bulletin Board System|bulletin board systems]].

== List of Software ==

Below is a list of software that can be used for this purpose:

* [[splitscreen]] - a UNIX implementation of the NOS ttylink command
* [[talk-ax25]] - a modifed version of the conventional Berkeley `talk' program to support Linux AX.25 operation
* [[Craig Small's ttylink Daemon]] - a daemon to accept a ttylink TCP connection and convert it into a talk request
* [[Michael Westfall's ttylink Daemon]] - a split screen terminal that listens for incoming ttylink connection requests
* [[Ping-Pong Convers Server software]] - convers server that allows multiple users to simultaneously chat with each other

[[Category:AX.25]]
[[Category:Packet Radio]]

Chat (AX.25)

2015-03-26T15:47:16Z

Irl: missed a software package

Chat (AX.25)

2015-03-26T15:45:25Z

Irl: Created page with "AX.25 can be used to encapsulate chat messages to other AX.25 users. Chat functions may also be built into telnet applications or Bulletin Board System|bu..."

AX.25 Tools

2015-03-26T15:36:25Z

Irl: Created page with " ''This page lists a series of tools available for AX.25 on Linux. For the software package, see ax25-tools.'' In the categories below are a series of tools for working w..."

Packet Radio

2015-03-26T15:27:45Z

Irl: Wiki formatting, adding categories, organising out some of the links

The term '''packet radio''' is generally used to mean the same as [[AX.25]], although other packet based protocols may also be used. Applications may use AX.25 frames directly, or they may encapsulate their traffic in [[TCP/IP]]. For quite a while now regular distributions of the open source Linux operating system have included AX.25 networking support in the kernel.

A comprehensive guide for using AX.25 with Linux is available as part of [http://www.tldp.org/ The Linux Documentation Project]: [http://www.tldp.org/HOWTO/AX25-HOWTO/ Linux Amateur Radio AX.25 HOWTO V2.0] (although this does contain outdated information, last updated 2001-09-19) and a German translation of this guide (V1.6-2, last updated 1999-07-08) is available [http://www.linuxhaven.de/dlhp/HOWTO/DE-AX25-HOWTO.html here].

The essential tools you need for configuring AX.25 on linux can be found in [[ax25-tools]] and a set of useful applications can be found in [[ax25-apps]]. If you would like to develop applications using AX.25 on Linux, [[libax25]] provides a set of useful functions to make this easier.

== Common AX.25 Applications ==

* [[APRS]]
* [[Chat (AX.25)|Chat]]
* [[Bulletin Board System]]
* [[Mail (AX.25)|Mail]]
* [[Telnet (AX.25)|Telnet]]
* [[TCP/IP over AX.25]]
* [[AX.25 Tools|Tools]]

== Related Pages and Links ==

''Note: This needs to be organised.''

Here's a list of packet-related Linux sites and software packages:

* [http://www.swiss-artg.ch/xnet/ (X)Net-Software] german site
* [http://www.nordlink.org/thenetnode/tnn.htm TheNetNode-Software] german site
* [[monax25]]
* [[splitscreen]]
* [[talk-ax25]]
* [[7Plus]]
* [[TNOS]]
* [[N0ARY Packet BBS]]
* [[LBBS - Linux BBS message gateway]]
* [[MBL/RLI message to NNTP and email converter]]
* [[BBSGATE]] - RFC 822 compatible ampr smtp/nntp Gateway <-> BBS
* [[Packet Cluster Node Software]]
* [[Single Floppy disk AX.25 router]]
* [[DPTNT Terminal and DPBOX BBS]]
* [[IPIP encapsulation daemon]]
* [[AXIP encapsulation daemon]]
* [[Ping-Pong Convers Server software]]
* [[RSPF Daemon]]
* [[Michael Westfall's ttylink Daemon]]
* [[Craig Small's ttylink Daemon]]

== See also ==
* http://radio.linux.org.au/ Hamsoft Database, a vast directory of amateur radio software of all kinds for Linux.

[[Category:Packet Radio]]
[[Category:AX.25]]
[[Category:Portal]]

Soundmodem (Kernel Driver)

2015-03-26T14:18:38Z

Irl: Add categories

'''This is historic information about the old kernel soundmodem driver. This driver was only available in 2.2 and 2.4 kernels. In mordern kernels, you should use the [[Soundmodem|user-mode version]] or an alternative such as [[Dire Wolf]].'''

Thomas Sailer has built a driver for the kernel that allows you to use your soundcard as a modem. Connect your radio directly to your soundcard to play packet! Thomas recommends at least a 486DX2/66 if you want to use this software as all of the digital signal processing is done by the main CPU.

The driver currently emulates 1200 bps AFSK, 4800 HAPN and 9600 FSK (G3RUH compatible) modem types. The only sound cards currently supported are SoundBlaster and Windows Sound System Compatible models. If you have a sound card of another type, you can try the user-mode soundmodem described later in this document.

The sound cards require some circuitry to help them drive the Push-To-Talk circuitry, and information on this is available from [http://www.baycom.org/~tom/pcf/ptt_circ/ptt.html Thomas's Soundmodem PTT circuit web page]. There are quite a few possible options, they are: detect the sound output from the soundcard, or use output from a parallel port, serial port or MIDI port. Circuit examples for each of these are on Thomas's site.

The Soundmodem driver creates network devices called: sm0, sm1, sm2 etc when it is configured.

''Note: The Soundmodem driver competes for the same resources as the Linux sound driver, so if you wish to use the Soundmodem driver you must ensure that the Linux sound driver is not installed. You can, of course, compile them both as modules and insert and remove them as you wish.''

== Kernel Compile Options ==

<pre>
Amateur Radio support --->
[*] Amateur Radio support
--- Packet Radio protocols
<*> Amateur Radio AX.25 Level 2 protocol
...
AX.25 network device drivers --->
--- AX.25 network device drivers
...
<*> Soundcard modem driver
[?] soundmodem support for Soundblaster and compatible cards
[?] soundmodem support for WSS and Crystal cards
[?] soundmodem support for 1200 baud AFSK modulation
[?] soundmodem support for 2400 baud AFSK modulation (7.3728MHz crystal)
[?] soundmodem support for 2400 baud AFSK modulation (8MHz crystal)
[?] soundmodem support for 2666 baud AFSK modulation
[?] soundmodem support for 4800 baud HAPN-1 modulation
[?] soundmodem support for 4800 baud PSK modulation
[?] soundmodem support for 9600 baud FSK G3RUH modulation
...
</pre>

== Configuring the sound card ==

The Soundmodem driver does not initialize the sound card. The ax25-utils package includes a utility to do this called `setcrystal' that may be used for sound cards based on the Crystal chip set. If you have some other card then you will have to use some other software to initialize it. Its syntax is fairly straightforward:

setcrystal [-w wssio] [-s sbio] [-f synthio] [-i irq] [-d dma] [-c dma2]

So, for example, if you wished to configure a SoundBlaster card at i/o base address 0x388, irq 10 and DMA 1 you would use:

<pre>
# setcrystal -s 0x388 -i 10 -d 1
</pre>

To configure a Window Sound System card at i/o base address 0x534, irq 5, DMA 3 you would use:

<pre>
# setcrystal -w 0x534 -i 5 -d 3
</pre>

The [-f synthio] parameter is the set the synthesizer address, and the [-c dma2] parameter is to set the second DMA channel to allow full duplex operation.

== Configuring the Soundmodem driver ==

When you have configured the soundcard you need to configure the driver telling it where the sound card is located and what sort of modem you wish it to emulate.

The sethdlc utility allows you to configure the driver with these parameters, or, if you have only one soundcard installed you may specify the parameters on the insmod command line when you load the Soundmodem module.

For example, a simple configuration, with one SoundBlaster soundcard configured as described above emulating a 1200 bps modem:

<pre>
# insmod hdlcdrv
# insmod soundmodem mode="sbc:afsk1200" iobase=0x220 irq=5 dma=1
</pre>

This is not really the preferred way to do it. The sethdlc utility works just as easily with one device as with many.

The sethdlc man page has the full details, but a couple of examples will illustrate the most important aspects of this configuration. The following examples assume you have already loaded the Soundmodem modules using:

<pre>
# insmod hdlcdrv
# insmod soundmodem
</pre>

or that you compiled the kernel with the driver inbuilt.

Configure the driver to support the Windows Sound System card we configured above to emulate a G3RUH 9600 compatible modem as device sm0 using a parallel port at 0x378 to key the Push-To-Talk:

<pre>
# sethdlc -p -i sm0 mode wss:fsk9600 io 0x534 irq 5 dma 3 pario 0x378
</pre>

Configure the driver to support the SoundBlaster card we configured above to emulate a 4800 bps HAPN modem as device sm1 using the serial port located at 0x2f8 to key the Push-To-Talk:

<pre>
# sethdlc -p -i sm1 mode sbc:hapn4800 io 0x388 irq 10 dma 1 serio 0x2f8
</pre>

Configure the driver to support the SoundBlaster card we configured above to emulate a 1200 bps AFSK modem as device sm1 using the serial port located at 0x2f8 to key the Push-To-Talk:

<pre>
# sethdlc -p -i sm1 mode sbc:afsk1200 io 0x388 irq 10 dma 1 serio 0x2f8
</pre>

== Configuring the AX.25 channel access parameters ==

The AX.25 channel access parameters are the equivalent of the [[KISS]] ppersist, txdelay and slottime type parameters. You use the sethdlc utility for this as well.

Again the sethdlc man page is the source of the most complete information but another example of two won't hurt:

Configure the sm0 device with TxDelay of 100 mS, SlotTime of 50mS, PPersist of 128 and full duplex:

<pre>
# sethdlc -i sm0 -a txd 100 slot 50 ppersist 128 full
</pre>

Note that the timing values are in milliseconds.

== Setting the audio levels and tuning the driver ==

It is very important that the audio levels be set correctly for any radio based modem to work. This is equally true of the Soundmodem. Thomas has developed some utility programs that make this task easier. They are called smdiag and smmixer.

; smdiag : provides two types of display, either an oscilloscope type display or an eye pattern type display.
: smmixer : allows you to actually adjust the transmit and receive audio levels.

To start the smdiag utility in 'eye' mode for the Soundmodem device sm0 you would use:

<pre>
# smdiag -i sm0 -e
</pre>

To start the smmixer utility for the Soundmodem device sm0 you would use:

<pre>
# smmixer -i sm0
</pre>

== Configuring the Kernel AX.25 to use the Soundmodem ==

The Soundmodem driver creates standard network devices that the AX.25 Kernel code can use. Configuration is much the same as that for a PI or PacketTwin card.

The first step is to configure the device with an AX.25 callsign. The ifconfig utility may be used to perform this.

<pre>
# /sbin/ifconfig sm0 hw ax25 VK2KTJ-15 up
</pre>

will assign the Soundmodem device sm0 the AX.25 callsign VK2KTJ-15. Alternatively you can use the axparms command, but you still need the ifconfig utility to bring the device up:

<pre>
# ifconfig sm0 up
# axparms -setcall sm0 vk2ktj-15
</pre>

The next step is to create an entry in the /etc/ax25/axports file as you would for any other device. The entry in the axports file is associated with the network device you've configured by the callsign you configure. The entry in the axports file that has the callsign that you configured the Soundmodem device with is the one that will be used to refer to it.

You may then treat the new AX.25 device as you would any other. You can configure it for TCP/IP, add it to ax25d and run NET/ROM or ROSE over it as you please.

[[Category:AX.25]]
[[Category:Kernel Driver]]
[[Category:Packet Radio]]

Soundmodem

2015-03-26T14:16:55Z

Irl: Move off the old kernel driver information, add an infobox and categories, wiki formatting

{| style="width: 30em; font-size: 90%; border: 1px solid #aaaaaa; background-color: #f9f9f9; color: black; margin-bottom: 0.5em; margin-left: 1em; padding: 0.2em; float: right; clear: right; text-align:left;"
! style="text-align: center; background-color:#ccccff;" colspan="2" |<big>soundmodem</big>
|-
! Upstream Author
| Thomas Sailer
|-
! Current Version
| 0.19
|-
! Homepage
| http://gna.org/projects/soundmodem
|-
! Mailing List
| [https://mail.gna.org/listinfo/soundmodem-discuss/ Info], [https://mail.gna.org/public/soundmodem-discuss Archives]
|-
! Working State
| Current
|}

''If you are looking for information about the old kernel-mode soundmodem driver, see [[Soundmodem (Kernel Driver)]].

Thomas Sailer has written a sound modem driver that runs in user-mode using the kernel sound drivers, so it should work with any sound card supported under Linux.

The driver is implemented as the user-mode program soundmodem. The graphical soundmodemconfig program allows configuring and testing the soundmodem driver. As well as kernel sound support you need the kernel AX.25 mkiss driver.

== Guides ==

* Detailed instructions and example configurations for Debian: http://www.qbjnet.com/packet.html

== Old Website ==

This project was previously hosted at another location. A mirror of this old location has been preserved at: http://soundmodem.vk4msl.yi.org/ (mirror of http://www.baycom.org/~tom/ham/soundmodem -- which is now gone).

[[Category:Software]]
[[Category:Packet Radio]]
[[Category:AX.25]]

Soundmodem (Kernel Driver)

2015-03-26T14:06:23Z

Irl: Migrate content out of the main soundmodem page

User:Irl

2015-03-26T13:59:45Z

Irl: Created a user page with contact info

Hi! I'm a member of the [http://wiki.debian.org/DebianHams Debian Hamradio Maintainers team]. You can contact me by the following methods:

* Email: [mailto:irl@fsfe.org irl@fsfe.org] (GPG: 0xE9846C49)
* IRC: irl on Freenode, EFnet, OFTC

More more information about me, see http://www.debiain.org/.