Arduino库教程-GSM-Pin Management
GSM PIN Management(GSM引脚管理)
- 这个例子是提供给管理GSM shield的工具的一部分,可以帮助你改变或删除一个SIM卡的PIN。
硬件要求
- Arduino or Genuino Board
- Arduino + Telefonica GSM/GPRS Shield
- SIM card
电路
这是在一块Arduino或者Genuino开发板上的Arduino GSM Shield图
样例代码
- 首先,加上GSM库
#include <GSM.h>
- 实例化GSMPin类
GSMPIN PINManager;
- 创建您的变量,从一个字符串开始来保存串口监视器的输入。还可以制作了一个用于检查SIM引脚是否有效的标志,并发送信息到串口监视器的消息。
String user_input = "";
boolean auth = false;
String oktext = "OK";
String errortext = "ERROR";
- 在setup里,打开一个到计算机的串口连接。打开连接后,向串口监视器发送一个消息示意该程序已启动。调用PINManager.begin()来重置调制解调器。
void setup(){
Serial.begin(9600);
Serial.println("Change PIN example\n");
PINManager.begin();
- 检查是否SIM卡被一个引脚锁住了。
while(!auth){
int pin_query = PINManager.isPIN();
if(pin_query == 1)
{
- 如果被锁定,通过串口监视器询问引脚。你可以使用一个自定义名为 readSerial() 的函数来解析这些信息。
Serial.print("Enter PIN code: ");
user_input = readSerial();
- 如果引脚有效,设置认证标志为true。向串口监视器发送状态消息,示意这个结果。如果你输入了错误的引脚,你可以再试一次。3次尝试失败后,引脚将被锁定,你将需要PUK号码解锁。
if(PINManager.checkPIN(user_input) == 0)
{
auth = true;
PINManager.setPINUsed(true);
Serial.println(oktext);
}
else
{
Serial.println("Incorrect PIN. Remember that you have 3 opportunities.");
}
}
- 如果SIM卡处在PUK锁定模式,询问PUK代码和一个新的引脚。
else if(pin_query == -1)
{
Serial.println("PIN locked. Enter PUK code: ");
String puk = readSerial();
Serial.print("Now, enter a new PIN code: ");
user_input = readSerial();
if(PINManager.checkPUK(puk, user_input) == 0)
{
auth = true;
PINManager.setPINUsed(true);
Serial.println(oktext);
}
else
{
Serial.println("Incorrect PUK or invalid new PIN. Try again!.");
}
}
- 如果出现错误,PIN号码和PUK同时被锁定,发送一个合适的状态信息:
else if(pin_query == -2)
{
Serial.println("PIN & PUK locked. Use PIN2/PUK2 in a mobile phone.");
while(true);
}
- 如果没有PIN号码,设置认证标志为true
else
{
// SIM does not requires authetication
Serial.println("No pin necessary.");
auth = true;
}
}
- 检查GSM网络登记,并注明是否你连接上,是否你在漫游。
Serial.print("Checking register in GSM network...");
if(PINManager.checkReg() == 0)
Serial.println(oktext);
else if(PINManager.checkReg() == 1)
Serial.println("ROAMING " + oktext);
else
{
Serial.println(errortext);
while(true);
}
}
- 您将创建一个自定义函数来处理来自串口监视器的串行输入。做一个字符串类型的命好名的函数。
String readSerial()
{
- 当有可用的串行信息,把它读进一个新的字符串。如果遇到一个换行符,返回主程序。
String text = "";
while(1)
{
while (Serial.available() > 0)
{
char inChar = Serial.read();
if (inChar == '\n')
{
return text;
}
if(inChar!='\r')
text += inChar;
}
}
}
- loop()作为PIN管理工具,允许你打开关闭PIN,或者改变它。
void loop()
{
Serial.println("Choose an option:\n1 - On/Off PIN.");
if(PINManager.getPINUsed())
Serial.println("2 - Change PIN.");
String user_op = readSerial();
if(user_op == "1")
{
Serial.println("Enter your PIN code:");
user_input = readSerial();
PINManager.switchPIN(user_input);
}
else if(user_op == "2" & PINManager.getPINUsed())
{
Serial.println("Enter your actual PIN code:");
String oldPIN = readSerial();
Serial.println("Now, enter your new PIN code:");
String newPIN = readSerial();
PINManager.changePIN(oldPIN, newPIN);
}
else
{
Serial.println("Incorrect option. Try again!.");
}
delay(1000);
}
一旦你的代码被上传,打开串口监视器开始PIN的工作。
完整程序如下。
/*
Band Management
This sketch, for the Arduino GSM shield, checks the band
currently configured in the modem and allows you to change
it.
Please check http://www.worldtimezone.com/gsm.html
Usual configurations:
Europe, Africa, Middle East: E-GSM(900)+DCS(1800)
USA, Canada, South America: GSM(850)+PCS(1900)
Mexico: PCS(1900)
Brazil: GSM(850)+E-GSM(900)+DCS(1800)+PCS(1900)
Circuit:
* GSM shield
created 12 June 2012
by Javier Zorzano, Scott Fitzgerald
This example is in the public domain.
*/
// libraries
#include <GSM.h>
// initialize the library instance
GSMBand band;
void setup() {
// initialize serial communications and wait for port to open:
Serial.begin(9600);
while (!Serial) {
; // wait for serial port to connect. Needed for Leonardo only
}
// Beginning the band manager restarts the modem
Serial.println("Restarting modem...");
band.begin();
Serial.println("Modem restarted.");
};
void loop() {
// Get current band
String bandName = band.getBand(); // Get and print band name
Serial.print("Current band:");
Serial.println(bandName);
Serial.println("Want to change the band you’re on?");
String newBandName;
newBandName = askUser();
// Tell the user what we are about to do…
Serial.print("\nConfiguring band ");
Serial.println(newBandName);
// Change the band
boolean operationSuccess;
operationSuccess = band.setBand(newBandName);
// Tell the user if the operation was OK
if (operationSuccess) {
Serial.println("Success");
} else {
Serial.println("Error while changing band");
}
if (operationSuccess) {
while (true);
}
}
// This function offers the user different options
// through the Serial interface
// The user selects one
String askUser() {
String newBand;
Serial.println("Select band:");
// Print the different options
Serial.println("1 : E-GSM(900)");
Serial.println("2 : DCS(1800)");
Serial.println("3 : PCS(1900)");
Serial.println("4 : E-GSM(900)+DCS(1800) ex: Europe");
Serial.println("5 : GSM(850)+PCS(1900) Ex: USA, South Am.");
Serial.println("6 : GSM(850)+E-GSM(900)+DCS(1800)+PCS(1900)");
// Empty the incoming buffer
while (Serial.available()) {
Serial.read();
}
// Wait for an answer, just look at the first character
while (!Serial.available());
char c = Serial.read();
if (c == '1') {
newBand = GSM_MODE_EGSM;
} else if (c == '2') {
newBand = GSM_MODE_DCS;
} else if (c == '3') {
newBand = GSM_MODE_PCS;
} else if (c == '4') {
newBand = GSM_MODE_EGSM_DCS;
} else if (c == '5') {
newBand = GSM_MODE_GSM850_PCS;
} else if (c == '6') {
newBand = GSM_MODE_GSM850_EGSM_DCS_PCS;
} else {
newBand = "GSM_MODE_UNDEFINED";
}
return newBand;
}
[Get Code]
更多
Arduino GSM Shield – 完整的产品描述。
Getting started with the GSM Shield – 在几分钟内启动所有东西
GSM library – GSM 库的参考网页
GSMPIN
begin()
isPIN()
checkPIN()
checkPUK()
changePIN()
switchPIN()
checkReg()
getPINUsed()
setPINUsed()
GSMToolsTestGPRS - 试图用提供的APN和证书来通过GPRS访问互联网 。
GSMToolsGsmScanNetworks - 扫描可用网络和打印关于IMEI和SIM卡号码的信息。
GSMToolsPinManagement - 如何更改或删除引脚数。
GSMToolsTestModem - 测试看看GSM shield的调制解调器是否正确工作。
GSMToolsTestWebServer - 一个简单的Web服务器,没有任何答复,只打印客户端的请求和服务器IP地址。
GSMExamplesMakeVoiceCall - 如何用麦克风和扬声器进行语音通话。
获取最新文章: 扫一扫右上角的二维码加入“创客智造”公众号