Học

Một HTTP GET từ ESP32: lấy dữ liệu thời tiết

Bắt đầu làm miễn phí

Hoặc xem mọi bài học.

  • 526linh kiện trên bàn làm mạch
  • 46bo mạch đang chạy
  • 1.00xthời gian thực, trên mọi bo mạch
ESP32-C3: lấy dữ liệu thời tiếttrực tiếp0.000 s 0.00x
Nhấp để mở trong trình soạn thảo
HTTPClient truy cập http://weather.mokxi/, trên một mạng được mô phỏng. Thay đổi các số trong tab Cloud.

Phần lớn các dự án kết nối mạng là một bo mạch hỏi server một mẩu dữ liệu nhỏ và làm gì đó với nó: thời tiết, giờ, một cài đặt. Trên ESP32 trong thế giới Arduino đó là thư viện HTTPClient, và pattern luôn gồm năm bước: nối vào mạng, bắt đầu một yêu cầu, GET nó, đọc phần thân, kết thúc yêu cầu.

Mạch phía trên là một ESP32-C3 chạy ví dụ có sẵn WiFi: lấy dữ liệu thời tiết. Trước tiên, phần trung thực: mạng trong Mokxi được mô phỏng. Không có sóng radio nào, và không có gì rời khỏi tab trình duyệt của bạn trừ khi bạn đăng nhập và bật internet thật. Bốn tên hư cấu trả lời (time.mokxi, weather.mokxi, echo.mokxi và api.mokxi) và code của bo mạch chính là code bạn sẽ nạp vào một ESP32 thật. Nhấn Chạy và Serial Monitor hiện các dấu chấm của vòng lặp kết nối, rồi "IP address: 192.168.4.2", rồi cứ năm giây một lần:

Mỗi lần lấy dữ liệu in ra "HTTP 200", rồi phần thân, {"location":"Mokxi","temperatureC":21.5,"humidity":48,"simulated":true}, rồi hai số mà sketch lấy ra từ đó: "temperature: 21.5 C" và "humidity: 48 %".

Năm bước

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.

Hai chi tiết quan trọng trên phần cứng thật. Kiểm tra mã trước khi dùng phần thân: số âm nghĩa là yêu cầu không hoàn tất (không có mạng, tên không phân giải được, hết thời gian chờ) và 404 hoặc 500 nghĩa là server trả lời với lỗi. Và luôn gọi end(), kể cả sau khi thất bại, để kết nối và bộ đệm của nó được giải phóng trước yêu cầu tiếp theo; bo mạch bỏ qua điều đó có thể rò rỉ một chút bộ nhớ mỗi yêu cầu cho đến khi ngừng hoạt động.

firmware/examples/wifiweather (yêu cầu, từ chương trình đang chạy phía trên)
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();

Lấy số ra khỏi JSON

Phản hồi là JSON, một định dạng văn bản nhỏ gồm tên và giá trị. Sketch này tìm chữ "temperatureC", bỏ qua dấu nháy, dấu hai chấm và các khoảng trắng, rồi sao chép các ký tự cho đến dấu phẩy hoặc ngoặc đóng tiếp theo. Thế là đủ cho một phản hồi phẳng do bạn kiểm soát, và giữ cho sketch dễ đọc. Với bất cứ thứ gì lồng nhau hoặc từ dịch vụ bên ngoài, hãy dùng trình phân tích thật; trên bo mạch vật lý phần lớn mọi người cài thư viện ArduinoJson.

Mở tab Cloud cạnh Serial trong khi nó chạy. Tab liệt kê mọi yêu cầu bo mạch đã gửi kèm trạng thái và phần thân, và có hai ô cho các số mà weather.mokxi trả về. Đổi nhiệt độ thành 30 và lần lấy dữ liệu tiếp theo, chậm nhất năm giây sau, in ra "temperature: 30 C". Đó là cùng một chu trình yêu cầu, phản hồi mà bo mạch thật gửi cho dịch vụ thời tiết thật, với server nằm trong tay bạn.

Khi yêu cầu thất bại

