EducationBot в 08:34, 8 июля 2023

2023-07-08T08:34:58Z

← Предыдущая версия		Версия от 12:34, 8 июля 2023
Строка 283:		Строка 283:

	<references />		<references />
			{{Навигационная таблица/Портал/Arduino}}
	[[Категория:Пример]]		[[Категория:Пример]]
	[[Категория:Примеры]]		[[Категория:Примеры]]
	[[Категория:Пример программирования Arduino]]		[[Категория:Пример программирования Arduino]]
	[[Категория:Примеры программирования Arduino]]		[[Категория:Примеры программирования Arduino]]

EducationBot в 08:32, 20 мая 2023

2023-05-20T08:32:36Z

Внесённые изменения

Myagkij: Замена текста — «» на «»

2016-12-13T20:19:06Z

Замена текста — «<syntaxhighlight lang="c" line="GESHI_NORMAL_LINE_NUMBERS|GESHI_FANCY_LINE_NUMBERS">» на «<syntaxhighlight lang="c" line="GESHI_NORMAL_LINE_NUMBERS|GESHI_FANCY_LINE_NUMBERS" enclose="div">»

Новая страница

{{Arduino панель перехода}}
{{Перевод от Сubewriter}}
{{Myagkij-редактор}}

==Отправка SMS<ref>[https://www.arduino.cc/en/Tutorial/GSMExamplesSendSMS Arduino - Send SMS]</ref>==

Этот скетч отправляет '''SMS'''-сообщение, используя для этого тандем из платы '''Arduino''' и модуля '''GSM Shield'''. Номер, на который будет передано '''SMS''', а также само сообщение вводятся через '''Serial Monitor'''.

==Необходимое оборудование==

* Плата '''Arduino''';
* Модуль '''Arduino + Telefonica GSM/GPRS Shield''';
* '''SIM'''-карта;

==Цепь==

[[Файл:GSMShield ArduinoUno.png|650px]]

Изображение модуля '''Arduino GSM Shield''', установленного поверх платы '''Arduino Uno'''

==Код==

Для начала импортируем библиотеку '''GSM'''.

<syntaxhighlight lang="c" line="GESHI_NORMAL_LINE_NUMBERS|GESHI_FANCY_LINE_NUMBERS" enclose="div">
#include <GSM.h>
</syntaxhighlight>

При помощи директивы #define определяем '''PIN'''-код как константу, чтобы разблокировать '''SIM'''-карту. Если '''PIN'''-кода нет, оставляем это место пустым.

<syntaxhighlight lang="c" line="GESHI_NORMAL_LINE_NUMBERS|GESHI_FANCY_LINE_NUMBERS" enclose="div">
#define PINNUMBER ""
</syntaxhighlight>

Создаем экземпляры классов '''GSM''' и '''GSM_SMS'''.

<syntaxhighlight lang="c" line="GESHI_NORMAL_LINE_NUMBERS|GESHI_FANCY_LINE_NUMBERS" enclose="div">
GSM gsmAccess;
GSM_SMS sms;
</syntaxhighlight>

В блоке setup() запускаем последовательную передачу данных на компьютер. Запустив, отсылаем на '''Serial Monitor''' сообщение, информирующее о начале работы скетча.

<syntaxhighlight lang="c" line="GESHI_NORMAL_LINE_NUMBERS|GESHI_FANCY_LINE_NUMBERS" enclose="div">
void setup(){
Serial.begin(9600);
Serial.println("SMS Messages Sender");
</syntaxhighlight>

Создаем локальную переменную, чтобы отслеживать статус соединения. Это нужно для того, чтобы скетч не начинал работать, пока '''SIM'''-карта не подключится к сети.

<syntaxhighlight lang="c" line="GESHI_NORMAL_LINE_NUMBERS|GESHI_FANCY_LINE_NUMBERS" enclose="div">
boolean notConnected = true;
</syntaxhighlight>

Подключаемся к сети при помощи функции gsmAccess.begin(), и '''PIN'''-код в ней будет в качестве аргумента. Размещаем эту функцию в цикле while(), чтобы постоянно проверять статус соединения. Когда модем подключится, gsmAccess() вернет значение '''GSM_READY''', и это будет сигналом для того, чтобы задать для переменной notConnected значение true или false. Если подключиться не удалось, информируем об этом через '''Serial Monitor'''.

<syntaxhighlight lang="c" line="GESHI_NORMAL_LINE_NUMBERS|GESHI_FANCY_LINE_NUMBERS" enclose="div">
while(notConnected)
{
if(gsmAccess.begin(PINNUMBER)==GSM_READY)
notConnected = false;
else
{
Serial.println("Not connected");
delay(1000);
}
}
</syntaxhighlight>

Заканчиваем секцию setup() выводом на '''Serial Monitor''' сообщения о том, что инициализация '''GSM''' прошла успешно.

<syntaxhighlight lang="c" line="GESHI_NORMAL_LINE_NUMBERS|GESHI_FANCY_LINE_NUMBERS" enclose="div">
Serial.println("GSM initialized.");
}
</syntaxhighlight>

Создаем функцию типа int под названием readSerial. Она будет делать перебор входящих данных, присланных через '''Serial Monitor''', попутно сохраняя номер, на который вы хотите отправить '''SMS''', а также само сообщение. В качестве аргумента у нее будет массив типа char.

<syntaxhighlight lang="c" line="GESHI_NORMAL_LINE_NUMBERS|GESHI_FANCY_LINE_NUMBERS" enclose="div">
int readSerial(char result[])
{
</syntaxhighlight>

Создаем переменную, которая будет пересчитывать содержимое буфера последовательного порта, а потом запускаем цикл while(), который будет выполнятся непрерывно.

<syntaxhighlight lang="c" line="GESHI_NORMAL_LINE_NUMBERS|GESHI_FANCY_LINE_NUMBERS" enclose="div">
int i = 0;
while(1)
{
</syntaxhighlight>

Покуда в буфере последовательного порта доступна какая-либо информация, считываем ее в переменную под названием '''inChar'''.

<syntaxhighlight lang="c" line="GESHI_NORMAL_LINE_NUMBERS|GESHI_FANCY_LINE_NUMBERS" enclose="div">
while (Serial.available() > 0)
{
char inChar = Serial.read();
</syntaxhighlight>

Если добрались до символа новой строки, стираем содержимое массива, очищаем буфер последовательного порта и выполняем функцию.

<syntaxhighlight lang="c" line="GESHI_NORMAL_LINE_NUMBERS|GESHI_FANCY_LINE_NUMBERS" enclose="div">
if (inChar == '\n')
{
result[i] = '\0';
Serial.flush();
return 0;
}
</syntaxhighlight>

Если входящий символ является '''ASCII'''-символом, а не символом новой строки или возврата строки, добавляем его к массиву и увеличиваем индекс. Затем закрываем циклы while() и саму функцию.

<syntaxhighlight lang="c" line="GESHI_NORMAL_LINE_NUMBERS|GESHI_FANCY_LINE_NUMBERS" enclose="div">
if(inChar!='\r')
{
result[i] = inChar;
i++;
}
}
}
}
</syntaxhighlight>

В секции loop() создаем массив типа char под названием remoteNumber, чтобы хранить в нем номер, на который вы хотите отправить '''SMS'''. Далее вызываем только что созданную функцию readSerial(), где remoteNumber будет в качестве аргумента. Эта функция заполнит массив remoteNumber номером, которому будет адресоваться '''SMS'''-сообщение.

<syntaxhighlight lang="c" line="GESHI_NORMAL_LINE_NUMBERS|GESHI_FANCY_LINE_NUMBERS" enclose="div">
Serial.print("Enter a mobile number: ");
char remoteNumber[20];
readSerial(remoteNumber);
Serial.println(remoteNumber);
</syntaxhighlight>

Создаем еще один массив типа char, но уже под названием txtMsg. Он будет содержать в себе содержимое вашего SMS и станет аргументом для функции readSerial().

<syntaxhighlight lang="c" line="GESHI_NORMAL_LINE_NUMBERS|GESHI_FANCY_LINE_NUMBERS" enclose="div">
Serial.print("Now, enter SMS content: ");
char txtMsg[200];
readSerial(txtMsg);
</syntaxhighlight>

Далее вызываем три функции. Первая (чтобы начать отправку сообщения) – это sms.beginSMS() с аргументом в виде массива remoteNumber. Вторая (чтобы отправить сообщение) – sms.print(). Третья (чтобы завершить процесс отправки) – sms.endSMS(). Печатаем пару '''«диагностических»''' сообщений и закрываем loop(). Ваше сообщение полетело к адресату!

<syntaxhighlight lang="c" line="GESHI_NORMAL_LINE_NUMBERS|GESHI_FANCY_LINE_NUMBERS" enclose="div">
Serial.println("SENDING");
Serial.println();
Serial.println("Message:");
Serial.println(txtMsg);

sms.beginSMS(remoteNumber);
sms.print(txtMsg);
sms.endSMS();
Serial.println("\nCOMPLETE!\n");
}
</syntaxhighlight>

