Arduino:Библиотеки/GSM/Класс GSM SMS/available()

Материал из Онлайн справочника
Перейти к навигацииПерейти к поиску

Перевод: Максим Кузьмин
Проверка/Оформление/Редактирование: Мякишев Е.А.

Функция available()[1]

Проверяет, есть ли на SIM-карте SMS-сообщения, которые можно прочесть, а затем возвращает количество символов в сообщении.

Синтаксис

SMS.available()

Параметры

Нет.

Что возвращает

Количество символов в сообщении. Тип данных  int.

Пример

#define PINNUMBER ""

// инициализируем экземпляр библиотеки:
GSM gsmAccess; // чтобы включить режим отладки, в скобочках нужно поставить параметр «true»
GSM_SMS sms;

char remoteNumber[20];  // массив для хранения исходящего номера

void setup() 
{
  // инициализируем последовательную коммуникацию:
  Serial.begin(9600); 

  Serial.println("SMS Messages Receiver");  //  "Получатель SMS-сообщений"

  // состояние соединения:
  boolean notConnected = true;

  // запускаем GSM-модуль; если у SIM-карты есть PIN-код,
  // вписываем его в скобочки функции begin():
  while(notConnected)
  {
    if(gsmAccess.begin(PINNUMBER)==GSM_READY)
      notConnected = false;
    else
    {
      Serial.println("Not connected");  //  "Соединение не удалось"
      delay(1000);
    }
  }

  Serial.println("GSM initialized");  //  "GSM инициализирован"
  Serial.println("Waiting for messages");  //  "Ожидание сообщений"
}

void loop() 
{
  char c;

  // проверяем, есть ли SMS, которые можно прочесть: 
  if (sms.available())
  {
    Serial.println("Message received from:");  //  "Сообщение получено от: "

    // извлекаем исходящий номер:
    sms.remoteNumber(remoteNumber, 20);
    Serial.println(remoteNumber);

    // это пример того, как можно отклонить пришедшее SMS; 
    // в данном случае будут отклонены все SMS, начинающиеся с «#»: 
    if(sms.peek()=='#')
    {
      Serial.println("Discarded SMS");  //  "Сообщение отклонено"
      sms.flush();
    }

    // считываем байты сообщения и выводим их на монитор порта:
    while(c=sms.read())
      Serial.print(c);

    Serial.println("\nEND OF MESSAGE");  //  "\nКОНЕЦ СООБЩЕНИЯ "

    // удаляем сообщение из памяти модема:
    sms.flush();
    Serial.println("MESSAGE DELETED");  //  "СООБЩЕНИЕ УДАЛЕНО"
  }

  delay(1000);

}

См.также

  1. beginSMS()
  2. ready()
  3. endSMS()
  4. available()
  5. remoteNumber()
  6. read()
  7. write()
  8. print()
  9. peek()
  10. flush()

Внешние ссылки