LogBeamOS Manual

Linux distribution for radio amateurs

logbeam.org/logbeamos · LogBeamOS Update 0.3.23 · Reporting a problem

1. First steps

2. Connecting the radio

  1. Connect the radio by USB. For most radios there is no driver to install: Linux already has it.
  2. Open Radio and Equipment. It shows the radio, the CAT port, the radio's sound card and the matching COM port for N1MM+ and Log4OM.
  3. Test CAT: choose the model; with the speed set to Automatic, it looks for the speed the radio answers at. The test only reads the frequency: it never transmits.
  4. Set up the programs…: choose the radio from the list and press Set up. WSJT-X, JTDX, Fldigi, Not1MM and Direwolf then use the radio at the same time, with the radio's sound and PTT by CAT. A copy of each program's settings is kept before changing them.
  5. N1MM+ and Log4OM: on the same screen, choose how each one uses the radio. Only N1MM+ (or Log4OM) uses the radio: the program talks directly to the radio; while it is open, the other programs have no CAT and, when it closes, they get it back. Uses the radio together with the other programs: all of them use the radio at the same time; N1MM+ sees a “Kenwood TS-2000” and functions specific to your radio may not work. You can change the choice whenever you want, in Set up the programs…. Log4OM has to be opened once before it can be set up.

The CAT speed must be the same in the radio's menu (for example, CAT RATE on Yaesu radios).

3. Which program for what

For…Program
FT8, FT4, WSPRWSJT-X or JTDX · with FT2: Decodium · map of the stations heard: GridTracker2
Weak-signal keyboard messagingJS8Call
RTTY, PSK, Olivia and other digital modesFldigi (with Flrig, Flmsg and Flamp)
ContestsN1MM+ (the Windows one, through Wine) or Not1MM
LogbookLog4OM (through Wine), CQRLOG or KLog · upload to logbeam.org: LogBeam Uplink · upload to Wavelog: WaveLogGate
Logbook of The World (LoTW) confirmationsTQSL, from the ARRL: signs your QSOs and uploads them to LoTW
APRSDirewolf (the sound card modem) and Xastir (the map); Xastir starts Direwolf by itself and connects to it
Winlink (e-mail over radio)Pat
SatellitesGpredict (predictions and tracking) · weather satellite images: SatDump
SDR receiversGqrx or SDR++ · experiments: GNU Radio
Digital voice and picturesFreeDV · SSTV: QSSTV
Remote Icom and Kenwood radioswfview
Programming DMR radiosqdmr
DMR without a radio (BrandMeister)VoxDMR (optional: installed by Update LogBeamOS; asks for your DMR ID and BrandMeister hotspot password)
EchoLinkQtel (the router must let UDP ports 5198–5199 and TCP port 5200 through, or use an EchoLink proxy)
WIRES-X (Yaesu)WIRES-X, through Wine. It does not come with LogBeamOS: download it from the Yaesu WIRES-X website (you need to log in with your ID), open WIRES-X and select the downloaded .zip file. The COM port of the HRI-200 or of the radio (PDN mode) is then shown, to choose on the WIRES-X COM port setting screen.
Antenna modellingxnec2c
Spectrum analysis and academic analysis of the radio spectrum4ham Spectrum Analysis

In Xastir, before transmitting: enter your callsign (Xastir asks for it the first time), change MYCALL in the direwolf.conf file in your home folder and turn transmitting on under Interfaces. By default, Xastir only receives.

4. Updating

5. Installing alongside Windows

First, in Windows

  1. Back up your data.
  2. Run "Preparar o Windows.cmd" with right-click → Run as administrator. It is at the root of the ISO: in Windows, double-click the ISO file to open it. It turns off fast startup and, if drive C: is encrypted, starts decrypting it; before installing, wait until the percentage encrypted reaches 0 %. It can also be done by hand: Before installing.

