Skip to main content

A sump pit monitoring system for Raspberry Pi

Project description

Raspi-sump is a sump pit water level monitoring system that uses a Raspberry Pi and an Ultrasonic Sensor (HC-SR04).

MobileScreenshot

Currently the system monitors the water level in your pit at defined intervals. It sends email sms alerts if the water reaches a critical level, indicating a possible sump pump failure.

What's New

Version 1.9 - Systemd is now an option to replace crontab. Control all Raspi-Sump services and Chart creation timers with Systemd.

You can continue using crontab if you prefer.

See the changelog for the latest information on Raspi-Sump features.

Supported Versions of Raspbian / Raspberry Pi OS

Raspi-Sump is currently supported on Raspberry Pi OS (Bullseye) and Raspian (Buster)

Plans are in the works for Raspberry Pi OS Bookworm. However changes to Python require a rethink on how Raspi-Sump is installed. More to come. For the time being, Bookworm is not supported.

Discord Group

Discuss and get support from other users. Email (alaudet@linuxnorth.org) for an invite link.

Install Raspi-Sump

Full install instructions are located at https://github.com/alaudet/raspi-sump/blob/master/docs/install.md

Upgrade Raspi-Sump

Upgrade an existing version

sudo pip3 install -U --no-binary :all: raspisump

If upgrading from version 1.8 or lower to version 1.9 see the 1.9 Upgrade Instructions

More Info

Further details provided at https://www.linuxnorth.org/raspi-sump/

Disclaimer

You are welcome to use Raspi-Sump but there is no guarantee it will work. Your house may still flood if your sump pump fails. This software comes with no warranty. See License details.

This is not a replacement for a properly maintained water pumping system. It is one tool you can use to give yourself extra piece-of-mind.

Best practices should include:

  • A backup pump that triggers at a slightly higher water level than your main pump.
  • The secondary pump should be connected to a seperate dedicated electrical breaker.
  • You should also have a generator that can provide power should you have an extended outage during the spring or other unseasonally wet time of year.
  • if you are building a new home, pay attention to the grade of your property, as you may be able to let gravity empty your pit for you. That would be the best approach with a backup pump for added protection.

Once you have done all of these things, then consider using a monitoring system like Raspi-Sump.

License

Raspi-Sump is released under the MIT License.

Contribute

Please refer to the Contributing Guidelines before issuing a pull request.

Donate

Your Donation is Appreciated

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

raspisump-1.9.4.tar.gz (79.3 kB view details)

Uploaded Source

Built Distribution

raspisump-1.9.4-py3-none-any.whl (81.3 kB view details)

Uploaded Python 3

File details

Details for the file raspisump-1.9.4.tar.gz.

File metadata

  • Download URL: raspisump-1.9.4.tar.gz
  • Upload date:
  • Size: 79.3 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/4.0.2 CPython/3.11.6

File hashes

Hashes for raspisump-1.9.4.tar.gz
Algorithm Hash digest
SHA256 4c68533f383ff0f903a0b3b14ffe70acefe9dad5327a3aaa926e2f72b8d60678
MD5 6679014102a3affea350e117e6117fc2
BLAKE2b-256 9b1605ff5f7d460b90e05004e65e543688fb06d9bee557396f385488eab4fe70

See more details on using hashes here.

File details

Details for the file raspisump-1.9.4-py3-none-any.whl.

File metadata

  • Download URL: raspisump-1.9.4-py3-none-any.whl
  • Upload date:
  • Size: 81.3 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/4.0.2 CPython/3.11.6

File hashes

Hashes for raspisump-1.9.4-py3-none-any.whl
Algorithm Hash digest
SHA256 a757e69b441eda503c6a235e91f5e10de60952ac39d222513aa831373485ba77
MD5 a6aad99043a75eb816153e4ea61cdbdb
BLAKE2b-256 f6ef923e904dcf9bb544f410a7a4709f5b58444e55103f7d1c41739b8f5b11ea

See more details on using hashes here.

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