Rehberler · 8 dk okuma

Raspberry Pi Pico W MQTT: umqtt ile Sensör ve LED Kontrolü

Raspberry Pi Pico W ile MQTT nasıl kullanılır? MicroPython umqtt kurulumu, ücretsiz broker, sıcaklık yayınlama, LED'e abone olma ve Home Assistant bağlantısı.

Raspberry Pi Pico W ile MQTT, kartını internete bağlayıp sensör verisi göndermenin ve uzaktan komut almanın en hafif ve en yaygın yoludur. MicroPython'daki umqtt.simple kütüphanesiyle Pico W birkaç satır kodla bir MQTT broker'ına bağlanır, ölçtüğü sıcaklığı bir konuya (topic) yayınlar ve başka bir konuya abone olarak gelen "ON" ya da "OFF" mesajlarıyla LED'i yakıp söndürür. Web sunucusu kurmaya, modemde port açmaya ya da kartın IP adresini ezberlemeye gerek kalmaz; telefon, bilgisayar ve Home Assistant aynı broker üzerinden kartınla konuşur.

Bu rehberde önce MQTT'nin mantığını ve temel kavramlarını öğreneceksin. Ardından umqtt kütüphanesini kuracak, ücretsiz bir genel broker'a bağlanacak, Pico W kartının dahili sıcaklık sensöründen okuduğun değeri on saniyede bir yayınlayacak ve dahili LED'i uzaktan kontrol edeceksin. Son olarak kodu, Wi-Fi ya da broker bağlantısı koptuğunda kendini otomatik toparlayacak hâle getirecek ve kartı MQTT Discovery ile Home Assistant'a tek satır YAML yazmadan ekleyeceksin.

Raspberry Pi Pico mikrodenetleyici kartı
Raspberry Pi Pico kartı. MQTT için kablosuz yongalı W sürümü (Pico W ya da Pico 2 W) gerekir; ek bir Wi-Fi modülüne ihtiyaç yoktur.

MQTT nedir, nasıl çalışır?

MQTT (Message Queuing Telemetry Transport), düşük bant genişliği ve sınırlı işlem gücü olan cihazlar için tasarlanmış bir yayınla/abone ol (publish/subscribe) mesajlaşma protokolüdür. Sistemin ortasında broker adı verilen bir sunucu durur. Cihazlar birbirine doğrudan bağlanmaz; her biri broker'a bir TCP bağlantısı açar (şifresiz bağlantıda port 1883, TLS ile 8883). Bir cihaz "bluegrays/picow/sicaklik" gibi bir konuya mesaj yayınladığında broker bu mesajı o konuya abone olan herkese iletir. Böylece Pico W, mesajı kimin okuyacağını bilmek zorunda kalmaz; bir telefon uygulaması, bir veri kaydedici ve Home Assistant aynı anda aynı veriyi alabilir. Bir MQTT paketinin sabit başlığı yalnızca 2 bayttır; bu yüzden HTTP isteklerine göre çok daha az veri ve enerji harcar.

KavramAnlamıÖrnek
BrokerMesajları alan ve abonelere dağıtan sunucuMosquitto, HiveMQ, EMQX
Client (istemci)Broker'a bağlanan her cihaz ya da uygulamaPico W, telefon, Home Assistant
Topic (konu)Mesajın gönderildiği, / ile ayrılmış adresbluegrays/picow/sicaklik
Publish (yayınla)Bir konuya mesaj göndermek"23.4" değerini gönder
Subscribe (abone ol)Bir konuya gelen mesajları dinlemekbluegrays/picow/led
QoSTeslim garantisi: 0 en fazla bir kez, 1 en az bir kez, 2 tam bir kezumqtt.simple 0 ve 1'i destekler
RetainBroker son mesajı saklar, yeni abone bağlanınca hemen gönderirLED'in son durumu
Last Will (LWT)Cihaz beklenmedik şekilde koparsa broker'ın yayınlayacağı mesaj"offline"
Keepaliveİstemcinin en geç kaç saniyede bir paket göndereceği60

Konular klasör yolu gibi düşünülür ve büyük-küçük harfe duyarlıdır. Abone olurken iki joker karakter kullanabilirsin: + tek bir seviyenin yerini tutar ("ev/+/sicaklik" hem "ev/salon/sicaklik" hem "ev/mutfak/sicaklik" konularını yakalar), # ise kalan tüm seviyeleri kapsar ve yalnızca en sonda kullanılır ("ev/#"). Yayın yaparken joker karakter kullanılamaz. Konu adlarında boşluk ve Türkçe karakter kullanmamak, farklı istemciler arasında sorun çıkma ihtimalini azaltır.

