Glucose Service

Glucose Service module. More...

Data Structures
struct	sfloat_t
	SFLOAT format (IEEE-11073 16-bit FLOAT, meaning 4 bits for exponent (base 10) and 12 bits mantissa) More...
struct	ble_gls_evt_t
	Glucose Service event. More...
struct	ble_gls_meas_t
	Glucose Measurement structure. This contains glucose measurement value. More...
struct	ble_gls_meas_context_t
	Glucose measurement context structure. More...
struct	ble_gls_rec_t
	Glucose measurement record. More...
struct	ble_gls_init_t
	Glucose Service init structure. This contains all options and data needed for initialization of the service. More...
struct	ble_gls_s
	Glucose Service structure. This contains various status information for the service. More...

Macros
#define	BLE_GLS_FEATURE_LOW_BATT   0x0001
	Glucose feature. More...
#define	BLE_GLS_FEATURE_MALFUNC   0x0002
#define	BLE_GLS_FEATURE_SAMPLE_SIZE   0x0004
#define	BLE_GLS_FEATURE_INSERT_ERR   0x0008
#define	BLE_GLS_FEATURE_TYPE_ERR   0x0010
#define	BLE_GLS_FEATURE_RES_HIGH_LOW   0x0020
#define	BLE_GLS_FEATURE_TEMP_HIGH_LOW   0x0040
#define	BLE_GLS_FEATURE_READ_INT   0x0080
#define	BLE_GLS_FEATURE_GENERAL_FAULT   0x0100
#define	BLE_GLS_FEATURE_TIME_FAULT   0x0200
#define	BLE_GLS_FEATURE_MULTI_BOND   0x0400
#define	BLE_GLS_MEAS_FLAG_TIME_OFFSET   0x01
	Glucose measurement flags. More...
#define	BLE_GLS_MEAS_FLAG_CONC_TYPE_LOC   0x02
#define	BLE_GLS_MEAS_FLAG_UNITS_KG_L   0x00
#define	BLE_GLS_MEAS_FLAG_UNITS_MOL_L   0x04
#define	BLE_GLS_MEAS_FLAG_SENSOR_STATUS   0x08
#define	BLE_GLS_MEAS_FLAG_CONTEXT_INFO   0x10
#define	BLE_GLS_MEAS_TYPE_CAP_BLOOD   1
	Glucose measurement type. More...
#define	BLE_GLS_MEAS_TYPE_CAP_PLASMA   2
#define	BLE_GLS_MEAS_TYPE_VEN_BLOOD   3
#define	BLE_GLS_MEAS_TYPE_VEN_PLASMA   4
#define	BLE_GLS_MEAS_TYPE_ART_BLOOD   5
#define	BLE_GLS_MEAS_TYPE_ART_PLASMA   6
#define	BLE_GLS_MEAS_TYPE_UNDET_BLOOD   7
#define	BLE_GLS_MEAS_TYPE_UNDET_PLASMA   8
#define	BLE_GLS_MEAS_TYPE_FLUID   9
#define	BLE_GLS_MEAS_TYPE_CONTROL   10
#define	BLE_GLS_MEAS_LOC_FINGER   1
	Glucose measurement location. More...
#define	BLE_GLS_MEAS_LOC_AST   2
#define	BLE_GLS_MEAS_LOC_EAR   3
#define	BLE_GLS_MEAS_LOC_CONTROL   4
#define	BLE_GLS_MEAS_LOC_NOT_AVAIL   15
#define	BLE_GLS_MEAS_STATUS_BATT_LOW   0x0001
	Glucose sensor status annunciation. More...
