HTTP GET dari ESP32: ambil data cuaca
Atau lihat semua pelajaran.
- 526komponen di meja kerja
- 46board sedang berjalan
- 1.00xwaktu nyata, di semua board
Sebagian besar proyek yang terhubung ke internet hanyalah board yang meminta sepotong kecil data dari server lalu melakukan sesuatu dengannya: cuaca, waktu, atau sebuah pengaturan. Di ESP32 dengan Arduino, itu berarti library HTTPClient, dan polanya selalu lima langkah yang sama: gabung ke jaringan, mulai sebuah request, GET, baca body, akhiri request.
Rangkaian di atas adalah ESP32-C3 yang menjalankan contoh bawaan WiFi: fetch the weather. Sebelum lanjut, bagian jujurnya dulu: jaringan di Mokxi adalah simulasi. Tidak ada radio, dan tidak ada yang keluar dari tab browser-mu kecuali kamu masuk dan menyalakan internet sungguhan. Empat nama buatan yang menjawab (time.mokxi, weather.mokxi, echo.mokxi dan api.mokxi) dan kode board-nya adalah kode yang akan kamu upload ke ESP32 sungguhan. Tekan Jalankan dan Serial Monitor akan menampilkan titik-titik dari loop koneksi, lalu "IP address: 192.168.4.2", lalu setiap lima detik:
Setiap fetch mencetak "HTTP 200", lalu body-nya, {"location":"Mokxi","temperatureC":21.5,"humidity":48,"simulated":true}, lalu dua angka yang diambil sketch dari sana: "temperature: 21.5 C" dan "humidity: 48 %".
Lima langkahnya
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.
Dua detail penting di hardware sungguhan. Periksa kodenya sebelum memakai body-nya: angka negatif berarti request tidak pernah selesai (tidak ada jaringan, nama yang tidak bisa di-resolve, timeout) dan 404 atau 500 berarti server menjawab dengan error. Dan selalu panggil end(), bahkan setelah gagal, supaya koneksi dan buffernya dilepas sebelum request berikutnya; board yang melewatkannya bisa membocorkan sedikit memori di setiap request sampai akhirnya berhenti bekerja.
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();Mengambil angka dari JSON
Balasannya adalah JSON, format teks kecil berisi nama dan nilai. Sketch ini mencari teks "temperatureC", melewati tanda kutip, titik dua, dan spasi apa pun, lalu menyalin karakter sampai koma berikutnya atau kurung tutup. Itu sudah cukup untuk balasan datar yang kamu kendalikan sendiri, dan sketch-mu tetap mudah dibaca. Untuk JSON bertingkat atau dari layanan pihak ketiga, pakai parser sungguhan; di board fisik kebanyakan orang memasang library ArduinoJson.
Buka tab Cloud di samping Serial saat program berjalan. Tab itu mencantumkan setiap request yang dibuat board beserta status dan body-nya, dan ada dua kolom untuk angka yang dijawab weather.mokxi. Ubah suhu menjadi 30 dan fetch berikutnya, paling lama lima detik kemudian, mencetak "temperature: 30 C". Itu round trip yang sama seperti board sungguhan ke layanan cuaca sungguhan, hanya saja servernya ada di kendalikanmu.
Saat request gagal
Sketch ini sengaja meminta http://example.com/ sekali di setup(), dan dengan Real internet mati, Serial Monitor mencetak alasannya gagal: tidak ada internet sungguhan, hanya nama di bawah .mokxi. Board sungguhan tanpa rute ke server gagal di tempat yang sama, di GET, dengan kode negatif, dan mencetak HTTPClient::errorToString(code) adalah cara tercepat untuk tahu alasannya.
Untuk berlatih menangani error server, buka contoh lab API dengan tombol di bawah. Contoh itu mengambil http://api.mokxi/data, dan tab Cloud membiarkanmu memilih kode status dan JSON yang dikembalikan. Atur ke 404 atau 500 dan lihat apa yang dilakukan kode-mu dengan balasan yang tidak ia duga. Alamat https:// sengaja gagal di sini, dengan pesan yang mengatakan TLS tidak disimulasikan; di ESP32 sungguhan, request https butuh WiFiClientSecure dan sertifikat servernya.
Kebiasaan yang layak dibangun
Jangan bertanya terlalu sering. Layanan cuaca sungguhan memperbarui datanya setiap beberapa menit dan banyak yang membatasi seberapa sering satu kunci bisa memanggil mereka; setiap lima detik tidak masalah untuk weather.mokxi dan terlalu sering untuk kebanyakan layanan sungguhan. Sekali semenit atau lebih jarang adalah pilihan yang baik.
Jangan taruh rahasia di kode yang dibagikan. Sketch dengan password WiFi atau API key di dalamnya akan ikut ke mana pun kamu menempelkannya. Taruh di header terpisah yang tidak kamu bagikan, dan ganti password di jaringan mana pun yang detailnya sampai terunggah secara publik.
GET yang terblokir memblokir semuanya. http.GET() menunggu balasan, jadi selama menunggu sketch tidak membaca tombol atau memperbarui tampilan. Di Mokxi sebuah request membuat sketch kehilangan round trip simulasinya, seperti di hardware, itu sebabnya proyek yang harus tetap responsif jarang melakukan fetch dan mengerjakan tugas lainnya dengan millis() daripada delay().
Buka rangkaian ini di editor. ESP32-C3: ambil data cuaca, terangkai seperti saat berjalan di bagian atas halaman ini. Ubah komponen atau nilainya lalu jalankan lagi.
Pertanyaan
Board mana saja yang bisa menjalankan ini?
Di Mokxi, board yang punya radio di hardware sungguhan: ESP32-C3, ESP32-C6, ESP32 DevKit klasik, ESP8266 NodeMCU, dan Raspberry Pi Pico W. Contoh yang sama tersedia untuk masing-masing board.
Bisakah sketch-mu mengakses situs sungguhan dari simulator?
Bisa, setelah kamu masuk. Nyalakan Real internet di panel Cloud, dan request HTTP serta HTTPS ke host sungguhan keluar lewat gateway Mokxi. Saat mati, hanya nama di bawah .mokxi yang bisa di-resolve, tidak ada yang keluar dari tab browser, dan yang lainnya mengembalikan error dengan satu kalimat penjelasan.
Apa arti kode HTTP -1 di ESP32?
Koneksi ditolak atau tidak bisa dibuat: biasanya tidak ada WiFi, alamat yang salah, atau server yang tidak ada di sana. HTTPClient::errorToString(code) mencetak alasannya dengan kata-kata.
Harus pakai GET atau POST?
GET untuk membaca data, POST untuk mengirimnya, misalnya pembacaan sensor ke layanan pencatatan. HTTPClient punya http.POST(body), dan echo.mokxi menjawab POST dengan body yang kamu kirim, jadi kamu bisa mengujinya di sini.
Kenapa http.getString() kembali kosong?
Biasanya karena request-nya gagal dan kodenya negatif, atau server menjawab tanpa body, seperti yang dilakukan 204. Cetak kode statusnya dulu; jika 200 dan body-nya tetap kosong, cetak http.getSize() untuk melihat berapa byte yang dikatakan server akan dikirim.
Rakit versi nyatanya
Buka editor, ubah sebuah nilai, dan lihat angkanya ikut berubah. Tidak ada yang perlu dipasang, dan tidak perlu akun.