Gerekenler ve Pico W bağlantıları

  • Raspberry Pi Pico W ya da Pico 2 W: Kablosuz yongası olmayan düz Pico ile MQTT kullanılamaz.
  • MicroPython firmware'i: W sürümü için hazırlanmış .uf2 dosyası. Kurulum adımları Raspberry Pi Pico Nedir? yazısında anlatılıyor.
  • Thonny ya da başka bir MicroPython editörü ve veri aktarabilen bir micro USB kablo.
  • 2,4 GHz Wi-Fi ağı: Pico W 5 GHz ağlara bağlanamaz.
  • Bir MQTT istemcisi: Test için bilgisayarda MQTT Explorer ya da telefonda bir MQTT panel uygulaması.
  • İsteğe bağlı: harici LED ve 220 Ω direnç, DHT22 ya da BME280 gibi harici bir sensör, bir röle modülü.
BileşenPico W bağlantısıNot
Dahili LEDPin("LED")Kablosuz yonga üzerinden sürülür, GP25 değildir
Dahili sıcaklık sensörüADC(4)Kablo gerekmez; yonganın kendi sıcaklığını ölçer
Harici LEDGP15 → 220 Ω → LED anot, katot → GNDKodda Pin(15, Pin.OUT)
DHT22 veri piniGP16 (VCC → 3V3, GND → GND)MicroPython'daki dht modülüyle okunur
Röle modülü INGP143,3 V ile tetiklenebilen bir modül seç
Kablosuz yongaya ayrılmış pinlerGPIO23, 24, 25, 29Kart dışına çıkmaz, başka işe kullanılamaz
Düz Pico'da dahili LED GP25'e bağlıdır, ama Pico W kartında GP25 kablosuz yonganın iletişim hattında kullanılır. Bu kartta Pin(25) yazarsan LED yanmaz, üstelik Wi-Fi iletişimini bozabilirsin. Dahili LED için her zaman Pin("LED", Pin.OUT) kullan. Harici LED bağlayacaksan direnç değerini LED direnci hesaplayıcısı ile 3,3 V'a göre seç.

umqtt kütüphanesini kurmak

  1. Kartı BOOTSEL tuşuna basılıyken bilgisayara bağla ve W sürümüne özel MicroPython .uf2 dosyasını açılan RPI-RP2 sürücüsüne kopyala.
  2. Thonny'de sağ alttan yorumlayıcı olarak MicroPython (Raspberry Pi Pico) seç ve kabuğa from umqtt.simple import MQTTClient yaz. Hata almıyorsan kütüphane firmware içinde gelmiştir, kuruluma gerek yok.
  3. ImportError alırsan aşağıdaki kodla kartı Wi-Fi ağına bağla ve mip ile kütüphaneyi doğrudan internetten indir.
  4. Alternatif olarak Thonny'deki Araçlar > Paketleri Yönet menüsünden micropython-umqtt.simple paketini arayıp kurabilirsin.
  5. Kurulumdan sonra Pico'nun dosya sisteminde /lib/umqtt/simple.py dosyasını görmelisin.
Python
1import network
2import time
3import mip
4
5wlan = network.WLAN(network.STA_IF)
6wlan.active(True)
7wlan.connect("WIFI_ADIN", "WIFI_SIFREN")   # kendi ağ bilgilerin / your network credentials
8
9while not wlan.isconnected():
10    print("Baglaniyor... / Connecting...")
11    time.sleep(1)
12
13print("IP:", wlan.ifconfig()[0])
14mip.install("umqtt.simple")                 # /lib/umqtt/simple.py olarak kurulur / installed as /lib/umqtt/simple.py
15mip.install("umqtt.robust")                 # isteğe bağlı / optional
umqtt.robust, umqtt.simple kütüphanesinin üzerine kurulu küçük bir katmandır: yayın ya da mesaj bekleme sırasında bağlantı koparsa otomatik olarak yeniden bağlanmayı dener. Ancak temiz oturumla (clean session) bağlandığında abonelikleri kendiliğinden yenilemez. Bu rehberde yeniden bağlanmayı kendimiz yazıyoruz; böylece Wi-Fi bağlantısının da koptuğu durumları kontrol edebilir ve abonelikleri her seferinde yeniden kurabiliriz.

Ücretsiz MQTT broker seçmek

