1'''
2AI - AI_on_demand_once.py with asynchronous mode.
3
4This example demonstrates the process of obtaining AI data in on demand mode.
5Additionally, it retrieve AI data from STEM.
6
7To begin with, it demonstrates the steps to open the AI and configure the AI parameters.
8Next, it outlines the procedure for reading the AI on demand data.
9Finally, it concludes by explaining how to close the AI.
10
11If your product is "STEM", please invoke the function `Sys_setAIOMode_async`and `AI_enableCS_async`.
12Example: AI_enableCS_async is {0, 2}
13Subsequently, the returned value of AI_readOnDemand_async and AI_readStreaming_async will be displayed as follows.
14data:
15 CH0, CH1, CH2, CH3, CH4, CH5, CH6, CH7, CH0, CH1, CH2, CH3, CH4, CH5, CH6, CH7
16 | | |
17 |---------------- CS0-----------------|---------------- CS2------------------|
18[sample0]
19[sample1]
20 .
21 .
22 .
23[sampleN]
24
25-------------------------------------------------------------------------------------
26Please change correct serial number or IP and port number BEFORE you run example code.
27
28For other examples please check:
29 https://github.com/WPC-Systems-Ltd/WPC_Python_driver_release/tree/main/examples
30See README.md file to get detailed usage of this example.
31
32Copyright (c) 2022-2025 WPC Systems Ltd. All rights reserved.
33'''
34
35## WPC
36from wpcsys import pywpc
37
38## Python
39import asyncio
40import sys
41sys.path.insert(0, 'src/')
42
43
44async def main():
45 ## Get Python driver version
46 print(f'{pywpc.PKG_FULL_NAME} - Version {pywpc.__version__}')
47
48 ## Create device handle
49 dev = pywpc.STEM()
50
51 ## Connect to device
52 try:
53 dev.connect("192.168.1.110") ## Depend on your device
54 except Exception as err:
55 pywpc.printGenericError(err)
56 ## Release device handle
57 dev.close()
58 return
59 try:
60 ## Parameters setting
61 slot = 1 ## Connect AIO module to slot
62 mode = 0
63 chip_select = [0, 1]
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 "AIO", set the slot mode to "AIO"
74 if slot_mode != "AIO":
75 err = await dev.Sys_setAIOMode_async(slot)
76 print(f"Sys_setAIOMode_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 ## Open AI
83 err = await dev.AI_open_async(slot)
84 print(f"AI_open_async in slot {slot}, status: {err}")
85
86 ## Enable CS
87 err = await dev.AI_enableCS_async(slot, chip_select)
88 print(f"AI_enableCS_async in slot {slot}, status: {err}")
89
90 ## Set AI acquisition mode to on demand mode (0)
91 err = await dev.AI_setMode_async(slot, mode)
92 print(f"AI_setMode_async {mode} in slot {slot}, status: {err}")
93
94 ## Read AI
95 ai_list = await dev.AI_readOnDemand_async(slot)
96 print(f"data in slot {slot}: {ai_list}")
97
98 ## Close AI
99 err = await dev.AI_close_async(slot)
100 print(f"AI_close_async in slot {slot}, status: {err}")
101 except Exception as err:
102 pywpc.printGenericError(err)
103
104 finally:
105 ## Disconnect device
106 dev.disconnect()
107
108 ## Release device handle
109 dev.close()
110
111
112def main_for_spyder(*args):
113 if asyncio.get_event_loop().is_running():
114 return asyncio.create_task(main(*args)).result()
115 else:
116 return asyncio.run(main(*args))
117
118
119if __name__ == '__main__':
120 asyncio.run(main()) ## Use terminal
121 # await main() ## Use Jupyter or IPython(>=7.0)
122 # main_for_spyder() ## Use Spyder