background image

Answering, Rejecting, and Hanging Up

If a call is coming in – 

phone.status()

is returning 

CALL_INCOMING

– you 

can use 

phone.answer()

to pick it up.

If you’ve checked the caller ID and don’t really feel like talking to the 
individual paired with that number, you have two options: ignore the call 
until they hang up or run 

phone.hangUp()

to reject the call.

Likewise, if you’ve answered the call and want to end it, call 

phone.hangUp()

to close the line.

Dialing

If you want to initiate a phone call, use 

phone.dial(char

 

*

 

phoneNumber)

to start dialing. 

phoneNumber

should be a character array formatted like any 

phone number you would dial from a normal phone. If you’re in the same 
area code, it may be as few as 7 digits (assuming it’s a U.S. number). On 
the other end of the spectrum, with international codes included, the 
number can be as long as 15 digits.

Here’s a quick example:

char destinationPhone[]

 

= "13032840979";

 

//

 

SparkFun

 

HQ

 ­

1

­

30

3

­

284

­

0979

phone.dial(destinationPhone);

 

//

 

Dial

 

the

 

phone

 

number

Serial.println("Dialing");
do
{

 

int phoneStatus

 

= phone.status();

    

Serial.print(".");

}

 

while ((phoneStatus

 

!= CALL_ACTIVE)

 

|| (phoneStatus

 

!= CALL_

IDLE))

 

if (callStatus

 

== CALL_ACTIVE)

    

Serial.println("Other

 

end

 

picked

 

up!");

Again, you can use 

phone.hangUp()

to end the call, unless the other party 

does so first.

Example Bonus: Posting to Phant

The motivating factor behind us seeking out a solid cellular module was 
finding a reliable tool to remotely post environment data to our data service
running Phant. We’d be remiss if we didn’t show at least one example of 
how to use the hardware and IoT service together.

Download the Phant Library

A sketch included with the library – MG2639_Phant – requires an additional 
library to take care of Phant posts. Download the library from our Phant-
Arduino repo, or by clicking the button below:

DOWNLO AD  THE PHAN T ARDUINO LIBRARY

Again, follow the Installing an Arduino Library tutorial for help installing it.

If you already have the Phant Arduino library, make sure it's updated 
to the latest version -- this sketch takes advantage of some flash-string 
storage recently added to the library. Memory is at a real premium. 
You'll get a compile error if the library isn't updated.

Running the Example

Open the MG2639_Phant example sketch by going to File > Examples > 
SparkFun MG2639 CellShield > MG2639_Phant.

Page 20 of 22

Содержание MG2639 Cellular Shield

Страница 1: ...whether it s a text message triggered MP3 player an environmental monitor logging to data sparkfun com or a new iteration of the Port O Rotary telephone Covered In This Tutorial This tutorial aims to...

Страница 2: ...requires more power than an Arduino can supply when it s powered over USB We recommend this 9V wall adapter but any power supply within your Arduino s specified input voltage range should work SIM Ca...

Страница 3: ...eld if you ve never installed a library before check this guide out Hardware Overview Before you get to connecting the MG2639 Cellular Shield to your Arduino you should familiarize yourself with the f...

Страница 4: ...use with SoftwareSerial Instead we recommend using the AltSoftSerial library with this part of the module Either of the two UARTS the cell or GPS can be switched over to the Arduino s hardware UART Ch...

Страница 5: ...B0104 level shifter It defaults to 5V but can be switched to 3 3V if your application requires Cellular UART RX and TX These jumpers allow you to switch the cellular module s RX and TX between either...

Страница 6: ...rduino s unused pins You can also instead use male headers to connect it to the Arduino If you re looking to use the shield as more of a breakout board you can solder wires directly to the pins you ne...

Страница 7: ...e SIM card into the shield The workings of the SIM card socket can take some getting used to To unlock the latch push the top part of the assembly towards the battery then lift it up Slide the SIM car...

Страница 8: ...nding a suitable SIM card the most important part of getting the MG2639 Shield working is supplying it with enough power Power Supply Requirements Depending on which state it s in the MG2639 module ca...

Страница 9: ...d to cut SJ2 and short SJ3 Jumper configuration for battery power Cut SJ2 and short SJ3 then clean it up better than we did SJ2 will prevent the 3 8V regulator from supplying a competing voltage to th...

Страница 10: ...lar Shield library depends on Download and Install the Arduino Library We ve written an Arduino library specifically for the MG2639 Cellular Shield Click the button below to download it or clone it fr...

Страница 11: ...s include SFE_MG2639_CellShield h To begin communication the cellular module and perform some set up call the cell begin function This initializing function will return with the status of the module a...

Страница 12: ...ch for help using those functions Example 1 Text Messages The library includes a fun example sketch the demonstrates how to send and receive text messages If your cellular plan has SMS ability give th...

Страница 13: ...rduino will send an SMS back to the sender with the desired information Using the Library SMS To use the SMS functionality of the library there is a second object defined as sms There are a variety of...

Страница 14: ...message sending phone and timestamp the message was sent These values are only updated after an sms read Here s an example based on the sketch Get first available unread message int messageIndex sms a...

Страница 15: ...ad allows you to go through the logs of your text messages and delete any or save them Example 2 GPRS TCP One of the most powerful aspects of the MG2639 is its ability to connect to a GPRS network and...

Страница 16: ...ion can take a while to return successfully upwards of 30 seconds if the module is just getting warmed up so be patient If you ever need to turn GPRS off use the gprs close function This function has...

Страница 17: ...connect to SparkFu n else if connectStatus 2 Serial println Received an error trying to connect Sending and Receiving As with other stream classes print write available and read functions are defined...

Страница 18: ...ve voice calls If you re using a passive microphone and speaker you can simply connect them to the differential pins on the audio port Connect the microphone pins to MIC and MIC and speaker wires to S...

Страница 19: ...G An outgoing call is in the process of dialing This status precedes ringing CALL_DIALED_RINGING An outgoing call has been dialed and is ringing on the other end CALL_INCOMING A call is coming in If a...

Страница 20: ...t while phoneStatus CALL_ACTIVE phoneStatus CALL_ IDLE if callStatus CALL_ACTIVE Serial println Other end picked up Again you can use phone hangUp to end the call unless the other party does so first...

Страница 21: ...e character at a time and don t abuse the strem Memory Limitations The MG2639 library can really test the limits of the Arduino s memory You ll notice that in most of these examples we put large const...

Страница 22: ...ar Shield should serve as a solid launching point Serial Graphic LCD Hookup Learn how to use the Serial Graphic LCD Graphic LCD Hookup Guide How to add some flashy graphics to your project with a 84x4...

Отзывы: