-
Notifications
You must be signed in to change notification settings - Fork 4
/
Copy pathabout_knxiot.html
292 lines (171 loc) · 9.76 KB
/
about_knxiot.html
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
<!DOCTYPE html>
<html class="writer-html5" lang="en" >
<head>
<meta charset="utf-8" />
<meta name="viewport" content="width=device-width, initial-scale=1.0" />
<title>About KNX IoT Point API — KNX IoT documentation</title>
<link rel="stylesheet" href="_static/css/nordic.css" type="text/css" />
<link rel="stylesheet" href="_static/pygments.css" type="text/css" />
<link rel="stylesheet" href="_static/pygments.css" type="text/css" />
<link rel="stylesheet" href="_static/css/nordic.css" type="text/css" />
<link rel="stylesheet" href="_static/tabs.css" type="text/css" />
<!--[if lt IE 9]>
<script src="_static/js/html5shiv.min.js"></script>
<![endif]-->
<script type="text/javascript" id="documentation_options" data-url_root="./" src="_static/documentation_options.js"></script>
<script data-url_root="./" id="documentation_options" src="_static/documentation_options.js"></script>
<script src="_static/jquery.js"></script>
<script src="_static/underscore.js"></script>
<script src="_static/_sphinx_javascript_frameworks_compat.js"></script>
<script src="_static/doctools.js"></script>
<script src="_static/sphinx_highlight.js"></script>
<script type="text/javascript" src="_static/js/theme.js"></script>
<script type="text/javascript" src="_static/js/ncs.js"></script>
<link rel="index" title="Index" href="genindex.html" />
<link rel="search" title="Search" href="search.html" />
<link rel="next" title="Requirements and setup" href="environment_setup.html" />
<link rel="prev" title="Welcome to nRF Connect SDK – KNX IoT Point API" href="index.html" />
<link rel="shortcut icon" href="_static/images/favicon.ico"/>
</head>
<body class="wy-body-for-nav">
<div class="wy-grid-for-nav">
<nav data-toggle="wy-nav-shift" class="wy-nav-side">
<div class="wy-side-scroll">
<div class="wy-side-nav-search" >
<a href="index.html" class="icon icon-home"> KNX IoT
</a>
<div id="searchbox" role="search">
<div class="searchformwrapper">
<form id="rtd-search-form" class="wy-form" action="search.html" method="get">
<input type="text" name="q" placeholder="Search docs" />
<input type="hidden" name="check_keywords" value="yes" />
<input type="hidden" name="area" value="default" />
</form>
</div>
</div>
<script>$('#searchbox').show(0);</script>
</div>
<div class="wy-menu wy-menu-vertical" data-spy="affix" role="navigation" aria-label="main navigation">
<p class="caption" role="heading"><span class="caption-text">Subpages:</span></p>
<ul class="current">
<li class="toctree-l1 current"><a class="current reference internal" href="#">About KNX IoT Point API</a><ul>
<li class="toctree-l2"><a class="reference internal" href="#knx-point-api-devices">KNX Point API devices</a></li>
</ul>
</li>
<li class="toctree-l1"><a class="reference internal" href="environment_setup.html">Requirements and setup</a></li>
<li class="toctree-l1"><a class="reference internal" href="testing_samples/samples.html">Samples</a></li>
<li class="toctree-l1"><a class="reference internal" href="knxiot_release_notes.html">Release notes</a></li>
<li class="toctree-l1"><a class="reference internal" href="knxiot_known_issues.html">Known issues</a></li>
<li class="toctree-l1"><a class="reference internal" href="additional_resources.html">Additional resources</a></li>
</ul>
</div>
</div>
</nav>
<section data-toggle="wy-nav-shift" class="wy-nav-content-wrap">
<nav class="wy-nav-top" aria-label="top navigation">
<i data-toggle="wy-nav-top" class="fa fa-bars"></i>
<a href="index.html">KNX IoT</a>
</nav>
<div class="wy-nav-content">
<div class="rst-content">
<div role="navigation" aria-label="breadcrumbs navigation">
<ul class="wy-breadcrumbs">
<li><a href="index.html" class="icon icon-home"></a> »</li>
<li>About KNX IoT Point API</li>
<li class="wy-breadcrumbs-aside">
<a href="_sources/about_knxiot.rst.txt" rel="nofollow"> View page source</a>
</li>
</ul>
<hr/>
</div>
<div role="main" class="document" itemscope="itemscope" itemtype="http://schema.org/Article">
<div itemprop="articleBody">
<div class="section" id="about-knx-iot-point-api">
<span id="about-knxiot"></span><h1>About KNX IoT Point API<a class="headerlink" href="#about-knx-iot-point-api" title="Permalink to this heading">¶</a></h1>
<p>The <a class="reference external" href="https://www.knx.org/knx-en/for-manufacturers/get-started/knx-iot-stack/">KNX IoT Point API stack</a> is an open-source reference implementation of the KNX IoT standard.
This implementation has been integrated with the nRF Connect SDK, hence it can be used to build a KNX-IoT device based on the Thread networking protocol including all the benefits it has to offer.</p>
<p>The KNX IoT Point API solution is described in chapter 3/10/5 of the KNX Specifications.</p>
<blockquote>
<div><div class="admonition note">
<p class="admonition-title">Note</p>
<p>To get access to KNX Specifications, apply for <a class="reference external" href="https://support.knx.org/hc/en-us/articles/360000038460/">KNX membership</a>.</p>
</div>
</div></blockquote>
<p>This chapter covers:</p>
<blockquote>
<div><ul>
<li><p>The IPv6-based transport layer that is suitable, among others, for Thread-based networks.</p></li>
<li><p>A new communication/message protocol using the CoAP protocol and the CBOR format.</p></li>
<li><p>Usage of the following data already used by other KNX transport layers:</p>
<blockquote>
<div><ul class="simple">
<li><p>Functional blocks and messages.</p></li>
<li><p>S-mode message semantics.</p></li>
<li><p>Configuration data to set connection between devices.</p></li>
</ul>
</div></blockquote>
</li>
</ul>
</div></blockquote>
<div class="section" id="knx-point-api-devices">
<h2>KNX Point API devices<a class="headerlink" href="#knx-point-api-devices" title="Permalink to this heading">¶</a></h2>
<p>Products that implement the KNX IoT Point API stack use IPv6-based protocols, such as Thread, for communication with the rest of the KNX installation.
All KNX devices, regardeless of the transmittion methods used, can be easily interconnected.</p>
<p>KNX IoT Point API devices are based on the same interoperability concept as KNX TP (Twisted Pair), KNX PL (Power Line) and KNX RF (Radio Frequency) methods.
It means that the same semantic data are shared through the transport layer as for non-IoT KNX implementations.
Lower layers of the protocol stack are not KNX-specific — in this case, the Thread protocol is used instead.
For this reason, a middleware is required for sharing the data between KNX IoT and non-IoT parts of the system.</p>
<blockquote>
<div><div class="admonition note">
<p class="admonition-title">Note</p>
<p>The middleware functionality could be implemented as a separate device called KNX IoT router.
It is connected to the same IP network as the KNX IP router.</p>
<p>The KNX IoT router is responsible for transmitting data in both directions as follows:</p>
<ul class="simple">
<li><p>From KNX IoT Point API devices through the Thread Border Router to non-IoT KNX devices through the KNX IP router.</p></li>
<li><p>From non-IoT KNX devices through the KNX IP router to KNX IoT Point API devices through the Thread Border Router.</p></li>
</ul>
<p>Moreover, if it is needed, and there are enough hardware resources, this feature can be implemented as an additional service on the Thread Border Router device.</p>
</div>
</div></blockquote>
<p>The diagram below presents a sample of the KNX installation that combines KNX devices using various communication methods within a single system:</p>
<div class="figure align-default">
<img alt="Sample KNX installation consisting of KNX IoT and non-IoT devices." src="_images/knx_iot_sys_sample.svg" /></div>
<p>To get more details on the KNX IoT and KNX IoT Point API, see the sources listed on the <a class="reference internal" href="additional_resources.html#additional-resources"><span class="std std-ref">Additional resources</span></a> page.</p>
</div>
</div>
</div>
</div>
<footer>
<div class="rst-footer-buttons" role="navigation" aria-label="footer navigation">
<a href="environment_setup.html" class="btn btn-neutral float-right" title="Requirements and setup" accesskey="n" rel="next">Next <span class="fa fa-arrow-circle-right"></span></a>
<a href="index.html" class="btn btn-neutral" title="Welcome to nRF Connect SDK – KNX IoT Point API" accesskey="p" rel="prev"><span class="fa fa-arrow-circle-left"></span> Previous</a>
</div>
<hr/>
<div role="contentinfo">
<table>
<tr>
<td>
<p>
© Copyright 2023, Nordic Semiconductor.
</p>
</td>
<td id="nordiclogo">
<a href="https://www.nordicsemi.com/"><img src="_static/images/nordic.svg" border="0"/></a>
</td>
</tr>
</table>
</div>
Built with <a href="http://sphinx-doc.org/">Sphinx</a> using a <a href="https://github.com/rtfd/sphinx_rtd_theme">theme</a> provided by <a href="https://readthedocs.org">Read the Docs</a>.
</footer>
</div>
</div>
</section>
</div>
<script type="text/javascript">
jQuery(function () {
SphinxRtdTheme.Navigation.enable(true);
});
</script>
</body>
</html>