Skip to main content

A module to control the Explorer HAT Raspberry Pi Addon Board

Project description

Explorer HAT/pHAT https://shop.pimoroni.com/products/explorer-hat https://shop.pimoroni.com/products/explorer-phat

The Explorer HAT and Explorer pHAT have a heap of useful input and output options that will take your Raspberry Pi projects to the next level. Great for driving motors, using analog sensors, interfacing with 5V systems, and touch interfaces.

Installing

Full install (recommended):

We've created an easy installation script that will install all pre-requisites and get your Explorer HAT/pHAT 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:

Finding the terminal

In the new terminal window type the command exactly as it appears below (check for typos) and follow the on-screen instructions:

curl https://get.pimoroni.com/explorerhat | bash

Alternatively, on Raspbian, you can download the pimoroni-dashboard and install your product by browsing to the relevant entry:

sudo apt-get install pimoroni

(you will find the Dashboard under 'Accessories' too, in the Pi menu - or just run pimoroni-dashboard at the command line)

If you choose to download examples you'll find them in /home/pi/Pimoroni/explorerhat/.

Manual install:

Library install for Python 3:

on Raspbian:

sudo apt-get install python3-explorerhat

other environments:

sudo pip3 install explorerhat

Library install for Python 2:

on Raspbian:

sudo apt-get install python-explorerhat

other environments:

sudo pip2 install explorerhat

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:

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 i2c bus.

Documentation & Support

Important Notes

Explorer HAT/pHAT uses an output driver chip called the ULN2003A, which contains a set of transistor pairs called a Darlington Array. It transforms the small logic signal of the Pi into something capable of driving much bigger loads, such as motors, steppers, lights and more.

The 4 outputs on Explorer can sink 5V, but not source. This means you need to connect your load to one of the 5V pins, and then to the output. When you turn the output on it will connect your circuit to ground, allowing current to flow and your load to turn on. This is the opposite of using a bare Pi GPIO pin, where you might connect to the pin and then to ground; keep this in mind!

Changelog

0.5.1

  • Fix Python 3.9 support for Thread.is_alive()

0.5.0

  • Refactor library setup()
  • Raise ImportError instead of hard exit
  • Add support for ADS1115 variant
  • Fix Syntax Warning

0.4.2

  • Initial release to Raspbian Apt repository

0.4.1

  • Dropped junk files from package
  • Refactor into package

0.4.0

  • Restructure to include pins/ads1015 in package
  • Dropped captouch from manifest

0.3.0

  • Added support for Explorer pHAT
  • Better device detection

0.2.0

  • Updated to depend upon common cap1xxx library
  • Hopefully supports Python 3

0.1.1

  • Added analog changed function

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

ExplorerHAT-0.5.1.tar.gz (13.4 kB view hashes)

Uploaded Source

Built Distribution

ExplorerHAT-0.5.1-py3-none-any.whl (12.9 kB view hashes)

Uploaded Python 3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page