دالتا Arduino Serial.print() وprintln()، سطراً بسطر
أو تصفّح كل الدروس.
- 526قطعة على المنضدة
- 46لوحة تعمل الآن
- 1.00xزمن حقيقي، على كل لوحة
Serial.print(x) يرسل x إلى الشاشة التسلسلية ويبقى على السطر نفسه. Serial.println(x) يفعل الشيء نفسه ثم يُنهي السطر، فيبدأ ما يُطبع بعده في سطر جديد. استدعِ Serial.begin(9600) مرة واحدة في setup() أولاً، واضبط الشاشة التسلسلية على السرعة نفسها.
الدائرة أعلاه هي Uno وحدها، تتحدث إلى الشاشة التسلسلية. اضغط «تشغيل». ستطبع "Mokxi Arduino Uno: serial example"، ثم "pi to five places is 3.14159"، ثم "up 1000 ms" و"up 2000 ms" وهكذا، مرة كل ثانية. اكتب حرفاً في المربع أسفل الشاشة واضغط Enter: يعود الحرف A كـ"you typed: A (0x41)"، وEnter كـ"you typed: <newline>".
فيما يلي كيف يختلف print عن println بايتاً بايتاً، وكيف تختار عدد المنازل العشرية وأنظمة الأرقام، والطريقة الخاطئة لطباعة نص ورقم معاً، وكم تكلف الطباعة من الوقت، كل ذلك على Uno مع ما طُبع فعلاً.
تريد النسخة خطوة بخطوة؟ الدرس «اجعل اللوحة تتحدث» يشرح ذلك مع نقاط تحقق.
افتح الدرسالكود
هذا هو setup() من الكود الذي يعمل أعلاه. Serial.begin(115200) يفتح المنفذ بمعدل 115200 baud. print() يكتب "pi to five places is " ويترك السطر مفتوحاً، وprintln(3.14159265, 5) يضيف الرقم بخمس منازل عشرية وينهي السطر.
اطبع قبل Serial.begin() ولن يخرج شيء. طبعنا "before begin" أولاً و"after begin" ثانياً، ولم يصل إلا "after begin".
void setup() {
Serial.begin(115200);
Serial.println("Mokxi Arduino Uno: serial example");
Serial.print("pi to five places is ");
Serial.println(3.14159265, 5);
}print مقابل println
ثلاث نداءات print ونداء println، print("a") وprint("b") وprintln("c")، طبع "abc" على سطر واحد، وبدأ الـprintln التالي سطراً جديداً. نهاية السطر التي يضيفها println بايتان: رجوع إلى بداية السطر وسطر جديد، \r\n. الشاشة التسلسلية تخفيهما؛ لكن برنامجاً يقرأ المنفذ، أو لوحة أخرى، يرى كليهما.
Serial.println() دون أي شيء بين القوسين ينهي السطر فقط، وهو مفيد بعد صف من نداءات print.
void setup() {
Serial.begin(9600);
Serial.print("a");
Serial.print("b");
Serial.println("c");
Serial.println("next line");
}
void loop() {
}افتح هذا الكود في المحررالكود وحده: يضع المحرر اللوحة والقطع التي يستطيع قراءتها من الكود.
المنازل العشرية، وHEX وBIN
يطبع الرقم العشري بمنزلتين عشريتين ما لم تحدد غير ذلك. Serial.println(3.14159) طبع 3.14. أعطِ عدد المنازل كقيمة ثانية: println(3.14159, 4) طبع 3.1416 مقرباً، وprintln(2.0 / 3, 3) طبع 0.667. مع 0 منازل يقرب إلى عدد صحيح، والنصف للأعلى: 1.5 طبع 2 و2.5 طبع 3.
مع عدد صحيح، تكون القيمة الثانية هي الأساس. println(255, HEX) طبع FF وprintln(5, BIN) طبع 101، دون أصفار بادئة، فأضفها بنفسك إن أردت البتات الثمانية كلها. الرقم السالب في HEX يعرض بايتات long الأربعة كلها: -1 طبع FFFFFFFF.
void setup() {
Serial.begin(9600);
Serial.println(3.14159);
Serial.println(3.14159, 4);
Serial.println(2.0 / 3, 3);
Serial.println(1.5, 0);
Serial.println(2.5, 0);
Serial.println(255, HEX);
Serial.println(5, BIN);
Serial.println(-1, HEX);
}
void loop() {
}افتح هذا الكود في المحررالكود وحده: يضع المحرر اللوحة والقطع التي يستطيع قراءتها من الكود.
أرقام وحروف وwrite()
تحدد الدالة print() طريقة عرض الشيء بحسب نوعه. الدالة println(65) طبعت 65، والدالة println('A') طبعت A، والدالة المنطقية طبعت 1. أما Serial.write(65) فمختلفة: فهي ترسل البايت نفسه، وتعرض الشاشة الحرف الذي يحمل ذلك الرمز، أي A. استخدم print() للبشر وwrite() لإرسال بايتات خام إلى جهاز آخر.
تعيد الدالة print() أيضًا عدد الأحرف التي أرسلتها. الدالة int n = Serial.print("hello"); أعطت 5.
نص ورقم على سطر واحد
الطريقة السريعة التي لا تعمل: Serial.println("Temp: " + t); مع قيمة t تساوي 21 طبعت بضع رموز غريبة. فإضافة رقم إلى نص بين علامتي اقتباس تحرّكك على طول النص بدلًا من الدمج، والإزاحة 21 حرفًا تتجاوز نهاية "Temp: ". وقد حذّر Clang: إضافة 'int' إلى نص لا تلحق بالنص. الطريقة البسيطة هي استدعاءان، Serial.print("Temp: "); ثم Serial.println(t);، كما أن "Temp: " + String(t) تعمل أيضًا، وكلاهما طبع "Temp: 21".
من يعرف لغة C يلجأ إلى sprintf(). وهي تعمل مع الأعداد الصحيحة: "%02d:%02d" مع 7 و5 طبعت 07:05. لكنها على Uno لا تتعامل مع الأعداد العشرية: %f طبع "t=?"، لأن printf الصغير على Uno يستبعد الأعداد العشرية. استخدم dtostrf(t, 6, 2, buf) التي طبعت " 21.50"، أو اطبع العدد العشري بمفرده. ولاحظ أن %d مخصص لـ int: عند تمرير long بقيمة 100000 طبع -31072 مع تحذير، استخدم %ld مع long.
void setup() {
Serial.begin(9600);
char buf[40];
float t = 21.5;
sprintf(buf, "t=%f", t);
Serial.println(buf);
dtostrf(t, 6, 2, buf);
Serial.println(buf);
sprintf(buf, "%02d:%02d", 7, 5);
Serial.println(buf);
long big = 100000;
sprintf(buf, "%d", big);
Serial.println(buf);
sprintf(buf, "%ld", big);
Serial.println(buf);
}
void loop() {
}افتح هذا الكود في المحررالكود وحده: يضع المحرر اللوحة والقطع التي يستطيع قراءتها من الكود.
ما تكلفته الطباعة، والدالة F()
الطباعة تستغرق وقتًا يحدده معدل البود. عند 9600 بود يستغرق الحرف حوالي ملّي ثانية واحدة للإرسال. تحتفظ Uno بطابور من 64 بايت، فالسطر القصير يدخل الطابور ويواصل الكود عمله، أما السطر الطويل فينتظر توفر مساحة. سطر من 100 حرف استغرق 38504 ميكروثانية للطباعة عند 9600 بود، و3168 عند 115200. الكود الذي يطبع كثيرًا عند 9600 يقضي معظم وقته في الطباعة، استخدم 115200 إلا إذا كان شيء آخر يحدد السرعة.
على Uno، يُنسخ كل نص بين علامتي اقتباس في الكود أيضًا إلى ذاكرة RAM البالغة 2048 بايت عند بدء التشغيل. غلّف النص الثابت بـ F()، كما في Serial.println(F("from flash"));، فيُقرأ من ذاكرة flash بدلًا من ذلك، حيث المساحة أكبر بكثير. وقد طبع "from flash" تمامًا كالسابق. في الكود الذي يحتوي رسائل كثيرة، هذه أسهل ذاكرة RAM يمكن استعادتها.
إذا كانت الشاشة التسلسلية تعرض رموزًا بلا معنى بدلًا من كلمات، فسرعتها لا تطابق Serial.begin(). صفحة رموز الشاشة التسلسلية الغريبة يشرح ذلك وبقية الأسباب.
افتح هذه الدائرة في المحرر. لوحة Arduino Uno: طباعة على الشاشة التسلسلية، موصّلة كما تعمل أعلى هذه الصفحة. غيّر قطعة أو قيمة ثم اضغط «تشغيل» مرة أخرى.
الأسئلة
ما الفرق بين Serial.print و Serial.println؟
الدالة print() ترسل النص وتبقى على السطر نفسه. أما println() فترسله ثم حرف رجوع وسطرًا جديدًا، فيبدأ ما يأتي بعدها على سطر جديد.
كيف أطبع عددًا عشريًا بعدد خانات عشرية أكبر؟
حدد عدد المنازل العشرية بعد الفاصلة: Serial.println(3.14159, 4) تطبع 3.1416. وبدونها يُطبع العدد العشري بمنزلتين.
كيف أطبع نصًا ومتغيرًا على السطر نفسه؟
استخدم استدعاءين: Serial.print("Temp: "); ثم Serial.println(t);. أو ادمجهما كـ Strings، "Temp: " + String(t). أما كتابة "Temp: " + t بدون String() فتطبع جزءًا من النص أو رموزًا غير مفهومة.
لماذا تطبع sprintf علامة استفهام بدل العدد العشري على Arduino؟
الدالة printf على Uno مبنية بدون دعم الأعداد العشرية، لذا فإن %f تطبع ?. حوّل العدد العشري بـ dtostrf() أولًا، أو اطبعه بـ Serial.print(t, 2).
لماذا لا تعرض الشاشة التسلسلية شيئًا؟
تأكد من أن Serial.begin() تعمل قبل أول طباعة، وأن الشاشة مضبوطة على معدل البود نفسه. كل ما طُبع قبل Serial.begin() يضيع.
كيف أطبع رقمًا بالنظام السداسي عشري HEX مع صفر بادئ؟
`Serial.println(10, HEX)` طبع "A" و`Serial.println(255, HEX)` طبع "FF": الدالة print() تترك الأصفار البادئة. للبايت، اطبع الصفر بنفسك عندما تكون القيمة أقل من 0x10. `if (b < 0x10) Serial.print("0");` قبل `Serial.println(b, HEX);` طبع "0A".
واصل
من أين جاءت الحقائق في هذه الصفحة
ابنِ هذا على أرض الواقع
افتح المحرر وغيّر قيمة وشاهد الرقم يتحرك معها. لا شيء لتثبّته ولا حاجة إلى حساب.