DO write port

  1'''
  2DIO - DO_write_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, voltage output is written to the DO port.
  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-2024 WPC Systems Ltd. All rights reserved.
 28'''
 29
 30## Python
 31import asyncio
 32
 33## WPC
 34
 35from wpcsys import pywpc
 36
 37
 38async def 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        DO_value = [1, 0, 1, 0]
 59
 60        ## Get firmware model & version
 61        driver_info = await dev.Sys_getDriverInfo_async()
 62        print("Model name: " + driver_info[0])
 63        print("Firmware version: " + driver_info[-1])
 64
 65        ## Get slot mode
 66        slot_mode = await dev.Sys_getMode_async(slot)
 67        print("Slot mode:", slot_mode)
 68
 69        ## If the slot mode is not set to "DIO", set the slot mode to "DIO"
 70        if slot_mode != "DIO":
 71            err = await dev.Sys_setDIOMode_async(slot)
 72            print(f"Sys_setDIOMode_async in slot {slot}, status: {err}")
 73
 74        ## Get slot mode
 75        slot_mode = await dev.Sys_getMode_async(slot)
 76        print("Slot mode:", slot_mode)
 77
 78        ## Get DIO start up information
 79        info = await dev.DIO_loadStartup_async(DO_port)
 80        print("Enable:   ", info[0])
 81        print("Direction:", info[1])
 82        print("State:    ", info[2])
 83
 84        ## Write port to high or low
 85        err = await dev.DO_writePort_async(DO_port, DO_value)
 86        print(f"DO_writePort_async in port {DO_port}, status: {err}")
 87    except Exception as err:
 88        pywpc.printGenericError(err)
 89
 90    ## Disconnect device
 91    dev.disconnect()
 92
 93    ## Release device handle
 94    dev.close()
 95
 96    return
 97
 98def main_for_spyder(*args):
 99    if asyncio.get_event_loop().is_running():
100        return asyncio.create_task(main(*args)).result()
101    else:
102        return asyncio.run(main(*args))
103if __name__ == '__main__':
104    asyncio.run(main()) ## Use terminal
105    # await main() ## Use Jupyter or IPython(>=7.0)
106    # main_for_spyder() ## Use Spyder