RadiaCode-Spectrometer/ESP32-S3-Touch/_archive_previous_project/QUICK_START_WEATHER_TIMEZONE.md

4.0 KiB

⚡ QUICK START - Configure Weather & Timezone

Your Problem

"Weather API settings missing from web UI. Timezone settings missing. That's why weather doesn't show on LCD."

What I Did

✅ Added Weather & Time settings section to web UI
✅ Made timezone selector visible
✅ Made weather provider selector visible
✅ Made location input visible
✅ Made API key field visible
✅ Uploaded to device

In 3 Minutes

1. Open Web UI

Browser → http://[device-ip]/
Click: Settings

2. Find Weather & Time Section

You'll see a NEW section called:
"Weather & Time"
(Between Display and Network sections)

3. Configure

Timezone:

Time Zone dropdown → Select "Europe/Sofia" (or your timezone)

Weather Provider:

Weather Provider dropdown → Choose:
  • "Open-Meteo (Free, No API Key)" ← Easiest
  • "OpenWeather (Requires API Key)" ← More features

Location:

Location field → Enter:
  • City name: Sofia
  • Or coordinates: 42.6977,23.3219

API Key (Only if OpenWeather):

Will only show if you selected OpenWeather
Get free key: https://openweathermap.org/api
Paste your API key

Update Interval:

Set to: 5 (minutes)

4. Save

Click: SAVE button

5. Check HOME Page

Go to Home page
Wait up to 5 minutes
Weather should appear! ✅

Settings Locations

Settings Page Layout:
├─ Display & Theme
│  (Brightness, Theme, Auto-rotate)
│
├─ 🌤️ Weather & Time ← YOUR NEW SETTINGS HERE
│  ├─ Timezone
│  ├─ Weather Provider
│  ├─ Location
│  ├─ API Key (if OpenWeather)
│  └─ Update Interval
│
├─ Network
│  (WiFi SSID, Password)
│
└─ System
   (Restart, Reset)

Before & After

BEFORE

Settings page → Scroll down → Nothing about weather! ❌
LCD HOME page → Weather shows: "--°C" ❌

AFTER

Settings page → Scroll down → See "Weather & Time" section ✅
Configure it → Click Save ✅
LCD HOME page → Real weather displays! ✅

Timezone Options

Pick from:

  • 🇬🇧 Europe/London
  • 🇫🇷 Europe/Paris
  • 🇩🇪 Europe/Berlin
  • 🇧🇬 Europe/Sofia (Bulgaria)
  • 🇬🇷 Europe/Athens
  • 🇷🇺 Europe/Moscow
  • 🇯🇵 Asia/Tokyo
  • 🇨🇳 Asia/Shanghai
  • 🇦🇺 Australia/Sydney
  • 🇺🇸 America/New_York
  • And 8 more...

Quick Troubleshooting

Weather not showing after 5 minutes?

✅ Check:

  1. Weather section is visible in Settings
  2. Location is filled in
  3. Provider is selected
  4. Settings were saved (try again)
  5. Device has internet connection
  6. Wait another 5 minutes (first load can be slow)

Wrong time showing?

✅ Check:

  1. Timezone is selected correctly
  2. Saved settings
  3. Look at LCD - should update in seconds

API Key error (OpenWeather)?

✅ Check:

  1. Got API key from: https://openweathermap.org/api
  2. Key is active (not expired)
  3. Pasted full key correctly
  4. Try again - new keys take few minutes to activate

Files Uploaded

✅ data/index.html - Added weather section
✅ data/js/settings.js - Added weather handlers
✅ Filesystem uploaded to device (COM24)


What Happens When You Save

Click Save
    ↓
Browser POSTs to /api/config
    ↓
Device stores settings
    ↓
Settings applied immediately (no restart!)
    ↓
Next weather fetch uses new settings
    ↓
HOME page updates
    ↓
You see weather! ✅

Next Step

NOW:

  1. Go to: http://[device-ip]/
  2. Click: Settings
  3. Find: "Weather & Time" (NEW!)
  4. Configure it
  5. Save
  6. Check HOME page

RESULT:

✅ Weather displays on LCD
✅ Clock shows correct time
✅ Settings saved permanently


Support

Full Documentation: See WEATHER_TIMEZONE_SETTINGS_GUIDE.md

Visual Guide: See VISUAL_WEATHER_TIMEZONE_GUIDE.md


Status: 🟢 READY TO USE

Weather and timezone settings are now:

  • ✅ Visible in web UI
  • ✅ Easy to configure
  • ✅ Applied immediately
  • ✅ Saved to device
  • ✅ Ready to make weather appear on your LCD!