Set device alias

 1'''
 2System_ETH - set_device_alias.py with asynchronous mode.
 3
 4This example demonstrates how to set device alias from EthanI.
 5
 6-------------------------------------------------------------------------------------
 7Please change correct serial number or IP and port number BEFORE you run example code.
 8
 9For other examples please check:
10    https://github.com/WPC-Systems-Ltd/WPC_Python_driver_release/tree/main/examples
11See README.md file to get detailed usage of this example.
12
13Copyright (c) 2022-2024 WPC Systems Ltd. All rights reserved.
14'''
15
16## Python
17import asyncio
18
19## WPC
20
21from wpcsys import pywpc
22
23async def main():
24    ## Get Python driver version
25    print(f'{pywpc.PKG_FULL_NAME} - Version {pywpc.__version__}')
26
27    ## Create device handle
28    dev = pywpc.EthanI()
29
30    ## Connect to device
31    try:
32        dev.connect("192.168.1.110") ## Depend on your device
33    except Exception as err:
34        pywpc.printGenericError(err)
35        ## Release device handle
36        dev.close()
37        return
38
39    try:
40        ## Parameters setting
41        alias_name = "WPC_1234"
42
43        ## Get firmware model & version
44        driver_info = await dev.Sys_getDriverInfo_async()
45        print("Model name: " + driver_info[0])
46        print("Firmware version: " + driver_info[-1])
47
48        ## Set device alias
49        err = await dev.Sys_setDeviceAlias_async(alias_name)
50        print(f"Sys_setDeviceAlias_async, status: {err}")
51    except Exception as err:
52        pywpc.printGenericError(err)
53
54    ## Disconnect network device
55    dev.disconnect()
56
57    ## Release device handle
58    dev.close()
59
60    return
61
62def main_for_spyder(*args):
63    if asyncio.get_event_loop().is_running():
64        return asyncio.create_task(main(*args)).result()
65    else:
66        return asyncio.run(main(*args))
67
68if __name__ == '__main__':
69    asyncio.run(main()) ## Use terminal
70    # await main() ## Use Jupyter or IPython(>=7.0)
71    # main_for_spyder() ## Use Spyder