الفرق بين المراجعتين ل"Arduino/serial/ifserial"
اذهب إلى التنقل
اذهب إلى البحث
جميل-بيلوني (نقاش | مساهمات) (إضافة محتويات الصفحة.) |
جميل-بيلوني (نقاش | مساهمات) ط |
||
| (مراجعة متوسطة واحدة بواسطة نفس المستخدم غير معروضة) | |||
| سطر 1: | سطر 1: | ||
| − | <noinclude>{{DISPLAYTITLE: | + | <noinclude>{{DISPLAYTITLE:التابع <code>Serial.if(Serial)</code> في أردوينو}}</noinclude> |
| − | + | يتحقَّق التابع <code>if(Serial)</code> إن كان المنفذ <code>Serial</code> التسلسلي المُمرَّر إليه جاهزًا للاستعمال. | |
| − | في لوحات أردوينو Leonardo، | + | في لوحات أردوينو Leonardo، يتحقَّ التابع <code>if(Serial)</code> إن كان منفذ الاتصال USB CDC مفتوحًا أم لا. في جميع النسخ الأخرى (من ضمنها <code>if(Serial1)</code>) في لوحات Leonardo، ذلك الاستدعاء سيعيد دومًا القيمة <code>true</code>. |
| − | + | عُرِّف هذا التابع في الإصدار أردوينو 1.0.1. | |
==البنية العامة== | ==البنية العامة== | ||
<syntaxhighlight lang="arduino"> | <syntaxhighlight lang="arduino"> | ||
| سطر 35: | سطر 35: | ||
</syntaxhighlight> | </syntaxhighlight> | ||
==انظر أيضًا== | ==انظر أيضًا== | ||
| − | * | + | *التابع <code>[[Arduino/serial/available|available()]]</code>: يجلب عدد البايتات (المحارف) المتاحة للقراءة من منفذ الاتصال التسلسلي. |
| − | * | + | *التابع <code>[[Arduino/serial/availableforwrite|availableForWrite()]]</code>: يجلب عدد البايتات (المحارف) المتاحة للكتابة في ذاكرة التخزين المؤقتة لمنفذ الاتصال التسلسلي دون حجب عملية الكتابة. |
| − | * | + | *التابع <code>[[Arduino/serial/begin|begin()]]</code>: يضبط معدل تدفق البتات في الثانية الواحدة (baud) لعملية نقل البيانات عبر الاتصال التسلسلي. |
| − | * | + | *التابع <code>[[Arduino/serial/end|end()]]</code>: يعطِّل الاتصال التسلسلي المفتوح محرِّرةً بذلك الرجل 0 (RX) والرجل 1 (TX) لتصبح قابلةً للاستعمال كدخل أو خرج رقمي. |
| − | * | + | *التابع <code>[[Arduino/serial/flush|flush()]]</code>: ينتظر اكتمال عملية نقل البيانات المرسلة عبر الاتصال التسلسلي |
| − | * | + | *التابع <code>[[Arduino/serial/settimeout|setTimeout()]]</code>: يضبط المهلة الزمنية القصوى بالميلي ثانية لانتظار وصول البيانات من منفذ الاتصال التسلسلي. |
| − | * | + | *التابع <code>[[Arduino/serial/serialevent|serialEvent()]]</code>: يُستدعَى عندما يكون هنالك بيانات متاحة للقراءة عبر منفذ الاتصال التسلسلي. |
==مصادر== | ==مصادر== | ||
| − | *[https://www.arduino.cc/reference/en/language/functions/communication/serial/ifserial/ صفحة | + | *[https://www.arduino.cc/reference/en/language/functions/communication/serial/ifserial/ صفحة التابع if(Serial) في توثيق أردوينو الرسمي.] |
[[تصنيف: Arduino]] | [[تصنيف: Arduino]] | ||
| − | [[تصنيف: Arduino | + | [[تصنيف: Arduino Method]] |
[[تصنيف: Arduino Communication]] | [[تصنيف: Arduino Communication]] | ||
[[تصنيف: Arduino Serial]] | [[تصنيف: Arduino Serial]] | ||
المراجعة الحالية بتاريخ 17:56، 6 نوفمبر 2018
يتحقَّق التابع if(Serial) إن كان المنفذ Serial التسلسلي المُمرَّر إليه جاهزًا للاستعمال.
في لوحات أردوينو Leonardo، يتحقَّ التابع if(Serial) إن كان منفذ الاتصال USB CDC مفتوحًا أم لا. في جميع النسخ الأخرى (من ضمنها if(Serial1)) في لوحات Leonardo، ذلك الاستدعاء سيعيد دومًا القيمة true.
عُرِّف هذا التابع في الإصدار أردوينو 1.0.1.
البنية العامة
// جميع اللوحات
if (Serial)
// Leonardo لوحات أردوينو
if (Serial1)
// Mega لوحات أردوينو
if (Serial1)
if (Serial2)
if (Serial3)
القيم المعادة
تعاد القيمة true المنطقية إن كان منفذ الاتصال التسلسلي المحدَّد متاحًا. ستعاد القيمة false إن استُعلِم عن الاتصال USB CDC التسلسلي في لوحات Leonardo قبل أن يكون جاهزًا.
أمثلة
مثال على تهيئة الاتصال التسلسلي وانتظار فتح المنفذ:
void setup() {
// تهيئة الاتصال التسلسلي والانتظار اكتمال فتح المنفذ
Serial.begin(9600);
while (!Serial) {
; // انتظار منفذ الاتصال التسلسلي لكي يتصل. هذا الأمر مطلوب من أجل المنفذ USB الأصلي
}
}
void loop() {
// تنفيذ بقية المهام بشكل طبيعي
}
انظر أيضًا
- التابع
available(): يجلب عدد البايتات (المحارف) المتاحة للقراءة من منفذ الاتصال التسلسلي.
- التابع
availableForWrite(): يجلب عدد البايتات (المحارف) المتاحة للكتابة في ذاكرة التخزين المؤقتة لمنفذ الاتصال التسلسلي دون حجب عملية الكتابة. - التابع
begin(): يضبط معدل تدفق البتات في الثانية الواحدة (baud) لعملية نقل البيانات عبر الاتصال التسلسلي. - التابع
end(): يعطِّل الاتصال التسلسلي المفتوح محرِّرةً بذلك الرجل 0 (RX) والرجل 1 (TX) لتصبح قابلةً للاستعمال كدخل أو خرج رقمي. - التابع
flush(): ينتظر اكتمال عملية نقل البيانات المرسلة عبر الاتصال التسلسلي - التابع
setTimeout(): يضبط المهلة الزمنية القصوى بالميلي ثانية لانتظار وصول البيانات من منفذ الاتصال التسلسلي. - التابع
serialEvent(): يُستدعَى عندما يكون هنالك بيانات متاحة للقراءة عبر منفذ الاتصال التسلسلي.