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

2023-07-08T08:22:32Z

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

	<references />		<references />
			{{Навигационная таблица/Портал/Arduino}}

EducationBot в 07:13, 8 июля 2023

2023-07-08T07:13:12Z

← Предыдущая версия		Версия от 11:13, 8 июля 2023
Строка 1:		Строка 1:
	~~{{#setlogo:ArduinoCommunityLogo.png}}~~
	{{Arduino панель перехода}}		{{Arduino панель перехода}}
	{{Перевод от Сubewriter}}		{{Перевод от Сubewriter}}
Строка 180:		Строка 180:
	<references />		<references />

	~~{{Навигационная таблица/Arduino библиотеки}}~~

	[[Категория:Стандартные библиотеки]]		[[Категория:Стандартные библиотеки]]

Myagkij: /* Внешние ссылки */

2016-12-09T14:56:43Z

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

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

{{#setlogo:ArduinoCommunityLogo.png}}
{{Arduino панель перехода}}
{{Перевод от Сubewriter}}
{{Myagkij-редактор}}

=Библиотека GSM<ref>[https://www.arduino.cc/en/Reference/GSM GSM library]</ref>=

'''Библиотека GSM''' идет в комплекте с '''IDE Arduino''' версии '''1.0.4''' и выше.

Благодаря этой библиотеке плата '''Arduino''', соединенная с модулем '''Arduino GSM Shield''', может выполнять большинство функций '''GSM'''-телефона: делать и принимать голосовые звонки, отправлять и получать '''SMS''', а также подключаться к интернету через '''GPRS'''-сеть.

У '''GSM'''-модуля есть модем, передающий данные от последовательного порта в '''GSM'''-сеть. Операции выполняются модемом через серию '''AT'''-команд. Цель библиотеки '''GSM''' – предоставить программные абстракты для обслуживания низкоуровневой коммуникации между модемом и '''SIM'''-картой. Для коммуникации между модемом и '''Arduino''' библиотека '''GSM''' полагается на библиотеку Software Serial.

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

==Структура==

Поскольку библиотека '''GSM''' используется для разнотипных функций, в ней присутствует несколько разных классов:

* '''Класс GSM''' отвечает за команды к модему. Он занимается коммуникационными аспектами '''GSM'''-модуля и регистрирует вашу систему в '''GSM'''-инфраструктуре. Объект этого класса требуется во всех скетчах, использующих '''GSM/GPRS''' – чтобы обрабатывать низкоуровневую коммуникацию.
* '''Класс GSMVoiceCall''' отвечает за обработку голосовых звонков.
* '''Класс GSM_SMS''' отвечает за отправку/получение '''SMS'''.
* '''Класс GPRS''' отвечает за подключение к интернету.
* '''Класс GSMClient''' включает в себя инструменты для управления клиентом – аналогично библиотекам Ethernet и WiFi.
* '''Класс GSMServer''' включает в себя инструменты для управления сервером – аналогично библиотекам Ethernet и WiFi. Примечание: Ряд мобильных операторов не разрешают входящие соединения из интернета общего пользования, но разрешают их внутри своей сети. Подробнее о подобных ограничениях спрашивайте у своего оператора.
* Ряд вспомогательных классов вроде '''GSMScanner''' или '''GSMModem'''

==Совместимость==

Разработчики старались сделать эту библиотеку максимально совместимой с библиотеками Ethernet и WiFi. Другими словами, если у вас есть скетч, использующий библиотеку Ethernet/WiFi, и вы хотите портировать его на '''Arduino''' с '''GSM'''-модулем, то с этим не должно возникнуть серьезных проблем. Впрочем, запустить этот скетч '''«как есть»''' не получится – в него нужно будет внести небольшие изменения. К примеру, подключить библиотеки, специфичные для '''GSM''' и '''GPRS''', и добавить сетевые настройки от вашего мобильного оператора.

==Примеры==

Примеры для '''GSM'''-модуля можно поделить на две группы. Первая – это скетчи-примеры, иллюстрирующие возможности модуля (вроде отправки '''SMS''' или подключения к интернету). Вторая – это '''«обслуживающие»''' скетчи-примеры, то есть программные инструменты для проверки функционала библиотеки и компонентов модуля, которые она использует.

http://wikihandbk.com/wiki/Arduino:Примеры/GSMExamplesWebServer

===Скетчи-примеры для демонстрации функций===

* [[Arduino:Примеры/GSMExamplesWebClient|GSM Web Client]] – Загрузка содержимого вебсайта на '''Arduino''' через '''GPRS'''
* [[Arduino:Примеры/GSMExamplesWebServer|GSM Web Server]] – Создание беспроводного веб-сервера через '''GPRS'''
* [[Arduino:Примеры/GSMExamplesMakeVoiceCall|Make Voice Call]] – Звонок по телефону через монитор порта
* [[Arduino:Примеры/GSMExamplesSendSMS|Send SMS]] – Отправка SMS на разные телефонные номера через монитор порта
* [[Arduino:Примеры/GSMExamplesReceiveVoiceCall|Receive Voice Call]] – Проверка статуса модема во время входящего телефонного звонка
* [[Arduino:Примеры/GSMExamplesReceiveSMS|Receive SMS]] – Получение '''SMS''' и их отображение на мониторе порта

http://wikihandbk.com/wiki/Arduino:Примеры/GSMExamplesTest_Web_Server

===Скетчи-примеры для проверки и отладки===

* [[Arduino:Примеры/GSMExamplesBandManagement|Band Management]] – Настройка диапазона частот, к которому будет подключаться '''GSM'''-модуль
* [[Arduino:Примеры/GSMExamplesGSMScanNetworks|GSM Scan Networks]] – Проверка доступных сетей
* [[Arduino:Примеры/GSMExamplesPinManagement|Pin Management]] – Управление '''PIN'''-кодом '''SIM'''-карты
* [[Arduino:Примеры/GSMExamplesTestGPRS|Test GPRS]] – Проверка функциональности '''GPRS'''-сети при помощи '''SIM'''-карты
* [[Arduino:Примеры/GSMExamplesTestModem|Test Modem]] – Получение '''IMEI'''-номера модема
* [[Arduino:Примеры/GSMExamplesTest_Web_Server|Test Web Server]] – Создание веб-сервера при помощи '''GSM'''-модуля

== Классы и функции ==

===Класс GSM===

Для коммуникации с модемом.

* [[Arduino:Библиотеки/GSM/Класс GSM|Класс GSM]]
** [[Arduino:Библиотеки/GSM/Класс GSM/begin()|begin()]]
** [[Arduino:Библиотеки/GSM/Класс GSM/shutdown()|shutdown()]]

===Класс GSMVoiceCall===

Для голосовой коммуникации через модем. Чтобы в полной мере пользоваться этим функционалом, требуются микрофон и динамик.

* [[Arduino:Библиотеки/GSM/Класс GSMVoiceCall|Класс GSMVoiceCall]]
** [[Arduino:Библиотеки/GSM/Класс GSMVoiceCall/getVoiceCallStatus()|getVoiceCallStatus()]]
** [[Arduino:Библиотеки/GSM/Класс GSMVoiceCall/ready()|ready()]]
** [[Arduino:Библиотеки/GSM/Класс GSMVoiceCall/voiceCall()|voiceCall()]]
** [[Arduino:Библиотеки/GSM/Класс GSMVoiceCall/answerCall()|answerCall()]]
** [[Arduino:Библиотеки/GSM/Класс GSMVoiceCall/hangCall()|hangCall()]]
** [[Arduino:Библиотеки/GSM/Класс GSMVoiceCall/retrieveCallingNumber()|retrieveCallingNumber()]]

=== Класс GSM_SMS ===

Для отправки и получения '''SMS'''-сообщений (от '''«Short Message Service»''', что значит '''«служба коротких сообщений»''').

* [[Arduino:Библиотеки/GSM/Класс GSM_SMS|Класс GSM_SMS]]
** [[Arduino:Библиотеки/GSM/Класс GSM_SMS/beginSMS()|beginSMS()]]
** [[Arduino:Библиотеки/GSM/Класс GSM_SMS/ready()|ready()]]
** [[Arduino:Библиотеки/GSM/Класс GSM_SMS/endSMS()|endSMS()]]
** [[Arduino:Библиотеки/GSM/Класс GSM_SMS/available()|available()]]
** [[Arduino:Библиотеки/GSM/Класс GSM_SMS/remoteNumber()|remoteNumber()]]
** [[Arduino:Библиотеки/GSM/Класс GSM_SMS/read()|read()]]
** [[Arduino:Библиотеки/GSM/Класс GSM_SMS/write()|write()]]
** [[Arduino:Библиотеки/GSM/Класс GSM_SMS/print()|print()]]
** [[Arduino:Библиотеки/GSM/Класс GSM_SMS/peek()|peek()]]
** [[Arduino:Библиотеки/GSM/Класс GSM_SMS/flush()|flush()]]

=== Класс GPRS ===

Отвечает за подключение файлов из библиотеки для обработки '''TCP'''-коммуникации.

* [[Arduino:Библиотеки/GSM/Класс GPRS|Класс GPRS]]
** [[Arduino:Библиотеки/GSM/Класс GPRS/attachGPRS()|attachGPRS()]]

===Класс GSMClient===

Для создания клиента, способного подключаться к серверам, а также отправлять/получать данные.

* [[Arduino:Библиотеки/GSM/Класс GSMClient|Класс GSMClient]]
** [[Arduino:Библиотеки/GSM/Класс GSMClient/ready()|ready()]]
** [[Arduino:Библиотеки/GSM/Класс GSMClient/connect()|connect()]]
** [[Arduino:Библиотеки/GSM/Класс GSMClient/beginWrite()|beginWrite()]]
** [[Arduino:Библиотеки/GSM/Класс GSMClient/write()|write()]]
** [[Arduino:Библиотеки/GSM/Класс GSMClient/endWrite()|endWrite()]]
** [[Arduino:Библиотеки/GSM/Класс GSMClient/connected()|connected()]]
** [[Arduino:Библиотеки/GSM/Класс GSMClient/read()|read()]]
** [[Arduino:Библиотеки/GSM/Класс GSMClient/available()|available()]]
** [[Arduino:Библиотеки/GSM/Класс GSMClient/peek()|peek()]]
** [[Arduino:Библиотеки/GSM/Класс GSMClient/flush()|flush()]]
** [[Arduino:Библиотеки/GSM/Класс GSMClient/stop()|stop()]]

=== Класс GSMServer ===

Для создания сервера, способного отправлять/получать данные от подключенных к нему клиентов (то есть программ, запущенных на других компьютерах и устройствах).

* [[Arduino:Библиотеки/GSM/Класс GSMServer|Класс GSMServer]]
** [[Arduino:Библиотеки/GSM/Класс GSMServer/ready()|ready()]]
** [[Arduino:Библиотеки/GSM/Класс GSMServer/beginWrite()|beginWrite()]]
** [[Arduino:Библиотеки/GSM/Класс GSMServer/write()|write()]]
** [[Arduino:Библиотеки/GSM/Класс GSMServer/endWrite()|endWrite()]]
** [[Arduino:Библиотеки/GSM/Класс GSMServer/read()|read()]]
** [[Arduino:Библиотеки/GSM/Класс GSMServer/available()|available()]]
** [[Arduino:Библиотеки/GSM/Класс GSMServer/stop()|stop()]]

=== Класс GSMModem ===

Для диагностической коммуникации с модемом.

* [[Arduino:Библиотеки/GSM/Класс GSMModem|Класс GSMModem]]
** [[Arduino:Библиотеки/GSM/Класс GSMModem/begin()|begin()]]
** [[Arduino:Библиотеки/GSM/Класс GSMModem/getIMEI()|getIMEI()]]

===Класс GSMScanner===

Для получения диагностической информации о сети и мобильном операторе.

* [[Arduino:Библиотеки/GSM/Класс GSMScanner|Класс GSMScanner]]
** [[Arduino:Библиотеки/GSM/Класс GSMScanner/begin()|begin()]]
** [[Arduino:Библиотеки/GSM/Класс GSMScanner/getCurrentCarrier()|getCurrentCarrier()]]
** [[Arduino:Библиотеки/GSM/Класс GSMScanner/getSignalStrength()|getSignalStrength()]]
** [[Arduino:Библиотеки/GSM/Класс GSMScanner/readNetworks()|readNetworks()]]

===Класс GSMPIN===

Для коммуникации с '''SIM'''-картой.

* [[Arduino:Библиотеки/GSM/Класс GSMPIN|Класс GSMPIN]]
** [[Arduino:Библиотеки/GSM/Класс GSMPIN/begin()|begin()]]
** [[Arduino:Библиотеки/GSM/Класс GSMPIN/isPIN()|isPIN()]]
** [[Arduino:Библиотеки/GSM/Класс GSMPIN/checkPIN()|checkPIN()]]
** [[Arduino:Библиотеки/GSM/Класс GSMPIN/checkPUK()|checkPUK()]]
** [[Arduino:Библиотеки/GSM/Класс GSMPIN/changePIN()|changePIN()]]
** [[Arduino:Библиотеки/GSM/Класс GSMPIN/switchPIN()|switchPIN()]]
** [[Arduino:Библиотеки/GSM/Класс GSMPIN/checkReg()|checkReg()]]
** [[Arduino:Библиотеки/GSM/Класс GSMPIN/getPINUsed()|getPINUsed()]]
** [[Arduino:Библиотеки/GSM/Класс GSMPIN/setPINUsed()|setPINUsed()]]

=== Класс GSMBand ===

Для получения информации о диапазоне частот, к которому подключен модем. Также имеет функции для настройки диапазона частот.

* [[Arduino:Библиотеки/GSM/Класс GSMBand|Класс GSMBand]]
** [[Arduino:Библиотеки/GSM/Класс GSMBand/begin()|begin()]]
** [[Arduino:Библиотеки/GSM/Класс GSMBand/getBand()|getBand()]]
** [[Arduino:Библиотеки/GSM/Класс GSMBand/setBand()|setBand()]]

=См.также=

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

<references />

{{Навигационная таблица/Arduino библиотеки}}

[[Категория:Стандартные библиотеки]]
[[Категория:Стандартная библиотека]]
[[Категория:Стандартная библиотека Arduino]]
[[Категория:Стандартные библиотеки Arduino]]

Arduino:Библиотеки/GSM - История изменений

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

EducationBot в 07:13, 8 июля 2023

Myagkij: /* Внешние ссылки */