Skip to content

Commit 8ea13df

Browse files
committed
Minor edits
1 parent 19bee61 commit 8ea13df

1 file changed

Lines changed: 21 additions & 22 deletions

File tree

draft-mohan-asdf-sdf-protocol-mapping.md

Lines changed: 21 additions & 22 deletions
Original file line numberDiff line numberDiff line change
@@ -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

7877
These 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

101100
A 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
106105
sdfProtocolMap
@@ -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

198197
Where:
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

300299
Where:
301300

0 commit comments

Comments
 (0)