这里会显示出您选择的修订版和当前版本之间的差别。
| — |
en:arduino:libraries:ethernetbegin [2016/12/25 22:15] (当前版本) |
||
|---|---|---|---|
| 行 1: | 行 1: | ||
| + | [[en:arduino:libraries:ethernet|Ethernet]] | ||
| + | ====== Ethernet.begin() ====== | ||
| + | |||
| + | ===== Description ===== | ||
| + | |||
| + | Initializes the ethernet library and network settings. | ||
| + | |||
| + | With version 1.0, the library supports DHCP. Using Ethernet.begin(mac) with the proper network setup, the Ethernet shield will automatically obtain an IP address. This increases the sketch size significantly. | ||
| + | ===== Syntax ===== | ||
| + | |||
| + | 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); | ||
| + | ===== Parameters ===== | ||
| + | |||
| + | **mac:** the MAC (Media access control) address for the device (array of 6 bytes). this is the Ethernet hardware address of your shield. Newer Arduino Ethernet Shields include a sticker with the device's MAC address. For older shields, choose your own. | ||
| + | |||
| + | **ip:** the IP address of the device (array of 4 bytes) | ||
| + | |||
| + | **dns:** the address for a DNS server. | ||
| + | |||
| + | **gateway:** the IP address of the network gateway (array of 4 bytes). optional: defaults to the device IP address with the last octet set to 1 | ||
| + | |||
| + | **subnet:** the subnet mask of the network (array of 4 bytes). optional: defaults to 255.255.255.0 | ||
| + | ===== Returns ===== | ||
| + | |||
| + | None | ||
| + | ===== Example ===== | ||
| + | <code cpp> | ||
| + | #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 () {} | ||
| + | </code> | ||
| + | |||
| + | [[en:arduino:libraries|Reference Home]] | ||