Silicon Labs UG118 ユーザーガイド

ブランド: Silicon Labs

モデル: UG118

タイプ: ユーザーガイド

このマニュアルも適しています

UG118：Blue Gecko Bluetooth

Profile

Toolkit

開発者ガイド

Bluetooth GATT のサービスと特性は、Bluetooth データ交換の基盤です。これらを使用し

て、心拍数モニタなどのデバイスによって表示されるデータの構造、アクセス・タイプ、

およびセキュリティ・プロパティを記述します。Bluetooth のサービスと特性は、明確に

定義され構造化された形式を採用しており、XML マークアップ言語を使用して簡単に記

述できます。

Profile Toolkit は、Bluetooth サービスと特性を記述するための XML ベースのマークアッ

プ言語です。GATT データベースとも呼ばれ、人間とマシンが簡単に判読できる形式のマ

ークアップ言語です。このガイドでは、Profile Toolkit

で使用される XML 構文について順

を追って説明するとともに、独自の Bluetooth サービスと特性を簡単に記述する方法、ア

クセスおよびセキュリティのプロパティを構成する方法、およびファームウェアの一部と

して GATT データベースを含める方法について説明します。

このガイドには実用的な例も記載されており、標準化された Bluetooth およびベンダー固

有の独自サービスの使用を紹介しています。これらの例は、独自の開発を開始する際に活

用できます。

要点

• Bluetooth GATT のプロファイル、サービ

ス、特性、

および属性プロトコルを理解す

る

• Profile Toolkit を使用して GATT データベ

ースを構築する

silabs.com | Building a more connected world. Rev. 2.1

第 1 章プロファイル、サービス、特性、および属性プロトコルを理解する

このセクションでは、Bluetooth のプロファイル、サービス、

および特性についての基本的な説明と、GATT サーバとクライアント間で

のデータ交換で属性プロトコルを使用する方法についても説明します。これらのテーマの詳細を参照できるリンクも記載されていま

す。

1.1 GATT ベースの Bluetooth プロファイルおよびサービス

Bluetooth プロファイルは、データを交換する構造を指定します。プロファイルは、プロファイルで使用されるサービスや特性などの

要素を定義しますが、セキュリティおよび接続確立パラメータの定義を含む場合もあります。一般的に、プロファイルは、心拍数や鳴

動のモニタリングなど、高水準の使用事例を実現するために必要な 1 つまたは複数のサービスで構成されます。標準化されたプロファ

イルにより、デバイスおよびソフトウェアのベンダーは相互運用可能なデバイスやアプリケーションを構築できます。

標準化された Bluetooth SIG プロファイルは以下のウェブサイトでご覧いただけます。

https://developer.bluetooth.org/gatt/profiles/Pages/ProfilesHome.aspx

1.2 サービス

サービスは、完全な使用事例ではなく、バッテリのモニタリングや温度データなど、デバイスの特定機能を実現するために使用される

1 つまたは複数の特性で構成されたデータの集合体です。

標準化された Bluetooth SIG サービスの仕様は以下のウェブサイトでご覧いただけます。

https://developer.bluetooth.org/gatt/services/Pages/ServicesHome.aspx

1.3 特性

特性は、データの公開/交換や情報の制御を行うためにサービスで使用される値です。特性には、明確に定義された規定の形式がありま

す。値へのアクセス手段、満たす必要があるセキュリティ要件、オプションで特性の値を表示または解釈する方法についての情報も含

まれます。特性には、値の記述、または特性データの表示/通知の許可の構成の記述を行う記述子が含まれている場合もあります。

標準化された Bluetooth SIG 特性は以下のウェブサイトでご覧いただけます。

https://developer.bluetooth.org/gatt/characteristics/Pages/CharacteristicsHome.aspx

UG118：Blue Gecko Bluetooth

Profile Toolkit 開発者ガイド

プロファイル、サービス、特性、および属性プロトコルを理解する

silabs.com | Building a more connected world. Rev. 2.1 | 2

1.4 属性プロトコル

属性プロトコルは、GATT サーバと GATT クライアント間のデータ交換を可能にします。このプロトコルは、2 つの GATT パーティ間

でデータのクエリ、書き込み、表示、通知を行う方法、および情報の制御方法といった一連の操作も提供します。

GATT server

(Heart Rate profile)

GAP service

UUID: 0x1800

Device Information

service

UUID: 0x180A

