IoT-For-Beginners/translations/he/1-getting-started/lessons/1-introduction-to-iot/wio-terminal.md

Wio Terminal

ה-Wio Terminal מבית Seeed Studios הוא מיקרו-בקר תואם Arduino, עם WiFi וחיישנים ומפעילים מובנים, וכן יציאות להוספת חיישנים ומפעילים נוספים, באמצעות מערכת חומרה הנקראת Grove.

הגדרה

כדי להשתמש ב-Wio Terminal, תצטרכו להתקין תוכנה חינמית במחשב שלכם. בנוסף, תצטרכו לעדכן את הקושחה של ה-Wio Terminal לפני שתוכלו לחבר אותו ל-WiFi.

משימה - הגדרה

התקינו את התוכנה הנדרשת ועדכנו את הקושחה.

1. התקינו את Visual Studio Code (VS Code). זהו העורך שבו תשתמשו לכתיבת קוד המכשיר שלכם ב-C/C++. עיינו ב-תיעוד של VS Code להוראות התקנה.

   💁 סביבת פיתוח פופולרית נוספת לפיתוח Arduino היא Arduino IDE. אם אתם כבר מכירים את הכלי הזה, תוכלו להשתמש בו במקום VS Code ו-PlatformIO, אך השיעורים יספקו הוראות בהתבסס על שימוש ב-VS Code.

2. התקינו את הרחבת PlatformIO עבור VS Code. זו הרחבה ל-VS Code שתומכת בתכנות מיקרו-בקרים ב-C/C++. עיינו ב-תיעוד הרחבת PlatformIO להוראות התקנה. הרחבה זו תלויה בהרחבת Microsoft C/C++ כדי לעבוד עם קוד C ו-C++, והיא מותקנת אוטומטית עם התקנת PlatformIO.

3. חברו את ה-Wio Terminal למחשב שלכם. ל-Wio Terminal יש יציאת USB-C בתחתית, ויש לחבר אותה ליציאת USB במחשב שלכם. ה-Wio Terminal מגיע עם כבל USB-C ל-USB-A, אך אם במחשב שלכם יש רק יציאות USB-C, תצטרכו כבל USB-C או מתאם USB-A ל-USB-C.

4. עקבו אחר ההוראות בתיעוד Wio Terminal Wiki WiFi Overview כדי להגדיר את ה-Wio Terminal ולעדכן את הקושחה.

שלום עולם

נהוג להתחיל עם שפה או טכנולוגיה חדשה על ידי יצירת אפליקציית 'שלום עולם' - אפליקציה קטנה שמציגה טקסט כמו "Hello World" כדי לוודא שכל הכלים מוגדרים כראוי.

אפליקציית שלום עולם עבור ה-Wio Terminal תוודא ש-VS Code מותקן כראוי עם PlatformIO ומוכן לפיתוח מיקרו-בקרים.

יצירת פרויקט PlatformIO

השלב הראשון הוא יצירת פרויקט חדש באמצעות PlatformIO המוגדר עבור ה-Wio Terminal.

משימה - יצירת פרויקט PlatformIO

צרו את פרויקט ה-PlatformIO.

1. חברו את ה-Wio Terminal למחשב שלכם

2. הפעילו את VS Code

3. סמל PlatformIO יופיע בסרגל התפריט הצדדי:

   

   בחרו באפשרות זו, ואז בחרו PIO Home -> Open

   

4. במסך הפתיחה, בחרו בכפתור + New Project

   

5. הגדירו את הפרויקט ב-Project Wizard:

   1. תנו שם לפרויקט שלכם nightlight

   2. בתפריט הנפתח Board, הקלידו WIO כדי לסנן את הלוחות, ובחרו Seeeduino Wio Terminal

   3. השאירו את Framework כ-Arduino

   4. השאירו את תיבת הסימון Use default location מסומנת, או בטלו אותה ובחרו מיקום לפרויקט שלכם

   5. לחצו על כפתור Finish

   

   PlatformIO יוריד את הרכיבים הדרושים לו כדי לקמפל קוד עבור ה-Wio Terminal ויצור את הפרויקט שלכם. זה עשוי לקחת כמה דקות.

חקר פרויקט PlatformIO

סייר VS Code יציג מספר קבצים ותיקיות שנוצרו על ידי אשף PlatformIO.

תיקיות

