1'''
2DIO - DIO_loopback_pins.py with asynchronous mode.
3
4This example demonstrates the process of DIO loopback using pins from STEM.
5It involves using DO pins to send signals and DI pins to receive signals on a single device, commonly known as "loopback".
6
7To begin with, it illustrates the steps required to open the DO and DI pins.
8Next, it performs the operation of writing to a DO pin and reading from a DI pin.
9Lastly, it concludes by closing the DO and DI pins.
10
11If your product is "STEM", please invoke the function `Sys_setDIOMode_async`.
12
13The DIO ports 0 to 1 are assigned to slot 1, while ports 2 to 3 are assigned to slot 2.
14---------------------------
15| Slot 1 port 1 & 0 |
16| Slot 2 port 3 & 2 |
17| Slot 3 port 5 & 4 |
18| Slot 4 port 7 & 6 |
19---------------------------
20
21-------------------------------------------------------------------------------------
22Please change correct serial number or IP and port number BEFORE you run example code.
23
24For other examples please check:
25 https://github.com/WPC-Systems-Ltd/WPC_Python_driver_release/tree/main/examples
26See README.md file to get detailed usage of this example.
27
28Copyright (c) 2022-2025 WPC Systems Ltd. All rights reserved.
29'''
30
31## WPC
32from wpcsys import pywpc
33
34## Python
35import asyncio
36import sys
37sys.path.insert(0, 'src/')
38
39
40async def main():
41 ## Get Python driver version
42 print(f'{pywpc.PKG_FULL_NAME} - Version {pywpc.__version__}')
43
44 ## Create device handle
45 dev = pywpc.STEM()
46
47 ## Connect to device
48 try:
49 dev.connect("192.168.1.110") ## Depend on your device
50 except Exception as err:
51 pywpc.printGenericError(err)
52 ## Release device handle
53 dev.close()
54 return
55
56 try:
57 ## Parameters setting
58 slot = 1 ## Connect DIO module to slot
59 DO_port = 0
60 DI_port = 1
61 DO_pins = [0, 1, 2, 3]
62 DI_pins = [4, 5, 6, 7]
63 DO_value = [1, 0, 1, 0]
64
65 ## Get firmware model & version
66 driver_info = await dev.Sys_getDriverInfo_async()
67 print(f"Model name: {driver_info[0]}, Firmware version: {driver_info[-1]} ")
68
69 ## Get slot mode
70 slot_mode = await dev.Sys_getMode_async(slot)
71 print("Slot mode:", slot_mode)
72
73 ## If the slot mode is not set to "DIO", set the slot mode to "DIO"
74 if slot_mode != "DIO":
75 err = await dev.Sys_setDIOMode_async(slot)
76 print(f"Sys_setDIOMode_async in slot {slot}, status: {err}")
77
78 ## Get slot mode
79 slot_mode = await dev.Sys_getMode_async(slot)
80 print("Slot mode:", slot_mode)
81
82 ## Get DIO start up information
83 info = await dev.DIO_loadStartup_async(DO_port)
84 print(f"Enable: {info[0]}")
85 print(f"Direction: {info[1]}")
86 print(f"State: {info[2]}")
87
88 ## Write pins to high or low
89 err = await dev.DO_writePins_async(DO_port, DO_pins, DO_value)
90 print(f"DO_writePins_async in DO_port {DO_port}, status: {err}")
91
92 ## Read pins state
93 state_list = await dev.DI_readPins_async(DI_port, DI_pins)
94 print(f"state_list_async in DI_port {DI_port}: {state_list}")
95 except Exception as err:
96 pywpc.printGenericError(err)
97
98 finally:
99 ## Disconnect device
100 dev.disconnect()
101
102 ## Release device handle
103 dev.close()
104
105
106def main_for_spyder(*args):
107 if asyncio.get_event_loop().is_running():
108 return asyncio.create_task(main(*args)).result()
109 else:
110 return asyncio.run(main(*args))
111
112
113if __name__ == '__main__':
114 asyncio.run(main()) ## Use terminal
115 # await main() ## Use Jupyter or IPython(>=7.0)
116 # main_for_spyder() ## Use Spyder