Başlamak için kendi sunucunu kurman gerekmez. Birçok şirket test amaçlı herkese açık broker'lar çalıştırır; bunlar kullanıcı adı ve şifre istemez, kartı bağlayıp birkaç dakika içinde ilk mesajını gönderebilirsin. Kalıcı bir proje için ise evdeki bir Raspberry Pi'ye, eski bir bilgisayara ya da Home Assistant'a Mosquitto kurmak en sağlam yoldur: veriler evinin içinde kalır ve internet kesilse bile yerel ağdaki cihazlar birbirine mesaj göndermeye devam eder.

BrokerAdresPortNot
HiveMQ genel brokerbroker.hivemq.com1883 (TCP)Kayıt yok, herkese açık
Eclipse Mosquitto test sunucusutest.mosquitto.org1883 (şifresiz), 8883 (TLS)Kayıt yok, herkese açık
EMQX genel brokerbroker.emqx.io1883 (TCP), 8883 (TLS)Kayıt yok, herkese açık
Home Assistant Mosquitto eklentisiHome Assistant'ın yerel IP adresi1883Kullanıcı adı ve şifre gerekir
Kendi Mosquitto sunucunRaspberry Pi ya da bilgisayarın IP adresi1883Tam kontrol, yerel ağda çalışır
Genel broker'lar herkese açıktır: senin konuna başkası da abone olabilir ya da mesaj gönderebilir. Konu adına kendine özgü bir ön ek ekle (örneğin adının baş harfleri ve rastgele birkaç rakam), şifre ya da kişisel bilgi gönderme ve kapı kilidi, priz gibi gerçek cihazları genel broker üzerinden kontrol etme.

Adım adım: sıcaklık yayınla, LED'e abone ol

Aşağıdaki program dört işi bir arada yapar: Wi-Fi ağına bağlanır, broker'a benzersiz bir istemci kimliğiyle bağlanır, bluegrays/picow/led konusuna abone olur ve dahili sıcaklık sensörünün değerini on saniyede bir bluegrays/picow/sicaklik konusuna yayınlar. LED konusuna "ON" gelirse LED yanar, "OFF" gelirse söner ve yeni durum retain bayrağıyla ayrı bir konuya bildirilir. Dosyayı Thonny'de main.py adıyla Pico'ya kaydedersen kart her açıldığında program kendiliğinden başlar.

