Acroname BrainStem Software Control Package
The BrainStem python package gives access to simple python commands to control and interact with a collection of BrainStem devices
[project_root]/development/python
to find the latest version of the brainstem-*.whl
On Windows, to install a new version of BrainStem (or update an existing one), simply execute:
$> pip install --user brainstem --upgrade
Or from wheel file:
$> pip install --user brainstem-*.whl --upgrade
On MacOS and Linux, pip is for the older Python 2 version, pip3 must be executed instead:
$ pip3 install --user brainstem --upgrade
Or from wheel file:
$ pip3 install --user brainstem-*.whl --upgrade
To uninstall the library, the easiest way is with pip:
Windows:
$> pip uninstall brainstem
MacOS and Linux:
$> pip3 uninstall brainstem
Additional Requirements
section near the bottom of this documentAfter navigating to [project_root]/development/python_examples
, choose the folder that corresponds with the product being used.
For example, the most common product sold is Acroname's 8-port hub, so the folder needed in this case will be usbhub3p_example
.
To run the example, execute:
$> python usbhub3p_example.py
for your specific BrainStem device.
The example requires that a USB BrainStem link module be connected to the host computer.
If the following message is seen, there is likely no module connected or the incorrect example program was run:
'Could not find a module.'
Once the example starts running, it will print out some basic information about the module and then blink the user LED on the module.
The following is a brief introduction to writing a python program that talks to a connected BrainStem:
Start up the python interpreter:
$> python
The first step is to import the BrainStem package:
>>> import brainstem
stem
and discover
are the two primary modules
stem
contains classes for each of the distinct module types:
Next search for all connected modules:
>>> specs = brainstem.discover.findAllModules(brainstem.link.Spec.USB)
>>> print [str(s) for s in specs]
Then search for the first USB module:
>>> spec = brainstem.discover.findFirstModule(brainstem.link.Spec.USB)
>>> print spec
If a USB module is found, create a USBStem object and connect to it using the spec object that was returned by discover:
>>> stem = brainstem.stem.USBStem()
>>> stem.connectFromSpec(spec)
Then get some information about the module:
>>> result = stem.system.getModel()
>>> print brainstem.defs.model_info(result.value)
Finally, flash the user LED, on or off every 100ms.
>>> from time import sleep
>>> for i in range(0,51):
... err = stem.system.setLED(i % 2)
... if err != brainstem.result.Result.NO_ERROR:
... break
... sleep(0.1)
...
>>>
That's it! Once this basic example is running, a good place to go is the documentation to learn about all the other features available.
At the prompt type the following:
>>> help(stem.system)
# or
>>> help(brainstem.stem)
The BrainStem python package is currently compatible with python 2.7 and python 3.6 through 3.10. When using 2.7 it is recommended that your python version be at least 2.7.9.
MS Windows generally does not include Python, and a suitable Python package will need to be downloaded and installed before proceeding with the following guide.
The BrainStem wheel is compatible with both 32 and 64bit python packages.
Python version >= 2.7.9 is recommended.
MacOS X and most Linux distributions generally include a Python installation.
However, the installation may not include pip and setuptools which are required to install the BrainStem Python module.
The BrainStem python package is installed via a platform specific wheel.
To install these wheels, a relatively up to date version of pip and setuptools is needed.
Pip can be installed by following the instructions at:
https://pip.pypa.io/en/latest/installing.html
If pip is installed it may still be helpful to update pip.
Administrator privileges may be required on MacOS and Linux.
Instructions for updating pip can be found at:
https://pip.pypa.io/en/latest/installing.html#upgrade-pip
The BrainStem python library relies on libffi.
On MacOS X and Windows, this is generally available.
Linux users may need to install libffi via the distro's package manager.
The package is generally named libffi-dev or similar.
Linux users may need to install the development package for python
via the distro's package manager before the brainstem wheel can be installed.
The package is generally named python-dev or similar.
On CentOS and yum based distros the following command will install the required packages:
$> sudo yum install libffi-devel python-devel
If these troubleshooting steps don't solve the issue, please let us know.
We have a mailing list located at: support@acroname.com
and a support page to get in touch with Acroname support staff.
Enjoy!
The Acroname Team.