Indoor Positioning Service

If conformance to this service is claimed, all capabilities indicated as mandatory for this service shall be supported in the specified manner (process-mandatory). This also applies for all optional and conditional capabilities for which support is indicated. All mandatory capabilities, and optional and conditional capabilities for which support is indicated, are subject to verification as part of the Bluetooth qualification program.

This service has no dependencies on other GATT-based services.

This service is compatible with any Bluetooth core specification host that includes the Generic Attribute Profile (GATT) and the broadcast mode in the Generic Access Profile (GAP).

Requirements in this section represent a minimum set of requirements for a Server. Other GATT sub-procedures may be used if supported by both Client and Server.

Additional GATT sub-procedures required beyond those required by the GATT are indicated in Table 1.1.

The service may operate over LE and BR/EDR transports. However the broadcasting of the location information will only operate in LE advertising mode.

This service defines the following Attribute Protocol Application Error code:

All characteristics used with this service shall be transmitted with the least significant octet first (i.e., little endian). The least significant octet is identified in the characteristic definitions in [1].

The service shall be either a «Primary Service» or «Secondary Service» and the service UUID set to «Indoor Positioning Service» as defined in [2].

This section describes the service behaviors, including any behaviors associated with each of the characteristics that make up the service.

The Indoor Positioning Configuration Characteristic is mandatory.

The characteristic property requirements are stated in Table 3.1.

The attribute permissions for this characteristic declaration shall include at least readable and writeable permissions. A higher layer may specify additional permission requirements but it is recommended that only authorized devices are permitted to write.

The Indoor Positioning Configuration Characteristic is a bit field. The meaning of each bit is described in Table 3.2:

The format of the characteristic is an unsigned integer of size 8 bits.

The characteristic UUID shall be set to « Indoor Positioning Configuration » as defined in [2].

The Latitude Characteristic is mandatory.

The characteristic property requirements are stated in Table 3.1.

The attribute permissions for this characteristic declaration shall include at least readable permission. A higher layer may specify additional permission requirements but it is recommended that only authorized devices are permitted to write.

Latitude is based on WGS84 [5] datum. The relation between the Latitude X in range [-90°, 90°] and the encoded (transmitted) number N is

$\mathrm{N}=\mathrm{floor} \left(\frac{\mathrm{X}}{90}{2}^{31}\right)$

where N is bounded to the range  − 2³¹ + 1 ≤ N ≤ 2³¹ − 1  . If N exceeds the bounds, the closest value within the bounds shall be used.

The floor operation shall be performed according to [4].

The value 0x80000000 in the Latitude Characteristic indicates not configured.

The format of the characteristic is a signed integer of size 32 bits encoded as signed magnitude.

The characteristic UUID shall be set to « Latitude » as defined in [2].

The Longitude Characteristic is mandatory.

The characteristic property requirements are stated in Table 3.1.

The attribute permissions for this characteristic declaration shall include at least readable permission. A higher layer may specify additional permission requirements but it is recommended that only authorized devices are permitted to write.

Longitude is based on WGS84 [5] datum. The relation between the Longitude X in range [-180°, 180°] and the encoded (transmitted) number N is

$\mathrm{N}=\mathrm{floor} \left(\frac{\mathrm{X}}{180}{2}^{31}\right)$

where N is bounded to the range   − 2³¹ + 1 ≤ N ≤ 2³¹ − 1. If N exceeds the bounds, the closest value within the bounds shall be used.

The floor operation shall be performed according to [4].

The value 0x80000000 means the Longitude characteristic is not configured.

The format of the characteristic is a signed integer of size 32 bits encoded as signed magnitude.

The characteristic UUID shall be set to « Longitude » as defined in [2].

The Local North Coordinate Characteristic is optional. If used, the Local North Coordinate shall be present together with Local East Coordinate.

The characteristic property requirements are stated in Table 3.1.