HR measurement

Characteristic

UUID: 0x2A37

Body Sensor

Location

Characteristic

UUID: 0x2A38

Declaration

(notify property, no

security

requirements)

Characteristic

(2-6B of data

exposing HR

reading)

Descriptors

(enable/disable

notifications)

GATT client

Attribute protocol

Operations:

Read

Write

Notify

Indicate

Heart Rate Service

UUID: 0x180D

図 1.1. プロファイル、サービス、および特性の関係

UG118：Blue Gecko Bluetooth

Profile Toolkit 開発者ガイド

プロファイル、サービス、特性、および属性プロトコルを理解する

silabs.com | Building a more connected world. Rev. 2.1 | 3

図 1.2. 属性の読み取り操作

図 1.3. 属性の書き込み操作

図 1.4. 属性の書き込み操作（応答なし）

図 1.5. 属性の表示操作

図 1.6. 属性の通知操作

UG118：Blue Gecko Bluetooth

Profile Toolkit 開発者ガイド

プロファイル、サービス、特性、および属性プロトコルを理解する

silabs.com | Building a more connected world. Rev. 2.1 | 4

第 2 章 Profile Toolkit を使用して GATT データベースを構築する

本書のこのセクションでは、Blue Gecko Bluetooth Profile Toolkit で使用される XML 構文を説明し、Bluetooth サービスと特性を構築す

る際に使用できるさまざまなオプションについて順を追って説明します。

いくつかの実用的な GATT データベースの例も示します。

2.1 一般的な制限

以下の表に、Blue Gecko デバイスでサポートされている GATT データベースの制限を示します。

項目制限注記

最大特性数無制限ですが、実際にはデータ

ベース内の属性の総数により制

限されます。

const="true" プロパティを持たないすべての特

性がカウントされます。

type="user" 特性の最大文字数 512 バイトこれらの特性はアプリケーションによって処理

されるため、アプリケーションで使用できる

RAM の容量によってこの値が制限されます。

type="user を使用しない場合、特性の最大文字

数は 255 バイトになります。

Note: Bluetooth 仕様により制限されます

const="true" 特性の最大文字数 255 バイト使用されるデバイスで使用可能なフラッシュの

空き領域によって、この値が定義されます。

const="false" 特性の最大文字数 255 バイト const="false" プロパティを持つすべての特性

に、特性値を保存するため、Bluetooth デバイス

の RAM が割り当てられます。

単一の GATT データベースの最大属性数 255 通常、1 つの特性で 3 ～ 5 の属性が使用されま

す。

通知可能な特性の最大数 64

機能の最大数 16 機能のロジック状態によって、各サービスと特性

の視認性が決定されます。

UG118：Blue Gecko Bluetooth

Profile Toolkit 開発者ガイド

Profile Toolkit を使用して GATT データベースを構築する

silabs.com | Building a more connected world. Rev. 2.1 | 5

2.2 <gatt>

GATT データベースは、サービスおよび特性とともに XML 属性 <gatt> 内に記述する必要があります。

Parameter Description

out Filename for the GATT C source file

Value: Any UTF-8 string. Must be valid as a filename and end

with '.c'

Default: gatt_db.c

header Filename for the GATT C header file

Value: Any UTF-8 string. Must be valid as a filename and end

with '.h'

Default:

gatt_db.h

db_name GATT database structure name and the prefix for data structures

in the GATT C source file.

Value:

Any UTF-8 string; must be valid in C.

Default: bg_gattdb_data

name Free text, not used by the database compiler

Value:

Any UTF-8 string

Default:

Nothing

prefix Prefix to add to each 'id' name for defining the handle macro that

can be referenced from the C application.

Value: Any UTF-8 string. Must be valid in C.

Default: Nothing

E.g. If prefix="my_gatt_" and id="temp_measurement" for a

particular characteristic, then the following will be generated in the

GATT C header file:

#define my_gatt_temp_measurement X (where X is the handle

number for the temp_measurement characteristic)

generic_attribute_service If it is set to true, Generic Attribute service and its

service_changed characteristic will be added in the beginning of

the database. The Bluetooth stack takes care of database

structure change detection and will send service_changed

notifications to clients when a change is detected. In addition, this

will enable the GATT-caching feature introduced in Bluetooth 5.1.

Values:

true: Generic Attribute service is automatically added to the

GATT database and GATT caching is enabled.

