Brzi početak
Ova pločica očitava temperaturu, relativnu vlažnost i tlak preko I2C-a. Spojite je, instalirajte biblioteku i pokrenite njezin primjer da biste vidjeli sva očitanja na računalu. Za ovu pločicu postoje i Arduino biblioteka i MicroPython modul, pa odaberite karticu koja odgovara vašem kontroleru.
Programirate kontroler spojen na ovu pločicu. Sama pločica se ne programira.
- Arduino
- MicroPython
1. Spojite pločicu
Priključite Qwiic kabel u bilo koji od Qwiic konektora na pločici i u odgovarajući konektor na kontroleru. Lemljenje nije potrebno, a drugi Qwiic konektor ostaje slobodan za ulančavanje još jedne Qwiic pločice.
| Kontroler | Environmental Sensor BME280 Breakout |
|---|---|
| Qwiic konektor | Bilo koji Qwiic konektor |

Bez Qwiica: spajanje na breadboardu
Ako vaš kontroler nema Qwiic konektor, zalemite priloženi header i umjesto toga spojite pločicu na njegove I2C pinove:
| Kontroler | Environmental Sensor BME280 Breakout |
|---|---|
| I2C podaci (SDA) | SDA |
| I2C takt (SCL) | SCL |
| 3,3 V ili 5 V | VCC |
| GND | GND |
Header radi s kontrolerima od 3,3 V i od 5 V: regulator na pločici daje 3,3 V za senzor, a pretvarač razina prilagođava dvije I2C linije.
2. Instalirajte biblioteku
Otvorite Library Manager u Arduino IDE-u, potražite BME280 i instalirajte biblioteku Soldered BME280 i BME680. Možete je preuzeti i s izvora navedenog u nastavku.
🔗Soldered BME280 i BME680 Arduino biblioteka
Provjerena Arduino biblioteka na commitu 64eae4d
Savjet: preuzimanje s GitHuba. Na GitHub stranici biblioteke kliknite zeleni gumb Code i odaberite Download ZIP, a zatim dodajte datoteku u Arduino IDE putem Sketch → Include Library → Add .ZIP Library....
3. Pokrenite prvi primjer
Ovo je BME280_Read_All_Values.ino, izvorni primjer biblioteke za ovu pločicu.
Ispisuje sva očitanja koja senzor nudi, najprije jednu po jednu vrijednost, a zatim
sve iz jednog mjerenja, jednom u sekundi.
#include "BME280-SOLDERED.h"
// Declare your sensors here
BME280 bme280;
void setup()
{
// Initialize the sensors
Serial.begin(115200);
// Initialize the sensors
bme280.begin();
}
void loop() // Temperature is not factory calibrated, you can add offset to it
{
float offset = 0; // offset in °C
Serial.println("Reading one by one: ");
float temperature = bme280.readTemperature() + offset;
Serial.print("Temperature: ");
Serial.println(temperature);
float humidity = bme280.readHumidity();
Serial.print("Humidity: ");
Serial.println(humidity);
float pressure = bme280.readPressure();
Serial.print("Pressure: ");
Serial.println(pressure);
float altitude = bme280.readAltitude();
Serial.print("Altitude: ");
Serial.println(altitude);
delay(1000);
Serial.println("\nReading all at once: ");
float temperature2, humidity2, pressure2;
bme280.readSensorData(temperature2, humidity2, pressure2);
Serial.print("Temperature: " + String(temperature2 + offset) + " C");
Serial.println();
Serial.print("Humidity: " + String(humidity2) + " %");
Serial.println();
Serial.print("Pressure: " + String(pressure2) + " hPa");
Serial.println();
// We need to caluclate altitude from pressure and sea level pressure
float altitude2 = bme280.calculateAltitude(pressure2);
Serial.print("Altitude: " + String(altitude2) + " m");
Serial.println();
Serial.println();
}
4. Provjerite rezultat
Otvorite Serial Monitor na 115200 bauda. Otprilike jednom u sekundi vidjet ćete blok poput ovoga:
Reading one by one:
Temperature: 23.30
Humidity: 46.00
Pressure: 1002.40
Altitude: 90.73
Reading all at once:
Temperature: 23.30 C
Humidity: 46.00 %
Pressure: 1002.38 hPa
Altitude: 90.90 m
Prva četiri retka ispisuju same brojeve, sljedeća četiri dodaju mjerne jedinice, a blok se ponavlja otprilike jednom u sekundi. Oznake potječu iz samog primjera, pa je oblik ispisa točan. Brojevi su ilustrativan primjer za Osijek u Hrvatskoj: oko 23 °C, 46 % relativne vlažnosti i 1002,4 hPa. U odnosu na referentnu vrijednost biblioteke od 1013,25 hPa taj tlak odgovara visini od oko 90 m, što je blizu stvarne nadmorske visine Osijeka. Vaša očitanja ovise o prostoriji i vremenskim prilikama.
5. Ako ne radi
Nastavite s Rješavanjem problema i nakon svake promjene ponovno pokrenite ovaj najmanji primjer.
1. Spojite pločicu
Priključite Qwiic kabel u bilo koji od Qwiic konektora na pločici i u odgovarajući konektor na kontroleru, točno kao u kartici Arduino.
| Kontroler | Environmental Sensor BME280 Breakout |
|---|---|
| Qwiic konektor | Bilo koji Qwiic konektor |

