cjn-PiTools 1.0

cjn's library of Raspberry Pi functions, drivers, tools, ...

cjn_PiTools - A collection of modules for Raspberry Pi projects

cjn_PiTools is comprised of several modules (follow links to respective documentation)

NOTE: These link point to the github repo since relative links to other .md files do not work on PyPI.

Module	Description/Purpose
PiBlinky	A multiple threaded LED driver for Raspberry Pi
PiOLED	Display multi-line messages on a shared Raspberry Pi connected OLED display
DS18B20	A high-featured library/driver using the w1_therm kernel driver
initW1buses	Initialize the W1 buses and set write permission on found therm_bulk_read file(s)

More to come!

• Drivers for SHT3x and HTU21D temp/RH sensors
• Driver for ADC121C027 ADC
• Driver for MCP23008 IO expander
• Driver for PCA9548s I2C expander

In most cases, these drivers will work with both RPi.GPIO (for local control) and pigpio for (local and remote control).

Developed and tested on Raspbian GNU/Linux 11 (bullseye) and Python 3.9.2, and supported on all higher versions.

In this documentation, "tool script" refers to a Python project that imports and uses cjn_PiTools. Some may be simple scripts, and others may themselves be installed packages.

Installation and usage

If using the RPi.GPIO driver:

pip install cjn_PiTools

If using the pigpio driver:

pip install cjn_PiTools[pigpio]

• And you will also need to install the pigpiod daemon (sudo apt install pigpiod) and start it manually or at boot. Here's a systemd service file for starting pigpiod at boot:

    [Unit]
    Description=Daemon required to control GPIO pins via pigpio
  
    [Service]
    ExecStart=/usr/local/bin/pigpiod -l
    Type=forking
    TimeoutStopSec=20
  
    [Install]
    WantedBy=multi-user.target
  

Key changes since the prior major public release (this is the first release)

• New. Bundled PiBlinky, PiOLED, initW1buses, and DS18B20 modules

Revision history

• 1.0 260207 - New. Bundled PiBlinky, PiOLED, initW1buses, and DS18B20 modules