false: Generic Attribute service is not automatically added to the

GATT database and GATT caching is disabled.

Default: false

gatt_caching The GATT caching feature is enabled by default if

generic_attribute_service is set to true. However, it can be

disabled by setting this attribute to false.

例：GATT データベースの定義。

<?xml version="1.0" encoding="UTF-8" ?> <gatt out="my_gatt_db.c" header="my_gatt_db.h" db_name="my_gatt_db_" prefix="my_gatt_"

generic_attribute_service="true" name="My GATT database"> … </gatt>

UG118：Blue Gecko Bluetooth

Profile Toolkit 開発者ガイド

Profile Toolkit を使用して GATT データベースを構築する

silabs.com | Building a more connected world. Rev. 2.1 | 6

2.3 <capabilities_declare>

GATT データベースのサービスと特性は、機能を使用して表示または非表示にできます。機能は

、<capability> 要素で宣言する必要が

あり、GATT データベースのすべての機能は、<capability> 要素のシーケンスで構成される <capabilities_declare> 要素で最初に宣言さ

れる必要があります。データベース内の機能の最大数は 16 です。

この新しい機能は、レガシ GATT XML データベース（Silicon Labs Bluetooth スタック・バージョン 2.4.x 以前）には影響しません。こ

れらのデータベースでは機能が明示的に宣言されないため、すべてのサービスと特性がリモート GATT クライアントに表示されたまま

になります。

Parameter Description

- -

例：機能の宣言

<capabilities_declare> … </capabilities_declare>

2.3.1 <capability>

各機能は、<capability> 要素を使用して <capabilities_declare> 要素内で個別に宣言される必要があります。

<capability> 要素には

"enable" という名前の 1 つの属性があり、データベースの初期化時に機能のデフォルトの状態を示します。

<capability> 要素のテキスト値は、生成されたデータベースの C ヘッダの対象機能に対する識別子名になります。したがって、この値

は C で有効である必要があります。

機能の継承

サービスと特性によって、使用する機能を宣言できます。機能が宣言されない場合は、次の継承規則が適用されます。

1. 機能を宣言しないサービスには、<capabilities_declare> 要素のすべての機能が付与される。

2. 機能を宣言しない特性には、その特性が属するサービスのすべての機能が付与される。サービスによって <capabilities_declare>

の機能のサブセットが宣言された場合は、そのサブセットのみが特性によって継承されます。

3. 特性のすべての属性が特性の機能を継承します。

可視性

機能を有効化または無効化して、次のロジックに従って GATT クライアントに対してサービスと特性を表示または非表示にできます。

1. 機能の少なくとも 1 つが有効になっている場合、サービスとそのすべての特性は表示に設定されます。

2. 機能のすべてが無効になっている場合、サービスとそのすべての特性は非表示に設定されます。

3. 機能の少なくとも 1 つが有効になっている場合、特性とそのすべての属性は表示に設定されます。

4. 機能のすべてが無効になっている場合、特性とそのすべての属性は非表示に設定されます。

Parameter Description

enable Sets the default state of a capability at database initialization.

Values:

true: Capability is enabled.

false: Capability is disabled.

Default: true

例：機能の宣言

<capabilities_declare>  <capability

enable="true">cap_light</capability> <!--

This capability is disabled by default and the identifier is cap_color --> <capability

enable="false">cap_color</capability> </capabilities_declare>

UG118：Blue Gecko Bluetooth

Profile Toolkit 開発者ガイド

Profile Toolkit を使用して GATT データベースを構築する

silabs.com | Building a more connected world. Rev. 2.1 | 7

2.4 <service>

GATT サービスの定義は、XML 属性 <service> およびそのパラメータによって行われます。

以下の表に、関連する値を定義するために使用できるパラメータを示します。

Parameter Description

uuid Universally Unique Identifier. The UUID uniquely identifies a service. 16-bit values are used for the

services defined by the Bluetooth SIG and 128-bit UUIDs can be used for vendor specific

implementations.

Range:

0x0000 – 0xFFFF: Reserved for Bluetooth SIG standardized services

0x00000000-0000-0000-0000-000000000000 - 0xFFFFFFFF-FFFF-FFFF-FFFF-FFFFFFFFFFFF:

Reserved for vendor specific services.

id The ID is used to identify a service within the service database and can be used as a reference from

other services (include statement). Typically this does not need to be used.

Value:

Any UTF-8 string