The attribute permissions for this characteristic declaration shall include at least readable permission. A higher layer may specify additional permission requirements but it is recommended that only authorized devices are permitted to write.

The Local North Coordinate is relative to the north orientation on a predefined map downloaded prior to using the Indoor Positioning Service at the given location.

The Local North Coordinate value is encoded in decimeters and has a range of -32767 decimeters to 32767 decimeters. The value 0x8000 means the Local North Coordinate information is not configured.

The format of the characteristic is a signed integer of size 16 bits.

The characteristic UUID shall be set to « Local North Coordinate » as defined in [2].

The Local East Coordinate Characteristic is optional. If used, the Local East Coordinate shall be present together with Local North Coordinate.

The characteristic property requirements are stated in Table 3.1.

The attribute permissions for this characteristic declaration shall include at least readable permission. A higher layer may specify additional permission requirements but it is recommended that only authorized devices are permitted to write.

The Local East Coordinate is relative to the east orientation of a predefined map downloaded prior to using the Indoor Positioning Service at the given location. The Local East Coordinate value is encoded decimeters and it ranges from -32767 decimeters up to 32767 decimeters.

The value 0x8000 means the Local East Coordinate information is not configured.

The format of the characteristic is a signed integer of size 16 bits.

The characteristic UUID shall be set to « Local East Coordinate » as defined in [2].

The Floor Number Characteristic is optional.

The characteristic property requirements are stated in Table 3.1.

The attribute permissions for this characteristic declaration shall include at least readable permission. A higher layer may specify additional permission requirements but it is recommended that only authorized devices are permitted to write.

The floor number, N, is encoded as X = N + 20 where X is the encoded floor number. Floor number -20 (X=0), has a special meaning not only indicating the floor -20, but also any floor below that. Floor number = 232 (X = 252) has a special meaning not only indicating the floor 232, but also any floor above that. (X = 253) meaning floor number 0 and ground floor. (X = 254) meaning floor number 1 and ground floor. X = 255 means no floor number is configured.

The format of the characteristic is an unsigned integer of size 8 bits.

The characteristic UUID shall be set to « Floor Number » as defined in [2].

The Altitude Characteristic is optional.

The characteristic property requirements are stated in Table 3.1. The attribute permissions for this characteristic declaration shall include at least readable permission. A higher layer may specify additional permission requirements but it is recommended that only authorized devices are permitted to write.

The Altitude Characteristic expresses the altitude beyond the WGS84 ellipsoid [5] of the device exposing its position.

The characteristic value (x) encodes the altitude (h) in decimeters, x = h + 1000. The valid range of h is from -1000 decimeters to 64534 decimeters. A decoded height of -1000 dm shall be interpreted as -1000 dm or below. A decoded height of 64534 dm shall be interpreted as 64534 dm or above.

The value x=0xFFFF means the altitude information is not configured.

The format of the characteristic is an unsigned integer of size 16 bits.

The characteristic UUID shall be set to « Altitude » as defined in [2].

The Uncertainty Characteristic is optional.

The characteristic property requirements are stated in Table 3.1.

The attribute permissions for this characteristic declaration shall include at least readable permission. A higher layer may specify additional permission requirements but it is recommended that only authorized devices are permitted to write.

The Uncertainty Characteristic consists of several values. The meaning of each bit is described in Table 3.4:

The format of the characteristic is an unsigned integer of size 8 bits.

The characteristic UUID shall be set to « Uncertainty » as defined in [2].

The Location Name Characteristic is optional.

The characteristic property requirements are stated in Table 3.1. The attribute permissions for this characteristic declaration shall include at least readable permission. A higher layer may specify additional permission requirements but it is recommended that only authorized devices are permitted to write.

The Location Name value is a UTF8 string holding the information of the location, for example location name, room name, floor name, etc. The location name shall be formatted according to the civicLocation definition [3].

The format of the characteristic is a string of variable size. If unset, the value has zero length.

The characteristic UUID shall be set to « Location Name » as defined in [2].