Бібліотека GSM

GSM

Бібліотека GSM включена в Arduino IDE 1.0.4 та пізніші версії. З шилдом Arduino GSM ця бібліотека дозволяє здійснювати більшість операцій, які Ви можете виконувати з GSM-телефоном: робити і приймати голосові дзвінки, надсилати та отримувати SMS і підключатися до інтернету через мережу GPRS.

GSM-шилд має модем, який передає дані з послідовного порту до мережі GSM. Модем виконує операції через серії AT-команд. Бібліотека повідомляє про низький рівень зв'язку між модемом та SIM-карткою. Вона спирається на бібліотеку Software Serial для зв’язку між модемом та Arduino.

Зазвичай кожна індивідуальна команда є частиною серії, необхідної для виконання певної функції. Бібліотека також може отримувати інформацію та повертати її, коли є потреба.

Структура бібліотеки

Так як бібліотека надає численні типи функціональності, є кілька різних класів:

• Клас GSM відповідає за команди до радіомодему. Він обробляє аспекти підключення з шилда та реєструє Вашу систему у GSM-інфраструктурі. Всі Ваші програми GSM/GPRS потребуватимуть включити об’єкт цього класу, щоб утримувати необхідний низький рівень зв’язку.
• Обробка голосових повідомлень, управляється класом GSMVoiceCall.
• Надсилання/отримування SMS-повідомлень, управляється класом GSM_SMS
• GPRSClass для підключення до інтернету.
• GSMClient включає реалізації для клієнта, схожий на бібліотеки Ethernet and WiFi.
• GSMServer включає реалізації для сервера, схожий на бібліотеки Ethernet and WiFi. Примітка: число мережевих операторів не дозволяють вхідні з’єднання з відкритого інтернету, але дозволять їх для власних. Зверніться до свого оператора, щоб дізнатись, які обмеження існують у використанні даних.
• Кілька додаткових класів, такі як GSMScanner та GSMModem.

Сумісність з бібліотекою Ethernet

Бібліотека намагається бути настільки сумісною з поточною бібліотекою Ethernet, наскільки це можливо. Портування програми з бібліотеки Arduino Ethernet чи WiFi з GSM-шилдом має бути досить простим. Хоча неможливо просто запустити Ethernet-сумісний код на GSM, потрібні будуть деякі незначні зміни бібліотек, як-от включення спеціальних бібліотек GSM та GPRS та отримання конфігураційних налаштувань мережі від Вашого оператора стільникової мережі.

Функції

Клас GSM
Цей клас готує функції, які здійснюватимуть зв’язок з модемом.

• GSM
• begin()
• shutdown()

Клас GSMVoiceCall
Забезпечує голосовий зв'язок через модем. Для повного використання потрібні мікрофон та динамік.

• GSMVoiceCall
• getVoiceCallStatus()
• ready()
• voiceCall()
• answerCall()
• hangCall()
• retrieveCallingNumber()

Клас GSM_SMS
Спрощує надсилання та отримування повідомдень сервісу коротких повідомдень (SMS).

• GSM_SMS
• beginSMS()
• ready()
• endSMS()
• available()
• remoteNumber()
• read()
• write()
• print()
• peek()
• flush()

Клас GPRS
Клас відповідає за включення файлів, які є частиною бібліотеки, що залучає TCP-зв’язок.

• GPRS
• attachGPRS()

Клас GSMClient
Клас Client створює клієнтів, які можуть підключатися до серверів та надсилати і отримувати дані.

• GSMClient
• ready()
• connect()
• beginWrite()
• write()
• endWrite()
• connected()
• read()
• available()
• peek()
• flush()
• stop()

Клас GSMServer
Клас Server створює сервери, які можуть надсилати та отримувати дані від підключених клієнтів (програми, що запускаються на інших комп’ютерах та пристроях).

• GSMServer
• ready()
• beginWrite()
• write()
• endWrite()
• read()
• available()
• stop()

Клас GSMModem
Клас GSMModem спрощує діагностичний зв'язок з модемом.

• GSMModem
• begin()
• getIMEI()

Клас GSMScanner
Клас GSMScanner забезпечує діагностичну інформацію про мережу та носія.

• GSMScanner
• begin()
• getCurrentCarrier()
• getSignalStrength()
• readNetworks()

Клас GSMPIN
Клас GSMPIN має можливості для зв’язку з SIM-картою.

• GSMPIN
• begin()
• isPIN()
• checkPIN()
• checkPUK()
• changePIN()
• switchPIN()
• checkReg()
• getPINUsed()
• setPINUsed()

Клас GSMBand
Клас GSMBand надає інформацію про частотний діапазон, до якого підключається модем. Є також способи налаштування діапазону.

• GSMBand
• begin()
• getBand()
• setBand()

Приклади

Є дві групи прикладів для GSM-шилдів. Є приклади для демонстрації можливостей шилда, як-от відправлення повідомлень чи підключення до інтернету. Також є набір інструментів-прикладів, які можна використовувати для налагодження функціональності бібліотеки та обладнання на нижчому рівні.
Gsm Web Client: скачати вміст веб-сайту на плату Arduino через GPRS.
Gsm Web Server: створити безпровідний веб-сервер через GPRS.
Make Voice Call: налаштування плати на здійснення телефонних дзвінків із серійного монітору.
Send SMS: використання серійного монітору для друку SMS-повідомлень до різних телефонних номерів.
Receive Voice Call: перевірка статусу модема під час отримання голосових дзвінків.
Receive SMS: зчитує SMS повідомлення та виводить їх на серійний монітор.

Інструменти
Band Management: керує групою, до якої підключається GSM-шилд.
GSM Scan Networks: перевіряє, чи є доступні мережі.
Pin Management: керує PIN-номером SIM-карти.
Test GPRS: перевіряє правильну роботу мережі GPRS з використанням SIM-карти.
Test Modem: зчитує IMEI Вашого модему.
Test Web Server: створює веб-сервер за допомогою GSM-шилда.

Повернутись до головної