type The type field defines whether the service is a primary or a secondary service. Typically this does not

need to be used.

Values:

primary: a primary service

secondary: a secondary service

Default: primary

advertise This field defines if the service UUID is included in the advertisement data.

The advertisement data can contain up to 13 16-bity UUIDs or one (1) 128-but UUID.

Values:

true: UUID included in advertisement data

false: UUID not included in advertisement data

Default: false

Note: You can override the advertisement data with the GAP API, in which case this is not valid.

例：汎用アクセス・プロファイル (GAP) サービスの定義。

…

</service>

例：ベンダー固有サービスの定義。

…

</service>

UG118：Blue Gecko Bluetooth

Profile Toolkit 開発者ガイド

Profile Toolkit を使用して GATT データベースを構築する

silabs.com | Building a more connected world. Rev. 2.1 | 8

例：UUID を持つ Heart Rate サービスはアドバタイズ・データおよび ID “hrs” に含まれます。

…

</service>

Note: http://www.itu.int/en/ITU-T/asn1/Pages/UUID/uuids.aspx で独自の 128 ビット UUID を生成できます。

2.4.1 <capabilities>

サービスは、<capabilities> 要素を使用して機能を宣言できます。要素は、<capability> 要素のシーケンスで構成されます。この要素の

識別子は <capabilities_declare> 要素にも含める必要があります。属性 "enable" はこのコンテキストで宣言された機能に影響を与えな

いため、除外できます。

サービスが機能を宣言しない場合は、

継承規則に従って <capabilities_declare> のすべての機能が付与されます。

サービスとそのすべての特性は、機能の少なくとも 1 つが有効になっている場合は表示に設定され、機能のすべてが無効になっている

場合は非表示に設定されます。

Parameter Description

- -

例：機能の宣言

<capabilities> <capability>cap_light</capability> <capability>cap_color</capability> </capabilities>

2.4.2 <description>

XML 要素 <description> は情報提供目的（コメント）で使用でき、実際の GATT データベースには使用できません。

2.4.3 <include>

サービスは、XML 属性 <include> を使用して、別のサービスに含めることができます。

Parameter Description

id ID of the included service

Value:

ID of another service

例：GAP サービス内に Heart Rate サービスを含める。

…

</service>

UG118：Blue Gecko Bluetooth

Profile Toolkit 開発者ガイド

Profile Toolkit を使用して GATT データベースを構築する

silabs.com | Building a more connected world. Rev. 2.1 | 9

2.5 <characteristic>

サービスによって公開されるすべての特性は、XML 属性 <characteristic> およびそのパラメータで定義されます。これらは、

<service> XML 属性タグ内で使用する必要があります。

以下の表に、関連する値を定義するために使用できるパラメータを示します。

Parameter Description

uuid Universally Unique Identifier. The UUID uniquely identifies a characteristic.

16-bit values are used for the services defined by the Bluetooth SIG and 128-bit UUIDs can be used

for vendor specific implementations.

Range:

0x0000 – 0xFFFF: Reserved for Bluetooth SIG standardized characteristics.

0x00000000-0000-0000-0000-000000000000 to 0xFFFFFFFF-FFFF-FFFF-FFFF-FFFFFFFFFFFF :

Reserved for vendor specific characteristics.

id The ID is used to identify a characteristic. The ID is used within a C application to read and write

characteristic values or to detect if notifications or indications are enabled or disabled for a specific

characteristic.

When the project is built the generated GATT C header file contains a macro with the characteristic

'id' and corresponding handle value.

Value:

Any UTF-8 string

例：GAP サービスにデバイス名特性を追加する。

…

</characteristic>

…

</service>

例：ID を持つベンダー固有のサービスにベンダー固有の特性を追加する。

…

</characteristic>

…

</service>

UG118：Blue Gecko Bluetooth

Profile Toolkit 開発者ガイド

Profile Toolkit を使用して GATT データベースを構築する

silabs.com | Building a more connected world. Rev. 2.1 | 10

2.5.1 <capabilities>

特性は、<capabilities> 要素を使用して機能を宣言できます。要素は、<capability> 要素のシーケンスで構成されます。この要素の識別

子は、親サービスでも

宣言される（または完全に継承される）必要があります。属性 "enable" はこのコンテキストで宣言された機能に

影響を与えないため、除外できます。

特性が機能を宣言しない場合は、継承規則に従って、その特性が属するサービスのすべての機能が付与されます。特性のすべての属性

