esptouch_flutter

esptouch_flutter

البرنامج المساعد Flutter لـ ESP-Touch لتكوين شبكة لأجهزة ESP-8266 و ESP-32. يعمل على iOS و Android.

esptouch_flutter هي حزمة مكون الإضافي Flutter والتي تحتوي على واجهة برمجة تطبيقات لـ ESP-TACHET مكتوبة في DART مع تطبيق خاص بالنظام الأساسي لنظام Android باستخدام JAVA و IOS باستخدام Objective-C.

توفر هذه الحزمة قابلية للتخصيص العالي لمهام Touch ESP وواجهة DART الاصطلاحية لإطلاق المهام. تتيح معلمات المهمة المخصصة لمستخدمي هذا البرنامج المساعد تغيير المدة التي يتم فيها تشغيل المهمة ، يمكنك ضبطها على ساعات ، إذا كان هذا هو ما يتطلبه سير عملك.

روابط مهمة

• نجم الريبو على جيثب! ️
• تحقق من معلومات الحزمة على pub.dev
• افتح مشكلة
• اقرأ المستندات التي بذلناها جهداً في المستندات ، لذلك إذا كان هناك شيء غير واضح ، فتح مشكلة. سنحاول أن نساعدك على الخروج وتحديث المستندات.
• يتم إنشاء حزمة DART هذه من قبل فريق تطوير SMAHO.

الاستخدام

مثال التطبيق

للحصول على تطبيق مثال كامل ، راجع مجلد example في المستودع.

يتيح لك تطبيق المثال تكوين WiFi SSID و BSSID وكلمة المرور ومدة المهمة وعدد المهام المتوقع وغيرها الكثير.

للحصول على أبسط تطبيق ممكن ، راجع مستودع smaho-engineering/esptouch_flutter_kotlin_example .

قصاصات الكود

 import 'package:esptouch_flutter/esptouch_flutter.dart' ;

// Somewhere in your widget...
final ESPTouchTask task = ESPTouchTask (
  ssid : 'My WiFi network' ,
  bssid : 'ab:cd:ef:12:23:34' ,
  password : 'I love SMAHO' ,
);
final Stream < ESPTouchResult > stream = task. execute ();
final printResult = ( ESPTouchResult result) {
 print ( 'IP: ${ result . ip } MAC: ${ result . bssid }' );
};
StreamSubscription < ESPTouchResult > streamSubscription = stream. listen (printResult);

// Don't forget to cancel your stream subscription.
// You might cancel after the UDP wait+send time has passed (default 1 min)
// or you could cancel when the user asked to cancel
// for example, either via X button, or popping a route off the stack.
streamSubscription. cancel ();

إذا كنت ترغب في تخصيص المهمة ، فوفر مثيل ESPTouchTaskParameter كمهم taskParameter إلى ESPTouchTask . في مثال الكود ، أقوم بتحديد أنواع الوضوح ولكن يمكنك حذف الأنواع التي يمكن أن تستنتجها DART.

 final ESPTouchTask task = ESPTouchTask (
  ssid : 'My WiFi network' ,
  bssid : 'ab:cd:ef:12:23:34' ,
  password : 'I love Flutter and ESP-Touch, too' ,
  // Tweak the task using task parameters
  taskParameter : ESPTouchTaskParameter (waitUdpReceiving : Duration (hour : 12 )),
);
// You can still stop the task at any point by calling .cancel on the stream subscription:
streamSubscription. cancel ();

في مثال حقيقي للعالم ، ستحصل على بيانات اعتماد WiFi من المستخدم ويمكنك إما عرض الجهاز الذي تم تكوينه أو حفظه محليًا في SQLite أو إرساله إلى الواجهة الخلفية.

الأساسيات

استخدم هاتفًا حقيقيًا للتطوير. لن يعمل المكون الإضافي في المحاكيات والمحاكاة ، لذلك تحتاج إلى هواتف حقيقية للتنمية. تشغيل flutter devices للتحقق.

تحضير أجهزتك المدمجة. للتحقق من أن تطبيق ESP-Touch يعمل ، تحتاج إلى بعض الأجهزة مع ESP8266 و ESP32 للاتصال بشبكة WiFi الخاصة بك.

connectivity

