1'''
2DIO - DO_write_pins.py with synchronous mode.
3
4This example illustrates the process of writing a high or low signal to a DO pin from STEM.
5
6To begin with, it demonstrates the steps required to open the DO pin.
7Next, voltage output is written to the DO pin.
8Lastly, it concludes by closing the DO pin.
9
10If your product is "STEM", please invoke the function `Sys_setDIOMode`.
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-2024 WPC Systems Ltd. All rights reserved.
28'''
29
30## Python
31import time
32
33## WPC
34
35from wpcsys import pywpc
36
37
38def main():
39 ## Get Python driver version
40 print(f'{pywpc.PKG_FULL_NAME} - Version {pywpc.__version__}')
41
42 ## Create device handle
43 dev = pywpc.STEM()
44
45 ## Connect to device
46 try:
47 dev.connect("192.168.1.110") ## Depend on your device
48 except Exception as err:
49 pywpc.printGenericError(err)
50 ## Release device handle
51 dev.close()
52 return
53
54 try:
55 ## Parameters setting
56 slot = 1 ## Connect DIO module to slot
57 DO_port = 0
58 pin_index = [0, 1, 2, 3]
59 DO_value = [1, 0, 1, 0]
60 timeout = 3 ## second
61
62 ## Get firmware model & version
63 driver_info = dev.Sys_getDriverInfo(timeout)
64 print("Model name: " + driver_info[0])
65 print("Firmware version: " + driver_info[-1])
66
67 ## Get slot mode
68 slot_mode = dev.Sys_getMode(slot, timeout)
69 print("Slot mode:", slot_mode)
70
71 ## If the slot mode is not set to "DIO", set the slot mode to "DIO"
72 if slot_mode != "DIO":
73 err = dev.Sys_setDIOMode(slot, timeout)
74 print(f"Sys_setDIOMode in slot {slot}, status: {err}")
75
76 ## Get slot mode
77 slot_mode = dev.Sys_getMode(slot, timeout)
78 print("Slot mode:", slot_mode)
79
80 ## Get DIO start up information
81 info = dev.DIO_loadStartup(DO_port, timeout)
82 print("Enable: ", info[0])
83 print("Direction:", info[1])
84 print("State: ", info[2])
85
86 ## Write pins to high or low
87 err = dev.DO_writePins(DO_port, pin_index, DO_value, timeout)
88 print(f"DO_writePins in port {DO_port}, status: {err}")
89 except Exception as err:
90 pywpc.printGenericError(err)
91
92 ## Disconnect device
93 dev.disconnect()
94
95 ## Release device handle
96 dev.close()
97
98 return
99
100if __name__ == '__main__':
101 main()