Перевод: Максим Кузьмин

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

Библиотека GSM^[1]

Библиотека 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

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

GSM Web Client – Загрузка содержимого вебсайта на Arduino через GPRS
GSM Web Server – Создание беспроводного веб-сервера через GPRS
Make Voice Call – Звонок по телефону через монитор порта
Send SMS – Отправка SMS на разные телефонные номера через монитор порта
Receive Voice Call – Проверка статуса модема во время входящего телефонного звонка
Receive SMS – Получение SMS и их отображение на мониторе порта

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

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

Band Management – Настройка диапазона частот, к которому будет подключаться GSM-модуль
GSM Scan Networks – Проверка доступных сетей
Pin Management – Управление PIN-кодом SIM-карты
Test GPRS – Проверка функциональности GPRS-сети при помощи SIM-карты
Test Modem – Получение IMEI-номера модема
Test Web Server – Создание веб-сервера при помощи GSM-модуля

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

Класс GSM

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

Класс GSM
- begin()
- shutdown()

Класс GSMVoiceCall

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

Класс GSMVoiceCall

Класс GSM_SMS

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

Класс GSM_SMS
- beginSMS()
- ready()
- endSMS()
- available()
- remoteNumber()
- read()
- write()
- print()
- peek()
- flush()

Класс GPRS

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

Класс GPRS
- attachGPRS()

Класс GSMClient

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

Класс GSMClient
- ready()
- connect()
- beginWrite()
- write()
- endWrite()
- connected()
- read()
- available()
- peek()
- flush()
- stop()

Класс GSMServer

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

Класс GSMServer
- ready()
- beginWrite()
- write()
- endWrite()
- read()
- available()
- stop()

Класс GSMModem

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

Класс GSMModem
- begin()
- getIMEI()

Класс GSMScanner

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

Класс GSMScanner

Класс GSMPIN

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

Класс GSMPIN
- begin()
- isPIN()
- checkPIN()
- checkPUK()
- changePIN()
- switchPIN()
- checkReg()
- getPINUsed()
- setPINUsed()

Класс GSMBand

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

Класс GSMBand

См.также

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

↑ GSM library

[1] GSM library

[1]

