AVR & ARDUINO

Каталог статей

Метод EthernetClient connect()

Описание

Метод объекта EthernetClient устанавливает соединение с удаленным IP-адресом через указанный порт. Значение, возвращаемое функцией, содержит информацию об успешности выполнения данной операции. Функция поддерживает DNS-запросы, поэтому допускается использование доменного имени вместо IP-адреса.

Синтаксис

client.connect(ip, port);
client.connect(URL, port);

Параметры

client - объект класса EthernetClient

ip - IP-адрес, с которым необходимо установить соединение (массив из 4 байт)

URL - доменное имя сервера, с которым необходимо установить соединение (строка, например "arduino.cc")

port - порт, через который необходимо установить соединение

Возвращаемые значения

Если соединение прошло успешно, функция возвращает 1 (SUCCESS), в противном случае 0 (ERROR) или, дополнительно при использовании DNS:

SUCCESS 1
TIMED_OUT -1
INVALID_SERVER -2
TRUNCATED -3
INVALID_RESPONSE -4

Пример

#include <SPI.h>
#include <Ethernet.h>

byte mac[] = { 0xDE, 0xAD, 0xBE, 0xEF, 0xFE, 0xED };
byte ip[] = { 10, 0, 0, 177 };
byte server[] = { 64, 233, 187, 99 }; // Google
 
EthernetClient client;
 
void setup()
{
 Ethernet.begin(mac, ip);
 Serial.begin(9600);
 client.connect(server, 80);
 delay(1000);
 
 Serial.println("connecting...");
 
 if (client.connected()) {
 Serial.println("connected");
 client.println("GET /search?q=arduino HTTP/1.0");
 client.println();
 } else {
 Serial.println("connection failed");
 }
}
 
void loop()
{
 if (client.available()) {
 char c = client.read();
 Serial.print(c);
 }
 
 if (!client.connected()) {
 Serial.println();
 Serial.println("disconnecting.");
 client.stop();
 for(;;) {}
 }
}