^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1) # SPDX-License-Identifier: GPL-2.0-only
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2) #
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 3) # Amateur Radio protocols and AX.25 device configuration
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 4) #
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 5)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 6) menuconfig HAMRADIO
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 7) depends on NET && !S390
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 8) bool "Amateur Radio support"
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 9) help
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 10) If you want to connect your Linux box to an amateur radio, answer Y
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 11) here. You want to read <https://www.tapr.org/>
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 12) and more specifically about AX.25 on Linux
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 13) <http://www.linux-ax25.org/>.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 14)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 15) Note that the answer to this question won't directly affect the
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 16) kernel: saying N will just cause the configurator to skip all
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 17) the questions about amateur radio.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 18)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 19) comment "Packet Radio protocols"
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 20) depends on HAMRADIO
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 21)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 22) config AX25
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 23) tristate "Amateur Radio AX.25 Level 2 protocol"
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 24) depends on HAMRADIO
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 25) help
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 26) This is the protocol used for computer communication over amateur
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 27) radio. It is either used by itself for point-to-point links, or to
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 28) carry other protocols such as tcp/ip. To use it, you need a device
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 29) that connects your Linux box to your amateur radio. You can either
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 30) use a low speed TNC (a Terminal Node Controller acts as a kind of
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 31) modem connecting your computer's serial port to your radio's
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 32) microphone input and speaker output) supporting the KISS protocol or
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 33) one of the various SCC cards that are supported by the generic Z8530
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 34) or the DMA SCC driver. Another option are the Baycom modem serial
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 35) and parallel port hacks or the sound card modem (supported by their
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 36) own drivers). If you say Y here, you also have to say Y to one of
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 37) those drivers.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 38)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 39) Information about where to get supporting software for Linux amateur
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 40) radio as well as information about how to configure an AX.25 port is
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 41) contained in the AX25-HOWTO, available from
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 42) <https://www.tldp.org/docs.html#howto>. You might also want to
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 43) check out the file <file:Documentation/networking/ax25.rst> in the
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 44) kernel source. More information about digital amateur radio in
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 45) general is on the WWW at
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 46) <https://www.tapr.org/>.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 47)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 48) To compile this driver as a module, choose M here: the
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 49) module will be called ax25.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 50)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 51) config AX25_DAMA_SLAVE
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 52) bool "AX.25 DAMA Slave support"
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 53) default y
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 54) depends on AX25
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 55) help
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 56) DAMA is a mechanism to prevent collisions when doing AX.25
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 57) networking. A DAMA server (called "master") accepts incoming traffic
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 58) from clients (called "slaves") and redistributes it to other slaves.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 59) If you say Y here, your Linux box will act as a DAMA slave; this is
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 60) transparent in that you don't have to do any special DAMA
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 61) configuration. Linux cannot yet act as a DAMA server. This option
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 62) only compiles DAMA slave support into the kernel. It still needs to
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 63) be enabled at runtime. For more about DAMA see
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 64) <http://www.linux-ax25.org>. If unsure, say Y.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 65)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 66) # placeholder until implemented
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 67) config AX25_DAMA_MASTER
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 68) bool 'AX.25 DAMA Master support'
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 69) depends on AX25_DAMA_SLAVE && BROKEN
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 70) help
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 71) DAMA is a mechanism to prevent collisions when doing AX.25
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 72) networking. A DAMA server (called "master") accepts incoming traffic
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 73) from clients (called "slaves") and redistributes it to other slaves.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 74) If you say Y here, your Linux box will act as a DAMA master; this is
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 75) transparent in that you don't have to do any special DAMA
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 76) configuration. Linux cannot yet act as a DAMA server. This option
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 77) only compiles DAMA slave support into the kernel. It still needs to
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 78) be explicitly enabled, so if unsure, say Y.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 79)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 80) config NETROM
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 81) tristate "Amateur Radio NET/ROM protocol"
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 82) depends on AX25
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 83) help
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 84) NET/ROM is a network layer protocol on top of AX.25 useful for
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 85) routing.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 86)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 87) A comprehensive listing of all the software for Linux amateur radio
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 88) users as well as information about how to configure an AX.25 port is
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 89) contained in the Linux Ham Wiki, available from
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 90) <http://www.linux-ax25.org>. You also might want to check out the
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 91) file <file:Documentation/networking/ax25.rst>. More information about
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 92) digital amateur radio in general is on the WWW at
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 93) <https://www.tapr.org/>.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 94)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 95) To compile this driver as a module, choose M here: the
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 96) module will be called netrom.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 97)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 98) config ROSE
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 99) tristate "Amateur Radio X.25 PLP (Rose)"
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 100) depends on AX25
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 101) help
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 102) The Packet Layer Protocol (PLP) is a way to route packets over X.25
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 103) connections in general and amateur radio AX.25 connections in
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 104) particular, essentially an alternative to NET/ROM.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 105)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 106) A comprehensive listing of all the software for Linux amateur radio
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 107) users as well as information about how to configure an AX.25 port is
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 108) contained in the Linux Ham Wiki, available from
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 109) <http://www.linux-ax25.org>. You also might want to check out the
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 110) file <file:Documentation/networking/ax25.rst>. More information about
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 111) digital amateur radio in general is on the WWW at
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 112) <https://www.tapr.org/>.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 113)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 114) To compile this driver as a module, choose M here: the
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 115) module will be called rose.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 116)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 117) menu "AX.25 network device drivers"
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 118) depends on HAMRADIO && AX25
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 119)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 120) source "drivers/net/hamradio/Kconfig"
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 121)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 122) endmenu