Geef ons het log,
en we kunnen het fixen.

1Wat er in het log staat

FT8AF houdt een roterend tekstbestand genaamd debug.log bij in zijn app-datamap. Het legt dingen vast als:

• USB-insteek- / uittrekgebeurtenissen en welk CAT-apparaat overeenkwam
• Automatische verbindingspogingen en eventuele mislukkingen
• CAT-seriële frames verzonden naar en ontvangen van de set
• Band- en frequentiewissels
• Levenscyclusgebeurtenissen bij het starten en stoppen van de app

Het is platte tekst, veilig om te lezen, en bevat geen wachtwoorden of upload-API-sleutels. Zie de privacy-sectie hieronder als je het wilt doornemen voor je het deelt.

2Ontgrendel de debugmodus

De makkelijkste manier om het log te halen gebruikt een in-app debugscherm — geen computer, geen bestandsbeheerder, geen rechten op de Android-data-map. Het scherm is standaard verborgen en je ontgrendelt het net als de ontwikkelaarsopties van Android: tik zeven keer op het versieblok.

1. Open het tabblad Settings in FT8AF.
2. Scroll naar de onderkant — de sectie ABOUT.
3. Tik op FAQ & Support. De About-dialoog opent en toont de app-versie en een beschrijving die begint met "FT8, made easy."
4. Tik zeven keer achter elkaar op die beschrijvingstekst. Na de zevende tik schakelt de debugmodus aan en blijft hij behouden tussen starts.
5. Sluit de About-dialoog. Er verschijnt nu een nieuwe Debug-rij in de ABOUT-sectie, vlak onder FAQ & Support.

3Open Debug & deel

Tik op de nieuwe Debug-rij. Een schermvullende logviewer opent en toont live de laatste paar honderd regels van debug.log — hij ververst elke paar seconden en scrollt automatisch naar de onderkant.

13:42:01  USB attach: vid=10c4 pid=ea60
13:42:01  autoConnect attempt #1 → SUCCESS
13:42:02  CAT > FE FE 94 E0 03 FD
13:42:02  CAT < FE FE E0 94 03 00 74 04 00 14 FD
13:42:05  band → 20m, freq 14.074 MHz
13:42:18  decode: 14 messages in 64 ms
13:42:33  decode: 11 messages in 58 ms

Vanaf de bovenste werkbalk:

Share

Opent het deelmenu van Android met debug.log bijgevoegd als tekstbestand (onderwerp "FT8AF debug.log"). Kies Gmail om het ons direct te mailen, of een app die bijlagen aankan — Drive, Outlook, Slack, Signal, Telegram, de systeem-app Bestanden, allemaal werken ze.

Clear

Verwijdert het huidige log. Handig als je opnieuw wilt beginnen voor je een bug reproduceert — druk gewoon op Clear, verlaat de dialoog, reproduceer het probleem, kom terug en deel. Het kortere log maakt het makkelijker voor ons om de relevante gebeurtenissen te zien.

Logcat: ON / OFF

Wanneer ON, voegt de viewer ook recente logcat-uitvoer van het eigen proces van de app toe — handig wanneer een crash of audiobug niet volledig in debug.log is vastgelegd. De logcat-staart gaat mee wanneer je op Share tikt.

4Terugval: Bestanden-app

Als je om een of andere reden niet bij het in-app Debugscherm kunt komen — oude build, het ontgrendelen lukte niet, je gebruikt liever de bestandsbeheerder — staat het logbestand ook op schijf in:

/Android/data/com.bg7yoz.ft8cn/files/debug.log

1. Open de app Bestanden (of Mijn bestanden) op je telefoon.
2. Navigeer naar Interne opslag → Android → data. Op sommige toestellen verbergt Android deze map standaard; tik op het menu met drie puntjes en schakel Verborgen bestanden tonen of Systeemmappen in.
3. Open de map genaamd com.bg7yoz.ft8cn, dan files. Je zou debug.log erin moeten zien.
4. Houd debug.log ingedrukt en tik op Delen.

5Terugval: ADB

