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-2025 WPC Systems Ltd. All rights reserved.
 33'''
 34
 35## WPC
 36from wpcsys import pywpc
 37
 38
 39def 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 AIO module to slot
 58        mode = 0
 59        timeout = 3  ## [sec]
 60        chip_select = [0, 1]
 61
 62        ## Get firmware model & version
 63        driver_info = dev.Sys_getDriverInfo(timeout)
 64        print(f"Model name: {driver_info[0]}, Firmware version: {driver_info[-1]} ")
 65
 66        ## Get slot mode
 67        slot_mode = dev.Sys_getMode(slot, timeout)
 68        print("Slot mode:", slot_mode)
 69
 70        ## If the slot mode is not set to "AIO", set the slot mode to "AIO"
 71        if slot_mode != "AIO":
 72            err = dev.Sys_setAIOMode(slot, timeout)
 73            print(f"Sys_setAIOMode in slot {slot}, status: {err}")
 74
 75        ## Get slot mode
 76        slot_mode = dev.Sys_getMode(slot, timeout)
 77        print("Slot mode:", slot_mode)
 78
 79        ## Open AI
 80        err = dev.AI_open(slot, timeout)
 81        print(f"AI_open in slot {slot}, status: {err}")
 82
 83        ## Enable CS
 84        err = dev.AI_enableCS(slot, chip_select, timeout)
 85        print(f"AI_enableCS in slot {slot}, status: {err}")
 86
 87        ## Set AI acquisition mode to on demand mode (0)
 88        err = dev.AI_setMode(slot, mode, timeout)
 89        print(f"AI_setMode {mode} in slot {slot}, status: {err}")
 90
 91        ## Read AI
 92        ai_list = dev.AI_readOnDemand(slot, timeout)
 93        print(f"data in slot {slot}: {ai_list}")
 94
 95        ## Close AI
 96        err = dev.AI_close(slot, timeout)
 97        print(f"AI_close in slot {slot}, status: {err}")
 98    except Exception as err:
 99        pywpc.printGenericError(err)
100
101    finally:
102        ## Disconnect device
103        dev.disconnect()
104
105        ## Release device handle
106        dev.close()
107
108
109if __name__ == '__main__':
110    main()