EIS Service SDK

From ESS-WIKI
Revision as of 03:30, 3 July 2017 by Eric.liang (talk | contribs)
Jump to: navigation, search

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:   06/26/2017 Modified
 * =============================================================================
 */

​SV_CODE SV_Initialize( Service_Cb fn, void *pInUserData )


/*
 *=============================================================================
 * Function name: SV_'''Uninitialize'''
 * Description: UnInitialize the Service SDK
 * Parameter:
 *      - NONE
 *
 * Return value:
 * SV_CODE  - SV_OK        : Successful
 *          - SV_ER_FAILED : Failed to call
 *
 * History:   06/26/2017 Modified
 * =============================================================================
 */

SV_CODE SV_Uninitialize( );  

Information

/*
 *=============================================================================
 * Function name: SV_GetVersion
 * Description: Get version of Service SDK
 * Parameter:
 *      - char * outVersion (out): point of result buffer size ( recomd: 128 bytes ) =>v1.0.1
 *      - int    bufsize     (in): max size of buffer
 *
 * Return value:
 * SV_CODE  - SV_OK        : Successful
 *          - SV_ER_FAILED : Failed to call
 *
 * History:   06/26/2017 Modified
 * =============================================================================
 */

SV_CODE SV_GetVersion(char *outVersion, int bufSize ); 

/*
 *=============================================================================
 * Function name: SV_GetServiceStatus
 * Description: Get status of Service System
 * Parameter:
 *      NONE
 *
 * Return value:
 * SERVICE_STATUS - SV_UNINIT : SDK NOT Initilize
 *                - SV_INIT   : Init Status
 *                - SV_JOINED : Joined to Service System
 *                - SV_LEAVED : Leaved from Service System
 *
 * History:   06/26/2017 Modified
 * =============================================================================
 */

SV_STATUS SV_GetServiceStatus( );

SV_CODE SV_Query_Service( char *outBuf, int bufSize );

Function for Service

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 );