SMS Utilities API
Article Metadata
Code Example
Source file: Media:SilentSMS.zip
Article
Created: ltomuta
(16 Jun 2007)
Last edited: hamishwillee
(08 May 2013)
SMS Utilities API provides methods for sending the sms using sockets.
Note:
- This API is not part of the public SDK. It can be found in the SDK API Plug-in.
- NB! If another application has already opened the socket then this method fails!
Use cases
Sending and receiving SMS silently (that is without the message tone and without any new message notification) can be achieved by sending SMS through sockets and also by listening for incoming SMS with the help of sockets.
Example code
SMSSendL() method is responsible for sending the sms using sockets.
void SMSSendL()
{
//iFileServer is RFs object
iFileSession.Connect();
//iSockerServer is RSocketServ object
iSocketServer.Connect();
//iSocket is RSocket Object
TInt err1 = iSocket.Open(iSocketServer,KSMSAddrFamily,
KSockDatagram, KSMSDatagramProtocol);
if(!err1)
{
//SMS address for a socket.
TSmsAddr smsaddr;
//Only for sending, no reception.
smsaddr.SetSmsAddrFamily(ESmsAddrSendOnly);
TInt BindErr1= iSocket.Bind(smsaddr);
if(BindErr1 == KErrNone)
{
CSmsBuffer *buffer = CSmsBuffer::NewL();
CleanupStack::PushL(buffer);
//Inserting msg. to be sent to a buffer
buffer->InsertL(0, _L("MyMessage"));
//Stream that writes a CSmsMessage object across a socket
RSmsSocketWriteStream writestream(iSocket);
//ESmsSubmit-SMS-SUBMIT, sent from Mobile Station to Service Center
iSmsMessage = CSmsMessage::NewL(iFileSession,CSmsPDU::ESmsSubmit,
buffer);
//Sets the message Service Center Address via which msg.
//will be sent to receipent
iSmsMessage->SmsPDU().SetServiceCenterAddressL(_L("+01234567890"));
//Sets destination number
iSmsMessage->SmsPDU().SetToFromAddressL(_L("+09876543210"));
//Externalises message to a stream which is used for
//writing data into the socket
iSmsMessage->ExternalizeL(writestream);
//Ensures that any buffered data is written to the stream.
writestream.CommitL();
TPckgBuf<TInt> sendBuffer;
sendBuffer=KSockSelectWrite;
//Applies an asynchronous I/O control operation on a socket.
iSocket.Ioctl(KIoctlSendSmsMessage,iStatus,&sendBuffer,KSolSmsProv);
iRead=EFalse;
SetActive();
CleanupStack::PopAndDestroy(buffer);
}
}
}
SMSRead() is responsible for Reading incoming SMS silently.Actually it checks whether the incoming message is of a specific patern(In this case the message should start with "##")
void SMSRead()
{
TBuf8<2> matchTag;
_LIT8(KTag1,"##");
matchTag.Copy(KTag);
iReadServer.Connect();
//Opens a socket by creating a new subsession to the socket server.
TInt err = iReadSocket.Open(iReadServer,KSMSAddrFamily,
KSockDatagram, KSMSDatagramProtocol);
if(!err)
{
TSmsAddr smsAddr;
// App. listens for sms msgs with some special tag in it.
smsAddr.SetSmsAddrFamily(ESmsAddrMatchText);
smsAddr.SetTextMatch(KTag1);
TInt bindErr = iReadSocket.Bind(smsAddr);
if(!bindErr)
{
sbuf() = KSockSelectRead;
//Applies an asynchronous I/O control operation on a socket.
iReadSocket.Ioctl( KIOctlSelect,iStatus, &sbuf, KSOLSocket);
iRead=ETrue;
SetActive();
}
}
}
void RunL()
{
if(iRead)
{
iFileSession.Connect()
TBuf<2> matchTag;
matchTag.Copy(KTag);
CSmsBuffer *buffer=CSmsBuffer::NewL();
CleanupStack::PushL(buffer);
//Stream that reads a CSmsMessage object across a socket.
RSmsSocketReadStream readStream(socket1);
//Allocates and creates a CSmsMessage
//ESmsDeliver-SMS-DELIVER, sent from service center to Station.
CSmsMessage message = CSmsMessage::NewL
TheFs1,CSmsPDU::ESmsDeliver,buffer);
CleanupStack::PushL(message);
//Internalises data from stream to CSmsMessage
message->InternalizeL(readStream);
readStream.Close();
//Extracting the received message to a buffer
TBuf<255> msgContents;
message->Buffer().Extract(msgContents,0,message->Buffer().Length());
CleanupStack::PopAndDestroy(2)
//compare whether the incoming message starts with "##"
if( (buf1.Left(2)).Compare(matchTag) == 0)
{
iReadSocket.Ioctl( KIoctlReadMessageSucceeded,iStatus, &sbuf,KSolSmsProv);
//Now msgContents contains the actual message.
iRead=EFalse;
SetActive();
}
}
}
Note: sBuf is of type TPckgBuf<TUint>
Example Application
See Also
See RSendAs class for sending SMS and CMsvSession and MMsvSessionObserver::HandleSessionEventL() for receiving SMS with public APIs. This approach may play the incoming message tone.
29 Sep
2009
SMS Utilities API's are useful to sending and receiving SMS using sockets. It is particlularly very useful to send/listen SMS silently, to listen SMS on particlular port and to listen SMS based on some pattern matching. This article demonstrates the use of SMS Utilities API to send SMS and listen SMS silently with pattern matching (## here). Note that this API, SMS Utilities API, is not part of the public SDK. So you have to download it from SDK API Plug-in before using it. Furthermore, the author added a working demo project, which can be used for more detailed study of new opportunities for various kinds of experiments.
Hi,
I tried to install SilentSMS on Nokia 6120c. However, I get an error message "Certificate Error. Contact the application supplier". Anyone know why?
Furthermore, because I cannot test this app, I would like to ask whether SilentSMS can wake up the app when it received a message.
Rgds
Hans
I tried the Send code but it does not work. An error on the bind method call method is received. The error number is "KErrPermissionDenied = -46 "that is described like " An operation cannot be performed due to a potential security violation. ". Is there something obvious thing that a quite new s60 developer should know regarding permission in order to send sms through Socket ?? Thanks in advance