MODULEFRN.CONF(5)

MODULEFRN.CONF 💖

okay bestie, welcome to ModuleFrn.conf(5) — the file formats girlies know this one. it's the config file for the SvxLink server Free Radio Network (FRN) module. yes, we're doing radio stuff. yes, it's iconic. let's go 🎀

---

✨ NAME ✨

ModuleFrn.conf — the configuration file for the SvxLink server Free Radio Network (FRN) module 🦋

---

🌸 DESCRIPTION 🌸

so like, svxlink is a general purpose voice service system for ham radio use. no cap. and this man-page? it describes the SvxLink server configuration for the FRN module. 💅

the FRN module is the one that connects you to Free Radio Network (FRN) servers. that's literally its whole job and it eats every time 🔥

---

👑 CONFIGURATION VARIABLES 👑

okay so there are a couple of configuration variables that are common to all modules. the documentation for those lives over in the svxlink.conf(5) manual page — go read that one too, bestie, i'm not gatekeeping 🫶

and here's the description of all the module specific configuration variables that the SvxLink FRN module understands:

💜 ModuleFrn

• SERVER — Free Radio Network (FRN) server hostname or ip address. you can find a list of active servers using the FRN desktop application or at http://freeradionetwork.eu web page ✨
• PORT — FRN server port number
• SERVER_BACKUP — Free Radio Network (FRN) backup server hostname or ip address. when connectivity to the main SERVER is not possible, the connection will fallback to this server. it's giving backup plan, we love a safety net 🧚
• PORT_BACKUP — FRN backup server port number
• VERSION — identify itself as a FRN client with this version.
• EMAIL_ADDRESS — your email address, which was used during registration.
• DYN_PASSWORD — password provided to you by FRN on registration.
• CLIENT_TYPE — type of the client:
  • 0 - crosslink
  • 1 - gateway
  • 2 - pc only

read more at http://freeradionetwork.eu/frnprotocol.htm web page.

• CALLSIGN_AND_USER — your callsign and user name used during registration, for example "1234, Bob".
• BAND_AND_CHANNEL — in case of PC only user, this is 'PC Only'. in case of a crosslink this is 'Crosslink'. in case of a gateway this is the frequancy in full Mhz and kHz separated by a . (dot), followed by the mode 'FM', 'AM' or 'DIG', followed by a space and the squelch type 'CTC', 'DSC' or 'NONE' followed by the CTC frequency or ID code.

examples:

446.03125FM CTC131.8
28.12500AM
145.43750FM DCS828
446.02625DIG CID123

• DESCRIPTION — custom extra information about the node.
• COUNTRY — full name of the country.
• CITY_CITY_PART — the city and the part of the city, or the part of the country and the city divided by a minus sign, for example "City - Street".
• NET — network (room) where to connect, each server holds up to 32 networks (rooms).
• FRN_DEBUG — define to enable extensive module logging, including FRN request and response printout. 👀
• DISABLE_RF — define to disable sending voice from FRN to RIG. nothing will be transmitted by radio (could be switched ON by DTMF command later if needed). lowkey a big deal, so read it twice 💀

---

🌈 FRN NEW USER REGISTRATION 🌈

to register at FRN service it is possible to use the native desktop client or just register using netcat:

echo 'IG:\
<ON>[CallsignAndUser]</ON>\
<EA>[EMailAddress]</EA>\
<BC>[BandAndChannel]</BC>\
<DS>[Description]</DS>\
<NN>[Country]</NN>\
<CT>[CityCityPart]</CT>' | nc -v sysman.freeradionetwork.eu 10025

FRN System Manager should return OK in case of successful registration. periodt. ✅

more information about new user registration is available at http://freeradionetwork.eu/frnprotocol.htm

---

🎀 FILES 🎀

• /etc/svxlink/svxlink.conf (or deprecated /etc/svxlink.conf) — the system wide configuration file.
• ~/.svxlink/svxlink.conf — per user configuration file.
• /etc/svxlink/svxlink.d/ModuleFrn.conf — global modularized configuration file. depends on the CFG_DIR configuration variable setting.
• ~/.svxlink/svxlink.d/ModuleFrn.conf — per user modularized configuration file. depends on the CFG_DIR configuration variable setting.

---

💖 AUTHOR 💖

Tobias Blomberg (SM0SVX) <sm0svx at svxlink dot org> — king behavior, honestly 👑

---

🦋 REPORTING BUGS 🦋

bugs should be reported using the issue tracker at https://github.com/sm0svx/svxlink.

questions about SvxLink should not be asked using the issue tracker. instead use the group set up for this purpose at groups.io: https://groups.io/g/svxlink — fr fr, keep the tracker for bugs only bestie 🙈

---

⭐ SEE ALSO ⭐

• svxlink.conf(5)

---

and that's the whole page, bestie!! this one's from the Linux girlies, version dated APRIL 2021, filed under MODULEFRN.CONF(5) 💅✨ slay, go configure your radio 🫶💖