GSM kütüphanesi Arduino IDE 1.0.4 ve sonraki sürümlerine dahil edilmiştir.

Arduino GSM Shield ile , bu kütüphane bir Arduino kartının bir GSM telefonla yapabileceğiniz işlemlerin çoğunu yapmasını sağlar: sesli aramalar yapın ve alın, SMS gönderin ve alın ve bir GPRS şebekesi üzerinden internete bağlanın.

GSM kalkanı, bir seri bağlantı noktasından GSM şebekesine veri aktaran bir modeme sahiptir. Modem işlemleri bir dizi AT komutu aracılığıyla yürütür. Kütüphane, modem ve SIM kart arasında düşük düzeyde iletişim kurar. Moden ve Arduino arasındaki iletişim için Software Serial kütüphanesine dayanır.

Tipik olarak, her bir komut belirli bir işlevi yürütmek için gereken daha büyük bir serinin parçasıdır. Kütüphane ayrıca bilgi alabilir ve gerektiğinde size geri verebilir.

Bu kütüphaneyi kullanmak için
#include <GSM.h>

Kütüphane Yapısı

Kütüphane birden fazla işlevsellik türünü etkinleştirdiğinden, birkaç farklı sınıf vardır.

• The class takes care of commands to the radio modem. This handles the connectivity aspects of the shield and registers your system in the GSM infrastructure. All of your GSM/GPRS programs will need to include an object of this class to handle the necessary low level communication.

• Voice call handling, managed by the GSMVoiceCall class.

• Send/receive SMS messages, managed by the GSM_SMS class.

• The GPRSClass is for connecting to the internet.

• GSMClient includes implementations for a client, similar to the Ethernet and WiFi libraries.

• GSMServer includes implementations for a server, similar to the Ethernet and WiFi libraries. NB : A number of network operators do not allow for incoming connections from the public internet, but will allow them from inside their own. Check with your operator to see what restrictions there are on data use.

• A number of utility classes such as GSMScanner and GSMModem

Ethernet Kitaplığı Uyumluluğu

Kitaplık, geçerli Ethernet kitaplığıyla mümkün olduğunca uyumlu olmaya çalışır. Bir programı Arduino Ethernet veya WiFi kütüphanesinden GSM Shield ile bir Arduino'ya taşımak oldukça kolay olmalıdır. Ethernet uyumlu kodu GSM kalkanında olduğu gibi çalıştırmak mümkün olmasa da, GSM ve GPRS'e özgü kütüphaneleri dahil etmek ve hücresel şebeke sağlayıcınızdan şebeke yapılandırma ayarlarını almak gibi bazı küçük, kütüphaneye özgü değişiklikler gerekli olacaktır.

Örnekler

GSM kalkanı için iki grup örnek vardır. Kalkanın olasılıklarını gösteren SMS mesajları gönderme ve internete bağlanma gibi örnekler var. Ayrıca, kitaplığın ve donanımın işlevselliğini daha düşük düzeyde hata ayıklamak için kullanabileceğiniz örnek araçlar da vardır.

• Gsm Web Client: Bir web sitesinin içeriğini GPRS aracılığıyla Arduino kartınıza indirin.
• Gsm Web Server: GPRS üzerinden kablosuz bir web sunucusu oluşturun.
• Make Voice Call: Seri Monitörden telefon görüşmeleri yapmak için kalkanınızı alın.
• Send SMS: Farklı telefon numaralarına SMS mesajları yazmak için Seri Monitörü kullanın.
• Receive Voice Call: Sesli arama alırken modemin durumunu kontrol edin.
• Receive SMS: SMS mesajlarını okuyun ve Seri Monitöre yönlendirin.

• Band Management: GSM kalkanının bağlandığı bandı yönetin.
• GSM Scan Networks: Kullanılabilir ağları kontrol edin.
• Pin Management: SIM kartınızın PIN numarasını yönetin.
• Test GPRS: SIM kartınızı kullanarak GPRS şebekesinin düzgün çalışıp çalışmadığını test edin.
• Test Modem: Modeminizin IMEI kodunu okuyun.
• Test Web Server: GSM kalkanınızla bir web sunucusu oluşturun.

GSM kalkanı hakkında ek bilgi için, Başlangıç sayfası ve GSM kalkanı donanım sayfasına bakın .

Son düzeltme 2019/12/24 by SM

GSM sınıfı

Bu sınıf, modemle iletişim kuracak işlevleri hazırlar.

• GSM

• begin()
• shutdown()

GSMVoiceCall sınıfı

Modem üzerinden sesli iletişimi etkinleştirir. Tam kullanım için bir mikrofon ve hoparlörün eklenmesi gerekir.

• GSMVoiceCall

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

GSM_SMS sınıfı

Kısa Mesaj Servisi (SMS) mesajları göndermeyi ve almayı kolaylaştırır.

• GSM_SMS

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

GPRS sınıfı

Bu sınıf, TCP iletişimini içeren kitaplığın bir parçası olan dosyaları dahil etmekten sorumludur.

• GPRS

• attachGPRS()

GSMClient sınıfı

İstemci sınıfı, sunuculara bağlanabilen ve veri gönderip alabilen istemciler oluşturur.

• GSMClient

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

GSMServer sınıfı

Sunucu sınıfı, bağlı istemcilere (diğer bilgisayarlarda veya aygıtlarda çalışan programlar) veri gönderebilen ve bunlardan veri alabilen sunucular oluşturur.

• GSMServer

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

GSMModem sınıfı

GSMModem sınıfı, modemle tanı iletişimini kolaylaştırır.

• GSMModem

• begin()
• getIMEI()

GSMScanner sınıfı

GSMScanner sınıfı, ağ ve operatör hakkında tanılama bilgileri sağlar.

• GSMScanner

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

GSMPIN sınıfı

GSMPIN sınıfı, SIM kart ile iletişim kurmak için yardımcı programlara sahiptir.

• GSMPIN

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

GSMBand sınıfı

GSMBand sınıfı, modemin bağlandığı frekans bandı hakkında bilgi sağlar. Bandı ayarlamak için yöntemler de vardır.

• GSMBand

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