DIO loopback pins

  1'''
  2DIO - DIO_loopback_pins.py with asynchronous mode.
  3
  4This example demonstrates the process of DIO loopback using pins from STEM.
  5It involves using DO pins to send signals and DI pins to receive signals on a single device, commonly known as "loopback".
  6
  7To begin with, it illustrates the steps required to open the DO and DI pins.
  8Next, it performs the operation of writing to a DO pin and reading from a DI pin.
  9Lastly, it concludes by closing the DO and DI pins.
 10
 11If your product is "STEM", please invoke the function `Sys_setDIOMode_async`.
 12
 13The DIO ports 0 to 1 are assigned to slot 1, while ports 2 to 3 are assigned to slot 2.
 14---------------------------
 15|  Slot 1    port 1 & 0   |
 16|  Slot 2    port 3 & 2   |
 17|  Slot 3    port 5 & 4   |
 18|  Slot 4    port 7 & 6   |
 19---------------------------
 20
 21-------------------------------------------------------------------------------------
 22Please change correct serial number or IP and port number BEFORE you run example code.
 23
 24For other examples please check:
 25    https://github.com/WPC-Systems-Ltd/WPC_Python_driver_release/tree/main/examples
 26See README.md file to get detailed usage of this example.
 27
 28Copyright (c) 2022-2025 WPC Systems Ltd. All rights reserved.
 29'''
 30
 31## WPC
 32from wpcsys import pywpc
 33
 34## Python
 35import asyncio
 36import sys
 37sys.path.insert(0, 'src/')
 38
 39
 40async def main():
 41    ## Get Python driver version
 42    print(f'{pywpc.PKG_FULL_NAME} - Version {pywpc.__version__}')
 43
 44    ## Create device handle
 45    dev = pywpc.STEM()
 46
 47    ## Connect to device
 48    try:
 49        dev.connect("192.168.1.110")  ## Depend on your device
 50    except Exception as err:
 51        pywpc.printGenericError(err)
 52        ## Release device handle
 53        dev.close()
 54        return
 55
 56    try:
 57        ## Parameters setting
 58        slot = 1  ## Connect DIO module to slot
 59        DO_port = 0
 60        DI_port = 1
 61        DO_pins = [0, 1, 2, 3]
 62        DI_pins = [4, 5, 6, 7]
 63        DO_value = [1, 0, 1, 0]
 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 "DIO", set the slot mode to "DIO"
 74        if slot_mode != "DIO":
 75            err = await dev.Sys_setDIOMode_async(slot)
 76            print(f"Sys_setDIOMode_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        ## Get DIO start up information
 83        info = await dev.DIO_loadStartup_async(DO_port)
 84        print(f"Enable: {info[0]}")
 85        print(f"Direction: {info[1]}")
 86        print(f"State: {info[2]}")
 87
 88        ## Write pins to high or low
 89        err = await dev.DO_writePins_async(DO_port, DO_pins, DO_value)
 90        print(f"DO_writePins_async in DO_port {DO_port}, status: {err}")
 91
 92        ## Read pins state
 93        state_list = await dev.DI_readPins_async(DI_port, DI_pins)
 94        print(f"state_list_async in DI_port {DI_port}: {state_list}")
 95    except Exception as err:
 96        pywpc.printGenericError(err)
 97
 98    finally:
 99        ## Disconnect device
100        dev.disconnect()
101
102        ## Release device handle
103        dev.close()
104
105
106def main_for_spyder(*args):
107    if asyncio.get_event_loop().is_running():
108        return asyncio.create_task(main(*args)).result()
109    else:
110        return asyncio.run(main(*args))
111
112
113if __name__ == '__main__':
114    asyncio.run(main())  ## Use terminal
115    # await main()  ## Use Jupyter or IPython(>=7.0)
116    # main_for_spyder()  ## Use Spyder