Installing

  1. Start from the USB drive and open Install LogBeamOS. For the installation type, choose to install alongside Windows and drag the divider to give LogBeamOS at least 50 GB; the installer does not accept less.
  2. Afterwards, when the computer starts, a menu with LogBeamOS and Windows is shown for 10 seconds. The last choice is remembered.

Removing LogBeamOS

  1. In Windows, in an administrator console: bcdedit /set {fwbootmgr} displayorder {bootmgr} /addfirst. The computer then starts straight into Windows.
  2. Disk Management: delete the LogBeamOS partitions (the ones after C: without a drive letter; never the EFI or recovery partition). Then right-click C: → Extend Volume.
  3. Optional, to also delete LogBeamOS's boot files, in the same console:
    • bcdedit /enum firmware lists the boot entries; delete the ones with \EFI\ubuntu in the path with bcdedit /delete {identifier};
    • mountvol S: /S and rmdir /S /Q S:\EFI\ubuntu;
    • if S:\EFI\Boot\fbx64.efi exists, the installer replaced the disk's fallback boot file: copy /Y S:\EFI\Microsoft\Boot\bootmgfw.efi S:\EFI\Boot\bootx64.efi and del S:\EFI\Boot\fbx64.efi S:\EFI\Boot\mmx64.efi;
    • finally, mountvol S: /D.

6. Common problems

The USB drive does not start: "Unable to find a medium containing a live file system"
Remove the USB drive, wait 5 seconds, plug it back in and start again.
Windows asks to format the USB drive
Always cancel. It is the part of the USB drive where your LogBeamOS data is kept, which Windows cannot read.
A program is stuck
Open the System Monitor (icon on the panel), Processes tab, right-click the program → End.
The desktop crashed ("fallback mode")
Press Ctrl+Alt+Esc to restart it, or log out and log back in.
The radio does not answer CAT
In Radio and Equipment, check the model and use the Automatic speed; check that CAT is enabled in the radio's menu and close the programs using the port.
N1MM+: "The given port name is invalid… not a serial port" or "Radio … is not responding"
The COM port chosen in N1MM+ is not the radio cable. In Radio and Equipment, click Set up the programs… and choose how N1MM+ uses the radio: the right port is written into N1MM+. The COM of each cable is shown in Radio and Equipment ("in N1MM+ and Log4OM: COM…").
LogBeam Uplink warns "port 2333 is in use by another program"
It is usually WaveLogGate, which also receives QSOs on that port. LogBeamOS moves WaveLogGate to port 2335 when the session starts; if it was set back to 2333, change it in WaveLogGate: Configuration → Advanced → UDP Port 2335 → Save. Then close and open LogBeam Uplink. If a program was sending QSOs to WaveLogGate, change its destination port to 2335 as well.
WaveLogGate: "HTTPS/WSS require a trusted certificate"
LogBeamOS puts the WaveLogGate certificate into Firefox by itself, without a password, as soon as WaveLogGate creates it: there is no need to click Install Certificate. If the warning stays, close WaveLogGate and open it again.
No radio sound in WSJT-X or Direwolf
In Radio and Equipment → Set up the programs…, choose the radio sound.
Direwolf closes straight away
The window stays open with the explanation. The settings are in the direwolf.conf file in your home folder.

7. Reporting a problem

When something fails, a report made with these three steps is enough to understand what happened.

  1. Write down what happened: what you were doing, what you expected and what showed up. If there is an error message, copy its text or take a picture of the screen (PrtSc key).
  2. Create the diagnostic report right after the failure, before restarting: in the menu, Diagnostic report; or, in a terminal, logbeamos-diagnostic. It leaves a text file on the desktop. If the computer froze and had to be restarted, use logbeamos-diagnostic --previous, which also gathers the errors of the previous start.
  3. Send the report with the file attached: at github.com/octaviofilipepereira/LogBeamOS, Issues tab (a GitHub account is needed; it is free).

The report holds no passwords or keys, and the user name, the computer name and network addresses are taken out. It holds the versions, the computer model, the USB devices connected, how the radio is set up in each program and the warnings and errors of the system. You can read it before sending it.