License: CC-BY-NC-SA
Oto tłumaczenie na angielski z niezmienionym formatowaniem Markdown:
The device connects to a Wi-Fi network and downloads propagation data from the HAMQSL.com server in XML format. Information such as Solar Flux, sunspot number, K and A indices, and propagation conditions for HF, 6m, 4m, and VHF (2m) bands is displayed on a color TFT screen. All XML data is extracted into corresponding variables in the code — this makes it easy to adjust which information should be displayed and in what form.
- Power on the device.
- If this is the first startup or the Wi-Fi network has been reset, the configuration mode will start.
- Connect to the Wi-Fi network named
HamQSL. - Open a browser and enter
192.168.4.1to configure the Wi-Fi connection. - After saving the data, the device will connect automatically.
- Hold the RESET button (GPIO 32 to ground) during startup to reset Wi-Fi settings.
| Item | Description |
|---|---|
| HF Band DAY/NIGHT | Propagation conditions during day/night |
| K-Index | Geomagnetic disturbance indicator |
| A-Index | Geomagnetic activity indicator |
| Solar Flux | Solar flux (sun activity) |
| Sunspots | Number of sunspots |
| VHF 6m/4m/2m | Conditions on 6m, 4m, and 2m bands (if available) |
- Red – poor conditions
- Yellow – moderate conditions
- Green – good conditions
If any of the bands (6m, 4m, 2m) are open (e.g., due to tropo or aurora), the information will appear in green.
- Data is refreshed automatically every 60 minutes.
- This interval can be changed by modifying the
intervalconstant in the source code. - Do not set the refresh interval shorter than 60 minutes!
- The serial port operates at 115200 baud — it can be used for diagnostics.
- If the Wi-Fi connection fails within 5 minutes, the device will restart.
-
Microcontroller: ESP32
-
Display: TFT 2.8" ILI9341 (SPI)
-
Arduino libraries:
- WiFiManager
- WiFiClientSecure
- ArduinoHttpClient
- TFT_eSPI
- Open Arduino IDE
- Go to Tools → Board → Boards Manager
- Search for
esp32 - Install esp32 by Espressif Systems
- Select the ESP32 Dev Module board
Install via Sketch → Include Library → Manage Libraries:
- WiFiManager by tzapu
- WiFiClientSecure
- ArduinoHttpClient by Arduino
- TFT_eSPI
- Download the project from GitHub: https://github.com/canislupus11/HamQSL-XML-Parser/
- Place the User_Setup.h file into the TFT_eSPI library directory (likely Arduino/libraries/TFT_eSPI)
- Open the
.inofile in Arduino IDE - Select the appropriate COM port and the ESP32 Dev Module board
- Upload the code to the board
Suggested 3D-printed enclosures:
Oto dodatkowa sekcja w angielskiej wersji, również w niezmienionym formacie Markdown:
If you are using the TZT ESP32 LVGL screen – https://a.aliexpress.com/_EwsuCq6 – there are commented lines in the code marked with the display model. You must comment out the original ones and uncomment the lines corresponding to this specific display.
Urządzenie łączy się z siecią Wi-Fi i pobiera dane propagacyjne z serwera HAMQSL.com w formacie XML. Informacje takie jak Solar Flux, liczba plam słonecznych, indeksy K i A oraz warunki propagacyjne w pasmach HF, 6m, 4m i VHF (2m) są wyświetlane na kolorowym wyświetlaczu TFT. Wszystkie dane z XML są wyciągane do odpowiednich zmiennych w kodzie – dzięki temu można łatwo dostosować, które informacje mają być wyświetlane lub w jakiej formie.
- Włącz urządzenie.
- Jeśli to pierwsze uruchomienie lub sieć Wi-Fi została zresetowana, uruchomi się tryb konfiguracji.
- Połącz się z siecią Wi-Fi o nazwie
HamQSL. - Otwórz przeglądarkę i wpisz
192.168.4.1, aby skonfigurować połączenie Wi-Fi. - Po zapisaniu danych urządzenie połączy się automatycznie.
- Przytrzymaj przycisk RESET (GPIO 32 do masy) podczas uruchamiania, aby zresetować ustawienia Wi-Fi.
| Pozycja | Opis |
|---|---|
| HF Band DAY/NIGHT | Warunki propagacyjne w dzień/noc |
| K-Index | Wskaźnik zaburzeń geomagnetycznych |
| A-Index | Wskaźnik aktywności geomagnetycznej |
| Solar Flux | Strumień słoneczny (aktywność słońca) |
| Sunspots | Liczba plam słonecznych |
| VHF 6m/4m/2m | Warunki w pasmach 6m, 4m i 2m (jeśli dostępne) |
- Czerwony – słabe warunki
- Żółty – umiarkowane warunki
- Zielony – dobre warunki
Jeśli któreś z pasm (6m, 4m, 2m) jest otwarte (np. przez tropo, aurorę), informacja o tym pojawia się w kolorze zielonym.
- Dane są odświeżane automatycznie co 60 minut.
- Czas ten można zmienić, edytując wartość stałej
intervalw kodzie źródłowym. - Nie ustawiaj krótszego czasu odświeżania niż 60 minut!
- Port szeregowy działa z prędkością 115200 baud – można użyć go do diagnostyki.
- Jeśli połączenie z Wi-Fi nie powiedzie się w ciągu 5 minut, urządzenie uruchomi się ponownie.
- Mikrokontroler: ESP32
- Wyświetlacz: TFT 2.8" ILI9341 (SPI)
- Biblioteki Arduino:
- WiFiManager
- WiFiClientSecure
- ArduinoHttpClient
- TFT_eSPI
- Otwórz Arduino IDE
- Przejdź do Narzędzia → Płytka → Menedżer płytek
- Wyszukaj
esp32 - Zainstaluj esp32 by Espressif Systems
- Wybierz płytkę ESP32 Dev Module
Zainstaluj przez Szkic → Dołącz bibliotekę → Zarządzaj bibliotekami:
- WiFiManager by tzapu
- WiFiClientSecure
- ArduinoHttpClient by Arduino
- TFT_eSPI
- Pobierz projekt z GitHuba:
https://github.com/canislupus11/HamQSL-XML-Parser/ - Plik User_Setup.h wrzuć do katalogu z biblioteką TFT_eSPI (Prawdopodobnie Adruino/libraries/TFT_eSPI)
- Otwórz plik
.inow Arduino IDE - Wybierz odpowiedni port COM i płytkę ESP32 Dev Module
- Wgraj kod do płytki
Propozycje drukowanej obudowy:
Jeśli używasz TZT ESP32 LVGL screen - https://a.aliexpress.com/_EwsuCq6 w kodzie istnieją zakomentowane linie opisane modelem wyświetlacza, należy zakomentować orginalne i odkomentować te odpowiedzialne za ten wyświetlacz.
