Hippy is a Python® module designed to communicate with SoHal (the HP Sprout Immersive Computer's Hardware Abstraction Layer). The devices and methods in hippy mirror the SoHal spec, but hippy handles all of the websocket communication and JSONRPC-2.0 protocol for the user.
Note that the objects in the hippy module are not thread safe.
Using hippy, the user can create simple Python scripts to communicate with the devices. For example, to turn on the projector:
from hippy import Projector
p = Projector()
p.open()
p.on()
p.close()
To install hippy, you first need to install Python. Hippy has been tested with the 64 bit version of Python 3.7.7 which can be found here: https://www.python.org/downloads/release/python-377/ Other versions of Python may work, but they have not been tested.
Note: When installing Python on Windows, it is helpful if you select the "Add Python to environment variables" option.
Next you need to install the hippy module using the provided
Hippy-x.x.x.x-py3-none-any.whl wheel package (where x.x.x.x represents the
current version number).
To install hippy, open a command prompt and run
pip install Hippy-x.x.x.x-py3-none-any.whl
Note that hippy requires the websockets Python package. If this dependency is not already installed, it will be installed automatically.
Note: If you're using
pipfrom a company network and you see an error such asNo matching distribution found, you may need to provide the proxy using:
pip install Hippy-x.x.x.x-py3-none-any.whl --proxy=your_proxy_here
Once all three items are installed, you're ready to start using hippy. First launch the soHal.exe and then run your Python script or start sending commands from a Python Prompt.
You can use Python's dir function to see a list of all methods a device
includes:
from hippy import Projector
dir(Projector)
and the help function to see information on a particular method:
from hippy import Projector
help(Projector.open)
"Python" is a registered trademark of the Python Software Foundation.