ATMOS

Battery-powered e-paper weather station with captive-portal Wi-Fi setup.

Contents

1. Introduction

ATMOS displays weather forecast data and combines it with indoor temperature, humidity, and pressure measured by its built-in BME280 sensor. After setup it works autonomously: wake up, fetch data, redraw the e-paper display, then return to deep sleep.

Supported languages are English, Deutsch, Čeština, Polski, and Slovenčina.

2. First startup

1. After power-on, the ATMOS startup screen appears.
2. If no home Wi-Fi is stored yet, the device creates its own hotspot.
3. The display shows a prompt and QR code for a network named ATMOS-XXXXXXXXXXXX.
4. Once a client connects, the configuration page becomes available at 192.168.4.1.

3. Wi-Fi and location setup

Fill in these fields in the web interface:

You do not need to enter coordinates or altitude manually. Firmware resolves them automatically after saving.

Once submitted, the configuration is stored in ESP32 internal preferences, the station connects to your Wi-Fi, and starts loading weather data.

4. Display overview

The display is divided into several horizontal blocks, stacked from top to bottom:

Header bar (black background)

• Day number — large numeral on the left.
• Day name — full weekday name (e.g. Monday) above a dashed line.
• Month and year — below the dashed line.
• Name day — shown on the right side, below the dashed line.
• Location — city name with a red dot marker, upper right area.
• Status icons — top right corner: last fetch time, next update interval, Wi-Fi signal strength (filled bars), and battery level.

Current weather (hero section)

• Weather icon — large icon on the left, shown in red when it is raining/snowing.
• Temperature — large number with °C on the right, shown in red when below zero.
• Condition text — description of current weather centered below the icon.
• Feels-like temperature — on the right side of the same row.
• Wind — bottom left: direction arrow icon and speed in km/h.
• Sun / Moon — bottom right: during the day sunrise and sunset times with icons; at night moon phase icon, phase name, and illumination percentage.

Advice bar (black background)

• Two-line weather tip or recommendation based on current conditions (e.g. "Take an umbrella" or "Great weather for a walk"). The two lines are separated by a dashed line.

Hourly chart / Weather radar

• Hourly chart — 24-hour temperature curve (black) with precipitation bars (red). Left axis shows temperature in °C, right axis shows rain in mm. Min and max points are highlighted with tooltips showing the value and time. Time labels appear on the bottom axis.
• Weather radar — when precipitation is forecast within the next few hours, the chart is automatically replaced by a live radar map. The map shows your location at the center with a red dot, country and regional borders, city labels, and rain intensity rendered in red (lighter = light rain, denser = heavy rain).

Five-day forecast

• Five columns, one per day. Each column shows: abbreviated day name (Sunday in red), weather icon, high temperature (large), low temperature (smaller), and °C units. Columns are separated by dashed vertical lines.
• Today's column is highlighted with an inverted color scheme (white on black) and a red bottom stripe.
• When rain is expected, a red badge with the probability percentage appears next to the weather icon.

Indoor sensors (shown when BME280 is connected)

• Three columns: Indoor temperature (°C with trend arrow and change), Humidity (% with comfort label and dew point), and Pressure (hPa with state and trend).
• Trend values are shown in red when changing, black when stable.

5. Daily operation

• During daytime, ATMOS refreshes every full hour.
• When precipitation is forecast, the refresh interval shortens to 15 minutes so the radar map stays current.
• At night it uses longer intervals to save battery.
• After each refresh it redraws the e-paper panel and returns to deep sleep.
• If Wi-Fi is temporarily unavailable, it can keep showing cached data and retry after 5 minutes.
• After five failed Wi-Fi attempts it returns to setup mode.

6. Changing settings later

1. Press the RESET button.
2. The station boots again, refreshes, and temporarily exposes its service web interface.
3. The display shows both its own hotspot and the local IP address on your home network.
4. You can either join the ATMOS hotspot or open the shown local IP in a browser.

The temporary service interface remains available for roughly 5 minutes.

7. Factory reset

Firmware uses a confirmed reset sequence so configuration is not erased by mistake.

1. Press RESET once.
2. During the startup screen, roughly within the next 5 seconds, press RESET again.
3. On the following boot, stored settings and local cache are erased.

8. Battery and power

• Battery level is measured internally through ADC and shown as percentage.
• When battery is low, the station asks for charger connection.
• Below roughly 10%, the device sleeps to protect battery and avoid unstable behavior.
• Use external power for initial setup, longer service sessions, or development work.

9. Firmware and service

Firmware updates happen automatically. Just press the RESET button — on boot the station connects to Wi-Fi, checks whether a newer firmware is available, and installs it if so.

Updates only run when the battery is sufficiently charged (above 90 %). For safety, connect the charger before updating.

10. Troubleshooting

11. Technical specifications

• MCU: ESP32, 16 MB flash
• Display: 7.5" BWR 800x480 physical panel, rotated to 480x800 portrait; optional 10.2" 960x640
• Sensors: BME280 for indoor temperature, humidity, and pressure
• Weather radar: RainViewer (public API), shown automatically when precipitation is forecast; includes vector basemap with country and regional borders
• Geocoding: Nominatim (OpenStreetMap)
• Local cache: LittleFS
• Languages: EN, DE, CS, PL, SK