ESP32'den bir HTTP GET isteği: hava durumunu al
Ya da tüm dersleri gör.
- 526parça tezgahta
- 46kart şu an çalışıyor
- 1.00xgerçek zamanlı, her kartta
Çoğu bağlı proje, bir kartın sunucudan küçük bir veri parçası istemesi ve onunla bir şey yapmasından ibarettir: hava durumu, saat, bir ayar. Arduino dünyasında bir ESP32'de bu, HTTPClient kütüphanesidir ve desen her zaman aynı beş adımdır: ağa katıl, isteği başlat, GET yap, gövdeyi oku, isteği bitir.
Yukarıdaki devre, hazır WiFi: hava durumu getirme örneğini çalıştıran bir ESP32-C3. Her şeyden önce dürüst olan kısmı: Mokxi'deki ağ simüle edilir. Radyo yoktur ve gerçek interneti açmadığın sürece tarayıcı sekenden hiçbir şey dışarı çıkmaz. Dört uydurma isim yanıt verir (time.mokxi, weather.mokxi, echo.mokxi ve api.mokxi) ve karttaki kod, gerçek bir ESP32'ye yükleyeceğin koddur. Çalıştır'a bas ve seri monitör bağlanma döngüsünün noktalarını, ardından "IP address: 192.168.4.2" satırını ve sonra her beş saniyede bir şunu gösterir:
Her getirme işlemi "HTTP 200" yazdırır, ardından gövdeyi, {"location":"Mokxi","temperatureC":21.5,"humidity":48,"simulated":true} yazısını ve sonra kodun içinden çıkardığı iki sayıyı: "temperature: 21.5 C" ve "humidity: 48 %".
Beş adım
WiFi.begin(ssid, password) starts joining, and the sketch waits in a loop until WiFi.status() returns WL_CONNECTED. Then, for each request, it makes a WiFiClient and an HTTPClient, calls http.begin(client, url), and http.GET() sends the request and waits for the reply. GET returns the HTTP status code, 200 for success, and http.getString() returns the body. http.end() frees the connection.
Gerçek donanımda iki ayrıntı önemli. Gövdeyi kullanmadan önce kodu kontrol et: negatif bir sayı isteğin hiç tamamlanmadığı anlamına gelir (ağ yok, çözümlenemeyen bir isim, zaman aşımı); 404 veya 500 ise sunucunun bir hatayla yanıt verdiğini gösterir. Ve bir hata olsa bile her zaman end() çağır ki bağlantı ve arabellekleri bir sonraki istekten önce serbest kalsın; bunu atlayan bir kart, çalışmayı durdurana kadar her istekte biraz bellek sızdırabilir.
WiFiClient client;
HTTPClient http;
http.begin(client, "http://weather.mokxi/");
int code = http.GET();
if (code <= 0) {
Serial.print("request failed: ");
Serial.println(HTTPClient::errorToString(code));
http.end();
return;
}
Serial.print("HTTP ");
Serial.println(code);
String body = http.getString();
http.end();JSON'dan sayı çıkarma
Yanıt JSON'dur, isim ve değerlerden oluşan küçük bir metin biçimi. Bu kod "temperatureC" metnini bulur, tırnak işaretini, iki noktayı ve boşlukları atlar ve sonraki virgüle veya kapanış parantezine kadar karakterleri kopyalar. Bu, kontrolü sende olan düz bir yanıt için yeterlidir ve kodun okunabilir kalmasını sağlar. İç içe olan veya üçüncü taraf bir hizmetten gelen yanıtlar için gerçek bir ayrıştırıcı kullan; fiziksel bir kartta çoğu kişi ArduinoJson kütüphanesini kurar.
Çalışırken Serial'in yanındaki Cloud sekmesini aç. Kartın yaptığı her isteği durumu ve gövdesiyle listeler ve weather.mokxi'nin yanıt verdiği sayılar için iki alan içerir. Sıcaklığı 30 yap ve en geç beş saniye sonra gerçekleşen sonraki getirme işlemi "temperature: 30 C" yazdırır. Bu, sunucu kontrolü sende olmak üzere, gerçek bir kartın gerçek bir hava durumu servisine yaptığı gidiş dönüşün aynısıdır.
İstek başarısız olduğunda
Kod, setup() içinde bilerek http://example.com/ adresine bir kez istek gönderiyor ve Gerçek internet kapalıyken seri monitör başarısızlık sebebini yazdırıyor: gerçek internet yok, sadece .mokxi altındaki adlar çözümleniyor. Sunucuya giden yolu olmayan gerçek bir kart da aynı yerde, GET aşamasında, negatif bir kodla başarısız olur ve HTTPClient::errorToString(code) yazdırmak sebebini görmenin en hızlı yoludur.
Sunucu hatalarını yönetmeyi alıştırmak için aşağıdaki düğmeyle API laboratuvarı örneğini aç. http://api.mokxi/data adresine istek gönderir ve Bulut sekmesi durum kodunu ve dönen JSON'u seçmeni sağlar. 404 veya 500 yap ve kodunun beklenmedik bir yanıtla ne yaptığını izle. https:// adresleri burada bilerek başarısız olur ve TLS simüle edilmediğini söyleyen bir mesaj görünür; gerçek bir ESP32'de https isteği WiFiClientSecure ve sunucunun sertifikasını gerektirir.
Değer edinilecek alışkanlıklar
Çok sık istek gönderme. Gerçek bir hava durumu servisi birkaç dakikada bir güncellenir ve çoğu bir anahtarın kaç kez çağrılabileceğini sınırlar; weather.mokxi için beş saniyede bir istek uygunken çoğu gerçek servis için çok sık olur. Dakikada bir veya daha az, kibar bir varsayılan olur.
Sırları paylaşılan kodun dışında tut. İçinde WiFi parolası veya API anahtarı olan bir kod, yapıştırdığın her yere gider. Bunları paylaşmadığın ayrı bir başlık dosyasına koy ve ayrıntıları herkese açık bir gönderide ortaya çıkan herhangi bir ağın parolasını değiştir.
Bloke olan bir GET her şeyi bloke eder. http.GET() yanıtı bekler, yani beklerken kod butonları okumaz veya ekranı güncellemez. Mokxi'de bir istek, donanımda olacağı gibi, koda simüle edilmiş gidiş dönüşünü ödetir; bu yüzden hızlı kalması gereken bir proje nadiren istek gönderir ve diğer işlerini delay() yerine millis() ile yapar.
Bu devreyi düzenleyicide aç. ESP32-C3: hava durumunu çek, bu sayfanın üstünde çalıştığı gibi kablolandı. Bir parçayı veya değeri değiştir ve yeniden çalıştır.
Sorular
Hangi kartlar bunu çalıştırabilir?
Mokxi'de, gerçek donanımda radyo bulunan kartlar: ESP32-C3, ESP32-C6, klasik ESP32 DevKit, ESP8266 NodeMCU ve Raspberry Pi Pico W. Aynı örnek her biri için hazır.
Kodum simülatörden gerçek bir web sitesine ulaşabilir mi?
Evet, giriş yaptıktan sonra. Bulut panelinde Gerçek internet'i aç ve gerçek sunuculara HTTP ve HTTPS istekleri Mokxi'nin ağ geçidinden çıkar. Kapalıyken sadece .mokxi altındaki adlar çözümlenir, hiçbir şey tarayıcı sekmesinden çıkmaz ve diğer her şey tek cümlelik bir açıklamayla hata döndürür.
ESP32'de HTTP kodu -1 ne demek?
Bağlantı reddedildi veya kurulamadı: genellikle WiFi yok, yanlış adres veya olmayan bir sunucu. HTTPClient::errorToString(code) sebebini sözle yazdırır.
GET mi POST mu kullanmalıyım?
Veri okumak için GET, veri göndermek için POST, örneğin bir kayıt servisine sensör verisi. HTTPClient içinde http.POST(body) vardır ve echo.mokxi bir POST'a gönderdiğin gövdeyle yanıt verir, yani burada test edebilirsin.
http.getString() neden boş dönüyor?
Genellikle istek başarısız olduğu ve kod negatif olduğu için, ya da sunucu gövdesiz yanıt verdiği için, 204'te olduğu gibi. Önce durum kodunu yazdır; 200 ise ve gövde hâlâ boşsa, sunucunun kaç bayt göndereceğini söylediğini görmek için http.getSize() yazdır.
Bunu gerçekten kur
Düzenleyiciyi aç, bir değeri değiştir ve sayının onunla birlikte değiştiğini izle. Kurulacak bir şey yok, hesaba da gerek yok.