pyAPIUSBP.DIO - Digital Input/Output Units

class pyAPIUSBP.DIO.DIO(deviceName)

echoBackBit(bitNo)

This method reads status of a logical output bit. If your device has 4 output ports (each port has 8 bit output), logical output bit is 0 to 31.

Parameters:bitNo (int) – Logical output bit number. Returns:Status of the bit (0 or 1).

echoBackByte(portNo)

This method reads status of a logical output port.

Parameters:portNo (int) – Logical output port number. The first port of the device is 0, and the following ports are 1, 2, 3... Use getMaxPorts() to query how many ports your device has. Returns:Status of the port (0-255).

echoBackMultiBit(bitList)

This method reads status of multiple logical input bits.

Parameters:bitList (int) – List of logical input bit numbers. Returns:List of status each logical bit.

echoBackMultiByte(portList)

This method reads status of multiple logical input ports.

Parameters:portList (int) – List of logical input port numbers. Returns:List of status each logical port.

getErrorString(code)

This method translates error code to error string.

Parameters:code (int) – Error code of Contec API-USBP DIO functions.

getMaxPorts()

This method returns number of available ports.

inputBit(bitNo)

This method reads a logical input bit. If your device has 4 input ports (each port has 8 bit input), logical input bit is 0 to 31.

Parameters:bitNo (int) – Logical input bit number. Returns:Data (0 or 1).

inputByte(portNo)

This method reads 1 byte data from a logical input port.

Parameters:portNo (int) – Logical input port number. The first port of the device is 0, and the following ports are 1, 2, 3... Use getMaxPorts() to query how many ports your device has. Returns:Data (0-255).

inputMultiBit(bitList)

This method reads data from multiple logical input bits.

Parameters:bitList (int) – List of logical input bit numbers. Returns:List of data read from each logical bit.

inputMultiByte(portList)

This method reads data from multiple logical input ports.

Parameters:portList (int) – List of logical input port numbers. Returns:List of data read from each logical port.

outputBit(bitNo, data)

This method writes 0 or 1 to a logical output bit. If your device has 4 output ports (each port has 8 bit output), logical output bit is 0 to 31.

Parameters:

• bitNo (int) – Logical output bit number.
• data (int) – Data to be written. Note that the value must be 0 or 1.

outputByte(portNo, data)

This method writes 1 byte data to a logical output port.

Parameters:

• portNo (int) – Logical output port number. The first port of the device is 0, and the following ports are 1, 2, 3... Use getMaxPorts() to query how many ports your device has.
• data (int) – Data to be written. Note that the value must be between 0 to 255 (unsigned byte).

outputMultiBit(bitList, data)

This method writes data to multiple logical output bits.

Parameters:

• bitList – List of logical output bit numbers.
• data – List of data to be written to each output bit.

outputMultiByte(portList, data)

This method writes data to multiple logical output ports.

Parameters:

• portList – List of logical output port numbers.
• data – List of data to be written to each output port.

reset()

This method resets device.

pyAPIUSBP.DIO.queryDioDeviceName()

Query names of available DIO devices.

Returns:A list of device name and product name. For example, if two DIO-0808TY-USBs are available whose device names are DIO000 and DIO001, following list is returned. [[‘DIO000’, ‘DIO-0808TY-USB’], [‘DIO001’, ‘DIO-0808TY-USB’]]