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
|
---
layout: default
title: Introduction
nav_order: 1
---
# [](#header-1)Introduction
# [](#header-2)Simple Example:
XKNX is using [asyncio](https://www.python.org/dev/peps/pep-3156/) for single-threaded concurrent code using coroutines.
This allows concurrency in a thread safe manner.
```python
import asyncio
from xknx import XKNX
async def main():
xknx = XKNX()
await xknx.start()
# USING THE XKNX OBJECT, e.g. for
# controlling lights, dimmers, shutters
await xknx.stop()
asyncio.run(main())
```
# [](#header-2)Explanation En Détail:
```python
async def main():
```
`main()` function. The `async` qualifier marks the function asy an asyncio function. See [asyncio](https://www.python.org/dev/peps/pep-3156/) documentation for details.
```python
xknx = XKNX()
```
Initialization of XKNX object. Constructor may take several arguments like a reference to the asyncio-loop or various callbacks for device updates or telegram received. See [XKNX object documentation](/xknx) for details.
```python
await xknx.start()
```
Asynchronous start of the XKNX object. `xknx.start()` will connect to a KNX/IP device and either build a tunnel or connect through Multicast UDP.
```python
await xknx.stop()
```
Asynchronous stop of the XKNX object. `xknx.stop()` will disconnect from Tunnels - which is important bc most of the devices have a limited amount of channels.
|