• .pio - תיקייה זו מכילה נתונים זמניים ש-PlatformIO זקוק להם, כמו ספריות או קוד מקומפל. היא נוצרת מחדש אוטומטית אם נמחקת, ואין צורך להוסיף אותה לשליטה בקוד מקור אם אתם משתפים את הפרויקט שלכם באתרים כמו GitHub.
• .vscode - תיקייה זו מכילה את התצורה שבה משתמשים PlatformIO ו-VS Code. היא נוצרת מחדש אוטומטית אם נמחקת, ואין צורך להוסיף אותה לשליטה בקוד מקור אם אתם משתפים את הפרויקט שלכם באתרים כמו GitHub.
• include - תיקייה זו מיועדת לקבצי כותרת חיצוניים הנדרשים בעת הוספת ספריות נוספות לקוד שלכם. לא תשתמשו בתיקייה זו באף אחד מהשיעורים הללו.
• lib - תיקייה זו מיועדת לספריות חיצוניות שתרצו לקרוא להן מתוך הקוד שלכם. לא תשתמשו בתיקייה זו באף אחד מהשיעורים הללו.
• src - תיקייה זו מכילה את קוד המקור הראשי של האפליקציה שלכם. בתחילה, היא תכיל קובץ יחיד - main.cpp.
• test - תיקייה זו מיועדת למבחני יחידה עבור הקוד שלכם.

קבצים

• main.cpp - קובץ זה בתיקיית src מכיל את נקודת הכניסה לאפליקציה שלכם. פתחו את הקובץ, והוא יכיל את הקוד הבא:

  #include <Arduino.h>
  
  void setup() {
    // put your setup code here, to run once:
  }
  
  void loop() {
    // put your main code here, to run repeatedly:
  }
  

  כאשר המכשיר מופעל, מסגרת Arduino תריץ את הפונקציה setup פעם אחת, ואז תריץ את הפונקציה loop שוב ושוב עד שהמכשיר יכבה.

• .gitignore - קובץ זה מפרט את הקבצים והתיקיות שיש להתעלם מהם בעת הוספת הקוד שלכם לשליטה בקוד מקור, כמו העלאה למאגר ב-GitHub.

• platformio.ini - קובץ זה מכיל תצורה עבור המכשיר והאפליקציה שלכם. פתחו את הקובץ, והוא יכיל את הקוד הבא:

  [env:seeed_wio_terminal]
  platform = atmelsam
  board = seeed_wio_terminal
  framework = arduino
  

  הסעיף [env:seeed_wio_terminal] מכיל תצורה עבור ה-Wio Terminal. ניתן להגדיר מספר סעיפי env כך שהקוד שלכם יוכל להיות מקומפל עבור מספר לוחות.

  הערכים האחרים תואמים את התצורה מאשף הפרויקט:

  • platform = atmelsam מגדיר את החומרה שבה משתמש ה-Wio Terminal (מיקרו-בקר מבוסס ATSAMD51)
  • board = seeed_wio_terminal מגדיר את סוג לוח המיקרו-בקר (ה-Wio Terminal)
  • framework = arduino מגדיר שהפרויקט הזה משתמש במסגרת Arduino.

כתיבת אפליקציית שלום עולם

כעת אתם מוכנים לכתוב את אפליקציית שלום עולם.

משימה - כתיבת אפליקציית שלום עולם

כתבו את אפליקציית שלום עולם.

1. פתחו את הקובץ main.cpp ב-VS Code

2. שנו את הקוד כך שיתאים לקוד הבא:

   #include <Arduino.h>
   
   void setup()
   {
       Serial.begin(9600);
   
       while (!Serial)
           ; // Wait for Serial to be ready
   
       delay(1000);
   }
   
   void loop()
   {
       Serial.println("Hello World");
       delay(5000);
   }
   

   הפונקציה setup מאתחלת חיבור ליציאת הסריאל - במקרה זה, יציאת ה-USB שמשמשת לחיבור ה-Wio Terminal למחשב שלכם. הפרמטר 9600 הוא קצב הסמל, או מהירות שבה נתונים יישלחו דרך יציאת הסריאל בביטים לשנייה. הגדרה זו אומרת ש-9,600 ביטים (0s ו-1s) של נתונים נשלחים בכל שנייה. לאחר מכן היא ממתינה שהיציאה הסריאלית תהיה מוכנה.

   הפונקציה loop שולחת את השורה Hello World! ליציאה הסריאלית, כך שהדמויות של Hello World! יחד עם תו שורה חדשה יישלחו. לאחר מכן היא ישנה למשך 5,000 מילישניות או 5 שניות. לאחר סיום הפונקציה loop, היא מופעלת שוב, ושוב, וכן הלאה כל עוד המיקרו-בקר מופעל.