が特性の機能を継承します。

特性とそのすべての属性は、機能の少なくとも 1 つが有効になっている場合は表示に設定され、機能のすべてが無効になっている場合

は非表示に設定されます。

Parameter Description

- -

例：機能の宣言

<capabilities> <capability>cap_light</capability> <capability>cap_color</capability> </capabilities>

UG118：Blue Gecko Bluetooth

Profile Toolkit 開発者ガイド

Profile Toolkit を使用して

GATT データベースを構築する

silabs.com | Building a more connected world. Rev. 2.1 | 11

2.5.2 <properties>

特性のアクセスおよびセキュリティ・プロパティは、XML 属性 <properties> およびそのパラメータで定義されます。これらは、

<characteristic> XML

属性タグ内で使用する必要があります。特性は、同時に複数のプロパティを持つことができます。

以下の表に、関連する値を定義するために使用できるパラメータを示します。

Parameter Description

read Characteristic can be read by a remote device.

Values:

true: Characteristic can be read

false: Characteristic cannot be read

Default: false

const Characteristic has a constant value, which cannot be modified after programming.

The benefit of constant values is that no RAM is allocated for them leaving more RAM to the

application.

Value:

true: Characteristic value is constant

false: Characteristic value is not constant

Default: false

write Characteristic can be written by a remote device

Values:

true: Characteristic can be written

false: Characteristic cannot be written

Default: false

write_no_response Characteristic can be written by a remote device. Write without response is not acknowledged over

the Attribute Protocol.

Values:

true: Characteristic can be written

false: Characteristic cannot be written

Default: false

notify Characteristic has the notify property and characteristic value changes are notified over the Attribute

Protocol. Notifications are not acknowledged over the Attribute Protocol.

Values:

true: Characteristic has notify property.

false: Characteristic does not have notify property.

Default: false

indicate Characteristic has the indicate property and characteristic value changes are indicated over the

Attribute Protocol. Indications are acknowledged over the Attribute Protocol.

Values:

true: Characteristic has indicate property.

false: Characteristic does not have indicate property.

Default: false

UG118：Blue Gecko Bluetooth

Profile Toolkit 開発者ガイド

Profile Toolkit を使用して GATT データベースを構築する

silabs.com | Building a more connected world. Rev. 2.1 | 12

Parameter Description

authenticated_read Reading the characteristic value requires an authentication. In order to read the characteristic with

this property the remote device has to be bonded using MITM protection and the connection must

be also encrypted.

Values:

true: Authentication is required

false: Authentication is not required

Default: false

encrypted_read Reading the characteristic value requires an encrypted link. With iOS 9.1 and newer devices must

also be bonded at least with Just Works pairing.

Values:

true: Encryption is required

false: Encryption is not required

Default: false

bonded_read Reading the characteristic value requires an encrypted link. Devices must also be bonded at least

with Just Works pairing.

Values:

true: Bonding and encryption are required

false: Bonding is not required

Default: false

authenticated_write Writing the characteristic value requires an authentication. In order to write the characteristic with

this property the remote device has to be bonded using MITM protection and the connection must

be also encrypted.

Values:

true: Authentication is required

false: Authentication is not required

Default: false

encrypted_write Writing the characteristic value requires an encrypted link. With iOS 9.1 and newer devices must

also be bonded at least with Just Works pairing.

Values:

true: Encryption is required

false: Encryption is not required

Default: false

bonded_write Writing the characteristic value requires an encrypted link. Devices must also be bonded at least

with Just Works pairing.

Values:

true: Bonding and encryption are required

false: Bonding is not required

Default: false

UG118：Blue Gecko Bluetooth

Profile Toolkit 開発者ガイド

Profile Toolkit を使用して GATT データベースを構築する

silabs.com | Building a more connected world. Rev. 2.1 | 13

Parameter Description

reliable_write Allows using reliable write procedure to modify attribute, this is just a hint to GATT client. The

Bluetooth stack always allows using reliable writes to be used to modify attributes.

Values:

true: Reliable write enabled

false: Reliable write disabled

Default: false

authenticated_notify Both enabling notifications/indications on this characteristic and sending out notifications/indications

on this characteristic require authentication. In order to enable/disable notifications/indications and

to be able to receive notifications/indications the remote device has to be bonded using MITM

protection and the connection must be also encrypted. Use this property along with the notify or

