AI on demand once

  1'''
  2AI - AI_on_demand_once.py with synchronous 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`and `AI_enableCS`.
 12Example: AI_enableCS is {0, 2}
 13Subsequently, the returned value of AI_readOnDemand and AI_readStreaming 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-2024 WPC Systems Ltd. All rights reserved.
 33'''
 34
 35## Python
 36import time
 37
 38## WPC
 39
 40from wpcsys import pywpc
 41
 42
 43def main():
 44    ## Get Python driver version
 45    print(f'{pywpc.PKG_FULL_NAME} - Version {pywpc.__version__}')
 46
 47    ## Create device handle
 48    dev = pywpc.STEM()
 49
 50    ## Connect to device
 51    try:
 52        dev.connect("192.168.1.110") ## Depend on your device
 53    except Exception as err:
 54        pywpc.printGenericError(err)
 55        ## Release device handle
 56        dev.close()
 57        return
 58
 59    try:
 60        ## Parameters setting
 61        slot = 1 ## Connect AIO module to slot
 62        mode = 0
 63        timeout = 3 ## second
 64        chip_select = [0, 1]
 65
 66        ## Get firmware model & version
 67        driver_info = dev.Sys_getDriverInfo(timeout)
 68        print("Model name: " + driver_info[0])
 69        print("Firmware version: " + driver_info[-1])
 70
 71        ## Get slot mode
 72        slot_mode = dev.Sys_getMode(slot, timeout)
 73        print("Slot mode:", slot_mode)
 74
 75        ## If the slot mode is not set to "AIO", set the slot mode to "AIO"
 76        if slot_mode != "AIO":
 77            err = dev.Sys_setAIOMode(slot, timeout)
 78            print(f"Sys_setAIOMode in slot {slot}, status: {err}")
 79
 80        ## Get slot mode
 81        slot_mode = dev.Sys_getMode(slot, timeout)
 82        print("Slot mode:", slot_mode)
 83
 84        ## Open AI
 85        err = dev.AI_open(slot, timeout)
 86        print(f"AI_open in slot {slot}, status: {err}")
 87
 88        ## Enable CS
 89        err = dev.AI_enableCS(slot, chip_select, timeout)
 90        print(f"AI_enableCS in slot {slot}, status: {err}")
 91
 92        ## Set AI acquisition mode to on demand mode (0)
 93        err = dev.AI_setMode(slot, mode, timeout)
 94        print(f"AI_setMode {mode} in slot {slot}, status: {err}")
 95
 96        ## Read AI
 97        ai_list = dev.AI_readOnDemand(slot, timeout)
 98        print(f"data in slot {slot}: {ai_list}")
 99
100        ## Close AI
101        err = dev.AI_close(slot, timeout)
102        print(f"AI_close in slot {slot}, status: {err}")
103    except Exception as err:
104        pywpc.printGenericError(err)
105
106    ## Disconnect device
107    dev.disconnect()
108
109    ## Release device handle
110    dev.close()
111
112    return
113
114if __name__ == '__main__':
115    main()