Arduino/serial/serialevent

تُستدعَى الدالة serialEvent()‎ عندما يكون هنالك بيانات متاحة للقراءة عبر منفذ الاتصال التسلسلي. استعمل الدالة read() ضمن هذه الدالة من أجل التقاط تلك البيانات وقراءتها.

ملاحظة: الدالة serialEvent()‎ غير متوافقة في الوقت الحالي مع اللوحات Esplora، أو Leonardo، أو Micro.

البنية العامة

void serialEvent(){
   // المهام المراد تنفيذها عند استدعاء الدالة
}

// :فقط Mega في لوحات أردوينو
void serialEvent1(){
   // المهام المراد تنفيذها عند استدعاء الدالة
}

void serialEvent2(){
   // المهام المراد تنفيذها عند استدعاء الدالة
}

void serialEvent3(){
   // المهام المراد تنفيذها عند استدعاء الدالة
}

القيم المعادة

لا يعاد أي شيء.

انظر أيضًا

• الدالة available()‎: تجلب عدد البايتات (المحارف) المتاحة للقراءة من منفذ الاتصال التسلسلي.
• الدالة find()‎: تتحقَّق من وجود السلسلة النصية المُمرَّرة إليها ضمن بيانات ذاكرة التخزين المؤقتة للاتصال التسلسلي.
• الدالة parseFloat()‎: تعيد أول عدد عشري صالح من مخزَّن الاتصال التسلسلي المؤقت.
• الدالة parseInt()‎: تعيد أول عدد صحيح صالح من مخزَّن الاتصال التسلسلي المؤقت.
• الدالة read()‎: تقرأ البيانات المستلمة عبر الاتصال التسلسلي.
• الدالة readBytes()‎: تقرأ البيانات المستلمة عبر الاتصال التسلسلي وتضعها في متغير يمثِّل مخزن مؤقت (buffer). 
• الدالة readBytesUntil()‎: تقرأ جزءًا محدَّدًا من البيانات المستلمة عبر الاتصال التسلسلي وتضعها في متغير يمثِّل مخزن مؤقت (buffer).
• الدالة readString()‎: تقرأ المحارف المستلمة عبر الاتصال التسلسلي وتعيدها كسلسلة نصية.
• الدالة readStringUntil()‎: تقرأ جزءًا من المحارف المستلمة عبر الاتصال التسلسلي وتعيدها كسلسلة نصية.

• مثال عملي يشرح كيفية استعمال الدالة serialEvent()‎ بشكل مفصَّل وكامل.

مصادر

• صفحة الدالة Serial.serialEvent()‎ في توثيق أردوينو الرسمي.