esptouch_flutter

esptouch_flutter

ปลั๊กอิน Flutter สำหรับ ESP-Touch เพื่อกำหนดค่าเครือข่ายสำหรับอุปกรณ์ ESP-8266 และ ESP-32 ทำงานบน iOS และ Android

esptouch_flutter เป็นแพ็คเกจปลั๊กอิน Flutter ซึ่งมี API สำหรับ ESP-Touch ที่เขียนใน DART รวมกับการใช้งานเฉพาะแพลตฟอร์มสำหรับ Android โดยใช้ Java และ iOS โดยใช้ Objective-C

แพ็คเกจนี้ให้ความสามารถในการปรับแต่งสูงให้กับงาน ESP Touch และอินเทอร์เฟซ DART สำนวนสำหรับการเปิดงาน พารามิเตอร์งานที่กำหนดเองช่วยให้ผู้ใช้ปลั๊กอินนี้เปลี่ยนระยะเวลาที่งานทำงานคุณสามารถตั้งค่าเป็นชั่วโมงได้หากนี่คือสิ่งที่เวิร์กโฟลว์ของคุณต้องการ

ลิงค์สำคัญ

• แสดง repo บน GitHub!
• ตรวจสอบข้อมูลแพ็คเกจบน 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 คุณสามารถกำหนดค่าเครือข่ายสำหรับอุปกรณ์ ESP8266 และ ESP32

โปรโตคอล ESP-Touch ของ Espressif ใช้เทคโนโลยีการกำหนดค่าอัจฉริยะเพื่อช่วยให้ผู้ใช้เชื่อมต่ออุปกรณ์ ESP8266EX- และ ESP32 ที่ฝังอยู่กับเครือข่าย Wi-Fi ผ่านการกำหนดค่าอย่างง่ายบนสมาร์ทโฟน

ทรัพยากร

คุณสามารถอ่านเพิ่มเติมเกี่ยวกับ esp-touch ได้ที่นี่:

• ภาพรวม Espressif 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 the com.apple.developer.networking.multicast การให้สิทธิ์เป็นสิ่งจำเป็นเพื่อให้สามารถออกอากาศแพ็คเกจ IP บน iOS ซึ่งใช้โดย Esptouch

ในการสั่งซื้อ ot เปิดใช้งานคุณต้องขอ entitlemant เป็นเจ้าของบัญชีที่นี่ เมื่อคุณลงทะเบียนแล้วคุณสามารถกำหนดค่าได้ที่นี่

มีส่วนช่วย

นี่คือโครงการโอเพนซอร์ซที่สร้างขึ้นโดยทีมวิศวกรรม Smaho จากมิวนิคเพื่อห่อชุดแอพมือถือ ESP-Touch ของ Espressif

กระพือ

หากคุณมาจากพื้นหลัง IoT คุณอาจไม่รู้ว่า Flutter คืออะไร

Flutter เป็นชุดเครื่องมือ UI ของ Google สำหรับการสร้างประสบการณ์พื้นเมืองที่สวยงามสำหรับ iOS และ Android จาก codebase เดียว สำหรับความช่วยเหลือในการเริ่มต้นใช้งาน Flutter ให้ดูเอกสารออนไลน์ ที่เก็บนี้มีแพ็คเกจปลั๊กอิน Flutter สำหรับ ESP-Touch แพ็คเกจปลั๊กอินเป็นแพ็คเกจพิเศษที่มีรหัสการใช้งานเฉพาะแพลตฟอร์มสำหรับ Android และ iOS ส่วนที่กระพือของแอพส่งข้อความไปยังโฮสต์ (iOS หรือ Android) ผ่านช่องทางแพลตฟอร์ม ปลั๊กอินนี้อาศัยช่องทางแพลตฟอร์ม (ช่องเหตุการณ์) อย่างมาก