MicroPython
1import network
2import time
3import machine
4import binascii
5from machine import Pin, ADC
6from umqtt.simple import MQTTClient
7
8SSID = "WIFI_ADIN"                 # Wi-Fi ağ adın / your Wi-Fi name
9PASSWORD = "WIFI_SIFREN"           # Wi-Fi şifren / your Wi-Fi password
10BROKER = "broker.hivemq.com"       # ücretsiz genel broker / free public broker
11PORT = 1883
12MQTT_USER = None                   # Home Assistant için kullanıcı / user for Home Assistant
13MQTT_PASS = None                   # Home Assistant için şifre / password for Home Assistant
14
15CLIENT_ID = b"picow-" + binascii.hexlify(machine.unique_id())   # benzersiz kimlik / unique client id
16TOPIC_TEMP = b"bluegrays/picow/sicaklik"
17TOPIC_LED = b"bluegrays/picow/led"
18TOPIC_LED_STATE = b"bluegrays/picow/led/durum"
19TOPIC_STATUS = b"bluegrays/picow/durum"
20PUBLISH_MS = 10000                 # 10 saniyede bir yayınla / publish every 10 s
21
22led = Pin("LED", Pin.OUT)          # Pico W dahili LED / Pico W onboard LED
23sensor = ADC(4)                    # dahili sıcaklık sensörü / internal temperature sensor
24wlan = network.WLAN(network.STA_IF)
25client = None
26pending_state = None               # bildirilecek LED durumu / LED state to report
27
28
29def read_temp():
30    voltage = sensor.read_u16() * 3.3 / 65535
31    return 27 - (voltage - 0.706) / 0.001721
32
33
34def wifi_connect():
35    wlan.active(True)
36    if wlan.isconnected():
37        return
38    wlan.connect(SSID, PASSWORD)
39    for _ in range(20):            # en fazla 20 saniye bekle / wait up to 20 s
40        if wlan.isconnected():
41            print("IP:", wlan.ifconfig()[0])
42            return
43        time.sleep(1)
44    raise OSError("Wi-Fi baglanamadi / Wi-Fi failed")
45
46
47def on_message(topic, msg):
48    global pending_state
49    print("Mesaj / Message:", topic, msg)
50    if topic == TOPIC_LED:
51        if msg == b"ON":
52            led.on()
53            pending_state = b"ON"
54        elif msg == b"OFF":
55            led.off()
56            pending_state = b"OFF"
57
58
59def mqtt_connect():
60    c = MQTTClient(CLIENT_ID, BROKER, port=PORT, user=MQTT_USER,
61                   password=MQTT_PASS, keepalive=60)
62    c.set_callback(on_message)
63    c.set_last_will(TOPIC_STATUS, b"offline", retain=True)   # koparsa broker yayınlar / broker sends it on drop
64    try:
65        c.connect()
66    except Exception:
67        try:
68            c.sock.close()         # yarım kalan soketi kapat / close the half-open socket
69        except Exception:
70            pass
71        raise
72    c.subscribe(TOPIC_LED)
73    c.publish(TOPIC_STATUS, b"online", retain=True)
74    return c
75
76
77def reconnect():
78    global client
79    delay = 2
80    while True:
81        if client:
82            try:
83                client.sock.close()
84            except Exception:
85                pass
86        try:
87            wifi_connect()
88            client = mqtt_connect()
89            print("MQTT bagli / connected")
90            return
91        except Exception as e:
92            print("Tekrar denenecek / retrying:", e)
93            time.sleep(delay)
94            delay = min(delay * 2, 60)     # üstel bekleme / exponential backoff
95
96
97reconnect()
98last_pub = time.ticks_add(time.ticks_ms(), -PUBLISH_MS)   # ilk yayın hemen / first publish right away
99
100while True:
101    try:
102        client.check_msg()                 # gelen mesaj var mı? / any incoming message?
103        if pending_state:
104            client.publish(TOPIC_LED_STATE, pending_state, retain=True)
105            pending_state = None
106        if time.ticks_diff(time.ticks_ms(), last_pub) >= PUBLISH_MS:
107            last_pub = time.ticks_ms()
108            temp = "{:.1f}".format(read_temp())
109            client.publish(TOPIC_TEMP, temp.encode())
110            print("Yayinlandi / Published:", temp)
111    except Exception as e:
112        print("Baglanti koptu / Connection lost:", e)
113        reconnect()
114    time.sleep_ms(100)
Kod parçasıNe yapar?
CLIENT_IDmachine.unique_id() ile her karta özel bir kimlik üretir; aynı kimlikle bağlanan iki cihaz broker'da birbirini düşürür
read_temp()ADC(4) değerini gerilime, gerilimi de 27 - (V - 0,706) / 0,001721 formülüyle santigrat dereceye çevirir
set_last_will()Bağlantı beklenmedik şekilde koparsa broker'ın durum konusuna "offline" yazmasını sağlar; connect() çağrısından önce çalışmalıdır
subscribe()LED konusunu dinlemeye başlar; her yeni bağlantıda yeniden çağrılır
check_msg()Gelen mesaj varsa on_message fonksiyonunu çağırır, yoksa beklemeden döner
pending_stateGeri çağırma fonksiyonu içinde yayın yapmak yerine durumu bir değişkene bırakır, yayını ana döngü yapar
ticks_diff()sleep ile beklemeden on saniyeyi ölçer; böylece LED komutları gecikmeden işlenir
reconnect()Wi-Fi ve MQTT bağlantısını 2, 4, 8 … en fazla 60 saniye arayla yeniden dener

Programı çalıştırdıktan sonra bilgisayarındaki MQTT Explorer ile aynı broker'a bağlan ve bluegrays/picow/# konusuna abone ol. On saniyede bir sıcaklık değerinin geldiğini ve durum konusunda "online" yazdığını görmelisin. LED'i denemek için bluegrays/picow/led konusuna büyük harfle ON yayınla; kartın üzerindeki yeşil LED hemen yanar ve Thonny kabuğunda gelen mesaj yazdırılır. Mosquitto istemci araçları kuruluysa aynı işi komut satırından mosquitto_pub -h broker.hivemq.com -t bluegrays/picow/led -m ON komutuyla da yapabilirsin. Dahili sensör yonganın kendi sıcaklığını ölçtüğü için oda sıcaklığından birkaç derece farklı okuyabilir; gerçek ortam ölçümü için DHT11/DHT22 ya da BME280 gibi harici bir sensör bağla ve read_temp() fonksiyonunu ona göre değiştir.

Kopan bağlantıyı otomatik yeniden kurmak

Evde çalışan bir IoT cihazının en büyük düşmanı bağlantı kopmalarıdır: modem yeniden başlar, Wi-Fi sinyali zayıflar ya da broker bakıma girer. umqtt.simple bu durumda kendiliğinden toparlanmaz; bir sonraki publish() ya da check_msg() çağrısında OSError fırlatır. Programdaki try/except bloğu bu hatayı yakalar ve reconnect() fonksiyonunu çağırır. Fonksiyon önce eski soketi kapatır, Wi-Fi koptuysa yeniden bağlanır, sonra MQTT bağlantısını ve aboneliği baştan kurar. Her başarısız denemeden sonra bekleme süresi ikiye katlanır (2, 4, 8, 16, 32, 60 saniye); buna üstel geri çekilme denir ve broker'ı saniyede onlarca denemeyle boğmanı engeller.

