Arduino/serial/available

يجلب التابع available()‎ عدد البايتات (المحارف) المتاحة للقراءة من منفذ الاتصال التسلسلي. يمثِّل هذا العدد كمية البيانات التي استُقبلَت مسبقًا وخُزِّنَت في ذاكرة التخزين المؤقتة للمنفذ التسلسلي ذي الحجم 64 بايت.

يرث التابع available()‎ من الصنف Stream.

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

Serial.available()

// فقط Mega لوحات أردوينو
Serial1.available()
Serial2.available()
Serial3.available()

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

يعاد عدد البايتات المستلمة والمتاحة للقراءة.

أمثلة

يعيد المثال التالي المحرف المستلم عبر واجهة التخاطب التسلسلية:

// متغير لتخزين البيانات الآتية من المنفذ التسلسلي
int incomingByte = 0;

void setup() {
        // فتح منفذ اتصال تسلسلي وتعيين معدل تدفق البيانات إلى 9600 بت/ثا
	Serial.begin(9600);	
}

void loop() {

	// الرد عند استلام بيانات فقط
	if (Serial.available() > 0) {
		// قراءة البايت المستلم
		incomingByte = Serial.read();

		// إعادة إرسال ما تم استلامه
		Serial.print("I received: ");
		Serial.println(incomingByte, DEC);
	}
}

المثال التالي خاص بلوحة أردوينو Mega. يعمل المثال على إرسال البيانات المستلمة من أحد منافذ الاتصال التسلسلية إلى منفذ آخر. يمكن تطبيق هذا الأمر لوصل جهاز مع الحاسوب مثلًا عبر لوحة أردوينو:

void setup() {
  Serial.begin(9600);
  Serial1.begin(9600);

}

void loop() {
  // القراءة من المنفذ 0، والإرسال إلى المنفذ 1
  if (Serial.available()) {
    int inByte = Serial.read();
    Serial1.print(inByte, DEC);

  }
  // القراءة من المنفذ 1، والإرسال إلى المنفذ 0
  if (Serial1.available()) {
    int inByte = Serial1.read();
    Serial.print(inByte, DEC);
  }
}

انظر أيضًا

• التابع availableForWrite()‎: يجلب عدد البايتات (المحارف) المتاحة للكتابة في ذاكرة التخزين المؤقتة لمنفذ الاتصال التسلسلي دون حجب عملية الكتابة.
• التابع begin()‎: يضبط معدل تدفق البتات في الثانية الواحدة (baud) لعملية نقل البيانات عبر الاتصال التسلسلي.
• التابع find()‎: يتحقَّق من وجود السلسلة النصية المُمرَّرة إليه ضمن بيانات ذاكرة التخزين المؤقتة للاتصال التسلسلي.
• التابع findUntil()‎: يتحقَّق من وجود السلسلة النصية المُمرَّرة إليه ضمن جزء محدَّد من بيانات ذاكرة التخزين المؤقتة للاتصال التسلسلي.
• التابع parseFloat()‎: يعيد أول عدد عشري صالح من مخزَّن الاتصال التسلسلي المؤقت.
• التابع read()‎: يقرأ البيانات المستلمة عبر الاتصال التسلسلي.
• التابع readBytes()‎: يقرأ البيانات المستلمة عبر الاتصال التسلسلي ويضعها في متغير يمثِّل مخزن مؤقت (buffer). 
• التابع readString()‎: يقرأ المحارف المستلمة عبر الاتصال التسلسلي ويعيدها كسلسلة نصية.
• التابع setTimeout()‎: يضبط المهلة الزمنية القصوى بالميلي ثانية لانتظار وصول البيانات من منفذ الاتصال التسلسلي.

مصادر

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