Sketch cố ý yêu cầu http://example.com/ một lần trong setup(), và khi Real internet tắt, Serial Monitor in ra lý do thất bại: không có internet thật, chỉ có các tên dưới .mokxi. Bo mạch thật không có đường đi tới server cũng thất bại ở đúng chỗ đó, tại GET, với mã âm, và in HTTPClient::errorToString(code) là cách nhanh nhất để biết lý do.

Để tập xử lý lỗi server, hãy mở ví dụ API lab bằng nút bên dưới. Nó truy cập http://api.mokxi/data, và tab Cloud cho bạn chọn mã trạng thái và JSON nhận về. Đặt thành 404 hoặc 500 và xem code của bạn làm gì với một phản hồi ngoài dự kiến. Các địa chỉ https:// cố ý thất bại ở đây, với thông báo nói TLS không được mô phỏng; trên ESP32 thật, yêu cầu https cần WiFiClientSecure và chứng chỉ của server.

Những thói quen đáng hình thành

Đừng hỏi quá thường xuyên. Dịch vụ thời tiết thật cập nhật mỗi vài phút và nhiều dịch vụ giới hạn số lần một khóa được gọi; năm giây một lần là ổn với weather.mokxi và quá dày cho phần lớn dịch vụ thật. Một phút một lần hoặc thưa hơn là mặc định lịch sự.

Giữ bí mật ra khỏi code chia sẻ. Sketch chứa mật khẩu WiFi hoặc khóa API sẽ đi theo bất cứ nơi nào bạn dán nó. Hãy đặt chúng vào một file header riêng mà bạn không chia sẻ, và đổi mật khẩu trên mọi mạng có chi tiết bị lộ trong một bài đăng công khai.

Một GET bị chặn sẽ chặn mọi thứ. http.GET() chờ phản hồi, nên trong lúc chờ sketch không đọc nút nhấn hay cập nhật màn hình. Trong Mokxi một yêu cầu làm sketch tốn thời gian khứ hồi mô phỏng, như trên phần cứng, đó là lý do một dự án cần phản ứng nhanh thì hiếm khi lấy dữ liệu và làm việc khác bằng millis() thay vì delay().

Mở mạch này trong trình soạn thảo. ESP32-C3: lấy dữ liệu thời tiết, nối dây như đang chạy ở đầu trang này. Thay một linh kiện hoặc một giá trị rồi chạy lại.

Câu hỏi

Bo mạch nào chạy được cái này?

Trong Mokxi, các bo mạch có sóng radio trên phần cứng thật: ESP32-C3, ESP32-C6, ESP32 DevKit kinh điển, ESP8266 NodeMCU và Raspberry Pi Pico W. Cùng một ví dụ có sẵn cho từng bo mạch.

Sketch của tôi có thể truy cập một trang web thật từ trình mô phỏng không?

Có, sau khi bạn đăng nhập. Bật Real internet trong bảng Cloud, và các yêu cầu HTTP, HTTPS tới server thật đi qua cổng của Mokxi. Khi tắt, chỉ các tên dưới .mokxi phân giải được, không gì rời khỏi tab trình duyệt, và các địa chỉ khác trả về lỗi kèm một câu giải thích lý do.

Mã HTTP -1 nghĩa là gì trên ESP32?

Kết nối bị từ chối hoặc không thiết lập được: thường là không có WiFi, sai địa chỉ, hoặc server không tồn tại. HTTPClient::errorToString(code) in lý do bằng lời.

Nên dùng GET hay POST?

GET để đọc dữ liệu, POST để gửi dữ liệu, ví dụ một số đo cảm biến tới dịch vụ ghi log. HTTPClient có http.POST(body), và echo.mokxi trả lời POST bằng chính phần thân bạn gửi, nên bạn có thể thử ở đây.

Tại sao http.getString() trả về rỗng?

Thường là vì yêu cầu thất bại và mã âm, hoặc server trả lời không có phần thân, như 204. In mã trạng thái trước; nếu là 200 mà phần thân vẫn rỗng, in http.getSize() để xem server nói nó gửi bao nhiêu byte.

Lắp mạch này ngoài đời

Mở trình soạn thảo, đổi một giá trị và xem con số thay đổi theo. Không cần cài gì, không cần tài khoản.