iphonecontroller.vb

vc实现串口收发短信

'//////////////////////////////////////////////////////////////////////////
'// Use at your own risk                                                 //
'// www.hesicong.net                                                     //
'// Copyright Dreamworld. You can use this program freely but no in      //
'// commerial use without my permission.                                 //
'// Authoer: hesicong                                                    //
'// Date: 2007-2-25                                                      //
'//////////////////////////////////////////////////////////////////////////

Namespace Dreamworld.Mobile.PhoneControllerSDK
    Public Interface IPhoneController
        ''' <summary>
        ''' Models that Plug-in supported
        ''' </summary>
        ''' <value></value>
        ''' <remarks></remarks>
        ReadOnly Property SupportedModel() As String()

        ''' <summary>
        ''' Connect a phone using port and at baudrate speed
        ''' </summary>
        ''' <param name="Port">Port name like "COM1:"</param>
        ''' <param name="baudrate">default 19200</param>
        ''' <returns>True if success, false if failed</returns>
        ''' <remarks></remarks>
        Function Connect(ByVal Port As String, Optional ByVal baudrate As Integer = 19200, Optional ByVal timeOut As Integer = 20000) As Boolean

        ''' <summary>
        ''' Disconnect phone
        ''' </summary>
        ''' <returns></returns>
        ''' <remarks></remarks>
        Function Disconnect() As Boolean

        ''' <summary>
        ''' Set phone to standard
        ''' </summary>
        ''' <returns>True if success, false if failed</returns>
        ''' <remarks></remarks>
        Function SetStandard() As Boolean

        ''' <summary>
        ''' Get the power of battery
        ''' </summary>
        ''' <returns>percent of your battery charge</returns>
        ''' <remarks></remarks>
        Function GetBatteryCharge() As Integer

        ''' <summary>
        ''' Get the IMSI of phone
        ''' </summary>
        ''' <returns>IMSI</returns>
        ''' <remarks></remarks>
        Function GetIMSI() As String

        ''' <summary>
        ''' Get the manufacture of phone
        ''' </summary>
        ''' <returns>manufacture of phone</returns>
        ''' <remarks></remarks>
        Function GetManufactureID() As String

        ''' <summary>
        ''' Get the model of phone
        ''' </summary>
        ''' <returns>model of phone</returns>
        ''' <remarks></remarks>
        Function GetModelID() As String

        ''' <summary>
        ''' Get the number of your phone. Own number is a number set by yourself.
        ''' </summary>
        ''' <returns>own number</returns>
        ''' <remarks></remarks>
        Function GetOwnNumber() As String

        ''' <summary>
        ''' Get quality of service.
        ''' </summary>
        ''' <returns>Quality of service. Unit -mdB, smaller is better quality.</returns>
        ''' <remarks></remarks>
        Function GetQualityOfService() As Integer

        ''' <summary>
        ''' Get last error code or description
        ''' </summary>
        ''' <returns></returns>
        ''' <remarks></remarks>
        Function GetLastError() As String

        ''' <summary>
        ''' Set character set of phone
        ''' </summary>
        ''' <param name="characterSet">Character set you want to use</param>
        ''' <returns></returns>
        ''' <remarks></remarks>
        Function SetCharacterSet(ByVal characterSet As CharactorSet) As Boolean

        ''' <summary>
        ''' Get phone capability
        ''' </summary>
        ''' <returns></returns>
        ''' <remarks></remarks>
        Function GetCapability() As Capability
        'End Interface

        ''' <summary>
        ''' Service Center number
        ''' </summary>
        ''' <value></value>
        ''' <remarks></remarks>
        Property ServiceCenterNumber() As String

        ''' <summary>
        ''' Using AT command to get service center number
        ''' </summary>
        ''' <returns></returns>
        ''' <remarks></remarks>
        Function GetServiceCenterNumber() As String

        ''' <summary>
        ''' Read a SMS by index
        ''' </summary>
        ''' <param name="index"></param>
        ''' <returns>Nothing when no item found</returns>
        ''' <remarks></remarks>
        Function ReadSMSByIndex(ByVal index As Integer) As SMSRead

        ''' <summary>
        ''' Read SMSs by status
        ''' </summary>
        ''' <param name="status"></param>
        ''' <returns>Nothing when no item found</returns>
        ''' <remarks></remarks>
        Function ReadSMSByStatus(ByVal status As ATSMSStatus) As SMSRead()

        ''' <summary>
        ''' Del a SMS with index
        ''' </summary>
        ''' <param name="index"></param>
        ''' <returns>True if success;False if failed</returns>
        ''' <remarks></remarks>
        Function DelSMS(ByVal index As Integer) As Boolean

        ''' <summary>
        ''' Send a SMS
        ''' </summary>
        ''' <param name="toSend"></param>
        ''' <returns>Message references of SMS. If content is bigger than capacity of one SMS , it will be splited to one more SMSs.</returns>
        ''' <remarks></remarks>
        Function SendSMS(ByVal toSend As SMSSend) As Integer()

        ''' <summary>
        ''' Write a SMS to memory
        ''' </summary>
        ''' <param name="toWrite"></param>
        ''' <returns>Index of write SMS. If content is longer than capacity of one SMS, it will be splited to one more SMSs.</returns>
        ''' <remarks></remarks>
        Function WriteSMS(ByVal status As ATSMSStatus, ByVal toWrite As SMSSend) As Integer()

        ''' <summary>
        ''' Select where SMS stored
        ''' </summary>
        ''' <param name="mem1">Memory from which messages are read and deleted</param>
        ''' <param name="mem2">Messages will be written and sent to this memory storage</param>
        ''' <param name="mem3">Memory in which received messages are preferred to be stored, if routing to TE is not set (see AT+CNMI command with parameter mt=2</param>
        ''' <returns></returns>
        ''' <remarks></remarks>
        Function SelectSMSStorage(ByVal mem1 As SMSStorage, ByVal mem2 As SMSStorage, ByVal mem3 As SMSStorage) As Boolean

        ''' <summary>
        ''' Raise when a new message is arrived
        ''' </summary>
        ''' <param name="index">index of the message</param>
        ''' <param name="content">Content of the message. May be empty if index is not zero.</param>
        ''' <remarks></remarks>
        Event NewMessageArrived(ByVal index As Integer, ByVal content As String)

        ''' <summary>
        ''' Set new message arrive report. Using AT+CNMI
        ''' </summary>
        ''' <param name="enabled">True if enable;false if disable</param>
        ''' <returns></returns>
        ''' <remarks></remarks>
        Function SetNewMessageArriveReport(ByVal enabled As Boolean) As Boolean

        ''' <summary>
        ''' Select phonebook you want to used
        ''' </summary>
        ''' <param name="phonebookType"></param>
        ''' <returns>True if successed, false if failed</returns>
        ''' <remarks></remarks>
        Function SelectPhonebookType(ByVal phonebookType As PhonebookType) As Boolean

        ''' <summary>
        ''' Read an entry
        ''' </summary>
        ''' <param name="index"></param>
        ''' <returns>If nothing found, returns nothing</returns>
        ''' <remarks></remarks>
        Function ReadPhonebookEntry(ByVal index As Integer) As PhonebookEntry

        ''' <summary>
        ''' Read all entries
        ''' </summary>
        ''' <returns>If nothing found, returns nothing</returns>
        ''' <remarks></remarks>
        Function ReadAllPhonebookEntry() As PhonebookEntry()

        ''' <summary>
        ''' Add an entry to phonebook
        ''' </summary>
        ''' <returns>True if successed, false if failed</returns>
        ''' <remarks></remarks>
        Function AddPhonebookEntry(ByVal entry As PhonebookEntry) As Boolean

        ''' <summary>
        ''' Del an entry with index
        ''' </summary>
        ''' <param name="index"></param>
        ''' <returns>True if successed, false if failed</returns>
        ''' <remarks></remarks>
        Function DelPhonebookEntry(ByVal index As Integer) As Boolean

        ''' <summary>
        ''' Get current phonebook status
        ''' </summary>
        ''' <returns>Your phonebook's capacity and how capacity is used</returns>
        ''' <remarks></remarks>
        Function GetPhonebookStatus() As PhonebookStatus

        ''' <summary>
        ''' Cancel Current Action.