Skip to main content
Pre-release

This release is a pre-release and may not be stable for production use.

Helium Hardware Definitions

IMPORTANT: This repository will go into 'Archive' mode soon as it has been migrated to hm-pyhelper.

This repository contains the python file that contains a GPIO map for all of the different hardware combinations to be supported by the Nebra Helium Hotspot Software.

All numbers below are their GPIO / BCM Numbers, not physical pin numbers.

Note: Light hotspot software will also work on all models listed as type "full".

Nebra Hotspots

Model ENV Identifier SPI Bus Reset Pin Status LED Button Type Cellular Notes
Nebra Indoor Hotspot Gen 1 NEBHNT-IN1 1.2 38 25 26 Full False CM3 based
Nebra Outdoor Hotspot Gen 1 NEBHNT-OUT1 1.2 38 25 24 Full True CM3 based
Nebra Pi 0 Light Hotspot S NEBHNT-LGT-ZS 1.2 22 24 23 Light False SPI Based Ethernet
Nebra Pi 0 Light Hotspot X NEBHNT-LGT-ZX 1.2 22 24 23 Light False USB Based Ethernet
Nebra Beaglebone Light Hotspot NEBHNT-BBB 1.0 60 31 30 Light False In Planning
Nebra Pocket Beagle Light Hotspot NEBHNT-PBB 1.0 60 31 30 Light False In Planning
Nebra Hotspot HAT RockPi4 NEBHNT-HHRK4 1.0 149 156 154 Full False In Planning
Nebra Hotspot HAT RPi NEBHNT-HHRPI 0.0 22 24 23 Full False Should be compatible with 3+ & 4
Nebra Hotspot HAT RPi LIGHT NEBHNT-HHRPL 0.0 22 24 23 Light False Light is compatible with all 40 pin headers
Nebra Hotspot HAT Tinkerboard 2 NEBHNT-HHTK 2.0 167 163 162 Full False Light would be compatible on TK1

Third Party Hotspots

We may be adding in support for other vendor's hotspots to use our software soon. Here are the variables for those.

These would also depend on their SOCs being supported by Balena.

Model SOC/SBC ENV Identifier SPI Bus Reset Pin Status LED Button Type Cellular Notes
Rak Hotspot Miner BCM2711 (Pi4 2gb RAM) COMP-RAKHM 0.0 17 20 21 Full False Only Compatible with V2 hotspots with ECC Key.
OG Helium Hotspot BCM2711 (Pi4 2gb RAM) COMP-HELIUM 0.0 17 20 21 Full False
Syncrobit Hotspot 1 (Pi) Full False
Syncrobit Hotspot 2 (RK) Full False
Bobcat Miner 300 Full False
SenseCAP M1 BCM2711 (Pi4 2gb RAM) COMP-SENSECAPM1 0.0 17 20 21 Full False

DIY Hotspots

The following DIY options are also supported for light hotspot software only.

Please note, DIY Hotspots do not earn HNT.

Model SOC/SBC ENV Identifier SPI Bus Reset Pin Status LED Button Type Cellular Notes
Pi Supply IoT LoRa Gateway HAT RPi DIY-PISLGH 0.0 22 Light False Any pi with 40 pin header
RAK2287 RPi DIY-RAK2287 0.0 17 Light False Any pi with 40 pin header

Install

This package is automatically built and published to our PyPI repo using GitHub Actions. Installing the package is as simple as:

pip install hm-hardware-defs

You can also install a specific version using:

pip install hm-hardware-defs==0.1.4

Usage

You can use the hardware definitions within your project by importing the package into your python script as follows:

from hm_hardware_defs.variant import variant_definitions

Important Notes

This package is used in a number of Nebra software repos:

Contributing

If there is hardware that you would like to be supported that is not listed here, please complete one of the following:

  • Create an issue on this repository which has the name of the Hotspot or DIY solution with (at a minimum) a link to a pinout of the device and which SBC it is to be used with. The more information you can provide the better!
  • Fork this repository and add the device to the array in variant.py, update the table above and then create a pull request.

Metadata

Release files for ba-hardware-defs 0.1.6a8

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for ba-hardware-defs 0.1.6a8
File Size Uploaded Provenance
ba-hardware-defs-0.1.6a8.tar.gz 4.3 kB Without provenance Details

Built distribution (wheel)

Table of built distributions (wheels) for ba-hardware-defs 0.1.6a8
File Interpreter ABI Platform
ba_hardware_defs-0.1.6a8-py3-none-any.whl Python 3 none any Details

Total release size: 9.2 kB

Release files / ba-hardware-defs-0.1.6a8.tar.gz

Download URL ba-hardware-defs-0.1.6a8.tar.gz
Size 4.3 kB
Tags Source
SHA-256 checksum
How to use checksums
147ea8f54f58e83a07927aa0b6cdea3d30875fc8ca36fe47c5b1d2b58d9a9eff
BLAKE2b-256 checksum
How to use checksums
2e684887f6e0d93f0816eb605b6a84c11e83b977b99d2219dee2577b25b66eaa
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/3.8.0 pkginfo/1.8.2 readme-renderer/32.0 requests/2.27.1 requests-toolbelt/0.9.1 urllib3/1.26.8 tqdm/4.62.3 importlib-metadata/4.10.1 keyring/23.5.0 rfc3986/2.0.0 colorama/0.4.4 CPython/3.9.10

Release files / ba_hardware_defs-0.1.6a8-py3-none-any.whl

Download URL ba_hardware_defs-0.1.6a8-py3-none-any.whl
Size 4.9 kB
Tags Python 3
SHA-256 checksum
How to use checksums
f334a0dd58fa159321d8867d5ba3d19606e784beeb61d35f4a7effd4dc9ac606
BLAKE2b-256 checksum
How to use checksums
bd4ac5718bccbd5352aca16ce111838754476ac582ffd258659681503ba00195
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/3.8.0 pkginfo/1.8.2 readme-renderer/32.0 requests/2.27.1 requests-toolbelt/0.9.1 urllib3/1.26.8 tqdm/4.62.3 importlib-metadata/4.10.1 keyring/23.5.0 rfc3986/2.0.0 colorama/0.4.4 CPython/3.9.10

Security for ba-hardware-defs 0.1.6a8

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page