Bez Qwiica: spajanje na breadboardu
Spojite header kao u kartici Arduino:
| Kontroler | Environmental Sensor BME280 Breakout |
|---|---|
| I2C podaci (SDA) | SDA |
| I2C takt (SCL) | SCL |
| 3,3 V ili 5 V | VCC |
| GND | GND |
Modul već zna brojeve pinova za ESP32 i ESP8266 (SCL na GPIO22, SDA na GPIO21) i koristi ih kada senzor stvorite bez argumenata. Na bilo kojoj drugoj pločici stvorite vlastiti I2C objekt i predajte ga:
i2c = I2C(0, scl=Pin(22), sda=Pin(21))
bme280 = BME280(i2c)
Isti postupak koristite i ako želite drugu I2C sabirnicu ili druge pinove.
2. Instalirajte modul
Instalirajte Soldered BME280 MicroPython Library pomoću mpremote, naredbom
iz README datoteke samog modula:
mpremote mip install github:SolderedElectronics/Soldered-BME280-MicroPython-Library
Na Windowsu:
python -m mpremote mip install github:SolderedElectronics/Soldered-BME280-MicroPython-Library
🔗Soldered BME280 MicroPython Library
Provjereni MicroPython modul na commitu ea39509
Savjet: preuzimanje s GitHuba. Bez mpremote otvorite .py
datoteku modula na GitHubu i kliknite Download raw file, zatim je otvorite u Thonnyju i
odaberite File → Save as... → MicroPython device da biste je kopirali na pločicu.
3. Pokrenite prvi primjer
Ovo je bme280-allValues.py, izvorni primjer modula, a njegovo zaglavlje navodi
ovu pločicu. Očitava sva tri mjerenja, pretvara tlak u nadmorsku visinu
i ponavlja se svakih 5 sekundi. Spremite ga na pločicu i pokrenite.
# FILE: bme280-allValues.py
# AUTHOR: Josip Šimun Kuči @ Soldered
# BRIEF: An example for the BME280 sensor that reads temperature, humidity,
# pressure and calculates the altitude using the pressure measurement
# WORKS WITH: Enviromental sensor BME280 breakout: www.solde.red/333036
# LAST UPDATED: 2025-05-23
from machine import Pin, I2C
from bme280 import BME280
import time
# If you aren't using the Qwiic connector, manually enter your I2C pins
# i2c = I2C(0, scl=Pin(22), sda=Pin(21))
# bme280 = BME280(i2c)
# Initialize sensor over Qwiic
bme280 = BME280()
# Infinite loop
while 1:
# Read the temperature, humidity and pressure values and store them in their respective variables
temp, pres, hum = bme280.readAllValues()
# Calculate the altitude using the pressure read by the sensor
altitude = bme280.calculateAltitude()
# Print the measured values, each in their own line
print("Temperature: {:.2f} °C".format(temp))
print("Pressure: {:.2f} hPa".format(pres))
print("Humidity: {:.2f} %".format(hum))
print("Altitude: {:.2f} m".format(altitude))
# Pause for 5 seconds
time.sleep(5.0)
4. Provjerite rezultat
Modul ispisuje četiri retka svakih 5 sekundi u Thonny ljusci ili serijskoj konzoli:
Temperature: 23.30 °C
Pressure: 1002.40 hPa
Humidity: 46.00 %
Altitude: 90.73 m
Svaki redak je jedan od print() poziva iz samog primjera, s vrijednošću na dvije
decimale, pa je oblik ispisa točan. Brojevi su ilustrativan primjer za
Osijek u Hrvatskoj: oko 23 °C, 46 % relativne vlažnosti i 1002,4 hPa. U odnosu na
referentnu vrijednost biblioteke od 1013,25 hPa taj tlak odgovara visini od oko 90 m, što je blizu
stvarne nadmorske visine Osijeka. Vaša očitanja ovise o prostoriji i vremenskim prilikama.
5. Ako ne radi
Nastavite s Rješavanjem problema i nakon svake promjene ponovno pokrenite ovaj najmanji primjer.