เอกสารและคู่มือการใช้งานระบบ MeOTA

1. ภาพรวมสถาปัตยกรรม MeOTA Smart-AirSync™ (Architecture Overview)

MeOTA Platform คือระบบศูนย์กลางการบริหารจัดการอุปกรณ์ IoT และระบบอัปเดตเฟิร์มแวร์ผ่านอากาศ (Over-The-Air Update) ระดับองค์กร ขับเคลื่อนด้วยสถาปัตยกรรม MeOTA Smart-AirSync™ ที่ออกแบบมาเพื่อให้อุปกรณ์ IoT ในโปรเจกต์ต่างๆ เช่น Smart Farm, ตู้ควบคุมอุตสาหกรรม, เซนเซอร์สิ่งแวดล้อม และสมาร์ทมิเตอร์ สามารถอัปเดตโค้ดเวอร์ชันใหม่ได้ทางไกลอย่างปลอดภัยและเสถียรที่สุด

2. วิธีการติดตั้ง MeOTA Library ใน Arduino IDE

1. กดปุ่มดาวน์โหลดไฟล์ MeOTA.zip
2. เปิดโปรแกรม Arduino IDE บนคอมพิวเตอร์ของคุณ
3. ไปที่เมนู Sketch ➔ Include Library ➔ Add .ZIP Library...
4. เลือกไฟล์ MeOTA.zip ที่ดาวน์โหลดมา
5. เมื่อติดตั้งสำเร็จ สามารถเปิดตัวอย่างได้ที่เมนู File ➔ Examples ➔ MeOTA ➔ ESP32_WiFi_OTA

3. ตัวอย่างโค้ดเริ่มต้น (ESP32 Wi-Fi Client)

คัดลอกโค้ดตัวอย่างด้านล่างนี้ลงใน Arduino IDE (💡 แนะนำ: คุณสามารถกดปุ่ม '💻 โค้ดเชื่อมต่อ' ในหน้าจัดการอุปกรณ์เพื่อรับโค้ดที่กรอกรหัส Device ID และ Server URL ของคุณให้เสร็จสรรพได้ทันที):

#include <WiFi.h>
#include <MeOTA.h>

const char* ssid     = "YOUR_WIFI_SSID";
const char* password = "YOUR_WIFI_PASSWORD";

// MeOTA Enterprise Cloud Endpoint & Hardware ID
const char* otaServer    = "https://ota.258877.xyz";
const char* deviceId     = "FARM_NODE_01";
const char* currentFwVer = "1.0.0";

MeOTA ota;
unsigned long lastCheck = 0;

void setup() {
  Serial.begin(115200);
  WiFi.begin(ssid, password);
  while (WiFi.status() != WL_CONNECTED) {
    delay(500);
    Serial.print(".");
  }

  // Initialize MeOTA client (Auto-provisions SN on first connect)
  ota.begin(otaServer, deviceId, currentFwVer);

  // Confirm successful boot to cancel ESP32 automatic rollback
  ota.markAppValid();

  // Send initial heartbeat (Battery 95%, Wi-Fi RSSI)
  ota.sendHeartbeat(95, WiFi.RSSI());
}

void loop() {
  // Check for firmware updates every 60 seconds
  if (millis() - lastCheck > 60000) {
    lastCheck = millis();

    MeOTAUpdateInfo update = ota.checkUpdate();
    if (update.updateAvailable) {
      Serial.printf("New version %s found! Upgrading...\n", update.targetVersion.c_str());
      ota.updateFromWiFi(update);
    } else {
      Serial.println("Firmware is up to date.");
    }
  }
}

4. ตัวอย่างการส่งค่าเซนเซอร์ & Smart Farm Telemetry

MeOTA ไม่ได้จำกัดอยู่แค่อัปเดตเฟิร์มแวร์เท่านั้น บอร์ดยังสามารถส่งค่าเซนเซอร์ขึ้นคลาวด์เพื่อมอนิเตอร์บน Dashboard ได้:

// Send farm sensor telemetry: Soil Moisture, Air Temp, Humidity, Valve Status
DynamicJsonDocument doc(256);
doc["soil_moisture"] = 65.4;
doc["temperature"]   = 28.5;
doc["humidity"]      = 74.2;
doc["valve_state"]   = "OPEN";
doc["group"]         = "Smart Farm Zone A";

String jsonString;
serializeJson(doc, jsonString);

// Push telemetry to MeOTA cloud
ota.sendTelemetryJson(jsonString);

5. ระบบ Dual-Boot A/B Safe Rollback ป้องกันอุปกรณ์ค้าง (Anti-Brick)

ESP32 มีการแบ่ง Flash Memory เป็น 2 ส่วน (ota_0 และ ota_1):

• เมื่อดาวน์โหลดเฟิร์มแวร์ใหม่ ระบบจะเขียนลงพาร์ทิชันสำรองและสลับให้บูตจากพาร์ทิชันนั้นในสถานะ PENDING_VERIFY
• เมื่อเครื่องบูตขึ้นมาและเชื่อมต่อเน็ตสำเร็จ ฟังก์ชัน ota.markAppValid() จะถูกเรียกเพื่อยืนยันว่าเฟิร์มแวร์ทำงานได้ปกติ
• หากเฟิร์มแวร์ใหม่มีบั๊กหรือแครช (Boot Loop): ESP32 Hardware Bootloader จะถอยกลับ (Rollback) ไปรันเฟิร์มแวร์เวอร์ชันเดิมทันที เครื่องจึงไม่มีวันดับหรือค้าง (Anti-brick)!

6. ระบบออก Serial Number อัตโนมัติ & การจัดกลุ่มโครงการ (Fleet Grouping)

MeOTA ออกแบบมาเพื่อการบริหารจัดการอุปกรณ์ IoT เชิงพาณิชย์ขนาดใหญ่ ด้วยระบบลงทะเบียนอัตโนมัติและระบบจัดกลุ่มอุปกรณ์เต็มรูปแบบ:

7. REST API Reference (Clean URLs)

อุปกรณ์ฮาร์ดแวร์ทุกประเภทสามารถเชื่อมต่อผ่าน REST API มาตรฐานได้:

8. คำถามที่พบบ่อย (Troubleshooting & FAQ)