()Ethernet.begin מאתחלת את ספריית ה-Ethernet ואת הגדרות הרשת שלה.גרסה 1.0 של הספירה תומכת ב-DHCP. ציון רק כתובת MAC בקריאה לפונקצייהונקציה זו (
(mac)Ethernet.begin) והגדרות רשת נכונות יגרמו למגן Ethernet לפנות לשרת DHCP כדי להשיג בצורה אוטומטית כתובת IP. שימוש ב-DHCP יגדיל בצורה משמעותית את גודל התוכנית שלכם. כדי שהקצעת כתובת ה-IP לכרטיס תעבוד בצורה תקינה, יש צורך לקרוא לפונקציה ()Ethernet.maintain TODO באופן קבוע.תחביר
- קוד: בחר הכל
Ethernet.begin(mac);
Ethernet.begin(mac, ip);
Ethernet.begin(mac, ip, dns);
Ethernet.begin(mac, ip, dns, gateway);
Ethernet.begin(mac, ip, dns, gateway, subnet);
פרמטרים:
mac - כתובת ה-MAC של הכרטיס (Media Access Control). זוהי מחרוזת בת 6 בתים (bytes). כתובת MAC היא כתובת חומרתית של מגן ה-Ethernet שלכם. דגמים חדשים של המגן כוללים מדבקה עם כתובת ה-MAC. לדגמים ישנים ללא המדבקה תוכלו לבחור כל כתובת שתרצו. חשוב שברשת לא יהיו התקנים עם אותה הכתובת.
ip - כתובת ה-IP של ההתקן. מערך של 4 בתים (bytes).
dns - כתובת ה-IP של שרת ה-DNS. מערך של 4 בתים (bytes). פרמטר זה אופציונלי. אם לא מציינים אותו, הספריה תשתמש בכתובת ה-IP של ההתקן עם בית אחרון בערך 1.
gateway - כתובת ה-IP של ה-router. מערך של 4 בתים (bytes). פרמטר זה אופציונלי. אם לא מציינים אותו, הספריה תשתמש בכתובת ה-IP של ההתקן עם בית אחרון בערך 1.
subnet - מסכת כתובות ה-IP. מערך של 4 בתים (bytes). פרמטר זה אופציונלי. אם לא מציינים אותו, הספריה תשתמש בערך 255.255.255.0
גרסת ה-DHCP של הפונקציה,
Ethernet.begin(mac), מחזירה int עם ערך 1 שיציין שכתובת הושגה בהצלחה או 0 אם לא הצליח להשיג את הכתובת.גרסאות אחרות של הפונקציות לא מחזירות ערכים.
דוגמה
- קוד: בחר הכל
#include <SPI.h>
#include <Ethernet.h>
// the media access control (ethernet hardware) address for the shield:
byte mac[] = { 0xDE, 0xAD, 0xBE, 0xEF, 0xFE, 0xED };
//the IP address for the shield:
byte ip[] = { 10, 0, 0, 177 };
void setup()
{
Ethernet.begin(mac, ip);
}
void loop () {}
ראו גם:
Ethernetפירוט שפת תכנות לסביבת Arduino
עמוד זה הוא תרגום של ()Ethernet.begin לפי רישיון Creative Commons Attribution-ShareAlike 3.0.