IPWorks BLE 2020 Delphi Edition

Questions / Feedback?

Characteristic Type

A GATT characteristic.

Remarks

This type represents a GATT characteristic.

Fields

CachedValue
String

The most recently cached value of this characteristic.

To read the characteristic's value directly from the remote server, use ReadValue.

CachedValueB
TBytes

The most recently cached value of this characteristic.

To read the characteristic's value directly from the remote server, use ReadValue.

CanSubscribe
Boolean

Whether or not you can subscribe to receive value updates for this characteristic.

Description
String

This characteristic's Bluetooth SIG user-friendly name, if one is defined.

Flags
Integer

A bitmask of this characteristic's flags.

This property is a bitmask which represents all of the flags (or, in BLE terms, "properties") which this characteristic has set. The following table shows what bitmask is used to represent each flag:

BitmaskFlag
0x00000001 Broadcast
0x00000002 Read
0x00000004 Write Without Response
0x00000008 Write
0x00000010 Notify
0x00000020 Indicate
0x00000040 Authenticated Signed Writes
0x00000080 Reliable Writes (extended property)
0x00000100 Writable Auxiliaries (extended property)

Note that, on some platforms, the component might have to automatically discover specific descriptors for the value this returns to be accurate. The component take care of handling this automatic discovery in the most energy-efficient manner possible.

Id
String

An identification string which uniquely identifies this instance of this characteristic.

This identification string is guaranteed to be unchanged while the component remains connected to the device.

Subscribed
Boolean

Whether or not the component has subscribed to updates for this characteristic's value.

See Subscribe for more information.

Note that, on some platforms, the component might have to automatically discover specific descriptors for the value this returns to be accurate. The component take care of handling this automatic discovery in the most energy-efficient manner possible.

UserDescription
String

The value of the user description descriptor for this characteristic.

If the "Writable Auxiliaries" property is set for this characteristic, you can change this value, which updates it on the server too.

Note that, on some platforms, the component might have to automatically discover specific descriptors for the value this returns to be accurate. The component take care of handling this automatic discovery in the most energy-efficient manner possible.

Uuid
String

This characteristic's 128-bit UUID string.

ValueExponent
Integer

The exponent of this characteristic's value, for applicable value formats.

For an applicable ValueFormat, this signed integer should be used as an exponent in the following formula in order to determine the actual value of the characteristic: [Value] * 10^[Exponent].

ValueFormat
TiplValueFormats

The data type of this characteristic's value.

The valid options are as follows:

Value TypeDescription
vfUndefined (0) Undefined
vfBoolean (1) Unsigned 1-bit; 0 = false, 1 = true
vf2Bit (2) Unsigned 2-bit integer
vfNibble (3) Unsigned 4-bit integer
vfUInt8 (4) Unsigned 8-bit integer; exponent applies
vfUInt12 (5) Unsigned 12-bit integer; exponent applies
vfUInt16 (6) Unsigned 16-bit integer; exponent applies
vfUInt24 (7) Unsigned 24-bit integer; exponent applies
vfUInt32 (8) Unsigned 32-bit integer; exponent applies
vfUInt48 (9) Unsigned 48-bit integer; exponent applies
vfUInt64 (10) Unsigned 64-bit integer; exponent applies
vfUInt128 (11) Unsigned 128-bit integer; exponent applies
vfSInt8 (12) Signed 8-bit integer; exponent applies
vfSInt12 (13) Signed 12-bit integer; exponent applies
vfSInt16 (14) Signed 16-bit integer; exponent applies
vfSInt24 (15) Signed 24-bit integer; exponent applies
vfSInt32 (16) Signed 32-bit integer; exponent applies
vfSInt48 (17) Signed 48-bit integer; exponent applies
vfSInt64 (18) Signed 64-bit integer; exponent applies
vfSInt128 (19) Signed 128-bit integer; exponent applies
vfFloat32 (20) IEEE-754 32-bit floating point
vfFloat64 (21) IEEE-754 64-bit floating point
vfSFloat (22) IEEE-11073 16-bit SFLOAT
vfFloat (23) IEEE-11073 32-bit FLOAT
vfDUInt16 (24) IEEE-20601 format (Two UInt16 values concatenated)
vfUtf8Str (25) UTF-8 string
vfUtf16Str (26) UTF-16 string
vfStruct (27) Opaque structure

ValueFormatCount
Integer

The number of value formats this characteristic has.

Characteristics whose values are an aggregate of multiple other values will often have multiple value formats as a result. In such cases, this property's value will be greater than 1, and the ValueFormatIndex property can be used to choose which value format the ValueFormat, ValueExponent, and ValueUnit properties are populated with.

Note that, on some platforms, the component might have to automatically discover specific descriptors for the value this returns to be accurate. The component take care of handling this automatic discovery in the most energy-efficient manner possible.

ValueFormatIndex
Integer

Selects the currently populated value format details for this characteristic.

See ValueFormatCount for more details.

ValueUnit
String

The 128-bit UUID string that represents the unit of measurement for this characteristic's value.

Constructors

constructor Create();

Copyright (c) 2022 /n software inc. - All rights reserved.
IPWorks BLE 2020 Delphi Edition - Version 20.0 [Build 8158]