Keepalive değeri de önemlidir. Kodda 60 saniye verdik; MQTT kurallarına göre broker, istemciden bu sürenin 1,5 katı boyunca (yani 90 saniye) hiçbir paket gelmezse bağlantıyı kapatır. On saniyede bir yayın yaptığımız için bu sorun olmaz. Ancak yayın aralığını örneğin beş dakikaya çıkarırsan araya düzenli olarak client.ping() çağrısı eklemen gerekir; umqtt.simple ping paketini otomatik göndermez. Last Will mesajı sayesinde kartın fişi çekilse bile broker keepalive süresi dolunca durum konusuna "offline" yazar ve Home Assistant cihazı "kullanılamıyor" olarak gösterir.

  • Wi-Fi bilgilerini ve broker şifresini ayrı bir secrets.py dosyasında tut; kodu paylaşırken o dosyayı paylaşma.
  • Kararlılık için machine.WDT(timeout=8000) ile bekçi köpeği zamanlayıcısı kur ve ana döngüde düzenli olarak wdt.feed() çağır; program bir yerde takılırsa kart kendini yeniden başlatır. Bu durumda reconnect() içindeki beklemeleri de 8 saniyenin altında tut ya da beklerken besleme yap.
  • Ölçümü her döngüde değil belirli aralıklarla yayınla; anlık dalgalanmaları azaltmak için birkaç ölçümün ortalamasını al (sensör verisi filtreleme).
  • LED durumu gibi son değeri önemli olan konularda retain kullan; komut konularına retain'li mesaj gönderme, yoksa kart her yeniden bağlandığında eski komutu tekrar uygular.
  • Bağlantı sık kopuyorsa wlan.config(pm=0xa11140) ile kablosuz yonganın güç tasarrufu modunu kapatmayı dene; bu, gecikmeyi azaltır ama akım tüketimini artırır.

Pico W kartını Home Assistant'a bağlamak

  1. Home Assistant'ta Ayarlar > Eklentiler bölümünden Mosquitto broker eklentisini kur ve başlat.
  2. Ayarlar > Kişiler bölümünde Pico W için ayrı bir kullanıcı oluştur (örneğin "pico"); MQTT bağlantısında bu kullanıcının adı ve şifresi kullanılır.
  3. Ayarlar > Cihazlar ve Hizmetler bölümünde keşfedilen MQTT entegrasyonunu yapılandır.
  4. Koddaki BROKER değerini Home Assistant'ın yerel IP adresiyle (örneğin 192.168.1.50) değiştir, MQTT_USER ve MQTT_PASS değişkenlerine kullanıcı adını ve şifreyi yaz.
  5. Aşağıdaki ha_discovery() fonksiyonunu koda ekle ve mqtt_connect() içinde subscribe() satırından sonra ha_discovery(c) diye çağır.
  6. Birkaç saniye içinde cihaz listesinde "Pico W" adlı yeni bir cihaz, altında da sıcaklık sensörü ve LED anahtarı belirir.
MicroPython
1import json
2import binascii
3import machine
4
5DEVICE_ID = "picow_" + binascii.hexlify(machine.unique_id()).decode()
6DEVICE = {
7    "identifiers": [DEVICE_ID],
8    "name": "Pico W",
9    "manufacturer": "Raspberry Pi",
10    "model": "Pico W",
11}
12
13
14def ha_discovery(c):
15    temp_cfg = {
16        "name": "Sicaklik",
17        "unique_id": DEVICE_ID + "_temp",
18        "state_topic": "bluegrays/picow/sicaklik",
19        "unit_of_measurement": "°C",
20        "device_class": "temperature",
21        "availability_topic": "bluegrays/picow/durum",
22        "device": DEVICE,
23    }
24    led_cfg = {
25        "name": "LED",
26        "unique_id": DEVICE_ID + "_led",
27        "command_topic": "bluegrays/picow/led",
28        "state_topic": "bluegrays/picow/led/durum",
29        "payload_on": "ON",
30        "payload_off": "OFF",
31        "availability_topic": "bluegrays/picow/durum",
32        "device": DEVICE,
33    }
34    base = DEVICE_ID.encode()
35    # JSON'u bytes olarak gönder (°C çok baytlıdır) / send JSON as bytes (°C is multi-byte)
36    c.publish(b"homeassistant/sensor/" + base + b"/temp/config",
37              json.dumps(temp_cfg).encode(), retain=True)
38    c.publish(b"homeassistant/switch/" + base + b"/led/config",
39              json.dumps(led_cfg).encode(), retain=True)
40
41# mqtt_connect() içinde subscribe() satırından sonra çağır / call after subscribe() in mqtt_connect()
42# ha_discovery(c)

