18c2ecf20Sopenharmony_ci# SPDX-License-Identifier: GPL-2.0-only 28c2ecf20Sopenharmony_ci# 38c2ecf20Sopenharmony_ci# Amateur Radio protocols and AX.25 device configuration 48c2ecf20Sopenharmony_ci# 58c2ecf20Sopenharmony_ci 68c2ecf20Sopenharmony_cimenuconfig HAMRADIO 78c2ecf20Sopenharmony_ci depends on NET && !S390 88c2ecf20Sopenharmony_ci bool "Amateur Radio support" 98c2ecf20Sopenharmony_ci help 108c2ecf20Sopenharmony_ci If you want to connect your Linux box to an amateur radio, answer Y 118c2ecf20Sopenharmony_ci here. You want to read <https://www.tapr.org/> 128c2ecf20Sopenharmony_ci and more specifically about AX.25 on Linux 138c2ecf20Sopenharmony_ci <http://www.linux-ax25.org/>. 148c2ecf20Sopenharmony_ci 158c2ecf20Sopenharmony_ci Note that the answer to this question won't directly affect the 168c2ecf20Sopenharmony_ci kernel: saying N will just cause the configurator to skip all 178c2ecf20Sopenharmony_ci the questions about amateur radio. 188c2ecf20Sopenharmony_ci 198c2ecf20Sopenharmony_cicomment "Packet Radio protocols" 208c2ecf20Sopenharmony_ci depends on HAMRADIO 218c2ecf20Sopenharmony_ci 228c2ecf20Sopenharmony_ciconfig AX25 238c2ecf20Sopenharmony_ci tristate "Amateur Radio AX.25 Level 2 protocol" 248c2ecf20Sopenharmony_ci depends on HAMRADIO 258c2ecf20Sopenharmony_ci help 268c2ecf20Sopenharmony_ci This is the protocol used for computer communication over amateur 278c2ecf20Sopenharmony_ci radio. It is either used by itself for point-to-point links, or to 288c2ecf20Sopenharmony_ci carry other protocols such as tcp/ip. To use it, you need a device 298c2ecf20Sopenharmony_ci that connects your Linux box to your amateur radio. You can either 308c2ecf20Sopenharmony_ci use a low speed TNC (a Terminal Node Controller acts as a kind of 318c2ecf20Sopenharmony_ci modem connecting your computer's serial port to your radio's 328c2ecf20Sopenharmony_ci microphone input and speaker output) supporting the KISS protocol or 338c2ecf20Sopenharmony_ci one of the various SCC cards that are supported by the generic Z8530 348c2ecf20Sopenharmony_ci or the DMA SCC driver. Another option are the Baycom modem serial 358c2ecf20Sopenharmony_ci and parallel port hacks or the sound card modem (supported by their 368c2ecf20Sopenharmony_ci own drivers). If you say Y here, you also have to say Y to one of 378c2ecf20Sopenharmony_ci those drivers. 388c2ecf20Sopenharmony_ci 398c2ecf20Sopenharmony_ci Information about where to get supporting software for Linux amateur 408c2ecf20Sopenharmony_ci radio as well as information about how to configure an AX.25 port is 418c2ecf20Sopenharmony_ci contained in the AX25-HOWTO, available from 428c2ecf20Sopenharmony_ci <https://www.tldp.org/docs.html#howto>. You might also want to 438c2ecf20Sopenharmony_ci check out the file <file:Documentation/networking/ax25.rst> in the 448c2ecf20Sopenharmony_ci kernel source. More information about digital amateur radio in 458c2ecf20Sopenharmony_ci general is on the WWW at 468c2ecf20Sopenharmony_ci <https://www.tapr.org/>. 478c2ecf20Sopenharmony_ci 488c2ecf20Sopenharmony_ci To compile this driver as a module, choose M here: the 498c2ecf20Sopenharmony_ci module will be called ax25. 508c2ecf20Sopenharmony_ci 518c2ecf20Sopenharmony_ciconfig AX25_DAMA_SLAVE 528c2ecf20Sopenharmony_ci bool "AX.25 DAMA Slave support" 538c2ecf20Sopenharmony_ci default y 548c2ecf20Sopenharmony_ci depends on AX25 558c2ecf20Sopenharmony_ci help 568c2ecf20Sopenharmony_ci DAMA is a mechanism to prevent collisions when doing AX.25 578c2ecf20Sopenharmony_ci networking. A DAMA server (called "master") accepts incoming traffic 588c2ecf20Sopenharmony_ci from clients (called "slaves") and redistributes it to other slaves. 598c2ecf20Sopenharmony_ci If you say Y here, your Linux box will act as a DAMA slave; this is 608c2ecf20Sopenharmony_ci transparent in that you don't have to do any special DAMA 618c2ecf20Sopenharmony_ci configuration. Linux cannot yet act as a DAMA server. This option 628c2ecf20Sopenharmony_ci only compiles DAMA slave support into the kernel. It still needs to 638c2ecf20Sopenharmony_ci be enabled at runtime. For more about DAMA see 648c2ecf20Sopenharmony_ci <http://www.linux-ax25.org>. If unsure, say Y. 658c2ecf20Sopenharmony_ci 668c2ecf20Sopenharmony_ci# placeholder until implemented 678c2ecf20Sopenharmony_ciconfig AX25_DAMA_MASTER 688c2ecf20Sopenharmony_ci bool 'AX.25 DAMA Master support' 698c2ecf20Sopenharmony_ci depends on AX25_DAMA_SLAVE && BROKEN 708c2ecf20Sopenharmony_ci help 718c2ecf20Sopenharmony_ci DAMA is a mechanism to prevent collisions when doing AX.25 728c2ecf20Sopenharmony_ci networking. A DAMA server (called "master") accepts incoming traffic 738c2ecf20Sopenharmony_ci from clients (called "slaves") and redistributes it to other slaves. 748c2ecf20Sopenharmony_ci If you say Y here, your Linux box will act as a DAMA master; this is 758c2ecf20Sopenharmony_ci transparent in that you don't have to do any special DAMA 768c2ecf20Sopenharmony_ci configuration. Linux cannot yet act as a DAMA server. This option 778c2ecf20Sopenharmony_ci only compiles DAMA slave support into the kernel. It still needs to 788c2ecf20Sopenharmony_ci be explicitly enabled, so if unsure, say Y. 798c2ecf20Sopenharmony_ci 808c2ecf20Sopenharmony_ciconfig NETROM 818c2ecf20Sopenharmony_ci tristate "Amateur Radio NET/ROM protocol" 828c2ecf20Sopenharmony_ci depends on AX25 838c2ecf20Sopenharmony_ci help 848c2ecf20Sopenharmony_ci NET/ROM is a network layer protocol on top of AX.25 useful for 858c2ecf20Sopenharmony_ci routing. 868c2ecf20Sopenharmony_ci 878c2ecf20Sopenharmony_ci A comprehensive listing of all the software for Linux amateur radio 888c2ecf20Sopenharmony_ci users as well as information about how to configure an AX.25 port is 898c2ecf20Sopenharmony_ci contained in the Linux Ham Wiki, available from 908c2ecf20Sopenharmony_ci <http://www.linux-ax25.org>. You also might want to check out the 918c2ecf20Sopenharmony_ci file <file:Documentation/networking/ax25.rst>. More information about 928c2ecf20Sopenharmony_ci digital amateur radio in general is on the WWW at 938c2ecf20Sopenharmony_ci <https://www.tapr.org/>. 948c2ecf20Sopenharmony_ci 958c2ecf20Sopenharmony_ci To compile this driver as a module, choose M here: the 968c2ecf20Sopenharmony_ci module will be called netrom. 978c2ecf20Sopenharmony_ci 988c2ecf20Sopenharmony_ciconfig ROSE 998c2ecf20Sopenharmony_ci tristate "Amateur Radio X.25 PLP (Rose)" 1008c2ecf20Sopenharmony_ci depends on AX25 1018c2ecf20Sopenharmony_ci help 1028c2ecf20Sopenharmony_ci The Packet Layer Protocol (PLP) is a way to route packets over X.25 1038c2ecf20Sopenharmony_ci connections in general and amateur radio AX.25 connections in 1048c2ecf20Sopenharmony_ci particular, essentially an alternative to NET/ROM. 1058c2ecf20Sopenharmony_ci 1068c2ecf20Sopenharmony_ci A comprehensive listing of all the software for Linux amateur radio 1078c2ecf20Sopenharmony_ci users as well as information about how to configure an AX.25 port is 1088c2ecf20Sopenharmony_ci contained in the Linux Ham Wiki, available from 1098c2ecf20Sopenharmony_ci <http://www.linux-ax25.org>. You also might want to check out the 1108c2ecf20Sopenharmony_ci file <file:Documentation/networking/ax25.rst>. More information about 1118c2ecf20Sopenharmony_ci digital amateur radio in general is on the WWW at 1128c2ecf20Sopenharmony_ci <https://www.tapr.org/>. 1138c2ecf20Sopenharmony_ci 1148c2ecf20Sopenharmony_ci To compile this driver as a module, choose M here: the 1158c2ecf20Sopenharmony_ci module will be called rose. 1168c2ecf20Sopenharmony_ci 1178c2ecf20Sopenharmony_cimenu "AX.25 network device drivers" 1188c2ecf20Sopenharmony_ci depends on HAMRADIO && AX25 1198c2ecf20Sopenharmony_ci 1208c2ecf20Sopenharmony_cisource "drivers/net/hamradio/Kconfig" 1218c2ecf20Sopenharmony_ci 1228c2ecf20Sopenharmony_ciendmenu 123