Voor ontwikkelaars met een computer en Androids adb-tool:

1. Schakel op je telefoon Ontwikkelaarsopties → USB-foutopsporing in.
2. Sluit de telefoon via USB aan op je computer, accepteer de foutopsporingsautorisatieprompt.
3. Bevestig vanuit een terminal dat de telefoon zichtbaar is:

   adb devices -l

4. Haal het log op:

   adb pull /sdcard/Android/data/com.bg7yoz.ft8cn/files/debug.log .

   Bij opstellingen met meerdere apparaten, richt je expliciet op de telefoon met -s <serial>.

6Schrijf de issue

Een nuttig bugrapport is klein — drie of vier korte alinea's zijn genoeg. Het patroon dat altijd werkt:

1. Wat deed je? "Mijn FT-891 ingestoken, CQ getikt op 20m." Concrete acties op volgorde. Geen noodzaak om de app te beschrijven — alleen wat je tikte.
2. Wat verwachtte je dat er zou gebeuren? "Ik verwachtte dat de set zou zenden en de app tonen zou gaan verzenden op 14.074."
3. Wat gebeurde er werkelijk? "De TX-balk bleef op LISTENING. Geen PTT, geen tonen." Als er iets op het scherm verscheen — foutmelding, bevroren interface, rare waterfall — beschrijf het. Een screenshot is goud waard.
4. Hoe vaak? Elke keer? Alleen nadat de telefoon in slaap ging? Alleen op 6m? Alles wat je kunt vastpinnen versmalt de zoektocht.
5. Voeg het log toe. Haal debug.log direct na het reproduceren van het probleem — de meest recente regels zijn het nuttigst.

7Issue-sjabloon

Kopieer dit naar een nieuwe issue en vul de gaten in:

## What happened

(One or two sentences describing the bug)

## Steps to reproduce
1. (First thing you tapped)
2. (Second thing)
3. (...)

## Expected vs. actual

Expected: (what should have happened)
Actual:   (what did happen)

## Environment

- FT8AF version:   (Settings → About, or the release tag you installed)
- Source:          GitHub APK / Google Play / built from source
- Android version: (e.g. 14)
- Device:          (e.g. Pixel 8, Samsung S23, etc.)
- Radio:           (e.g. Yaesu FT-891 over USB-C)
- Cable:           (USB-C direct / OTG adapter / brand if relevant)

## Log

(Attach debug.log, or paste the last ~50 lines in a code block.)

8Als de app crashte

Wanneer FT8AF helemaal crasht, houdt Android een apart crashrapport bij. Twee plekken om te kijken:

• Als je hem van Google Play kreeg, kies dan één keer voor anonieme crashrapportage en wij zien de stack trace automatisch. Je hoeft niets te doen — maar het toevoegen van "Ik heb net een crashrapport verzonden vanaf toestel X rond <tijd>" aan de issue helpt ons het te koppelen.
• Als je ADB beschikbaar hebt, bevat het live systeemlog meestal de crash trace vlak nadat hij gebeurt:

  adb logcat -d > logcat.txt

  Voeg logcat.txt toe naast debug.log.

9Privacy

Het debuglog is gewoon tekst. Het legt de bedrijfsgebeurtenissen van de app vast, niet je persoonlijke gegevens. Je ziet regels als:

13:42:01 USB attach: vid=10c4 pid=ea60 (Silicon Labs CP210x)
13:42:01 autoConnect attempt #1 → SUCCESS
13:42:02 CAT > FE FE 94 E0 03 FD
13:42:02 CAT < FE FE E0 94 03 00 74 04 00 14 FD
13:42:05 band → 20m, freq 14.074 MHz

Wat er niet in staat: Cloudlog- of QRZ-API-sleutels, je accountwachtwoorden, foto's, contacten of locatie. Je roepletters en locator staan er wel in, omdat die je station identificeren — maar dat is toch openbare informatie voor gelicentieerde zendamateurs.

Als je het wilt doornemen of redigeren voor je het verstuurt, het bestand is platte UTF-8-tekst. Elke teksteditor opent het.