Home Assistant varsayılan olarak homeassistant/ ön ekiyle başlayan konuları dinler. Pico W bu konulara retain bayrağıyla bir JSON yapılandırması gönderdiğinde Home Assistant varlıkları otomatik oluşturur: sensor yapılandırması sıcaklığı grafiklenebilir bir değer olarak gösterir, switch yapılandırması ise arayüze bir aç/kapa anahtarı ekler. Anahtara dokunduğunda Home Assistant command_topic konusuna "ON" ya da "OFF" yayınlar, kart LED'i değiştirir ve state_topic konusuna yeni durumu yazar; böylece arayüzdeki anahtar her zaman gerçek durumu gösterir. availability_topic alanı da Last Will mesajını kullanarak kart kapandığında varlıkları gri gösterir. Aynı yapıyı ESP32 tarafında görmek istersen ESP32 MQTT ve Home Assistant yazısına göz at.

Pico W ve MQTT ile proje fikirleri

  • Oda sıcaklığı ve nem panosu: Her odaya bir Pico W ve DHT22 koy, ev/salon/sicaklik gibi konularla tüm evi tek ekranda izle.
  • Uzaktan kontrollü lamba: LED yerine bir röle modülü sürerek lambayı Home Assistant'tan aç kapat.
  • Bitki sulama bildirimi: Toprak nem sensörü değerini yayınla, toprak kuruyunca otomasyonla telefonuna bildirim gönder.
  • Hareket alarmı: PIR sensörü tetiklendiğinde ev/koridor/hareket konusuna mesaj yayınla.
  • Akvaryum termometresi: DS18B20 ile su sıcaklığını ölç, eşik aşılınca retain'li bir uyarı mesajı gönder.
  • Web arayüzüyle karşılaştır: Aynı LED'i bir de Pico W web sunucusu ile kontrol ederek iki yöntemin farkını gör.

Sık yapılan hatalar ve çözümleri

BelirtiOlası sebepÇözüm
ImportError: no module named 'umqtt'Kütüphane firmware içinde yokmip.install("umqtt.simple") ya da Thonny paket yöneticisi
Wi-Fi bir türlü bağlanmıyor5 GHz ağ, yanlış şifre ya da zayıf sinyal2,4 GHz ağ kullan, wlan.status() değerini yazdır, kartı modeme yaklaştır
connect() sırasında OSErrorBroker adresi çözülemedi ya da ağ bağlantısı yokÖnce wlan.isconnected() değerini kontrol et, broker adını ve portu doğru yaz
MQTTException: 4 ya da 5Kullanıcı adı ya da şifre hatalı, yetki yokHome Assistant kullanıcısını ve şifresini kontrol et
Bağlantı yaklaşık 90 saniyede kopuyorKeepalive süresinde hiç paket gitmiyorDüzenli yayın yap ya da client.ping() ekle
Mesajlar hiç gelmiyorcheck_msg() döngüde çağrılmıyor ya da set_callback() unutulduset_callback() çağrısını subscribe() çağrısından önce yap, döngüde check_msg() kullan
Karşılaştırma hep yanlış çıkıyorKonu ve mesaj bytes geliyor, sen str ile karşılaştırıyorsunb"ON" gibi bytes sabitleri kullan
İki kart sürekli birbirini düşürüyorAynı CLIENT_ID kullanılıyormachine.unique_id() ile benzersiz kimlik üret
Hata ayıklarken zinciri parça parça test et: kabukta wlan.isconnected() True dönüyor mu, MQTT Explorer'dan yayınladığın mesaj Pico'da görünüyor mu, Pico'nun yayını MQTT Explorer'a düşüyor mu? Sorunun Wi-Fi, broker ya da kod tarafında olduğunu bu üç adımla dakikalar içinde ayırırsın. Wi-Fi tarafındaki genel ipuçları için ESP32 Wi-Fi bağlanmıyor yazısındaki kontrol listesi Pico W için de büyük ölçüde geçerlidir.