قد توفر طريقة سهلة للحصول على SSID و BSSID لشبكة شبكة WiFi الحالية. استخدم المكون الإضافي connectivity لاكتشاف حالة الشبكة (WiFi & Mobile/Cellular) على Android و iOS.

esp-touch

باستخدام ESP-Touch ، يمكنك تكوين شبكة لأجهزة ESP8266 و ESP32.

يقوم بروتوكول ESP-Touch الخاص بـ ESPREFIF بتنفيذ تقنية التكوين الذكية لمساعدة المستخدمين على توصيل الأجهزة التي تُحمل ESP8266EX- و ESP32 بشبكة Wi-Fi من خلال التكوين البسيط على الهاتف الذكي.

موارد

يمكنك قراءة المزيد عن ESP-Touch هنا:

• نظرة عامة على ESP-Touch
• دليل مستخدم ESP-Touch ( .pdf )
• مرجع Smart Config API - لا نستخدم هذا مباشرة في المكون الإضافي ، ولكن يمكن أن يساعدك في فهم كيفية عمل الأشياء
• EspressifApp/EsptouchForIOS esp-touch لـ iOS باستخدام Objective-c
• EspressifApp/EsptouchForAndroid ESP-Touch لنظام Android باستخدام Java

كان لا بد من تخصيص وحدات iOS و Android الأصلية بشكل كبير من أجل دعم معلمات المهمة المخصصة.

القضايا المعروفة

• كنا بحاجة إلى التخصيص الكامل لمعلمات Touch Task ، هذه جعلت تغيير جزء كبير من الرمز الجانبي لنظام Android و iOS ضروري. أضفنا بناة لمعلمات المهمة لأن هذا يبدو وكأنه حل يتطلب أقل تغييرات على رمز النظام الأساسي.
• الطريقة الوحيدة التي يمكنني من خلالها تنفيذ هذا البرنامج المساعد هي لصق الكود الخاص بالنظام الأساسي في هذا المشروع. كان أحد أسباب ذلك هو أنه لم يتم نشره في أي مكان كحزم قابلة للتثبيت بسهولة ، والسبب الثاني هو أنه كان علي تعديل رمز النظام الأساسي لدعم تكوين EsptouchTaskParameters. هذا يعني أن التغييرات الجديدة على مستودعات GIT الأصلية لا تظهر تلقائيًا في هذا المشروع ، لذلك نحتاج إلى تحديث رمز Android و iOS يدويًا.
• تدعم تطبيقات Android و iOS الأساسية معلمات المهام المختلفة. كانت هناك تغييرات متعددة خاصة حول معالجة IPv4 مقابل IPv6. المكون الإضافي لا يتعامل مع كل هذه الاختلافات.
• يعد تتبع المهام النهائية ضروريًا على جانب Flutter.
• دعم AES (آخر آخر راجعت الدعم مختلف على Android و iOS ، لذلك لم أضفها)

كسر التغيير في iOS 14.6

بدءًا من iOS 14.6 ، مطلوب com.apple.developer.networking.multicast ، للسماح ببث حزم IP على iOS ، والتي تستخدمها Esptouch.

من أجل تمكينها ، تحتاج إلى طلب Entitlemant كحامل حساب هنا. بمجرد التسجيل ، يمكنك تكوينه هنا

يساهم

هذا مشروع مفتوح المصدر الذي صممه فريق SMAHO الهندسي من ميونيخ لالتفاف مجموعات تطبيقات ESP-Touch من ESPREFIF.

رفرفة

إذا كنت قادمًا من خلفية إنترنت الأشياء ، فقد لا تعرف ما هو الرفرفة.

Flutter هي مجموعة أدوات واجهة المستخدم الخاصة بـ Google لإنشاء تجارب جميلة ومتوسعة لنظام التشغيل iOS و Android من قاعدة كود واحدة. للمساعدة في البدء مع Flutter ، عرض الوثائق عبر الإنترنت. يحتوي هذا المستودع على حزمة مكون الإضافي لـ Flutter لـ ESP-Touch. حزمة البرنامج المساعد عبارة عن حزمة متخصصة تتضمن رمز تنفيذ خاص بالنظام الأساسي لنظام Android و iOS. يرسل جزء الرفرفة من التطبيق رسائل إلى مضيفه (iOS أو Android) عبر قناة النظام الأساسي. يعتمد هذا البرنامج المساعد على قنوات النظام الأساسي (قنوات الأحداث) بشدة.