Skip to main content

Ethernet

Ethernet

This is a library for Ethernet initialization. Specify #include <Ethernet.h> for use.

begin

Description
Initializes the Ethernet library and network settings. The DHCP automatically obtains an IP address, DNS, default gateway, and subnet mask.
Syntax
int 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: MAC address (array of 6 bytes)
ip: IP address (array of 4 bytes)
dns: Name server address (array of 4 bytes)
gateway: Default gateway address (array of 4 bytes)
subnet: Subnet mask (array of 4 bytes)
Returns
If Ethernet.begin(mac) is successful = 1; if failure = 0. Others are none.

localIP

Description
Obtains the IP address of the board.
Syntax
IPAddress Ethernet.localIP()
Parameters
None
Returns
The IP address

Sample Program

Connect with DHCP, and then display the IP address.


#include <Arduino.h>
#include <Ethernet.h>
 
byte mac[] = {  
  0x00, 0xAA, 0xBB, 0xCC, 0xDE, 0x02 };
// Initialize the Ethernet client library
// with the IP address and port of the server 
// that you want to connect to (port 80 is default for HTTP):
EthernetClient client;
  
void setup()
{
    Serial.begin(9600);
    Serial.println("Start to connect..");
 
    // start the Ethernet connection:
    if (Ethernet.begin(mac) == 0) {
        Serial.println("Failed to configure Ethernet using DHCP");
        while(1);
    }
    // print your local IP address:
    Serial.println(Ethernet.localIP());
}
  
void loop() {
}