Difference between revisions of "EIS Service SDK"
Eric.liang (talk | contribs) |
Eric.liang (talk | contribs) |
||
| Line 73: | Line 73: | ||
*'''History''': 06/26/2017 Modified | *'''History''': 06/26/2017 Modified | ||
| + | |||
| + | |||
== Information == | == Information == | ||
| Line 89: | Line 91: | ||
*'''History''': 06/26/2017 Modified | *'''History''': 06/26/2017 Modified | ||
| + | |||
| + | |||
| Line 105: | Line 109: | ||
*'''History''': 06/26/2017 Modified | *'''History''': 06/26/2017 Modified | ||
| + | |||
| + | |||
| Line 125: | Line 131: | ||
== Function for Service == | == Function for Service == | ||
| + | <pre>SV_CODE SV_GetCapability( const char *ServiceName, char *outBuffer, int bufSize )</pre> | ||
| + | |||
| + | *'''Description''': Query All of Service Name | ||
| + | *'''Parameter''': | ||
| + | |||
| + | - char * outBuf (out): point of result buffer size ( recomd: 1024 bytes ) => { "Service":{"e":[{"n":"HDD_PMQ},{"n":"Modebus"}] } | ||
| + | |||
| + | - int bufsize (in): max size of buffer | ||
| + | |||
| + | *'''Return value:''' | ||
| + | |||
| + | SV_CODE - SV_OK : Successful<br/> - SV_ER_FAILED: Failed to call | ||
| + | |||
| + | *'''History''': 06/26/2017 Modified | ||
| + | |||
| + | |||
| + | <pre>SV_CODE SV_AutoReportStart( const char *ServiceName , char *inData, int inDataLen );</pre> | ||
| + | |||
| + | *'''Description''': Query All of Service Name | ||
| + | *'''Parameter''': | ||
| + | |||
| + | - char * outBuf (out): point of result buffer size ( recomd: 1024 bytes ) => { "Service":{"e":[{"n":"HDD_PMQ},{"n":"Modebus"}] } | ||
| + | |||
| + | - int bufsize (in): max size of buffer | ||
| + | |||
| + | *'''Return value:''' | ||
| + | |||
| + | SV_CODE - SV_OK : Successful<br/> - SV_ER_FAILED: Failed to call | ||
| + | |||
| + | *'''History''': 06/26/2017 Modified | ||
| + | |||
| + | |||
| + | <pre>SV_CODE SV_AutoReportStop( const char *ServiceName, char *inData, int inDataLen );</pre> | ||
| + | |||
| + | *'''Description''': Query All of Service Name | ||
| + | *'''Parameter''': | ||
| + | |||
| + | - char * outBuf (out): point of result buffer size ( recomd: 1024 bytes ) => { "Service":{"e":[{"n":"HDD_PMQ},{"n":"Modebus"}] } | ||
| + | |||
| + | - int bufsize (in): max size of buffer | ||
| + | |||
| + | *'''Return value:''' | ||
| + | |||
| + | SV_CODE - SV_OK : Successful<br/> - SV_ER_FAILED: Failed to call | ||
| + | |||
| + | *'''History''': 06/26/2017 Modified | ||
| + | |||
| − | SV_CODE | + | <pre>SV_CODE SV_Action( const char *ServiceName , char *szAction, void *pUserData );</pre> |
| − | + | *'''Description''': Query All of Service Name | |
| + | *'''Parameter''': | ||
| − | + | - char * outBuf (out): point of result buffer size ( recomd: 1024 bytes ) => { "Service":{"e":[{"n":"HDD_PMQ},{"n":"Modebus"}] } | |
| − | + | - int bufsize (in): max size of buffer | |
| + | |||
| + | *'''Return value:''' | ||
| + | |||
| + | SV_CODE - SV_OK : Successful<br/> - SV_ER_FAILED: Failed to call | ||
| + | |||
| + | *'''History''': 06/26/2017 Modified | ||
[[Category:Editor]] | [[Category:Editor]] | ||
Revision as of 04:51, 3 July 2017
Contents
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
SV_CODE SV_Initialize( Service_Cb fn, void *pInUserData )
- 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_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
Information
SV_CODE SV_GetVersion(char *outVersion, int bufSize );
- 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_STATUS 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_CODE SV_Query_Service( char *outBuf, int bufSize );
- Description: Query All of Service Name
- Parameter:
- char * outBuf (out): point of result buffer size ( recomd: 1024 bytes ) => { "Service":{"e":[{"n":"HDD_PMQ},{"n":"Modebus"}] }
- 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
Function for Service
SV_CODE SV_GetCapability( const char *ServiceName, char *outBuffer, int bufSize )
- Description: Query All of Service Name
- Parameter:
- char * outBuf (out): point of result buffer size ( recomd: 1024 bytes ) => { "Service":{"e":[{"n":"HDD_PMQ},{"n":"Modebus"}] }
- 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_AutoReportStart( const char *ServiceName , char *inData, int inDataLen );
- Description: Query All of Service Name
- Parameter:
- char * outBuf (out): point of result buffer size ( recomd: 1024 bytes ) => { "Service":{"e":[{"n":"HDD_PMQ},{"n":"Modebus"}] }
- 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_AutoReportStop( const char *ServiceName, char *inData, int inDataLen );
- Description: Query All of Service Name
- Parameter:
- char * outBuf (out): point of result buffer size ( recomd: 1024 bytes ) => { "Service":{"e":[{"n":"HDD_PMQ},{"n":"Modebus"}] }
- 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_Action( const char *ServiceName , char *szAction, void *pUserData );
- Description: Query All of Service Name
- Parameter:
- char * outBuf (out): point of result buffer size ( recomd: 1024 bytes ) => { "Service":{"e":[{"n":"HDD_PMQ},{"n":"Modebus"}] }
- 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