msLoggerNext (Function)

Top Previous Next

Request which type of record is the next to be read from the logger buffer. Subsequently read the specified record with msLoggerRead.

Record types are:

Define	Value	Description
_MS_LOGGER_NODATA	0	No more data to be read from current buffer
_MS_LOGGER_TIMESTAMP	1	Timestamp of the dataset. Represents seconds elapsed after the first sensor was turned on.
_MS_LOGGER_ACCDATA	2	Accelerometer data set.
_MS_LOGGER_GYRDATA	3	Gyroscope data set.
_MS_LOGGER_MAGDATA	4	Magnetometer data set.

The logger will place sensor records in the following order:

Gyroscope, Accelerometer, Magnetometer, Timestamp.

Thus a timestamp always belongs to the preceding sensor measurements.

Input:

Logger : SYSHANDLE

A user provided handle to uniquely identify the logger. See SYSHANDLE page. This field is mandatory.

Returns: INT

>0	- Record ID.
0	- No new data.
-1	- Interface is not open. Call msOpen first.
-2	- Generic error.
-5	- The logger is not present.
-9	- The specified logger is running. Call msLoggerStop first.

Declaration

FUNCTION msLoggerNext : INT;
VAR_INPUT
Logger : MANDATORY SYSHANDLE;
END_VAR;

Example:

// See example under msLoggerRead