الفرق بين المراجعتين ل"Arduino/serial/read"
اذهب إلى التنقل
اذهب إلى البحث
جميل-بيلوني (نقاش | مساهمات) (إضافة محتويات الصفحة.) |
جميل-بيلوني (نقاش | مساهمات) ط |
||
سطر 1: | سطر 1: | ||
− | <noinclude>{{DISPLAYTITLE: | + | <noinclude>{{DISPLAYTITLE:التابع <code>Serial.read()</code> في أردوينو}}</noinclude> |
− | + | يقرأ التابع <code>read()</code> البيانات المستلمة عبر الاتصال التسلسلي. | |
− | + | يرث التابع <code>read()</code> من الصنف <code>[[Arduino/stream|Stream]]</code>. | |
==البنية العامة== | ==البنية العامة== | ||
<syntaxhighlight lang="arduino"> | <syntaxhighlight lang="arduino"> | ||
سطر 36: | سطر 36: | ||
</syntaxhighlight> | </syntaxhighlight> | ||
==انظر أيضًا== | ==انظر أيضًا== | ||
− | * | + | *التابع <code>[[Arduino/serial/available|available()]]</code>: يجلب عدد البايتات (المحارف) المتاحة للقراءة من منفذ الاتصال التسلسلي. |
− | * | + | *التابع <code>[[Arduino/serial/find|find()]]</code>: يتحقَّق من وجود السلسلة النصية المُمرَّرة إليه ضمن بيانات ذاكرة التخزين المؤقتة للاتصال التسلسلي. |
− | * | + | *التابع <code>[[Arduino/serial/parseint|parseInt()]]</code>: يعيد أول [[Arduino/int|عدد صحيح]] صالح من مخزَّن الاتصال التسلسلي المؤقت. |
− | * | + | *التابع <code>[[Arduino/serial/readbytes|readBytes()]]</code>: يقرأ البيانات المستلمة عبر الاتصال التسلسلي وتضعها في متغير يمثِّل مخزن مؤقت (buffer). |
− | * | + | *التابع <code>[[Arduino/serial/readbytesuntil|readBytesUntil()]]</code>: يقرأ جزءًا محدَّدًا من البيانات المستلمة عبر الاتصال التسلسلي ويضعها في متغير يمثِّل مخزن مؤقت (buffer). |
− | * | + | *التابع <code>[[Arduino/serial/readstring|readString()]]</code>: يقرأ المحارف المستلمة عبر الاتصال التسلسلي ويعيدها كسلسلة نصية. |
− | * | + | *التابع <code>[[Arduino/serial/readstringuntil|readStringUntil()]]</code>: يقرأ جزءًا من المحارف المستلمة عبر الاتصال التسلسلي ويعيدها كسلسلة نصية. |
− | * | + | *التابع <code>[[Arduino/serial/settimeout|setTimeout()]]</code>: يضبط المهلة الزمنية القصوى بالميلي ثانية لانتظار وصول البيانات من منفذ الاتصال التسلسلي. |
− | * | + | *التابع <code>[[Arduino/serial/serialevent|serialEvent()]]</code>: يُستدعَى عندما يكون هنالك بيانات متاحة للقراءة عبر منفذ الاتصال التسلسلي. |
==مصادر== | ==مصادر== | ||
− | *[https://www.arduino.cc/reference/en/language/functions/communication/serial/read/ صفحة | + | *[https://www.arduino.cc/reference/en/language/functions/communication/serial/read/ صفحة التابع Serial.read() في توثيق أردوينو الرسمي.] |
[[تصنيف: Arduino]] | [[تصنيف: Arduino]] | ||
− | [[تصنيف: Arduino | + | [[تصنيف: Arduino Method]] |
[[تصنيف: Arduino Communication]] | [[تصنيف: Arduino Communication]] | ||
[[تصنيف: Arduino Serial]] | [[تصنيف: Arduino Serial]] |
المراجعة الحالية بتاريخ 18:16، 6 نوفمبر 2018
يقرأ التابع 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()
: يُستدعَى عندما يكون هنالك بيانات متاحة للقراءة عبر منفذ الاتصال التسلسلي.