3. הכניסו את ה-Wio Terminal למצב העלאה. תצטרכו לעשות זאת בכל פעם שתעלו קוד חדש למכשיר:

   1. משכו את מתג ההפעלה מטה פעמיים במהירות - הוא יחזור למצב הפעלה בכל פעם.

   2. בדקו את נורית הסטטוס הכחולה בצד ימין של יציאת ה-USB. היא אמורה להבהב.

   

   לחצו על התמונה למעלה לצפייה בסרטון שמראה כיצד לעשות זאת.

4. קומפלו והעלו את הקוד ל-Wio Terminal

   1. פתחו את תפריט הפקודות של VS Code

   2. הקלידו PlatformIO Upload כדי לחפש את אפשרות ההעלאה, ובחרו PlatformIO: Upload

      

      PlatformIO יקומפל את הקוד באופן אוטומטי אם יש צורך לפני ההעלאה.

   3. הקוד יקומפל ויועלה ל-Wio Terminal

      💁 אם אתם משתמשים ב-macOS, תופיע התראה על DISK NOT EJECTED PROPERLY. זה קורה מכיוון שה-Wio Terminal מותקן ככונן כחלק מתהליך ההעלאה, והוא מנותק כאשר הקוד המקומפל נכתב למכשיר. ניתן להתעלם מההתראה הזו.

   ⚠️ אם אתם מקבלים שגיאות על כך שיציאת ההעלאה אינה זמינה, קודם כל ודאו שה-Wio Terminal מחובר למחשב שלכם, מופעל באמצעות המתג בצד שמאל של המסך, ומוגדר למצב העלאה. הנורית הירוקה בתחתית צריכה להיות דולקת, והנורית הכחולה צריכה להבהב. אם עדיין יש שגיאה, משכו את מתג ההפעלה מטה פעמיים במהירות שוב כדי להכניס את ה-Wio Terminal למצב העלאה ונסו להעלות שוב.

ל-PlatformIO יש מוניטור סריאלי שיכול לעקוב אחר נתונים שנשלחים דרך כבל ה-USB מה-Wio Terminal. זה מאפשר לכם לעקוב אחר הנתונים שנשלחים על ידי הפקודה Serial.println("Hello World");.

1. פתחו את תפריט הפקודות של VS Code

2. הקלידו PlatformIO Serial כדי לחפש את אפשרות המוניטור הסריאלי, ובחרו PlatformIO: Serial Monitor

   

   ייפתח טרמינל חדש, והנתונים שנשלחים דרך יציאת הסריאל יוזרמו לטרמינל הזה:

   > Executing task: platformio device monitor <
   
   --- Available filters and text transformations: colorize, debug, default, direct, hexlify, log2file, nocontrol, printable, send_on_enter, time
   --- More details at http://bit.ly/pio-monitor-filters
   --- Miniterm on /dev/cu.usbmodem101  9600,8,N,1 ---
   --- Quit: Ctrl+C | Menu: Ctrl+T | Help: Ctrl+T followed by Ctrl+H ---
   Hello World
   Hello World
   

   Hello World יודפס למוניטור הסריאלי כל 5 שניות.

💁 תוכלו למצוא את הקוד הזה בתיקיית code/wio-terminal.

😀 אפליקציית 'שלום עולם' שלכם הצליחה!

---

כתב ויתור:
מסמך זה תורגם באמצעות שירות תרגום מבוסס בינה מלאכותית Co-op Translator. למרות שאנו שואפים לדיוק, יש לקחת בחשבון שתרגומים אוטומטיים עשויים להכיל שגיאות או אי דיוקים. המסמך המקורי בשפתו המקורית צריך להיחשב כמקור סמכותי. עבור מידע קריטי, מומלץ להשתמש בתרגום מקצועי על ידי אדם. איננו אחראים לאי הבנות או לפרשנויות שגויות הנובעות משימוש בתרגום זה.