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