Skip to content

v0.2.0 - First Public Release

Choose a tag to compare

@eman eman released this 01 Feb 23:00
· 129 commits to main since this release

πŸŽ‰ First Public Release

Highlights

  • Complete BLE communication library for Grundfos ALPHA HWR pumps
  • Full type safety with mypy and basedpyright (0 errors)
  • Comprehensive CLI tool for pump management
  • 499 passing tests with 56% code coverage
  • Complete documentation at https://eman.github.io/alpha-hwr/

Features

  • Device Management: Connect, authenticate, and read device info
  • Control Operations: Set control modes (constant pressure, proportional pressure, constant speed, flow control)
  • Telemetry: Real-time monitoring of motor state, flow, pressure, temperature, and alarms
  • Scheduling: Create and manage time-based operation schedules
  • History: Read and export historical data (trend logs)
  • Configuration: Backup and restore pump configurations
  • Event Log: Read pump event logs and alarms

Technical Improvements

  • Fixed all basedpyright type errors
  • Improved test fixtures and mocking
  • Updated serial number handling to match hardware behavior
  • Removed unused imports and improved code quality

Requirements

  • Python 3.13 or higher
  • Bluetooth Low Energy support

Installation

pip install alpha-hwr

Quick Start

# Discover pumps
alpha-hwr device scan

# Connect and read device info
alpha-hwr device info AA:BB:CC:DD:EE:FF

# Monitor telemetry
alpha-hwr monitor telemetry AA:BB:CC:DD:EE:FF

See the documentation for full usage examples.