# Python Wrapper (legacy)

## Notice!

Our initial python library was actually what would best be described as a 'wrapper'. It simply wrapped our ASCII commands into a set of equivalent Python functions. This served as well, but was a temporary solution to buy us time to produce a much more powerful library. We highly encourage everyone to use our new Python package which is packed with features:

{% content-ref url="/pages/-MVTDXIh\_maiAFzX2204" %}
[Binho Python Package](/python-libraries/binho-python-package.md)
{% endcontent-ref %}

This page and the others in this section are left for historical purposes. This 'wrapper' library remains available and we'll continue to support customers using it, however all future improvements will be implemented only in our new library.

## Documentation

The packaged releases contains two libraries:

#### binhoHostAdapter

This library is essentially a wrapper for all of the commands presented in the [ASCII Command Set ](https://support.binho.io/user-guide/ascii-interface)documentation. The library is written in such a way to support multiple devices as well as [properly handling INTERRUPTS](https://support.binho.io/user-guide/using-the-device/receiving-interrupts) by making use of threads.

{% content-ref url="/pages/-LbeyODC6Vx74ySYpSZe" %}
[binhoHostAdapter](/python-libraries/python-wrapper/binhohostadapter.md)
{% endcontent-ref %}

#### binhoUtilities

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.

{% content-ref url="/pages/-LbewTWsXlI6o9k8FsRf" %}
[binhoUtilities](/python-libraries/python-wrapper/binhoutilities.md)
{% endcontent-ref %}

Here's where the releases live on PyPi:

{% embed url="<https://pypi.org/project/binho-host-adapter/>" %}

## Installation <a href="#installation" id="installation"></a>

The officially-supported Python library can easily be installed using pip:

```bash
pip install binho-host-adapter
```

This library is cross-platform and is intended for use with Python 3.x.

## Example Usage <a href="#example-usage" id="example-usage"></a>

```python
from binhoHostAdapter import binhoHostAdapter
from binhoHostAdapter import binhoUtilities

print("Demo Script with Binho Host Adapter Python Libraries")
print

utilities = binhoUtilities.binhoUtilities()
devices = utilities.listAvailableDevices()

if len(devices) == 0:
	print("No Devices Found!")
	exit()

elif len(devices) == 1:
	COMPORT = devices[0]
	print("Found 1 attached adapter @ " + devices[0])
	print
else:
	COMPORT = devices[0]
	print("Found more than 1 attached adapter, using first device found on " + COMPORT)
	print

print("Opening " + COMPORT + "...")
print

# create the binhoHostAdapter object
binho = binhoHostAdapter.binhoHostAdapter(COMPORT)

print("Connecting to host adapter...")
print(binho.getDeviceID())
print
```

There are also many examples of the python libraries in action in the examples section of the support portal:

{% content-ref url="/pages/-Lgu3BHabGxPhpHMSXLh" %}
[Examples](/python-libraries/python-wrapper/examples.md)
{% endcontent-ref %}

## API Reference <a href="#api-reference" id="api-reference"></a>

The library contains two classes, each with a distinct purpose. Please see the following pages for the documentation on each of these classes.

Functions to connect to a host adapter and interact with it:

{% content-ref url="/pages/-LbeyODC6Vx74ySYpSZe" %}
[binhoHostAdapter](/python-libraries/python-wrapper/binhohostadapter.md)
{% endcontent-ref %}

Utility functions for device discovery and management:

{% content-ref url="/pages/-LbewTWsXlI6o9k8FsRf" %}
[binhoUtilities](/python-libraries/python-wrapper/binhoutilities.md)
{% endcontent-ref %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://csupport.binho.io/python-libraries/python-wrapper.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.