This plugin is available only on Linux.
This plugin encodes and modulates transmissions made in the M17 protocol. M17 is a fully Open Source and Open Source audio codec based project (Codec2) for FM based digital voice amateur radio. More information is available here
There are 4 collapsible main sections in the GUI
- A: Settings: General RF settings
- B: Audio: Audio related settings
- C: Packet: Packet mode related settings
- D: Digital: Settings specific to digital
This is similar to what is found in the NFM modulator.
Use the wheels to adjust the frequency shift in Hz from the center frequency of transmission. Left click on a digit sets the cursor position at this digit. Right click on a digit sets all digits on the right to zero. This effectively floors value at the digit position. Wheels are moved with the mousewheel while pointing at the wheel or by selecting the wheel with the left mouse click and using the keyboard arrows. Pressing shift simultaneously moves digit by 5 and pressing control moves it by 2.
Average total power in dB relative to a ±1.0 amplitude signal generated in the pass band.
Use this button to toggle mute for this channel.
This is the bandwidth in kHz of the channel signal filtered after modulation.
This is the peak FM deviation in ±kHz that will be effective for nominal (1.0) audio volume (FM analog) or extreme symbols (digital). As per M17 standard the value of ±2.4 kHz shall be used. However different values can be chosen for experimentation.
This is the volume of the audio signal from 0.0 (mute) to 2.0 (maximum). It can be varied continuously in 0.1 steps using the dial button.
Shows the level of the modulating FM signal.
- top bar (beige): average value
- bottom bar (brown): instantaneous peak value
- tip vertical bar (bright red): peak hold value
Works only in FM analog mode (B.3). Switches to audio tone input.
Adjusts the tone frequency from 0.1 to 2.5 kHz in 0.01 kHz steps
Toggle analog modulation for audio (tone B.1, mic B.4 or file B.8 inputs). Used for testing purposes.
Left click to switch to the audio input. You must switch it off to make other inputs available.
Right click to select audio input device. See audio management documentation for details.
Activate or de-activate the input source audio feedback. The audio output device may be selected by right clicking on the button.
Adjust audio feedback volume.
The path to the selected audio file to be played or dots if unselected
Opens a file dialog to select the audio file to be played. It must be mono 48 kHz F32LE raw format. Using sox a .wav file can be converted with this command: sox piano.wav -t raw -r 48k -c 1 -b 32 -L -e float piano.raw
Play the audio file in an infinite loop
Toggle play/pause file play. When paused the slider below (B.13) can be used to randomly set the position in the file when re-starting.
This is the current audio file play position in time units relative to the start
This is the audio file play length in time units
This slider can be used to randomly set the current position in the file when file play is in pause state (button B.10)
Turn on packet mode. No other mode must be selected.
Send packet frames immediately
Send packet frames in an infinite loop with a delay between transmissions set by (C.4)
Delay between packet frames in seconds when in loop mode (C.3)
This is a special mode for Bit Error Rate Testing. In this mode only a synchronization word followed by a chunk of bits taken from a pseudo random generator is sent for each frame. It can be selected only if no other mode is selected.
Panels corresponding to each available packet type are arranged in a tabbed setup. Tabs can be selected with icons on the right. These are:
- SMS: SMS data with the chat icon. Selects SMS packet type.
- APRS: APRS data with the world icon. Selects APRS packet type.
Selected with the tab with chat icon (top most). Selecting this tab will set the packet mode to SMS.
This is simply a text edit window where you can type your SMS message. As per M17 standard the maximum number of characters is 798 and text will be truncated to this size if it is larger.
Selected with the tab with word icon (bottom most). Selecting this tab will set the packet mode to APRS.
This is the "FROM" of APRS message and usually is the station callsign followed by a dash and a numeric suffix.
When toggled messages with data (C.6.2.5) and location payloads are sent alternatively. Location data (latitude and longitude) are taken from the global station position settings.
This is the "TO" of APRS message. There is a choice between "APRS¨, "APZ¨, "CQ", "BEACON", "CALLSIGN-SSID" or custom.
This is the "VIA" of APRS message. There is a choice between "WIDE2-2", "ARISS" or custom.
Arbitrary data payload to be added to the APRS message. As per APRS standard it must be prefixed with the > sign for text payloads.
Only the standard 4.8 kBaud rate is available. This is a provision for possible future experimentations.
This is the source callsign
Check this button to add GNSS data to the LSF (Link Setup Frame) data. Latitude, longitude and altitude are taken from the global station position settings.
This is the destination callsign. Keep empty for a general (CQ or BROADCAST) call.
This is the 0..15 channel access number sent in the LSF (Link Setup Frame).