esptouch_flutter

esptouch_flutter

Plugin Flutter untuk ESP-Touch untuk mengonfigurasi jaringan untuk perangkat ESP-8266 dan ESP-32. Berjalan di iOS dan Android.

esptouch_flutter adalah paket plugin flutter yang berisi API untuk ESP-touch yang ditulis dalam DART dikombinasikan dengan implementasi khusus platform untuk Android menggunakan Java dan iOS menggunakan Objective-C.

Paket ini memberikan kemampuan penyesuaian yang tinggi untuk tugas -tugas Touch ESP dan antarmuka DART idiomatik untuk meluncurkan tugas. Parameter tugas khusus memungkinkan pengguna plugin ini mengubah berapa lama tugas berjalan, Anda dapat mengaturnya menjadi jam, jika ini yang diperlukan alur kerja Anda.

Tautan penting

• Bintang repo di github! ️
• Periksa info paket di pub.dev
• Buka masalah
• Bacalah dokumen yang kami berupaya ke dalam dokumen, jadi jika ada sesuatu yang masih belum jelas, buka suatu masalah. Kami akan mencoba membantu Anda dan memperbarui dokumen.
• Paket DART ini dibuat oleh tim pengembangan SMAHO.

Penggunaan

Contoh aplikasi

Untuk aplikasi contoh lengkap , lihat folder example di repositori.

Aplikasi Contoh memungkinkan Anda mengonfigurasi WiFi SSID, BSSID, kata sandi, durasi tugas, jumlah tugas yang diharapkan dan banyak lagi.

Untuk aplikasi yang paling sederhana , lihat repositori smaho-engineering/esptouch_flutter_kotlin_example .

Cuplikan kode

 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 ();

Jika Anda ingin menyesuaikan tugas, berikan instance ESPTouchTaskParameter sebagai taskParameter untuk ESPTouchTask . Dalam contoh kode, saya menentukan jenis untuk kejelasan tetapi Anda dapat menghilangkan tipe karena DART dapat menyimpulkannya.

 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 ();

Dalam contoh dunia nyata, Anda akan mendapatkan kredensial WiFi dari pengguna dan Anda bisa menampilkan perangkat yang dikonfigurasi, menyimpannya secara lokal di SQLite atau mengirimkannya ke backend Anda.

Fundamental

Gunakan telepon sungguhan untuk pengembangan. Plugin ini tidak akan bekerja di emulator dan simulator, jadi Anda memerlukan ponsel nyata untuk pengembangan. Jalankan flutter devices untuk memverifikasi.

Siapkan perangkat tertanam Anda. Untuk memverifikasi bahwa aplikasi ESP-Touch berfungsi, Anda memerlukan beberapa perangkat keras dengan ESP8266 dan ESP32 untuk terhubung ke jaringan WiFi Anda.

connectivity

Anda dapat memberikan cara yang mudah untuk mendapatkan SSID dan BSSID WiFi Network saat ini. Gunakan plugin connectivity untuk menemukan status konektivitas jaringan (WiFi & seluler/seluler) di Android dan iOS.

Esp-touch

Menggunakan ESP-Touch, Anda dapat mengonfigurasi jaringan untuk perangkat ESP8266 dan ESP32.

Protokol ESP-Touch ESPressif mengimplementasikan teknologi Config Config untuk membantu pengguna menghubungkan perangkat ESP8266EX- dan ESP32-EMBEDDDD ke jaringan Wi-Fi melalui konfigurasi sederhana pada smartphone.

Sumber daya

Anda dapat membaca lebih lanjut tentang ESP-Touch di sini:

• Espressif ESP-Touch Tinjauan
• Panduan Pengguna ESP-Touch ( .pdf )
• Referensi API Konfigurasi Cerdas - Kami tidak langsung menggunakan ini di plugin, tetapi dapat membantu Anda memahami cara kerja
• EspressifApp/EsptouchForIOS ESP-Touch untuk iOS Menggunakan Objective-C
• EspressifApp/EsptouchForAndroid ESP-Touch untuk Android Menggunakan Java

Modul iOS dan Android asli harus sangat disesuaikan dan diubah untuk mendukung parameter tugas khusus.

Masalah yang diketahui

• Kami membutuhkan kemampuan kustomisasi penuh untuk parameter tugas sentuh, ini membuat mengubah sebagian besar kode sisi platform Android dan iOS yang diperlukan. Kami menambahkan pembangun untuk parameter tugas karena ini tampak seperti solusi yang membutuhkan sedikit perubahan pada kode platform.
• Satu-satunya cara saya dapat mengimplementasikan plugin ini adalah dengan menempelkan kode platform khusus ke dalam proyek ini. Salah satu alasan untuk ini adalah bahwa itu tidak dipublikasikan di mana pun sebagai paket yang mudah diinstal, dan alasan kedua adalah bahwa saya harus mengubah kode platform untuk mendukung konfigurasi EsptouchTaskParameters. Ini berarti bahwa perubahan baru pada repositori Git asli tidak secara otomatis muncul dalam proyek ini, jadi kami perlu memperbarui kode Android dan iOS secara manual.
• Aplikasi Android dan iOS yang mendasarinya mendukung parameter tugas yang berbeda. Ada beberapa perubahan terutama di sekitar penanganan IPv4 vs IPv6. Plugin tidak menangani semua perbedaan ini.
• Melacak tugas jadi diperlukan di sisi Flutter.
• Dukungan AES (Terakhir saya memeriksa Dukungan berbeda pada Android dan iOS, jadi saya belum menambahkannya)

Breaking Change di iOS 14.6

Dimulai dengan iOS 14.6 com.apple.developer.networking.multicast Intitlement diperlukan, untuk memungkinkan penyiaran paket IP di iOS, yang digunakan oleh Esptouch.

Agar Aktifkannya, Anda perlu meminta EntitLemant sebagai pemegang akun di sini. Setelah Anda terdaftar, Anda dapat mengonfigurasinya di sini

Menyumbang

Ini adalah proyek open-source yang dibangun oleh tim teknik Smaho dari Munich untuk membungkus kit aplikasi seluler ESP-touch Espressif.

Berdebar

Jika Anda datang dari latar belakang IoT, Anda mungkin tidak tahu apa itu Flutter.

Flutter adalah toolkit UI Google untuk menciptakan pengalaman asli yang indah untuk iOS dan Android dari basis kode tunggal. Untuk bantuan memulai dengan flutter, lihat dokumentasi online. Repositori ini berisi paket plugin flutter untuk ESP-touch. Paket plugin adalah paket khusus yang mencakup kode implementasi khusus platform untuk Android dan iOS. Bagian flutter dari aplikasi mengirim pesan ke host (iOS atau Android) melalui saluran platform. Plugin ini sangat bergantung pada saluran platform (saluran acara).