Arduino/serial/read

تقرأ الدالة read()‎ البيانات المستلمة عبر الاتصال التسلسلي.

ترث الدالة read()‎ من الصنف Stream.

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

Serial.read()

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

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

يعاد البايت الأول من البيانات المتاحة الآتية من منفذ الاتصال التسلسلي المحدَّد، أو تعاد القيمة 1- إن لم يكن هنالك أية بيانات متاحة للقراءة.

أمثلة

قراءة البيانات المستلمة من منفذ الاتصال التسلسلي وإعادة إرسالها:

int incomingByte = 0;   // متغير لتخزين البيانات المراد قراءتها

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

void loop() {

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

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

انظر أيضًا

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

مصادر

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