Skip to main content

Platform detection for use by libraries like Adafruit-Blinka.

Project description


This library provides best-guess platform detection for a range of single-board computers and (potentially) other platforms. It was written primarily for use in Adafruit_Blinka, but may be useful in other contexts.

Platform detection is divided into “chip” and “board” detection, with the latter generally dependent on the former. Platform info is gathered from:

  • Python’s sys.platform
  • Various files on Linux systems:
    • /proc/cpuinfo (for processor info, Raspberry Pi hardware revisions, etc.)
    • /proc/device-tree/compatible (for 96Boards info)
  • Beaglebone EEPROM board IDs
  • Distribution-specific files such as /etc/armbian-release.

The API is currently unstable and may change drastically in future releases.


On supported GNU/Linux systems like the Raspberry Pi, you can install the driver locally from PyPI. To install for current user:

pip3 install Adafruit-PlatformDetect

To install system-wide (this may be required in some cases):

sudo pip3 install Adafruit-PlatformDetect

To install in a virtual environment in your current project:

mkdir project-name && cd project-name
python3 -m venv .env
source .env/bin/activate
pip3 install Adafruit-PlatformDetect


from adafruit_platformdetect import Detector
detector = Detector()
print("Chip id: ",
print("Board id: ",

# Check for specific board models:
print("Pi 3B+? ", detector.board.RASPBERRY_PI_3B_PLUS)
print("BBB? ", detector.board.BEAGLEBONE_BLACK)
print("Orange Pi PC? ", detector.board.ORANGE_PI_PC)
print("generic Linux PC? ", detector.board.GENERIC_LINUX_PC)

See for more possible detectable boards

Project details

Download files

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

Files for Adafruit-PlatformDetect, version 1.4.4
Filename, size File type Python version Upload date Hashes
Filename, size Adafruit-PlatformDetect-1.4.4.tar.gz (16.0 kB) File type Source Python version None Upload date Hashes View hashes

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page