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