indicate property.

Values:

true: Authentication is required

false: Authentication is not required

Default: false

encrypted_notify Both enabling notifications/indications on this characteristic and sending out notifications/indications

on this characteristic require an encrypted link. With iOS 9.1 and newer, devices must also be

bonded at least with Just Works pairing. Use this property along with the notify or indicate

property.

Values:

true: Encryption is required

false: Encryption is not required

Default: false

bonded_notify Both enabling notifications/indications on this characteristic and sending out notifications/indications

on this characteristic require an encrypted link. Devices must also be bonded at least with Just

Works pairing. Use this property along with the notify or indicate property.

Values:

true: Encryption is required

false: Encryption is not required

Default: false

例：const および read プロパティを持つデバイス名特性。

…

</characteristic>

例：リモート・デバイスによって値の変更を可能にする read および write プロパティを持つデバイス名特性。

…

</characteristic>

UG118：Blue Gecko Bluetooth

Profile Toolkit 開発者ガイド

Profile Toolkit を使用して GATT データベースを構築する

silabs.com | Building a more connected world. Rev. 2.1 | 14

例：notify プロパティを持つ心拍数測定特性。

…

</characteristic>

例：encrypted read プロパティを持つ特性。

…

</characteristic>

例：authenticated write プロパティを持つ特性。

…

</characteristic>

例：authenticated indicate プロパティを持つ特性。

…

</characteristic>

UG118：Blue Gecko Bluetooth

Profile Toolkit 開発者ガイド

Profile Toolkit を使用して GATT データベースを構築する

silabs.com | Building a more connected world. Rev. 2.1 | 15

2.5.3 <value>

特性のデータ・

タイプと長さは、XML 属性 <value> およびそのパラメータで定義されます。これらは、<characteristic> XML 属性タ

グ内で使用する必要があります。

以下の表に、関連する値を定義するために使用できるパラメータを示します。

Parameter Description

length Defines a fixed length for the characteristic or the maximum length if variable_length is true. If

length is not defined and there is a value (e.g. data exists inside <value></value>), then the value

length is used to define the length.

If both length and value are defined, then the following rules apply:

1. If variable_length

is false and length is bigger than the value's length, then the value will be

padded with 0's at the end to match the attribute's length.

2. If length is smaller than the value's length, then the value will be clipped to match length,

regardless of whether variable_length is true or false.

Range:

0 – 255: Length in bytes if type is 'hex' or 'utf-8'

0 – 512: Length in bytes if type is 'user'

Default: 0

variable_length Defines that the value is of variable length. The maximum length must also be defined with the

length

attribute or by defining a value. If both length

and value are defined, then the rules decribed

in length apply.

Values:

true: Value is of variable length

false: Value has a fixed length

Default: false

type Defines the data type.

Values:

hex: Value type is hex

utf-8: Value is a string

user: When the characteristic type is marked as type="user", the application is responsible for

initializing the characteristic value and also providing it, for example, when read operation occurs.

The Bluetooth stack does not initialize the value or automatically provide the value when it is being

read. When this is set, the Bluetooth stack generates gatt_server_user_read_request or

gatt_server_user_write_request, which must be handled by the application.

Default: utf-8

例：notify プロパティと 2 バイトの固定長を持つ心拍数測定特性。

…

</characteristic>

例：最大長が 20 バイトの可変長のベンダー固有特性。

UG118：Blue Gecko Bluetooth

Profile Toolkit 開発者ガイド

Profile Toolkit を使用して GATT データベースを構築する

silabs.com | Building a more connected world. Rev. 2.1 | 16

…

</characteristic>

例：特性の値と長さは、<value> タグ内に実際の値を入力して定義することもできます。

<value>Blue Gecko BGM111</value>

</characteristic>

上記の例の場合、値は “Blue Gecko BGM111” で、長さは 17 バイトです。

例：値の長さより大きい長さで length と value の両方を定義する場合。

</characteristic>

上記の例では、length が値の長さより大きく、value に 0 が埋め込まれた状態になるため、値は “01020000” になります。

例：値の長さより小さい長さで length と value の両方を定義する場合。

</characteristic>

上記の例では、length

が値の長さより小さく、その結果、値が length と一致するようにクリップされるため、値は “0102” になり

ます。

2.5.4 <descriptor>

XML 要素 <descriptor> は、汎用特性記述子を定義するために使用できます。