Загрузив код, открываем '''Serial Monitor'''. Убедитесь, что он настроен таким образом, что при нажатии на клавишу ввода отсылается только символ новой строки. Когда скетч попросит вас ввести желаемый номер, впишите цифры и нажмите клавишу ввода. Затем вас попросят ввести сообщение. Напечатайте его и снова нажмите клавишу ввода.

<syntaxhighlight lang="c" line="GESHI_NORMAL_LINE_NUMBERS|GESHI_FANCY_LINE_NUMBERS" enclose="div">
/*
Отправщик SMS

Этот скетч, предназначенный для Arduino GSM Shield,
отправляет на указанный адрес SMS-сообщение, введенное через Serial Monitor.
Подключив Shield к Arduino и настроив скетч, откройте Serial Monitor
и, увидев сообщение READY, начинайте писать сообщение.
Убедитесь, что Serial Monitor настроен таким образом,
чтобы при нажатии на клавишу ввода отправлять только символ новой строки.

Цепь:
* GSM Shield, подключенный к Arduino

Создан 25 февраля 2012 Томом Иго (Tom Igoe).

Этот код не защищен авторским правом.
*/

// Библиотека:
#include <GSM.h>

#define PINNUMBER ""

// Создаем экземпляры классов GSM и GSM_SMS:
GSM gsmAccess; // включая параметр «true» для активации отладки
GSM_SMS sms;
void setup()
{
// Инициализируем последовательную передачу данных:
Serial.begin(9600);

Serial.println("SMS Messages Sender"); // "Отправщик SMS-сообщений"

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

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

Serial.println("GSM initialized"); // "GSM не инициализирован"
}