#define	BLE_GLS_MEAS_STATUS_SENSOR_FAULT   0x0002
#define	BLE_GLS_MEAS_STATUS_SAMPLE_SIZE   0x0004
#define	BLE_GLS_MEAS_STATUS_STRIP_INSERT   0x0008
#define	BLE_GLS_MEAS_STATUS_STRIP_TYPE   0x0010
#define	BLE_GLS_MEAS_STATUS_RESULT_HIGH   0x0020
#define	BLE_GLS_MEAS_STATUS_RESULT_LOW   0x0040
#define	BLE_GLS_MEAS_STATUS_TEMP_HIGH   0x0080
#define	BLE_GLS_MEAS_STATUS_TEMP_LOW   0x0100
#define	BLE_GLS_MEAS_STATUS_STRIP_PULL   0x0200
#define	BLE_GLS_MEAS_STATUS_GENERAL_FAULT   0x0400
#define	BLE_GLS_MEAS_STATUS_TIME_FAULT   0x0800
#define	BLE_GLS_CONTEXT_FLAG_CARB   0x01
	Glucose measurement context flags. More...
#define	BLE_GLS_CONTEXT_FLAG_MEAL   0x02
#define	BLE_GLS_CONTEXT_FLAG_TESTER   0x04
#define	BLE_GLS_CONTEXT_FLAG_EXERCISE   0x08
#define	BLE_GLS_CONTEXT_FLAG_MED   0x10
#define	BLE_GLS_CONTEXT_FLAG_MED_KG   0x00
#define	BLE_GLS_CONTEXT_FLAG_MED_L   0x20
#define	BLE_GLS_CONTEXT_FLAG_HBA1C   0x40
#define	BLE_GLS_CONTEXT_FLAG_EXT   0x80
#define	BLE_GLS_CONTEXT_CARB_BREAKFAST   1
	Glucose measurement context carbohydrate ID. More...
#define	BLE_GLS_CONTEXT_CARB_LUNCH   2
#define	BLE_GLS_CONTEXT_CARB_DINNER   3
#define	BLE_GLS_CONTEXT_CARB_SNACK   4
#define	BLE_GLS_CONTEXT_CARB_DRINK   5
#define	BLE_GLS_CONTEXT_CARB_SUPPER   6
#define	BLE_GLS_CONTEXT_CARB_BRUNCH   7
#define	BLE_GLS_CONTEXT_MEAL_PREPRANDIAL   1
	Glucose measurement context meal. More...
#define	BLE_GLS_CONTEXT_MEAL_POSTPRANDIAL   2
#define	BLE_GLS_CONTEXT_MEAL_FASTING   3
#define	BLE_GLS_CONTEXT_MEAL_CASUAL   4
#define	BLE_GLS_CONTEXT_MEAL_BEDTIME   5
#define	BLE_GLS_CONTEXT_TESTER_SELF   1
	Glucose measurement context tester. More...
#define	BLE_GLS_CONTEXT_TESTER_PRO   2
#define	BLE_GLS_CONTEXT_TESTER_LAB   3
#define	BLE_GLS_CONTEXT_TESTER_NOT_AVAIL   15
#define	BLE_GLS_CONTEXT_HEALTH_MINOR   1
	Glucose measurement context health. More...
#define	BLE_GLS_CONTEXT_HEALTH_MAJOR   2
#define	BLE_GLS_CONTEXT_HEALTH_MENSES   3
#define	BLE_GLS_CONTEXT_HEALTH_STRESS   4
#define	BLE_GLS_CONTEXT_HEALTH_NONE   5
#define	BLE_GLS_CONTEXT_HEALTH_NOT_AVAIL   15
#define	BLE_GLS_CONTEXT_MED_RAPID   1
	Glucose measurement context medication ID. More...
#define	BLE_GLS_CONTEXT_MED_SHORT   2
#define	BLE_GLS_CONTEXT_MED_INTERMED   3
#define	BLE_GLS_CONTEXT_MED_LONG   4
#define	BLE_GLS_CONTEXT_MED_PREMIX   5

Typedefs
typedef struct ble_gls_s	ble_gls_t
	Glucose Service structure. This contains various status information for the service.