記述子のプロパティは <properties> 要素によって定義され、読み取りアクセスおよび/または書き込みアクセスのみが許可されます。値

は特性値の場合と同じように、<value> 要素によって定義されます。

例：タイプ UUID 2908 の特性記述子の追加。

</descriptor>

</characteristic>

UG118：Blue Gecko Bluetooth

Profile Toolkit 開発者ガイド

Profile Toolkit を使用して GATT データベースを構築する

silabs.com | Building a more connected world. Rev. 2.1 | 17

2.5.5 <description>

特性ユーザ説明値は、XML 属性 <description> で定義されます

。これらは、<characteristic> XML 属性タグ内で使用する必要がありま

す。

特性のユーザ説明はオプション値です。これはリモート・デバイスによって使用され、これを使用して、ユーザに分かりやすい特性の

説明をアプリケーションのユーザ・インターフェイスに表示したりすることができます。

例：定数文字列「心拍数測定」

<description>Heart Rate Measurement</description>

</characteristic>

プロパティ要素を使用して、属性のリモート変更を許可できます。

例：リモート読み取りを許可するが、書き込みには結合が必要

<characteristic uuid="2a37"> <properties notify="true" /> <value length="2" /> <description> <properties read="true" write="true"

authenticated_write="true" /> <value variable_length="true" length="20" /> </description> </characteristic>

Note: 説明が書き込み可能な場合、GATT パーサは、Bluetooth 準拠に設定された writable_auxiliaries ビットを使用して拡張プロパティ

属性を自動的に追加します。

2.5.6 <agggregate>

XML 要素 <aggregate> を使用すると、ID を属性ハンドルに自動的に変換することにより、集計された特性形式記述子を作成できます。

属性 ID は、特性表示形式記述子を参照する必要があります。

例：特性集計を追加

2.6 GATT の例

例：定数としてデバイス名特性および外観特性、read プロパティを持つ完全な GAP サービス。

<?xml version="1.0" encoding="UTF-8" ?>

<gatt>

<value>Blue Gecko</value>

</characteristic>

</characteristic>

</service>

</gatt>

UG118：Blue Gecko Bluetooth

Profile Toolkit 開発者ガイド

Profile Toolkit を使用して

GATT データベースを構築する

silabs.com | Building a more connected world. Rev. 2.1 | 18

例：完全なデバイス情報、即時の通知、リンク・ロス・サービス

<?xml version="1.0" encoding="UTF-8" ?>

<gatt>

<value>Silicon Labs</value>

</characteristic>

</characteristic>

</characteristic>

</service>

</characteristic>

</service>

</characteristic>

</service>

</gatt>

UG118：Blue Gecko Bluetooth

Profile Toolkit 開発者ガイド

Profile Toolkit を使用して GATT データベースを構築する

silabs.com | Building a more connected world. Rev. 2.1 | 19

例：機能を持つ GATT データベース

<capabilities_declare>

<capability enable="true">cap_light</capability>

<capability enable="false">cap_color</capability>

</capabilities_declare>

<capability>cap_light</capability>

<capability>cap_color</capability>

</capabilities>

<capability>cap_light</capability>

</capabilities>

</characteristic>

<characteristic uuid="6d2dede5-91f8-4dd3-8276-dbd967a5ac39" id="color_control"> <!-- this characteristic is invisible to

remotes by default -->

<capability>cap_color</capability>

</capabilities>

</characteristic>

</service>

</gatt>

• 機能 cap_light および cap_color が有効になっている場合は、light_service 全体が表示に設定されます

• 機能 cap_light が有効になっている場合は、特性 light_control が非表示に設定されます

• 機能 cap_color が有効になっている場合は、特性 color_control が非表示に設定されます

UG118：Blue Gecko Bluetooth

Profile Toolkit 開発者ガイド

Profile Toolkit を使用して GATT データベースを構築する

silabs.com | Building a more connected world. Rev. 2.1 | 20

ページが読み込まれています...

Silicon Labs UG118 ユーザーガイド

ブランド: Silicon Labs

モデル: UG118

タイプ: ユーザーガイド

このマニュアルも適しています

PDFをダウンロードします

報告

他の言語で

English: Silicon Labs UG118 User guide

Silicon Labs UG118 ユーザーガイド

このマニュアルも適しています

Silicon Labs UG118 ユーザーガイド

他の言語で

関連論文

その他のドキュメント