konradandCursor
2c621d4b7f
The default stays v2. A reflector that refuses that version and names the other gets one session of it, then the station announces the configured protocol again. Co-authored-by: Cursor <cursoragent@cursor.com>
62 lines
2.6 KiB
Markdown
62 lines
2.6 KiB
Markdown
# funknetz
|
||
|
||
A headset station for the FM-Funknetz. It joins one reflector talk group and lets the operator listen and speak.
|
||
|
||
## Language
|
||
|
||
**FM-Funknetz**:
|
||
The German amateur network of linked analog FM stations that this application joins.
|
||
_Avoid_: using that name for this application
|
||
|
||
**Station**:
|
||
This application’s presence on a reflector, named by a callsign. It has no radio of its own.
|
||
_Avoid_: node, client, channel, hotspot
|
||
|
||
**Reflector**:
|
||
The conference that forwards audio among stations that have joined the same talk group. One talk group has at most one talker.
|
||
_Avoid_: server, bridge
|
||
|
||
**Talk group**:
|
||
A numbered audio room on the reflector. The station is joined to one talk group at a time; changing it in the config starts a new session after Save.
|
||
_Avoid_: channel, room
|
||
|
||
**Talker**:
|
||
The station currently sending audio on a talk group.
|
||
_Avoid_: transmitter
|
||
|
||
**Callsign**:
|
||
The uppercase amateur call sign that names this station on the reflector.
|
||
_Avoid_: a lowercase spelling, username, node id
|
||
|
||
**Auth key**:
|
||
The shared secret the network issues for this station’s callsign. It proves the station on protocol 2.0, and on protocol 3.0 when the reflector has not signed a certificate yet.
|
||
_Avoid_: a password sent in the clear, the certificate
|
||
|
||
**Certificate**:
|
||
An X.509 certificate whose common name is this station’s callsign. It proves the station on protocol 3.0.
|
||
_Avoid_: auth key, a PEM pasted into the config file
|
||
|
||
**Certificate directory**:
|
||
The directory the station config names. It holds the CA bundle and this station’s key and certificate.
|
||
_Avoid_: PEM text inside the config file
|
||
|
||
**CA bundle**:
|
||
The reflector’s certificate authority, kept in the certificate directory. Protocol 3.0 uses it to check the reflector.
|
||
_Avoid_: the station certificate
|
||
|
||
**Protocol**:
|
||
The reflector session this station speaks: 2.0 or 3.0. The config chooses v2 or v3; v2 is the default.
|
||
_Avoid_: TYPE
|
||
|
||
**Push-to-talk**:
|
||
The operator holding the control that makes this station the talker. Releasing it returns the station to listening.
|
||
_Avoid_: voice-operated transmit, a mute toggle
|
||
|
||
**Config**:
|
||
The JSON file that names how this station joins a reflector (host, port, callsign, auth key, talk group, protocol, certificate directory, logging). Default path `~/.funknetz.json`; `-c` may select another file.
|
||
_Avoid_: settings file, preferences, treating PEMs as config fields
|
||
|
||
**Config window**:
|
||
The in-app form that edits the config. It fills the station window, which is resized to the form.
|
||
_Avoid_: a separate OS window, settings window, preferences dialog, a raw JSON editor as the primary UI
|