typedef void(*	ble_gls_evt_handler_t )(ble_gls_t *p_gls, ble_gls_evt_t *p_evt)
	Glucose Service event handler type.

Enumerations
enum	ble_gls_evt_type_t { BLE_GLS_EVT_NOTIFICATION_ENABLED, BLE_GLS_EVT_NOTIFICATION_DISABLED }
	Glucose Service event type. More...

Functions
uint32_t	ble_gls_init (ble_gls_t *p_gls, const ble_gls_init_t *p_gls_init)
	Function for initializing the Glucose Service. More...
void	ble_gls_on_ble_evt (ble_gls_t *p_gls, ble_evt_t *p_ble_evt)
	Function for handling the Application's BLE Stack events. More...
uint32_t	ble_gls_glucose_new_meas (ble_gls_t *p_gls, ble_gls_rec_t *p_rec)
	Function for reporting a new glucose measurement to the glucose service module. More...

Detailed Description

Glucose Service module.

This module implements the Glucose Service.

Note

The application must propagate BLE stack events to the Glucose Service module by calling ble_gls_on_ble_evt() from the from the ble_stack_handler callback.

Attention! To maintain compliance with Nordic Semiconductor ASA Bluetooth profile qualification listings, this section of source code must not be modified.

Macro Definition Documentation

#define BLE_GLS_CONTEXT_CARB_BREAKFAST   1

Glucose measurement context carbohydrate ID.

Breakfast

#define BLE_GLS_CONTEXT_CARB_BRUNCH   7

Brunch

#define BLE_GLS_CONTEXT_CARB_DINNER   3

Dinner

#define BLE_GLS_CONTEXT_CARB_DRINK   5

Drink

#define BLE_GLS_CONTEXT_CARB_LUNCH   2

Lunch

#define BLE_GLS_CONTEXT_CARB_SNACK   4

Snack

#define BLE_GLS_CONTEXT_CARB_SUPPER   6

Supper

#define BLE_GLS_CONTEXT_FLAG_CARB   0x01

Glucose measurement context flags.

Carbohydrate id and carbohydrate present

#define BLE_GLS_CONTEXT_FLAG_EXERCISE   0x08

Exercise duration and exercise intensity present

#define BLE_GLS_CONTEXT_FLAG_EXT   0x80

Extended flags present

#define BLE_GLS_CONTEXT_FLAG_HBA1C   0x40

Hba1c present

#define BLE_GLS_CONTEXT_FLAG_MEAL   0x02

Meal present

#define BLE_GLS_CONTEXT_FLAG_MED   0x10

Medication ID and medication present

#define BLE_GLS_CONTEXT_FLAG_MED_KG   0x00

Medication value units, kilograms

#define BLE_GLS_CONTEXT_FLAG_MED_L   0x20

Medication value units, liters

#define BLE_GLS_CONTEXT_FLAG_TESTER   0x04

Tester-health present

#define BLE_GLS_CONTEXT_HEALTH_MAJOR   2

Major health issues

#define BLE_GLS_CONTEXT_HEALTH_MENSES   3

During menses

#define BLE_GLS_CONTEXT_HEALTH_MINOR   1

Glucose measurement context health.

Minor health issues

#define BLE_GLS_CONTEXT_HEALTH_NONE   5

No health issues

#define BLE_GLS_CONTEXT_HEALTH_NOT_AVAIL   15

Health value not available

#define BLE_GLS_CONTEXT_HEALTH_STRESS   4

Under stress

#define BLE_GLS_CONTEXT_MEAL_BEDTIME   5

Bedtime

#define BLE_GLS_CONTEXT_MEAL_CASUAL   4

Casual (snacks, drinks, etc.)

#define BLE_GLS_CONTEXT_MEAL_FASTING   3

Fasting

#define BLE_GLS_CONTEXT_MEAL_POSTPRANDIAL   2

Postprandial (after meal)

#define BLE_GLS_CONTEXT_MEAL_PREPRANDIAL   1

