W praktyce masz dwie drogi:

1. Tryb aktywny (active) – urządzenie (np. Raspberry Pi Zero 2 W / 2 W z Bluetooth) łączy się z czujnikiem po BLE i odczytuje dane przez GATT.
2. Tryb pasywny (advertising) – czujnik rozgłasza dane w reklamach BLE, a odbiornik tylko nasłuchuje (bez parowania i bez utrzymywania połączeń).

Tryb aktywny: szybki start, większe zużycie baterii​

W trybie aktywnym Raspberry Pi działa jak “klient” BLE: nawiązuje połączenie z czujnikiem i pobiera pomiary.

Plusy

• Bardzo szybki start (szczególnie jeśli już masz RPi z Bluetooth).
• Dobra kontrola nad tym, kiedy i jak często pobierasz dane.

Minusy

• Częstsze łączenie się i wymiana danych zwykle oznacza szybsze rozładowanie baterii w czujniku.
• Przy większej liczbie czujników rośnie koszt “utrzymania” połączeń (czas, zakłócenia, kolejki).

Tryb pasywny (advertising): najlepszy kompromis baterii i skali​

W trybie pasywnym czujnik nadaje dane w reklamach BLE, a odbiornik tylko nasłuchuje. W realnym domu/mieszkaniu to zwykle wygrywa: mniejsze obciążenie i łatwiejsze skalowanie.

Kluczową ideą jest zmiana firmware na taki, który rozgłasza dane (np. ATC / PVVX), dzięki czemu:

• odbiornik nie musi łączyć się z czujnikiem,
• nie ma ciągłej “interakcji” dwóch urządzeń BLE,
• bateria w czujniku zwykle trzyma dłużej.

Krok wymagany do trybu pasywnego: Mi Home + token/bindkey​

Żeby podmienić firmware w LYWSD03MMC bez lutowania, typowy flow wygląda tak:

1. Dodaj czujnik do Xiaomi Mi Home (powiązanie urządzenia z kontem).
2. Wyciągnij dane dostępowe (tokeny / bindkey) przez token extractor.
3. Użyj webowego flashera po BLE (TelinkMiFlasher) i wgraj firmware nadający (np. PVVX).

Uwaga: szczegóły zależą od wersji czujnika i aktualnego firmware – zawsze czytaj instrukcję dla swojej wersji.

Flashowanie: TelinkMiFlasher (PVVX)​

Flasher działa z poziomu przeglądarki (Web Bluetooth; najlepiej Chrome), więc nie potrzebujesz programatora ani lutowania:

• https://pvvx.github.io/ATC_MiThermometer/TelinkMiFlasher.html

Po poprawnym flashu możesz ustawić tryb rozgłaszania (advertising) i parametry emisji.

Most BLE → MQTT: ESP32 albo Raspberry Pi​

Po stronie “odbiornika” masz dwa typowe warianty:

• ESP32 (np. OpenMQTTGateway) robi skan BLE i publikuje dane do MQTT.
• Raspberry Pi skanuje BLE lokalnie i publikuje dane do MQTT (lub uruchamia gateway, który to robi).

Nettemp (przez nettemp config) potrafi tę konfigurację spiąć tak, żeby finalnie dane lądowały w brokerze MQTT, a potem w Nettemp Cloud / Docker.

Mini‑checklista (skrót)​

1) Dodanie do Xiaomi Mi Home​

• Dodaj czujnik w aplikacji Mi Home (powiązanie z kontem jest potrzebne do uzyskania kluczy).

2) Token extractor (token/bindkey)​

• https://github.com/PiotrMachowski/Xiaomi-cloud-tokens-extractor

3) Flash PVVX przez TelinkMiFlasher​

• Wejdź na: https://pvvx.github.io/ATC_MiThermometer/TelinkMiFlasher.html
• Connect
• Podaj token oraz BLE KEY / bindkey (jeśli wymagane w Twoim wariancie)
• Start flashing
• Po sukcesie: połącz się ponownie (Connect) i ustaw parametry rozgłaszania, np.:
  • Advertising type: ATC1441
  • AdFlags
  • (opcjonalnie) Get name / Set name
• Send Config → Disconnect

• ESP32 z OpenMQTTGateway (aktywny skan BLE, uplink Wi‑Fi)
• Raspberry Pi z Bluetooth uruchamiający nettemp client + nettemp config (pasywny nasłuch BLE)

Oba sposoby dają ten sam efekt—dane z czujników BLE trafiają do Nettemp przez MQTT—różni się tylko sprzęt, który nasłuchuje.

Wgrywanie OpenMQTTGateway na ESP32​

1. Wejdź na https://docs.openmqttgateway.com/upload/web-install.html
2. Podłącz ESP32 przez USB.
3. Wybierz esp32dev-ble.
4. Połącz się z tymczasowym Wi‑Fi rozgłaszanym przez ESP32.
5. W instalatorze ustaw Wi‑Fi oraz IP/host brokera MQTT (trzeba zrobić to teraz; później edycja jest zablokowana w 1.8.0/1.8.1).
6. Zakończ instalację i zrestartuj ESP32.

Uruchomienie na Raspberry Pi​

Jeśli masz Raspberry Pi z Bluetooth, możesz wszystko zrobić na jednym urządzeniu:

• Uruchom nettemp client i w nettemp config włącz most MQTT oraz reguły subskrypcji.
• Pozwól, aby pasywnie nasłuchiwał beaconów BLE i wysyłał odczyty do brokera MQTT w Nettemp.

Znane problemy i wskazówki​

• Problemy z flashowaniem w Chrome? Uruchom Chrome ponownie i spróbuj jeszcze raz w web-installerze.
• Ustaw IP serwera MQTT podczas konfiguracji Wi‑Fi—później nie da się tego zmienić w OMG 1.8.0/1.8.1.
• W nettemp config możesz automatycznie wykryć tematy, zapisać subskrypcje oraz ustawic czas co jaki dane maja wpadac do nettemp.

linki​

https://github.com/1technophile/OpenMQTTGateway

• MQTT dwukierunkowo: Nettemp Client odbiera dane z bezprzewodowych urządzeń (np. ESP z firmware ESP Mega) i przekazuje je do Nettemp Docker lub Nettemp Cloud. Może też publikować własne odczyty na brokerze.
• Szersze wsparcie Xiaomi: Dodaje obsługę czujnika temperatury i wilgotności Xiaomi Mi Temperature Humidity Monitor 2 (LYWSD03MMC). Wystarczy włączyć sensor i pozwolić Nettemp go wykryć. Nie trzeba aktywować w aplikacji Xiaomi. Świetnie sprawdza się Raspberry Pi Zero 2W z wbudowanym Bluetooth.
• Prostsza konfiguracja nettemp_client: Przejrzyste ustawienia dzieki Nettemp Client Installation. Umożliwia włączenie MQTT, wybór serwera, przegląd wykrytego czujnika i aktywację tylko potrzebnych opcji.

What is NetTemp?​

NetTemp is an IoT sensor monitoring platform designed for Raspberry Pi and Linux devices. It combines:

• Easy hardware support - 22+ sensor types, plug-and-play
• Real-time dashboards - See your data instantly
• Smart alarms - Get notified before problems occur
• Cloud or self-hosted - You choose where your data lives

What You'll Need​

1. Hardware

   • Raspberry Pi (any model) or Linux device
   • At least one sensor (DHT22, BME280, DS18B20, etc.)
   • MicroSD card with Raspberry Pi OS

2. Account

   • Free NetTemp account at app.nettemp.pl

3. Time

   • About 10 minutes for initial setup

Step-by-Step Setup​

1. Create Your Account​

Head to app.nettemp.pl and register:

Email: your@email.com
Password: ••••••••

After registering, verify your email. You'll be redirected to the dashboard.

2. Get Your API Key​

In the dashboard:

1. Click Settings → API Tokens
2. Click Generate New Token
3. Give it a name like "Living Room Pi"
4. Copy the token (starts with ntk_)

⚠️ Important: Save this token! You'll need it in step 4.

3. Install Client on Raspberry Pi / Linux​

📖 For detailed setup with interactive configuration tool, see the Nettemp Client Installation documentation

The installation guide covers everything: automatic setup, sensor configuration, hardware discovery, and troubleshooting.

View Your Data​

Back in your browser, go to app.nettemp.pl:

Overview Tab​

You'll see a tile for your device showing:

• Device name ("living-room-1")
• Latest sensor readings
• Last update time
• Green status badge (online)

Click the tile to see all sensors from this device.

Charts Tab​

Click Charts to visualize your data:

• Select sensor(s) to plot
• Choose time range (1h, 6h, 24h, 7d, 30d)
• Zoom and pan to explore
• Hover to see exact values

My View Tab​

Create a custom dashboard:

1. Click My View → Edit Mode
2. Click + Add Value Tile
3. Select your sensor
4. Drag to position
5. Click Save

You can add gauges, mini charts, and floor plans too!

What's Next?​

Now that you have data flowing, here are some ideas:

Set Up Alarms​

Get notified when temperature goes too high:

1. Go to Alarms tab
2. Click New Alarm
3. Configure:
   • Sensor: living-room-1 → Temperature
   • Condition: Temperature > 25°C
   • Cooldown: 60 minutes
4. Add notification:
   • Channel: Email
   • Template: Default
5. Click Save

Now you'll get an email if temperature exceeds 25°C!

Add More Sensors​

See the Client Installation Guide for 22+ supported sensor types and configuration examples.

Create Floor Plans​

If you have a floor plan image:

1. Go to My View → Edit Mode
2. Upload floor plan (Settings → Devices → Upload Plan)
3. Add Plan Tile to your dashboard
4. Position sensors on the plan
5. See real-time status on your floor plan!

Export Data​

Need your data in Excel/CSV?

1. Go to Charts
2. Select sensor and time range
3. Click Export CSV
4. Open in Excel, Google Sheets, etc.

Troubleshooting​

Having issues? The interactive configuration tool can help diagnose problems:

nettemp config

Use the tool's features:

• Discover Devices - Check if sensors are detected
• Test Sensor Readings - Verify sensors are working
• System Management → Check Status - See if client is running

For detailed troubleshooting steps, see the Client Installation Guide.

Getting Help​

Stuck? We're here to help!

• Documentation: Full guides at nettemp.pl
• Discord: Live chat at discord.gg/S4egxNvQHM

Next Steps​

Explore the NetTemp Cloud dashboard to discover all features including sensor configuration, alarm setup, custom dashboards, and API integration.

Welcome to the NetTemp community! 🎉

We can't wait to see what you build. Share your setup in our Discord!