MQTT'yi bir kez kurduğunda karta eklediğin her yeni sensör ya da çıkış yalnızca yeni bir konu demektir; altyapı aynı kalır. Önce dahili LED ve sıcaklık sensörüyle bu rehberdeki programı çalıştır, sonra röle ve harici sensörlerle büyüt. MicroPython'da LED, buton ve PWM gibi temel adımları pekiştirmek istersen BlueGrays uygulamasındaki Raspberry Pi Pico projelerinde her adımın devre şemasını ve kodunu adım adım bulabilirsin.

Sıkça sorulan sorular

Normal Raspberry Pi Pico ile MQTT kullanılabilir mi?

Hayır, düz Pico'da Wi-Fi ya da Ethernet olmadığı için doğrudan bir broker'a bağlanamaz. MQTT için kablosuz yongalı Pico W ya da Pico 2 W kullanman gerekir. Düz Pico ancak harici bir Wi-Fi ya da Ethernet modülüyle ağa çıkabilir; bu da kurulumu oldukça karmaşıklaştırır.

umqtt.simple ile umqtt.robust arasındaki fark nedir?

umqtt.simple bağlanma, yayınlama ve abone olma gibi temel MQTT işlemlerini yapan çok küçük bir istemcidir ve bağlantı koptuğunda hata fırlatır. umqtt.robust bu istemcinin üzerine kuruludur ve hata anında otomatik yeniden bağlanmayı dener. Ancak abonelikleri kendiliğinden yenilemediği için yeniden bağlandıktan sonra subscribe() çağrısını yine senin yapman gerekir.

En iyi ücretsiz MQTT broker hangisi?

Deneme için broker.hivemq.com, test.mosquitto.org ve broker.emqx.io kayıt gerektirmeyen ve 1883 portunda çalışan genel broker'lardır. Herkese açık oldukları için bunlara yalnızca test verisi göndermelisin. Kalıcı ve güvenli bir kurulum için evdeki bir Raspberry Pi'ye ya da Home Assistant'a Mosquitto kurmak en iyi ücretsiz seçenektir.

Pico W Home Assistant'a nasıl eklenir?

Home Assistant'a Mosquitto broker eklentisini ve MQTT entegrasyonunu kur, Pico W için ayrı bir kullanıcı oluştur. Kartı bu kullanıcıyla Home Assistant'ın IP adresine bağla ve homeassistant/ ile başlayan konulara retain'li bir discovery yapılandırması yayınla. Home Assistant sensörü ve anahtarı otomatik olarak oluşturur.

Pico W MQTT bağlantısı neden kopuyor?

En sık sebep keepalive süresi içinde hiç paket gönderilmemesidir; umqtt.simple ping paketini otomatik atmaz, bu yüzden düzenli client.ping() ya da yayın gerekir. Zayıf Wi-Fi sinyali, modemin yeniden başlaması ve aynı istemci kimliğini kullanan ikinci bir cihaz da kopmalara yol açar. Kodunu OSError hatalarını yakalayıp yeniden bağlanacak şekilde yazmak bu durumların hepsini çözer.

Pico W ile MQTT üzerinden TLS (8883) kullanılabilir mi?

Evet. umqtt.simple kütüphanesindeki ssl parametresiyle 8883 portunda şifreli bağlantı kurabilirsin; güncel MicroPython sürümlerinde bu parametreye ssl.SSLContext ile oluşturulmuş bir bağlam verilir. TLS el sıkışması RP2040 üzerinde birkaç saniye sürebilir ve RAM kullanımını artırır. HiveMQ Cloud gibi bulut broker'ları genellikle TLS bağlantısını zorunlu tutar.

Tüm projeleri gör
Raspberry Pi Pico Dahili LED Yakma (Pico ve Pico W)
PI-1Başlangıç

Raspberry Pi Pico Dahili LED Yakma (Pico ve Pico W)