Glucose measurement context meal.

Preprandial (before meal)

#define BLE_GLS_CONTEXT_MED_INTERMED   3

Intermediate acting insulin

#define BLE_GLS_CONTEXT_MED_LONG   4

Long acting insulin

#define BLE_GLS_CONTEXT_MED_PREMIX   5

Pre-mixed insulin

#define BLE_GLS_CONTEXT_MED_RAPID   1

Glucose measurement context medication ID.

Rapid acting insulin

#define BLE_GLS_CONTEXT_MED_SHORT   2

Short acting insulin

#define BLE_GLS_CONTEXT_TESTER_LAB   3

Lab test

#define BLE_GLS_CONTEXT_TESTER_NOT_AVAIL   15

Tester value not available

#define BLE_GLS_CONTEXT_TESTER_PRO   2

Health care professional

#define BLE_GLS_CONTEXT_TESTER_SELF   1

Glucose measurement context tester.

Self

#define BLE_GLS_FEATURE_GENERAL_FAULT   0x0100

General Device Fault Supported

#define BLE_GLS_FEATURE_INSERT_ERR   0x0008

Sensor Strip Insertion Error Detection Supported

#define BLE_GLS_FEATURE_LOW_BATT   0x0001

Glucose feature.

Low Battery Detection During Measurement Supported

#define BLE_GLS_FEATURE_MALFUNC   0x0002

Sensor Malfunction Detection Supported

#define BLE_GLS_FEATURE_MULTI_BOND   0x0400

Multiple Bond Supported

#define BLE_GLS_FEATURE_READ_INT   0x0080

Sensor Read Interrupt Detection Supported

#define BLE_GLS_FEATURE_RES_HIGH_LOW   0x0020

Sensor Result High-Low Detection Supported

#define BLE_GLS_FEATURE_SAMPLE_SIZE   0x0004

Sensor Sample Size Supported

#define BLE_GLS_FEATURE_TEMP_HIGH_LOW   0x0040

Sensor Temperature High-Low Detection Supported

#define BLE_GLS_FEATURE_TIME_FAULT   0x0200

Time Fault Supported

#define BLE_GLS_FEATURE_TYPE_ERR   0x0010

Sensor Strip Type Error Detection Supported

#define BLE_GLS_MEAS_FLAG_CONC_TYPE_LOC   0x02

Glucose Concentration, Type, and Sample Location Present

#define BLE_GLS_MEAS_FLAG_CONTEXT_INFO   0x10

Context Information Follows

#define BLE_GLS_MEAS_FLAG_SENSOR_STATUS   0x08

Sensor Status Annunciation Present

#define BLE_GLS_MEAS_FLAG_TIME_OFFSET   0x01

Glucose measurement flags.

Time Offset Present

#define BLE_GLS_MEAS_FLAG_UNITS_KG_L   0x00

Glucose Concentration Units kg/L

#define BLE_GLS_MEAS_FLAG_UNITS_MOL_L   0x04

Glucose Concentration Units mol/L

#define BLE_GLS_MEAS_LOC_AST   2

Alternate Site Test (AST)

#define BLE_GLS_MEAS_LOC_CONTROL   4

Control solution

#define BLE_GLS_MEAS_LOC_EAR   3

Earlobe

#define BLE_GLS_MEAS_LOC_FINGER   1

Glucose measurement location.

Finger

#define BLE_GLS_MEAS_LOC_NOT_AVAIL   15

Sample Location value not available

#define BLE_GLS_MEAS_STATUS_BATT_LOW   0x0001

Glucose sensor status annunciation.

Device battery low at time of measurement

#define BLE_GLS_MEAS_STATUS_GENERAL_FAULT   0x0400

General device fault has occurred in the sensor

#define BLE_GLS_MEAS_STATUS_RESULT_HIGH   0x0020

Sensor result higher than the device can process

