Python Tutorial - Hello World¶

This tutorial describes the simplest implementation of UTIM-Uhost usage

Uhost¶

Code of this example here.

Steps:

Import from Uhost library

from uhost import uhost
from uhost.utilities.exceptions import UtimConnectionException, UtimInitializationError

Create Uhost object and run it
```
uh1 = uhost.Uhost()
uh1.run()
```
Finally, stop Utim before exit
```
uh1.stop()
```

UTIM¶

Code of this example here.

Steps:

Import from UTIM library

from utim.connectivity.manager import ConnectivityConnectError
from utim.utim import Utim
from utim.connectivity import DataLinkManager, TopDataType
from utim.connectivity.manager import ConnectivityManager
from utim.utilities.tag import Tag
from utim.utilities.exceptions import UtimConnectionException, UtimInitializationError

Initialize two queues - first is for receiving and second is for transmitting
```
rx_queue = queue.Queue()
tx_queue = queue.Queue()
```
Initialize ConnectivityManager - utility to read data from queues. To use queues to send and receive data you should set argument dl_type=DataLinkManager.TYPE_QUEUE to ConnectifityManager
```
cm1 = ConnectivityManager()
cm1.connect(dl_type=DataLinkManager.TYPE_QUEUE, rx=tx_queue, tx=rx_queue)
```

Create UTIM object and run it

concrete_utim = Utim()
concrete_utim.connect(dl_type=DataLinkManager.TYPE_QUEUE, rx=rx_queue, tx=tx_queue)
concrete_utim.run()

Send data to start communication:

data1 = [TopDataType.DEVICE, Tag.INBOUND.NETWORK_READY]
cm1.send(data1)

Wait for session key and stop it when the key is received

while True:
    data = cm1.receive()
    if data:
        session_key = data[1]
        concrete_utim.stop()
        break

Finally, stop Utim (if not stopped) and ConnectivityManager before exit
```
concrete_utim.stop()

cm1.stop()
```