Part 1
요약·해설
Metadata entry 구조, raw data pointer와 mandatory list terminator를 설명합니다.
Mesh 1.1
Device-key only
Entry list
Primary only
Part 2
접을 수 있는 영어 원문 전체
영어 원문 전체 펼치기
1815C31A0253F63853ADDFA45DAAE8B597BE07E1555F09A4BBDE78B985B1E21D
.. _bluetooth_mesh_lcd_srv:
Large Composition Data Server
#############################
The Large Composition Data Server model is a foundation model defined by the Bluetooth Mesh
specification. The model is optional, and is enabled through the
:kconfig:option:`CONFIG_BT_MESH_LARGE_COMP_DATA_SRV` option.
The Large Composition Data Server model was introduced in the Bluetooth Mesh Protocol Specification
version 1.1, and is used to support the functionality of exposing pages of Composition Data that do
not fit in a Config Composition Data Status message and to expose metadata of the model instances.
The Large Composition Data Server does not have an API of its own and relies on a
:ref:`bluetooth_mesh_lcd_cli` to control it. The model only accepts messages encrypted with the
node's device key.
If present, the Large Composition Data Server model must only be instantiated on the primary
element.
Models metadata
===============
The Large Composition Data Server model allows each model to have a list of model's specific
metadata that can be read by the Large Composition Data Client model. The metadata list can be
associated with the :c:struct:`bt_mesh_model` through the :c:member:`bt_mesh_model.metadata` field.
The metadata list consists of one or more entries defined by the
:c:struct:`bt_mesh_models_metadata_entry` structure. Each entry contains the length and ID of the
metadata, and a pointer to the raw data. Entries can be created using the
:c:macro:`BT_MESH_MODELS_METADATA_ENTRY` macro. The :c:macro:`BT_MESH_MODELS_METADATA_END` macro
marks the end of the metadata list and must always be present. If the model has no metadata, the
helper macro :c:macro:`BT_MESH_MODELS_METADATA_NONE` can be used instead.
API reference
*************
.. doxygengroup:: bt_mesh_large_comp_data_srv
:project: Zephyr
:members:
Part 3
한국어 전문 번역
Large Composition Data Server
Bluetooth Mesh specification이 정의한 optional foundation model이며 CONFIG_BT_MESH_LARGE_COMP_DATA_SRV로 활성화합니다.
Bluetooth Mesh Protocol Specification 1.1에 도입됐습니다. Config Composition Data Status message에 들어가지 않는 Composition Data page와 model instance metadata를 외부에 제공합니다.
자체 API가 없고 Large Composition Data Client가 제어합니다. Node device key로 encryption된 message만 받아들입니다. 이 model을 사용한다면 primary element에만 instance화해야 합니다.
Models metadata
각 model은 Large Composition Data Client가 읽을 model-specific metadata list를 가질 수 있습니다. List는 bt_mesh_model.metadata field를 통해 bt_mesh_model에 연결합니다.
Metadata list는 bt_mesh_models_metadata_entry structure로 정의하는 entry 하나 이상으로 구성됩니다. 각 entry는 metadata length, ID와 raw data pointer를 담습니다.
BT_MESH_MODELS_METADATA_ENTRY macro로 entry를 만들고 BT_MESH_MODELS_METADATA_END macro로 list 끝을 표시합니다. End marker는 항상 있어야 합니다. Model에 metadata가 없으면 대신 BT_MESH_MODELS_METADATA_NONE helper macro를 사용할 수 있습니다.
API Reference
공식 bt_mesh_large_comp_data_srv Doxygen group이 Large Composition Data Server model과 metadata 정의를 생성합니다.
Source
출처
영어 원문에는 문단, 문서 지시문, 표, 코드, 코드 심벌, 경로를 그대로 보존했습니다.