التعرف على وظيفة Serial.readString ()
تعد الوظيفة Serial.readString () جزءًا من مكتبة Arduino التسلسلية ، والتي تتيح الاتصال بين وحدة التحكم الدقيقة والكمبيوتر أو الأجهزة الخارجية الأخرى.
تسمح هذه الوظيفة للمتحكم الدقيق بقراءة سلسلة من الأحرف المرسلة من اتصال تسلسلي. تقوم الوظيفة بقراءة البيانات من المخزن المؤقت التسلسلي وإرجاع البيانات في شكل كائن سلسلة.
هذه الوظيفة موروثة من فئة Stream.
بناء الجملة
بناء جملة هذه الوظيفة كما يلي:
مسلسل. readString ( )
حدود
هذه الوظيفة لا تأخذ أي معلمات. يقرأ فقط كائن المنفذ التسلسلي.
عائدات
تُرجع سلسلة تحتوي على الأحرف المتلقاة عبر المنفذ التسلسلي. تنتهي السلسلة بالحرف الأخير الذي تم تلقيه ، والذي غالبًا ما يكون حرف سطر جديد (\ n). في حالة عدم توفر أحرف في المخزن المؤقت التسلسلي ، تقوم الوظيفة بإرجاع سلسلة فارغة ('').
ملحوظة: إذا كان حرف سطر النهاية متاحًا في البيانات ، فلن تنتهي الوظيفة مبكرًا. قد تحتوي السلسلة التي تم إرجاعها على أحرف إرجاع السطر.
رمز المثال
يوضح الكود أدناه استخدام وظيفة Serial.readString () في برمجة Arduino:
يوضح الكود أدناه استخدام وظيفة Serial.readString () في برمجة Arduino:
فارغ يثبت ( ) {مسلسل. يبدأ ( 9600 ) ؛
}
فارغ حلقة ( ) {
مسلسل. println ( 'أدخل البيانات:' ) ؛
بينما ( مسلسل. متاح ( ) == 0 ) { } // انتظر البيانات المتاحة
سلسلة teststr = مسلسل. readString ( ) ؛ // قراءة حتى انتهاء المهلة
teststr. تقليم ( ) ؛ // قم بإزالة أي \ r \ n مسافة بيضاء من نهاية السلسلة
مسلسل. مطبعة ( 'إدخال بيانات: ' ) ؛
مسلسل. println ( teststr ) ؛
لو ( teststr == 'مرحبًا' ) {
مسلسل. println ( 'مرحبا بك ايضا!' ) ؛
} آخر {
مسلسل. println ( 'أنا آسف ، لم أفهم مدخلاتك.' ) ؛
}
}
في ال يثبت() يتم تمكين الاتصال التسلسلي للوظيفة باستخدام معدل الباود 9600.
في ال حلقة() وظيفة ، يطالب الرمز المستخدم بإدخال البيانات عن طريق طباعة 'إدخال البيانات:' إلى الشاشة التسلسلية. ثم ينتظر أن تكون البيانات متاحة عن طريق التحقق مما إذا كان المخزن المؤقت التسلسلي فارغًا باستخدام وظيفة Serial.available ().
بمجرد توفر البيانات ، يقرأ الكود البيانات كسلسلة باستخدام وظيفة Serial.readString () ويزيل أي أحرف مسافة بيضاء في نهاية السلسلة باستخدام وظيفة القطع ().
ثم يقارن الكود سلسلة الإدخال بالسلسلة 'hello'. إذا كانت سلسلة الإدخال هي 'مرحبًا' ، الرمز يستجيب بالطباعة 'مرحبا بك ايضا!' على الشاشة التسلسلية. بخلاف ذلك ، ستطبع رسالة 'أنا آسف ، لم أفهم ما أدخلته'. على الشاشة التسلسلية. تتكرر وظيفة الحلقة () بعد ذلك ، مطالبة المستخدم بمزيد من المدخلات.
انتاج |
يمكننا أن نرى في المخرجات سلاسل مختلفة تقرأها الشفرة من المستخدم وتطابقها مع السلسلة 'hello'.
خاتمة
تقرأ وظيفة Serial.readString () في Arduino البيانات التسلسلية المرسلة من جهاز كمبيوتر أو أجهزة أخرى إلى اللوحة. باستخدام هذه الوظيفة ، يمكننا قراءة ومقارنة بيانات سلسلة الإدخال التسلسلية لإنشاء استجابات الإخراج مثل التحكم في أجهزة الاستشعار والأجهزة.