We've released python libraries to make it lighting fast to start automating test and development tasks with a Binho Nova Multi-Protocol USB Host Adapter. The packaged releases contains two libraries:
This library is essentially a wrapper for all of the commands presented in the ASCII Command Set documentation. The library is written in such a way to support multiple devices as well as properly handling INTERRUPTS by making use of threads.
This library provides a handful of functions which aid in device management, as in identifying COM ports and Binho devices attached to the host computer.
The officially-supported Python library can easily be installed using pip:
pip install binho-host-adapter
This library is cross-platform and is intended for use with Python 3.x. Source code can be found here.
Let's use the binhoUtilities class to find devices attached to this computer. Start by creating a new python script, call it binhoDemo.py
, and enter the following code:
binhoDemo.pyfrom binhoHostAdapter import binhoUtilitiesfrom binhoHostAdapter import binhoHostAdapter​utilities = binhoUtilities.binhoUtilities()devices = utilities.listAvailableDevices()​print('Binho Host Adapters Found On The Following Ports:')print(devices)
Make sure your device is plugged in and then run the script. A list of ports where Binho devices have been found will be printed to the screen.
Now that you know how to use the binhoUtilities
class to discover devices, let's extend the script to connect with the first device it discovers. We'll leave a comment where we'll implement our desired functionality later in Step #4, and then just immediately close the connection and exit.
binhoDemo.pyfrom binhoHostAdapter import binhoUtilitiesfrom binhoHostAdapter import binhoHostAdapter​utilities = binhoUtilities.binhoUtilities()devices = utilities.listAvailableDevices()​print('Binho Host Adapters Found On The Following Ports:')print(devices)print()​# Make sure at least one binho device was found before proceedingif len(devices) < 1:print('No Binho Host Adapter found...Quitting script')exit(1)​# Target the port of the first device in the listtargetPort = devices[0]print('Connecting to host adapter on ' + targetPort)print()​# Connect to the binho device on the target portbinho = binhoHostAdapter.binhoHostAdapter(targetPort)print('Connected!')print()​## Here's where we'll implement our desired functionality, see Step #4#​# Close the connection to the device before exitingbinho.close()print('Connection closed!')print()​# Exit gracefullyexit(0)
Now that we have a basic script which handles device discovery, connection, and disconnection, all that's left to do is implement our desired functionality. The simple example below shows how to generate a PWM signal on IO0.
binhoDemo.pyfrom binhoHostAdapter import binhoUtilitiesfrom binhoHostAdapter import binhoHostAdapter​utilities = binhoUtilities.binhoUtilities()devices = utilities.listAvailableDevices()​print('Binho Host Adapters Found On The Following Ports:')print(devices)print()​# Make sure at least one binho device was found before proceedingif len(devices) < 1:print('No Binho Host Adapter found...Quitting script')exit(1)​# Target the port of the first device in the listtargetPort = devices[0]print('Connecting to host adapter on ' + targetPort)print()​# Connect to the binho device on the target portbinho = binhoHostAdapter.binhoHostAdapter(targetPort)print('Connected!')print()​# Set the LED color to GREENbinho.setLEDColor('GREEN')print('Set LED to Green')print()​# Set the operation mode to IObinho.setOperationMode(0, 'IO')​# Set IO0 to PWM modebinho.setIOpinMode(0, 'PWM')​# Set IO0 PWM Frequency to 75kHzbinho.setIOpinPWMFreq(0, 75000)​# Set IO0 PWM duty cycle to 512/1024binho.setIOpinValue(0, 512)print('IO0 set to PWM with 50% duty cycle / 75kHz frequency')print()​# Close the connection to the device before exitingbinho.close()print('Connection closed!')print()​# Exit gracefullyexit(0)
We've just covered the most basic case of using the Python libraries to automate your Binho Nova. The full documentation of the python libraries can be found here:
And example Python scripts which demonstrate all of the various protocols and features of the Binho Nova can be found here: