User's Manual

RK-5424-5 Reference Kit User’s Guide 4-39
iBeanAPI_LPR.h
iBeanAPI_LPR.h
Functions
1. ibApi_LPR_SetClock()
ibApi_FUNC ibApi_LPR_SetClock(
ibApi_APIHANDLE api_hdl,
ibApi_GROUPID network,
ibApi_UINT32 utc_sec
);
This function sets the UTC clock for all devices. The UTC clock is used for the time
synchronization purposes. The gateway will synchronize each device's clock through time
synchronization process. The clock setting is a global attribute that applies to all devices in
the network.
Parameters:
api_hdl: (input) API handle returned from ibApi_Open().
network: (input) Group ID of the network.
utc_sec: (input) The UTC value in seconds, system clock is used if the value is zero.
Return Value:
ibApi_RESULT_SUCCESS if successful, or error code (<0) if not.
2. ibApi_LPR_GetClock()
ibApi_FUNC ibApi_LPR_GetClock(
ibApi_APIHANDLE api_hdl,
ibApi_GROUPID network,
ibApi_UINT32 * utc_sec
)
This function retrieves the UTC clock value (in seconds) used for all devices.
Note: After setting the network-wide clock by the method
ibApi_LPR_SetClock(), it is necessary to wait at least 1 second before calling this function to
allow the system to take on the new value.
Parameters:
api_hdl: (input) API handle returned from ibApi_Open().
network: (input) Group ID of the network.
utc_sec: (output) UTC value in seconds.
Return Value:
The wakeup interval in ms if successful, or error code (<0) if not.