void loop()
{

Serial.print("Enter a mobile number: "); // "Введите мобильный номер"
char remoteNumber[20]; // телефонный номер, которому будем слать SMS
readSerial(remoteNumber);
Serial.println(remoteNumber);

// Текст SMS-сообщения:
Serial.print("Now, enter SMS content: "); // "Теперь введите SMS-сообщение: "
char txtMsg[200];
readSerial(txtMsg);
Serial.println("SENDING"); // "Отправка"
Serial.println();
Serial.println("Message:"); // "Сообщение:"
Serial.println(txtMsg);

// Отправляем сообщение:
sms.beginSMS(remoteNumber);
sms.print(txtMsg);
sms.endSMS();
Serial.println("\nCOMPLETE!\n"); // "\nГотово!\n"
}

/*
Считываем входящие данные, пришедшие через последовательный порт
*/

int readSerial(char result[])
{
int i = 0;
while(1)
{
while (Serial.available() > 0)
{
char inChar = Serial.read();
if (inChar == '\n')
{
result[i] = '\0';
Serial.flush();
return 0;
}
if(inChar!='\r')
{
result[i] = inChar;
i++;
}
}
}
}
</syntaxhighlight>

== См.также==

# GSM Constructor
# GSM.begin()
# GSM.shutdown()
# GSM_SMS Constructor
# beginSMS()
# ready()
# endSMS()
# available()
# remoteNumber()
# read()
# write()
# print()
# peek()
# flush()

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

<references />
[[Категория:Пример]]
[[Категория:Примеры]]
[[Категория:Пример программирования Arduino]]
[[Категория:Примеры программирования Arduino]]

Arduino:Примеры/GSMExamplesSendSMS - История изменений

EducationBot в 08:34, 8 июля 2023

EducationBot в 08:32, 20 мая 2023

Myagkij: Замена текста — «» на «»