Raspberry Pi Pico serisinin açılış projesi! Pico'nun üzerindeki yeşil dahili LED'i yakıp söndürerek kartın çalıştığını doğruluyoruz; klasik "Hello World" tarzı ilk deney. Harici bileşene gerek yok, Pico ve USB kablosu yeterli. Kod MicroPython ile yazıldı (Raspberry Pi Vakfı'nın resmî olarak desteklediği dil).

5.0(1)
10
Raspberry Pi Pico Harici LED Yakma (Breadboard)
PI-2Başlangıç

Raspberry Pi Pico Harici LED Yakma (Breadboard)

Pico'nun dahili LED'inden sonraki adım: breadboard'a harici bir LED bağlayıp GP14 pini üzerinden kontrol etmek. Bu projede Pico'nun herhangi bir GPIO pinini çıkış olarak kullanmayı, LED'in kutuplarını (uzun bacak = anot/+, kısa bacak = katot/–) ve akım sınırlama direncinin (220Ω) neden şart olduğunu öğreniyorsun. Direnci koymazsan LED'e aşırı akım gider ve yanabilir.

4.5(2)
7
Raspberry Pi Pico Buton ile LED Yakma (Push)
PI-9Başlangıç
Premium

Raspberry Pi Pico Buton ile LED Yakma (Push)

Pico ile ilk input projesi — buton okuma! Butona basıldıkça LED yanar, bırakıldıkça söner. Bu proje LED animasyonlarından sonraki büyük adım: Pico'ya dünyadan sinyal girişi. Yeni öğrenme: Pin.IN (input mode), Pin.PULL_UP (dahili pull-up direnci — buton için standart), button.value() okuma. GP14 LED, GP2 buton (dahili PULL_UP). Buton basılınca sinyal LOW (0), bırakılınca HIGH (1) — bu ters mantık ilk başta kafa karıştırıcı ama endüstri standardı.

11
Raspberry Pi Pico Buton ile LED Yakma (Toggle)
PI-10Başlangıç

Raspberry Pi Pico Buton ile LED Yakma (Toggle)

Buton ile LED — bir üst seviye! Basit buton projesinin aksine burada butonu basılı tutmana gerek yok. Bir kez bas ve bırak → LED açılır. Tekrar bas ve bırak → LED söner (toggle). Devre aynı (LED GP14, Buton GP2), ama kod büyük fark içeriyor. Yeni öğrenme: edge detection (kenar algılama — pinin 1'den 0'a düştüğü an), state tracking (önceki durumu hafızada tut), debounce (buton mekanik "bounce" sonrası yanlış tetikleme önleme). MicroPython'ın led.toggle() metodu ile tek satırda değişim.

10
Raspberry Pi Pico PWM ile LED Fade (Nefes Efekti)
PI-14Başlangıç

Raspberry Pi Pico PWM ile LED Fade (Nefes Efekti)

LED artık sadece yanıp sönmüyor, nefes alıyor! Raspberry Pi Pico'nun PWM (Pulse Width Modulation, darbe genişlik modülasyonu) özelliğiyle LED'in parlaklığı yavaş yavaş artar, sonra yavaş yavaş azalır; uyku modundaki bir dizüstü bilgisayarın ışığı gibi sakin bir "nefes" efekti. Bu projede machine.PWM sınıfını, duty_u16() ile 0–65535 arası 16 bit parlaklık değerini ve PWM frekansını öğrenirsin.

4
Raspberry Pi Pico RGB LED Renk Çevrimi (3 Kanal PWM)
PI-15Başlangıç

Raspberry Pi Pico RGB LED Renk Çevrimi (3 Kanal PWM)

Tek LED, milyonlarca renk! RGB LED'in içinde aslında 3 ayrı LED var: kırmızı, yeşil ve mavi. Pico'nun 3 ayrı PWM kanalıyla her birinin parlaklığını ayrı ayrı ayarlayınca renkler karışır: kırmızı + yeşil = sarı, yeşil + mavi = camgöbeği, üçü birden = beyaz. Bu projede LED 8 renk arasında sırayla dönüyor.

6
ESP32 Wi-Fi STA Bağlantısı (LCD Ekranlı)
ES-25İleri

ESP32 Wi-Fi STA Bağlantısı (LCD Ekranlı)

Bu projede ESP32'yi Station (STA) modunda evdeki Wi-Fi ağına güvenli ve hata toleranslı şekilde bağlıyoruz. SSID/şifreyi secrets.h dosyasına ayırarak Git'e sızmasını önlüyor, otomatik yeniden bağlanma mekanizması kuruyor, RSSI sinyal seviyesini ve IP adresini I2C LCD ekranda gösteriyoruz. Dahili LED durum göstergesi olarak çalışır. Üretim seviyesi bir bağlantı yöneticisidir.

4.4(21)
38
ESP32 Async Web Server (LCD'de IP Göstergeli)
ES-27İleri

ESP32 Async Web Server (LCD'de IP Göstergeli)

Bu projede ESP32'yi aynı Wi-Fi ağındaki telefonunuzdan veya bilgisayarınızdan kontrol edebileceğiniz asenkron bir web sunucusuna dönüştürüyoruz. ESPAsyncWebServer kütüphanesi sayesinde sunucu birden fazla isteği aynı anda işleyebiliyor (klasik WebServer.h gibi tek istekte bloklamıyor). Tarayıcıdan ESP32'nin IP adresine bağlanıp ON/OFF butonlarına basarak (/on ve /off adresleri) GPIO 5'e bağlı LED'i açıp kapatabileceksiniz.

4.8(16)
26