Difference between revisions of "EIS Service SDK"

From ESS-WIKI
Jump to: navigation, search
Line 48: Line 48:
  
 
== Initial & Uninitial  ==
 
== Initial & Uninitial  ==
<pre>'''/*&nbsp;
+
<pre>/*
&nbsp;*=============================================================================
+
*=============================================================================
&nbsp;* &nbsp;Function name: SV_Initialize
+
*Function name: SV_Initialize
&nbsp;* &nbsp;Description: Initialize the Service SDK
+
* &nbsp;Description: Initialize the Service SDK
&nbsp;* &nbsp;Parameter:
+
* &nbsp;Parameter:
 
&nbsp;* &nbsp; &nbsp; &nbsp;- Service_Cb &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; fn: &nbsp;point of callback function
 
&nbsp;* &nbsp; &nbsp; &nbsp;- Service_Cb &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; fn: &nbsp;point of callback function
&nbsp;* &nbsp; &nbsp; &nbsp; - void* &nbsp; pInUserData: &nbsp;user data will pass when callback
+
* &nbsp; &nbsp; &nbsp; - void* &nbsp; pInUserData: &nbsp;user data will pass when callback
 
&nbsp;*
 
&nbsp;*
 
&nbsp;* &nbsp;Return value:
 
&nbsp;* &nbsp;Return value:
Line 64: Line 64:
 
&nbsp;* =============================================================================
 
&nbsp;* =============================================================================
 
&nbsp;*/
 
&nbsp;*/
SV_CODE SV_Initialize( Service_Cb fn, void *pInUserData ) '''</pre>
+
'''SV_CODE SV_Initialize'''( Service_Cb fn, void *pInUserData )</pre>
  
  

Revision as of 04:05, 3 July 2017

Definition

Service Return Code

typedef enum {                                                        
    SV_ER_NOT_IMPLEMENT                = -13,   /*        Does Not Support this command        (501)        */
    SV_ER_TIMEOUT                      = -12,   /*        Request Timeout                      (408)        */
    SV_ER_SYS_BUSY                     = -11,   /*        System is busy                       (503)        */
    SV_ER_VALUE_OUT_OF_RNAGE           = -10,   /*        Value is out of range                (416)        */
    SV_ER_SYNTAX_ERROR                 =  -9,   /*        Format is correct but syntax error   (422)        */
    SV_ER_FORMAT_ERROR                 =  -8,   /*        Format error                         (415)        */
    SV_ER_REQUEST_ERROR                =  -7,   /*        Request error                        (400)        */
    SV_ER_RESOURCE_LOSE                =  -6,   /*        SenHub disconnect                    (410)        */
    SV_ER_RESOURCE_LOCKED              =  -5,   /*        Resource is in setting               (426)        */
    SV_ER_NOT_FOUND                    =  -4,   /*        Resource Not Found                   (404)        */
    SV_ER_WRITE_ONLY                   =  -3,   /*        Read Only                            (405)        */
    SV_ER_READ_ONLY                    =  -2,   /*        Write Only                           (405)        */
    SV_ER_FAILED                       =  -1,   /*        Failed                               (500)        */
    SV_OK                              =   0,   /*        Success                              (200)        */
    SV_INITILIZED                      =   1,   /*        Library had initilized                            */
} SV_CODE;

Service Status

typedef enum
{
    SV_UNINIT = 0,
    SV_INIT   = 1,
    SV_JOINED = 2,
    SV_LEAVED = 3,
}SV_STATUS;

Service Event Callback Function

typedef SV_CODE (SVCALL *Service_Cb) ( SV_EVENT e, char *ServiceName, void *inData, int dataLen, void *UserData )

Service Event Type

typedef enum
{
    SV_E_JoinServiceSystem,        // Connected to the Service System
    SV_E_LeaveServiceSystem,       // Disconnected from the Service System
    SV_E_RegisterService,          // Registed a new Service ( ex: HDD_PMQ Plugin )
    SV_E_DeregisterService,        // Deregisted a Service
    SV_E_UpdateServiceCapability,  // Update Service's Capability
    SV_E_UpdateData,               // Update Service's data value
    SV_E_ActionResult,             // Get / Set Reply
    SV_E_EventNotify,              // EventNotify
}SV_EVENT;

Functions

Initial & Uninitial 

/*
*=============================================================================
*Function name: SV_Initialize
*  Description: Initialize the Service SDK
*  Parameter:
 *      - Service_Cb             fn:  point of callback function
*       - void*   pInUserData:  user data will pass when callback
 *
 *  Return value:
 *       SV_CODE    - SV_OK                :  Successful 
 *                             - SV_ER_FAILED  :  Failed to call
 *
 *  History:
 *       Eric Liang      06/26/2017          Modified
 * =============================================================================
 */
'''SV_CODE SV_Initialize'''( Service_Cb fn, void *pInUserData )


SV_CODE SV_Uninitialize( );  

Function Information

SV_CODE SV_GetVersion(char *outVersion, int bufSize ); 

SV_STATUS SV_GetServiceStatus( );

SV_CODE SV_Query_Service( char *outBuf, int bufSize );

SV_CODE SV_GetCapability( const char *ServiceName, char *outBuffer,  int bufSize )

SV_CODE SV_AutoReportStart( const char *ServiceName , char *inData, int inDataLen  );

SV_CODE  SV_AutoReportStop( const char *ServiceName, char *inData, int inDataLen );

SV_CODE SV_Action( const char *ServiceName , char *szAction,  void *pUserData );