Data structure to make a linked list of data points to send it out in one transaction. More...

#include <connector_api_data_point.h>

Data Fields
struct {
enum connector_data_point_t:: { ... } type
	data format type
union {
union {
int32_t int_value
	32-bit two's complement integer
int64_t long_value
	64-bit two's complement integer
char * string_value
	a null-terminated utf-8 encoding string
float float_value
	32-bit IEEE754 floating point
double double_value
	64-bit IEEE754 floating point
} native
	to represent the data value in their native form
char * text
	carries data in ascii format, a null-terminated string
} element
	each data element
}	data
	data in each data point
struct {
enum connector_data_point_t:: { ... } source
	Time value format.
union {
connector_time_epoch_fractional_t since_epoch_fractional
	Time since the Epoch time in seconds and milliseconds.
connector_time_epoch_whole_t since_epoch_whole
	Time since the Epoch time in milliseconds.
char * iso8601_string
	A null-terminated local time in ISO 8601 format.
} value
	Time value data structure.
}	time
	Time at the data point is captured.
struct {
enum connector_data_point_t:: { ... } type
	location format type
union {
struct {
float latitude
	latitude in degree
float longitude
	longitude in degree
float elevation
	elevation in meters
} native
	location in native format
struct {
char * latitude
	latitude in degree (null-terminated string)
char * longitude
	longitude in degree (null-terminated string)
char * elevation
	elevation in meters (null-terminated string)
} text
	location in text format
} value
	location value
}	location
	location where the data point is captured
struct {
enum connector_data_point_t:: { ... } type
	quality format type
int value
	data quality value
}	quality
	user specified data point quality
char *	description
	null terminated description string (optional field, set to NULL if not used)
struct connector_data_point_t *	next
	Points to next data point, set to NULL if this is the last one.

Detailed Description

Data structure to make a linked list of data points to send it out in one transaction.

All the data points in a list must belong to single stream.

See also:: connector_request_data_point_single_t; connector_data_point_type_t

Definition at line 115 of file connector_api_data_point.h.

Field Documentation

struct { ... } data

data in each data point

char* description

null terminated description string (optional field, set to NULL if not used)

Definition at line 231 of file connector_api_data_point.h.

double double_value

64-bit IEEE754 floating point

Definition at line 136 of file connector_api_data_point.h.

union { ... } element

each data element

float elevation

elevation in meters

Definition at line 205 of file connector_api_data_point.h.

char* elevation

elevation in meters (null-terminated string)

Definition at line 213 of file connector_api_data_point.h.

float float_value

32-bit IEEE754 floating point

Definition at line 135 of file connector_api_data_point.h.

int32_t int_value

32-bit two's complement integer

Definition at line 129 of file connector_api_data_point.h.

char* iso8601_string

A null-terminated local time in ISO 8601 format.

Supported format is YYYY-MM-DDThh:mm:ss[.mmm]TZD (eg 2012-03-29T10:05:45-06:00) where:

YYYY = four-digit year.
MM = two-digit month (eg 03=March).
DD = two-digit day of the month (01 through 31).
T = a set character indicating the start of the time element.
hh = two digits of an hour (00 through 23, AM/PM not included).
mm = two digits of a minute (00 through 59).
ss = two digits of a second (00 through 59).
mmmm (optional) milliseconds (0 through 999).
TZD = time zone designator (Z or +hh:mm or -hh:mm), the + or - values indicate how far ahead or behind a time zone is from the UTC zone. US time zone values are as follows:
- EDT = -4:00
- EST/CDT = -5:00
- CST/MDT = -6:00
- MST/PDT = -7:00
- PST = -8:00
Some examples of valid representations:
- 2012-01-12T06:16:55.235Z
- 2012-12-22T03:16:44Z
- 2012-12-21T19:16:44-08:00