ما هي مجموعة أدوات التطوير SDK؟

SDK هي مكتبة برمجية C++ جاهزة مسبقاً للمتحكم الدقيق ESP32. تتعامل مع جميع تعقيدات الاتصال السحابي والمصادقة والتواصل الفوري التي يحتاجها الجهاز الذكي. بدلاً من بناء هذه البنية التحتية من الصفر، تكتب كمية صغيرة من الكود الخاص بجهازك وتتولى SDK الباقي.

عند رفع البرنامج المبني على SDK إلى ESP32، يكتسب جهازك تلقائياً:

• تهيئة الواي فاي عبر تطبيق TS Smart Home المحمول.
• التسجيل السحابي وإدارة هوية الجهاز.
• التحكم الفوري بالريلاي عبر التطبيق والـ API.
• تحديثات البرنامج التلقائية عن بُعد (OTA) المُرسَلة من المنصة.
• تنفيذ الجداول — الجداول المضبوطة في التطبيق تعمل على الجهاز نفسه.
• الإبلاغ عن الحالة — الاتصال أو الانقطاع، حالة الريلاي، وحالات الأخطاء.

لمن SDK هذه؟

صُممت SDK لمجموعة واسعة من المطورين والصانعين:

• الشركات الناشئة في مجال الأجهزة التي تبني منتجات منزل ذكي للمستهلكين وتحتاج إلى سحابة وتطبيق بدون أشهر من تطوير الخادم.
• هواة الإلكترونيات الذين يريدون لمشاريع ESP32 DIY أن تعمل مع تطبيق محمول احترافي.
• متكاملو الأنظمة الذين يضيفون تحكماً ذكياً إلى المعدات الصناعية أو التجارية.
• المعلمون والباحثون في مجال الاتصال بإنترنت الأشياء وأتمتة المنازل.

الحصول على رمز المطور

لاستخدام SDK، سجّل كمطور على منصة TS Smart Home واحصل على رمز SDK للمطور. يُضمَّن هذا الرمز في البرنامج الثابت ويحدد حساب المطور الذي تنتمي إليه أجهزتك.

1. حمّل تطبيق TS Smart Home وثبّته.
2. انتقل إلى الحساب > بوابة المطورين.
3. أكمل نموذج تسجيل المطور بتفاصيل مشروعك.
4. بعد الموافقة، يظهر رمز SDK الخاص بك في قسم بوابة المطورين بالتطبيق.

تعامل مع رمز SDK كمفتاح API خاص. لا تضعه في مستودعات عامة — فهو يُصادق على جميع الأجهزة التي تنتجها، وتعرّضه للخطر يؤثر على كل وحدة منتشرة.

معمارية SDK والاستخدام الأساسي

تتبع SDK نمط تهيئة بسيط:

#include "TSSmartHome.h"
TSSmartHome device("YOUR_SDK_TOKEN", "DEVICE_MODEL_ID");

void setup() {
  device.begin();
  device.onRelayCommand([](bool state) {
    digitalWrite(RELAY_PIN, state ? HIGH : LOW);
  });
}

void loop() {
  device.loop();
}

تدير SDK تلقائياً: استعادة اتصال الواي فاي، والتواصل مع السحابة عبر MQTT/WebSocket، وتحليل الأوامر، ومعالجة تحديثات OTA، وإرسال نبضات الحياة.

الميزات الرئيسية للـ SDK

ردود نداء التحكم بالريلاي

سجّل دوال ردود نداء تُشغَّل عند إرسال التطبيق أو جدول أمر تشغيل أو إيقاف. يستقبل ردّ النداء قيمة منطقية وأنت تقرر كيفية التحكم في مخرج الأجهزة.

تحديثات البرنامج الثابت عن بُعد (OTA)

تراقب SDK نقطة نهاية تحديث البرنامج الثابت. عند نشرك نسخة جديدة لنموذج جهازك، يُنزَّل تلقائياً ويُطبَّق على كل وحدة منتشرة في الميدان — بدون أي إجراء من المستخدم.

بيانات الجهاز المخصصة

اربط معرّف نموذج الجهاز ونسخة البرنامج الثابت بتسجيل جهازك. يتيح ذلك للمنصة إدارة تحديثات OTA بشكل صحيح — نماذج أجهزة مختلفة تحصل على بنيات برمجية مختلفة.

ما يمكنك بناؤه

تدعم SDK أي فئة أجهزة تعتمد على التحكم بالريلاي أو الإبلاغ عن الحالة:

• وصلات ذكية وشرائط طاقة ذكية
• مفاتيح إضاءة ذكية (أحادية ومزدوجة وثلاثية)
• أنظمة تحكم بالري الذكي
• وحدات تحكم في الأجهزة المنزلية بالريلاي
• تحكم تشغيل/إيقاف للمعدات الصناعية