Basic Library
Digital I/O
Analog I/O
Advanced I/O
Time
Math
Trigonometry
Random Numbers
Bits and Bytes
Interrupts
Serial Comm.
Standard Library
Servo Motor
Stepping Motor
Liquid Crystal
EEPROM
SPI
I2C (Wire)
SD Card
SD (File Operations)
Ethernet
Ethernet (Server)
Ethernet (Client)
Firmata
Periodic Operation
Power Save
Clock (RTC)
SoftwareSerial
Utility
Ethernet
This is a library for Ethernet initialization. Initialization is necessary for both client and server. Connect with the Arduino shield and ioShield equipped with WIZnet's WIZ550io and control by SPI. Specify #include <SPI.h> and #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()
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
maintain
Description
Allows for the renewal of DHCP leases.
Syntax
Ethernet.maintain()
Parameters
None
Returns
0: Nothing happened
1: Renew failed
2: Renew success
3: Rebind fail
4: Rebind success
Sample Program
Connect with DHCP, and then display the IP address.
#include <Arduino.h>
#include <SPI.h>
#include <Ethernet.h>
void setup()
{
Serial.begin(9600);
// start the Ethernet connection:
if (Ethernet.begin() == 0) {
Serial.println("Failed to configure Ethernet using DHCP");
while(1);
}
// print your local IP address:
Serial.println(Ethernet.localIP());
}
void loop() {
}