#define BLE_GLS_MEAS_STATUS_RESULT_LOW   0x0040

Sensor result lower than the device can process

#define BLE_GLS_MEAS_STATUS_SAMPLE_SIZE   0x0004

Sample size for blood or control solution insufficient at time of measurement

#define BLE_GLS_MEAS_STATUS_SENSOR_FAULT   0x0002

Sensor malfunction or faulting at time of measurement

#define BLE_GLS_MEAS_STATUS_STRIP_INSERT   0x0008

Strip insertion error

#define BLE_GLS_MEAS_STATUS_STRIP_PULL   0x0200

Sensor read interrupted because strip was pulled too soon at time of measurement

#define BLE_GLS_MEAS_STATUS_STRIP_TYPE   0x0010

Strip type incorrect for device

#define BLE_GLS_MEAS_STATUS_TEMP_HIGH   0x0080

Sensor temperature too high for valid test/result at time of measurement

#define BLE_GLS_MEAS_STATUS_TEMP_LOW   0x0100

Sensor temperature too low for valid test/result at time of measurement

#define BLE_GLS_MEAS_STATUS_TIME_FAULT   0x0800

Time fault has occurred in the sensor and time may be inaccurate

#define BLE_GLS_MEAS_TYPE_ART_BLOOD   5

Arterial whole blood

#define BLE_GLS_MEAS_TYPE_ART_PLASMA   6

Arterial plasma

#define BLE_GLS_MEAS_TYPE_CAP_BLOOD   1

Glucose measurement type.

Capillary whole blood

#define BLE_GLS_MEAS_TYPE_CAP_PLASMA   2

Capillary plasma

#define BLE_GLS_MEAS_TYPE_CONTROL   10

Control solution

#define BLE_GLS_MEAS_TYPE_FLUID   9

Interstitial fluid (ISF)

#define BLE_GLS_MEAS_TYPE_UNDET_BLOOD   7

Undetermined whole blood

#define BLE_GLS_MEAS_TYPE_UNDET_PLASMA   8

Undetermined plasma

#define BLE_GLS_MEAS_TYPE_VEN_BLOOD   3

Venous whole blood

#define BLE_GLS_MEAS_TYPE_VEN_PLASMA   4

Venous plasma

Enumeration Type Documentation

enum ble_gls_evt_type_t

Glucose Service event type.

Enumerator
BLE_GLS_EVT_NOTIFICATION_ENABLED	Glucose value notification enabled event.
BLE_GLS_EVT_NOTIFICATION_DISABLED	Glucose value notification disabled event.

Function Documentation

uint32_t ble_gls_glucose_new_meas	(	ble_gls_t *	p_gls,
		ble_gls_rec_t *	p_rec
	)

Function for reporting a new glucose measurement to the glucose service module.

The application calls this function after having performed a new glucose measurement. The new measurement is recorded in the RACP database.

Parameters

[in]	p_gls	Glucose Service structure.
[in]	p_rec	Pointer to glucose record (measurement plus context).

Returns

NRF_SUCCESS on success, otherwise an error code.

uint32_t ble_gls_init	(	ble_gls_t *	p_gls,
		const ble_gls_init_t *	p_gls_init
	)

Function for initializing the Glucose Service.

This call allows the application to initialize the Glucose Service.

Parameters

[out]	p_gls	Glucose Service structure. This structure will have to be supplied by the application. It will be initialized by this function, and will later be used to identify this particular service instance.
[in]	p_gls_init	Information needed to initialize the service.

Returns

NRF_SUCCESS on successful initialization of service, otherwise an error code.

void ble_gls_on_ble_evt	(	ble_gls_t *	p_gls,
		ble_evt_t *	p_ble_evt
	)

Function for handling the Application's BLE Stack events.

Handles all events from the BLE stack of interest to the Glucose Service.

Parameters

[in]	p_gls	Glucose Service structure.
[in]	p_ble_evt	Event received from the BLE stack.