Описание
Метод объекта GSMClient возвращает количество непрочитанных байт (т.е. количество байт, принятых клиентом от удаленного сервера, с которым установлено соединение). Функция available() является наследником вспомогательного класса Stream.
Синтаксис
client.available();
Параметры
client - объект класса GSMClient.
Возвращаемые значения
int - количество непрочитанных байт.
Пример
/*
Веб-клиент
Данная программа с помощью GSM-платы расширения заходит на указанный веб-сайт.
В примере показана процедура скачивания страницы по адресу "http://arduino.cc/" и
вывод ее содержимого в программу Serial monitor через последовательный порт.
Схема:
* GSM-плата расширения, подключенная к Ардуино
* установленная SIM-карта
создано 8 Марта 2012
Автор - Tom Igoe
http://arduino.cc/en/Tutorial/GSMExamplesWebClient
*/
// библиотеки
#include <GSM.h>
// PIN-код
#define PINNUMBER ""
// Данные точки доступа APN
#define GPRS_APN "GPRS_APN" // замените на свою GPRS-точку доступа
#define GPRS_LOGIN "login" // замените на свой логин для подключения к GPRS
#define GPRS_PASSWORD "password" // замените на свой пароль для подключения к GPRS
// инициализируем экземпляры классов
GSMClient client;
GPRS gprs;
GSM gsmAccess;
// URL, путь и порт (например: arduino.cc)
char server[] = "arduino.cc";
char path[] = "/";
int port = 80; // порт 80 (по умолчанию для http)
void setup()
{
// инициализируем последовательный интерфейс передачи данных
Serial.begin(9600);
Serial.println("Starting Arduino web client.");
// состояние соединения
boolean notConnected = true;
// после инициализации модема функцией GSM.begin()
// подключаем плату расширения к GPRS-сети с указанной точкой доступа APN,
//именем пользователя и паролем
while(notConnected)
{
if((gsmAccess.begin(PINNUMBER)==GSM_READY) &
(gprs.attachGPRS(GPRS_APN, GPRS_LOGIN, GPRS_PASSWORD)==GPRS_READY))
notConnected = false;
else
{
Serial.println("Not connected");
delay(1000);
}
}
Serial.println("connecting...");
// если соединение установлено, сигнализируем об этом через последовательный порт:
if (client.connect(server, port)==1)
{
Serial.println("connected");
// делаем HTTP-запрос:
client.print("GET ");
client.print(path);
client.println(" HTTP/1.0");
client.println();
}
else
{
// если подключиться к серверу не удалось:
Serial.println("connection failed");
}
}
void loop()
{
// если от сервера поступили данные,
// то считываем и выводим их:
if (client.available())
{
char c = client.read();
Serial.print(c);
}
// если сервер отключился, то останавливаем клиент:
if (!client.available() && !client.connected())
{
Serial.println();
Serial.println("disconnecting.");
client.stop();
// больше ничего не делаем:
for(;;)
;
}
}
Смотрите также:
конструктор GSMClient
ready()
connect()
beginWrite()
write()
endWrite()
connected()
read()
peek()
flush()
stop()
Библиотека GSM
Справочник
Материалы взяты с официального сайта проекта Arduino и представлены по лицензии Creative Commons Attribution-ShareAlike 3.0 License.
Источник: http://arduino.cc/en/Reference/GSMClientAvailable |