https://github.com/pimoroni/unicorn-hat-hd
Python library and examples for Unicorn HAT HD
https://github.com/pimoroni/unicorn-hat-hd
pypi-package
Last synced: 7 months ago
JSON representation
Python library and examples for Unicorn HAT HD
- Host: GitHub
- URL: https://github.com/pimoroni/unicorn-hat-hd
- Owner: pimoroni
- License: mit
- Created: 2017-06-05T15:24:20.000Z (over 8 years ago)
- Default Branch: master
- Last Pushed: 2025-01-08T17:30:18.000Z (10 months ago)
- Last Synced: 2025-04-11T19:03:41.935Z (7 months ago)
- Topics: pypi-package
- Language: Python
- Homepage: https://shop.pimoroni.com/products/unicorn-hat-hd
- Size: 381 KB
- Stars: 175
- Watchers: 26
- Forks: 68
- Open Issues: 7
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
http://shop.pimoroni.com/products/unicorn-hat-hd
[](https://travis-ci.com/pimoroni/unicorn-hat-hd)
[](https://coveralls.io/github/pimoroni/unicorn-hat-hd?branch=master)
[](https://pypi.python.org/pypi/unicornhathd)
[](https://pypi.python.org/pypi/unicornhathd)
## Installing
### Full install (recommended):
We've created an easy installation script that will install all pre-requisites and get your Unicorn HAT HD
up and running with minimal efforts. To run it, fire up Terminal which you'll find in Menu -> Accessories -> Terminal
on your Raspberry Pi desktop, as illustrated below:
In the new terminal window type the command exactly as it appears below (check for typos) and follow the on-screen instructions:
```bash
curl https://get.pimoroni.com/unicornhathd | bash
```
If you choose to download examples you'll find them in `/home/pi/Pimoroni/unicornhathd/`. To prototype and try out your code without having to deploy it onto a Raspberry Pi every time, you can use the [Unicorn HAT simulator](https://github.com/jayniz/unicorn-hat-sim) to run a mock Unicorn HAT on your computer.
### Manual install:
SPI needs to be enabled to communicate with the Unicorn Hat HD. If the SPI on your Pi is not enabled or you are unsure if it is:
```bash
sudo raspi-config nonint do_spi 0
sudo reboot
```
#### Library install for Python 3:
```bash
sudo apt-get install python3-pip python3-dev python3-spidev
sudo pip3 install unicornhathd
```
#### Library install for Python 2:
```bash
sudo apt-get install python-pip python-dev python-spidev
sudo pip install unicornhathd
```
### Development:
If you want to contribute, or like living on the edge of your seat by having the latest code, you should clone this repository, `cd` to the library directory, and run:
```bash
sudo apt-get install python-dev python-setuptools
sudo python3 setup.py install
```
(or `sudo python setup.py install` whichever your primary Python environment may be)
In all cases you will have to enable the SPI bus.
## Documentation & Support
* Function reference - http://docs.pimoroni.com/unicornhathd/
* GPIO Pinout - http://pinout.xyz/pinout/unicorn_hat_hd
* Get help - http://forums.pimoroni.com/c/support