Skip to main content

nicesprinkler

Your lawn does not need a robot. It needs water in the right place.

pypi Github Actions Build PyPI Status GitHub issues GitHub closed issues API Docs License

Two stepper motors, a garden hose and a Raspberry Pi. One motor turns, the other lifts, and the jet lands where the software says it should — if the software knows the truth about the garden. Getting it to know that is the interesting part.

the garden in 3D

What it does

  • Simulates the throw over a 3D model of your garden before a drop falls
  • Aims the head from the browser, or from a pattern
  • Watches itself through the device camera while it works
  • Measures its own flow with a bucket and a stopwatch, and remembers it

the sprinkler head

Why the camera

A stepper says where it was told to go. Water pressure has opinions. The hose bends, the head shifts under the jet, and the model drifts away from the machine. So every frame the camera records is written with the commanded angles beside it — pictures without angles teach nothing.

Install

pip install nicesprinkler

Run

sprinkler -s

Then open the address it prints. On a Raspberry Pi it drives the motors through TB6600 drivers; anywhere else it runs the simulation with a mock GPIO, so you can build the garden model on your laptop.

Configure

Lawn size, head position, angle limits, hose specification and motor pins live in one yaml. Start from nicesprinkler_examples/example_config.yaml.

Documentation

License

Apache 2.0

Download files

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

Source Distribution

nicesprinkler-0.0.3.tar.gz (4.9 MB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

nicesprinkler-0.0.3-py3-none-any.whl (175.7 kB view details)

Uploaded Python 3

File details

Details for the file nicesprinkler-0.0.3.tar.gz.

File metadata

  • Download URL: nicesprinkler-0.0.3.tar.gz
  • Upload date:
  • Size: 4.9 MB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for nicesprinkler-0.0.3.tar.gz
Algorithm Hash digest
SHA256 6dea4ea2876483d60f2656ca37f6b6cc9d6323ea25788a9d87885a247d51eea1
MD5 05c7c2ed65a305001fb6bca2d4f061df
BLAKE2b-256 498987ed86dc6cec8aa1da31e7ce707299979f70e417c453e4075604cec65657

See more details on using hashes here.

Provenance

The following attestation bundles were made for nicesprinkler-0.0.3.tar.gz:

Publisher: upload-to-pypi.yml on WolfgangFahl/nicesprinkler

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file nicesprinkler-0.0.3-py3-none-any.whl.

File metadata

  • Download URL: nicesprinkler-0.0.3-py3-none-any.whl
  • Upload date:
  • Size: 175.7 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for nicesprinkler-0.0.3-py3-none-any.whl
Algorithm Hash digest
SHA256 1bc137da4b2574368f89b846a7f9f49d278db03afb7ab900f4de5848a5a1ec02
MD5 aa537aab9c5bcf9f584860bf7c5c4986
BLAKE2b-256 38240a816564e3ad8eb0191cb5e377fdfd19af96211a50ac50b0faa927e5dc7b

See more details on using hashes here.

Provenance

The following attestation bundles were made for nicesprinkler-0.0.3-py3-none-any.whl:

Publisher: upload-to-pypi.yml on WolfgangFahl/nicesprinkler

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page