Библиотеки Arduino
Стандартные библиотеки
EEPROM	read() • write() • update() • get() • put() • EEPROM[]
Ethernet	Класс Ethernet: begin() • localIP() • maintain() Класс IPAddress: IPAddress() Класс Server: Класс Server • EthernetServer() • begin() • available() • write() • print() • println() Класс Client: Класс Client • EthernetClient() • if (EthernetClient) • connected() • connect() • write() • print() • println() • available() • read() • flush() • stop() Класс EthernetUDP: begin() • read() • write() • beginPacket() • endPacket() • parsePacket() • available() • stop() • remoteIP() • remotePort()
Firmata	-
GSM	Класс GSM: Класс GSM • begin() • shutdown() Класс GSMVoiceCall: Класс GSMVoiceCall • getVoiceCallStatus() • ready() • voiceCall() • answerCall() • hangCall() • retrieveCallingNumber() Класс GSM SMS: Класс GSM_SMS • beginSMS() • ready() • endSMS() • available() • remoteNumber() • read() • write() • print() • peek() • flush() Класс GPRS: Класс GPRS • attachGPRS() Класс GSMClient:Класс GSMClient • ready() • connect() • beginWrite() • write() • endWrite() • connected() • read() • available() • peek() • flush() • stop() Класс GSMServer: Класс GSMServer • ready() • beginWrite() • write() • endWrite() • read() • available() • stop() Класс GSMModem: Класс GSMModem • begin() • getIMEI() Класс GSMScanner: Класс GSMScanner • begin() • getCurrentCarrier() • getSignalStrength() • readNetworks() Класс GSMPIN: Класс GSMPIN • begin() • isPIN() • checkPIN() • checkPUK() • changePIN() • switchPIN() • checkReg() • getPINUsed() • setPINUsed() Класс GSMBand: Класс GSMBand • begin() • getBand() • setBand()
LiquidCrystal	LiquidCrystal() • begin() • clear() • home() • setCursor() • write() • print() • cursor() • noCursor() • blink() • noBlink() • display() • noDisplay() • scrollDisplayLeft() • scrollDisplayRight() • autoscroll() • noAutoscroll() • leftToRight() • rightToLeft() • createChar()
SD	Класс SD: begin() • exists() • mkdir() • open() • remove() • rmdir() Класс File: available() • close() • flush() • peek() • position() • print() • println() • seek() • size() • read() • write() • isDirectory() • openNextFile() • rewindDirectory()
Servo	attach() • write() • writeMicroseconds() • read() • attached() • detach()
SPI	Класс SPISettings • begin() • end() • beginTransaction() • endTransaction() • setBitOrder() • setClockDivider() • setDataMode() • transfer() • usingInterrupt() • Расширенное использование шины SPI на Due
SoftwareSerial	Класс SoftwareSerial • available() • begin() • isListening() • overflow() • peek() • read() • print() • println() • listen() • write()
Stepper	Stepper(steps, pin1, pin2) • Stepper(steps, pin1, pin2, pin3, pin4) • setSpeed(rpm) • step(steps)
TFT	Класс TFT • Класс EsploraTFT • begin() • background() • stroke() • noStroke() • fill() • noFill() • text() • setTextSize() • point() • line() • rect() • width() • height() • circle() • image() • loadImage() • Класс PImage • PImage.height() • PImage.width() • PImage.isValid()
WiFi	Класс WiFi: • begin() • disconnect() • config() • setDNS() • SSID() • BSSID() • RSSI() • encryptionType() • scanNetworks() • status() • getSocket() • macAddress() Класс IPAddress: • localIP() • subnetMask() • gatewayIP() Класс WiFiServer: • Класс WiFiServer • WiFiServer() • begin() • available() • write() • print() • println() Класс WiFiClient: • Класс WiFiClient • WiFiClient() • connected() • connect() • write() • print() • println() • available() • read() • flush() • stop() Класс UDP: • Класс WiFiUDP • begin() • available() • beginPacket() • endPacket() • write() • parsePacket() • peek() • read() • flush() • stop() • remoteIP() • remotePort()
Wire	begin() • requestFrom() • beginTransmission() • endTransmission() • write() • available() • read() • onReceive() • onRequest()
Только для Arduino 101
CurieBLE	BLEPeripheral: • Класс BLEPeripheral • begin() • poll() • end() • setAdvertisedServiceUuid() • setLocalName() • setDeviceName() • setAppearance() • setEventHandler() • addAttribute() • disconnect() • central() • connected() BLEDescriptor: • Класс BLEDescriptor BLECentral: • Класс BLECentral • connected() • address() • disconnect() • poll() BLECharacteristic: • Класс BLECharacteristic BLEService: • Класс BLEService
CurieIMU	begin() • getGyroRate() • setGyroRate() • getAccelerometerRate() • setAccelerometerRate() • getGyroRange() • setGyroRange() • getAccelerometerRange() • setAccelerometerRange() • autoCalibrateGyroOffset() • autoCalibrateAccelerometerOffset() • noGyroOffset() • noAccelerometerOffset() • gyroOffsetEnabled() • accelerometerOffsetEnabled() • getGyroOffset() • getAccelerometerOffset() • setGyroOffset() • setAccelerometerOffset() • getDetectionThreshold() • setDetectionThreshold() • getDetectionDuration() • setDetectionDuration() • interrupts() • noInterrupts() • interruptEnabled() • getInterruptStatus() • getStepDetectionMode() • setStepDetectionMode() • readMotionSensor() • readAccelerometer() • readGyro() • readTemperature() • shockDetected() • motionDetected() • tapDetected() • stepsDetected() • attachInterrupt() • detachInterrupt()
CurieTimerOne	start() • restart() • kill() • attachInterrupt() • detachInterrupt() • readTickCount() • rdRstTickCount() • pause() • resume() • pwmStart() • pwmStop()
Только для Arduino Due
Audio	begin() • prepare() • write()
Scheduler	startLoop() • yield()
Только для Arduino Due, Zero и MKR1000
USBHost	Класс MouseController:Класс MouseController • mouseMoved() • mouseDragged() • mousePressed() • mouseReleased() • getXChange() • getYChange() • getButton() Класс KeyboardController:Класс KeyboardController • keyPressed() • keyReleased() • getModifiers() • getKey() • getOemKey()
Только для Arduino Zero и MKR1000
Audio Frequency Meter Library	begin() • end() • setClippingPin() • checkClipping() • setAmplitudeThreshold() • setTimerTolerance() • setSlopeTolerance() • setBandwidth() • getFrequency()
AudioZero	begin() • play() • end()
RTC	begin() • setHours() • setMinutes() • setSeconds() • setTime() • setYear() • setMonth() • setDay() • setDate() • getHours() • getMinutes() • getSeconds() • getYear() • getMonth() • getDay() • setAlarmHours() • setAlarmMinutes() • setAlarmSeconds() • setAlarmTime() • setAlarmYear() • setAlarmMonth() • setAlarmDay() • setAlarmDate() • enableAlarm() • disableAlarm() • attachInterrupt() • detachInterrupt() • standbyMode()
Только для WiFi 101 и MKR1000
WiFi101	Класс WiFi: • begin() • disconnect() • config() • setDNS() • SSID() • BSSID() • RSSI() • encryptionType() • scanNetworks() • status() • macAddress() Класс IPAddress: • localIP() • subnetMask() • gatewayIP() Класс WiFiServer: • Класс WiFiServer • WiFiServer() • begin() • available() • write() • print() • println() Класс WiFiClient: • Класс WiFiClient • WiFiClient() • Класс WiFiSSLClient • connected() • connect() • connectSSL() • write() • print() • println() • available() • read() • flush() • stop() Класс WiFiUDP: • Класс WiFiUDP • begin() • available() • beginPacket() • endPacket() • write() • parsePacket() • peek() • read() • flush() • stop() • remoteIP() • remotePort()
Только для Arduino Robot
Robot	RobotControl: • Класс Robot • begin() • setMode() • pauseMode() • isActionDone() • lineFollowConfig() • digitalRead() • digitalWrite() • analogRead() • analogWrite() • updateIR() • knobRead() • compassRead() • keyboardRead() • waitContinue() • motorsWrite() • motorsStop() • turn() • pointTo() • beginSpeaker() • playMelody() • beep() • playFile() • tuneWrite() • tempoWrite() • beginTFT() • text() • drawBMP() • debugPrint() • clearScreen() • displayLogos() • drawCompass() • beginSD() • userNameRead() • userNameWrite() • robotNameRead() • robotNameWrite() • cityNameRead() • cityNameWrite() • countryNameRead() • countryNameWrite() RobotMotor: • Класс RobotMotor • begin() • process() • parseCommand() • motorsWrite() • IRread()
Только для Arduino Yun
Bridge	Класс Bridge: begin() • put() • get() • transfer() Класс Process: begin() • addParameter() • run() • runAsynchronously() • running() • exitValue() • close() • runShellCommand() • runShellCommandAsynchronously() • available() • read() • write() • peek() • flush() Класс Console: begin() • end() • buffer() • noBuffer() • connected() • available() • read() • write() • peek() • flush() Класс FileIO: Класс FileSystem: begin() • open() • exists() • mkdir() • rmdir() • remove() • Класс File • close() • rewindDirectory() • openNextFile() • seek() • position() • size() • available() • read() • write() • peek() • flush() Класс Mailbox: begin() • end() • readMessage() • writeMessage() • writeJSON() • messageAvailable() Класс HttpClient: get() • getAsynchronously() • ready() • getResult() Класс BridgeClient: stop() • connect() • connected() • available() • read() • write() • peek() • flush() Класс BridgeSSLClient: stop() • connect() • connected() • available() • read() • write() • peek() • flush() Класс BridgeServer: begin() • listenOnLocalhost() • noListenOnLocalhost() • write() Deprecated classes: Класс YunClient: stop() • connect() • connected() • available() • read() • write() • peek() • flush() Класс YunServer: begin() • listenOnLocalhost() • noListenOnLocoalhost() • write()
USB-библиотеки (Leonardo, Micro, Due, Zero и Esplora)
Keyboard	begin() • end() • press() • print() • println() • release() • releaseAll() • write()
Mouse	begin() • click() • end() • move() • press() • release() • isPressed()
Коммуникация (сети и протоколы)
CmdMessenger	-
NewSoftSerial	-
OneWire	-
PS2Keyboard	-
SimpleMessageSystem	-
SSerial2Mobile	-
Webduino	-
X10	-
XBee	-
SerialControl	-
Датчики
CapacitiveSensing	-
Bounce	-
Дисплеи и светодиоды
Adafruit GFX	-
GLCD	-
LedControl	-
LedDisplay	-
Matrix	-
PCD8544	-
Sprite	-
ST7735	-

Arduino:Библиотеки/GSM

Содержание

Библиотека GSM^[1]

Структура

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

Примеры

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

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

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

Класс GSM

Класс GSMVoiceCall

Класс GSM_SMS

Класс GPRS

Класс GSMClient

Класс GSMServer

Класс GSMModem

Класс GSMScanner

Класс GSMPIN

Класс GSMBand

См.также

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

Навигация

Действия на странице

Действия на странице

Персональные инструменты

Навигация

Поиск

Инструменты

Arduino:Библиотеки/GSM

Библиотека GSM[1]

Структура

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

Примеры

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

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

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

Класс GSM

Класс GSMVoiceCall

Класс GSM_SMS

Класс GPRS

Класс GSMClient

Класс GSMServer

Класс GSMModem

Класс GSMScanner

Класс GSMPIN

Класс GSMBand

См.также

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

Навигация

Поиск

Библиотека GSM^[1]