Бібліотека 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
Цей клас готує функції, які здійснюватимуть зв’язок з модемом.

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

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

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

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

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

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

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

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

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

Приклади
Є дві групи прикладів для 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-шилда.

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

Коментарі 0

Тільки зареєстровані та авторизовані користувачі можуть залишати коментарі.