@@ -57,33 +57,32 @@ informative:
5757
5858--- abstract
5959
60- This document defines protocol mapping extensions for the Semantic
61- Definition Format (SDF) to enable mapping of protocol-agnostic SDF
62- affordances to protocol-specific operations. The protocol mapping
63- mechanism allows SDF models to specify how properties, actions, and
64- events should be accessed using specific non-IP protocols such as
65- Bluetooth Low Energy and Zigbee.
60+ This document defines protocol mapping extensions for the Semantic Definition
61+ Format (SDF) to enable mapping of protocol-agnostic SDF affordances to
62+ protocol-specific operations. The protocol mapping mechanism allows SDF models
63+ to specify how properties, actions, and events should be accessed using specific
64+ IP and non-IP protocols such as Bluetooth Low Energy and Zigbee.
6665
6766--- middle
6867
6968# Introduction
7069
71- The Semantic Definition Format (SDF) {{-sdf}} provides a protocol-agnostic
72- way to describe IoT devices and their capabilities through properties,
73- actions, and events (collectively called affordances). However, when
74- implementing these affordances on actual devices that use specific
75- communication protocols, there needs to be a mechanism to map the
76- protocol-agnostic SDF definitions to protocol- specific operations.
70+ The Semantic Definition Format (SDF) {{-sdf}} provides a protocol-agnostic way
71+ to describe IoT devices and their capabilities through properties, actions, and
72+ events (collectively called affordances). However, when implementing these
73+ affordances on actual devices using specific communication protocols, there
74+ needs to be a mechanism to map the protocol-agnostic SDF definitions to
75+ protocol-specific operations.
7776
7877These protocols can be non-IP protocols that are commonly used in IoT
79- environments, such as {{BLE53}} and {{Zigbee22}}, or
80- IP-based protocols like HTTP or CoAP.
78+ environments, such as {{BLE53}} and {{Zigbee22}}, or IP-based protocols, such as
79+ HTTP or CoAP.
8180
82- To leverage an SDF model to perform protocol-specific operations on an
83- instance of a device, a mapping of the SDF affordance to a protocol-specific
84- attribute is required. This document defines the protocol mapping mechanism
85- using the `sdfProtocolMap` keyword, which allows SDF models to include
86- protocol-specific mapping information alongside the protocol-agnostic definitions.
81+ To leverage an SDF model to perform protocol-specific operations on an instance
82+ of a device, a mapping of the SDF affordance to a protocol-specific attribute is
83+ required. This document defines the protocol mapping mechanism using the
84+ ` sdfProtocolMap` keyword, which allows SDF models to include protocol-specific
85+ mapping information alongside the protocol-agnostic definitions.
8786
8887
8988# Conventions and Definitions
@@ -100,7 +99,7 @@ as an attribute in a cluster of an endpoint.
10099
101100A protocol mapping object is a JSON object identified by the
102101` sdfProtocolMap` keyword. Protocol-specific properties are embedded
103- within this object, organized by protocol name ( e.g., "ble" or "zigbee") .
102+ within this object, organized by protocol name, e.g., "ble" or "zigbee".
104103
105104~~~ aasvg
106105sdfProtocolMap
@@ -193,7 +192,7 @@ ble-protocol-map = {
193192 characteristicID : text
194193}
195194~~~
196- {: # blemap1 title="BLE Protocol Mapping for properties and actions"}
195+ {: # blemap1 title="CDDL definition for BLE Protocol Mapping for properties and actions"}
197196
198197Where :
199198
@@ -295,7 +294,7 @@ zigbee-protocol-map = {
295294 type : uint
296295}
297296~~~
298- {: # zigmap1 title="Zigbee Protocol Mapping for properties and actions"}
297+ {: # zigmap1 title="CDDL definition for Zigbee Protocol Mapping for properties and actions"}
299298
300299Where :
301300
0 commit comments