Skip to main content

pygruenbeck_cloud

Gruenbeck

PyPI - Python Version PyPI release Release status Build Pipeline codecov Checked with mypy Pre-commit License

pygruenbeck_cloud is a Python 3 (>= 3.12) library to communicate with the Grünbeck Cloud based Water softeners.

It is intended to be used in custom_component hagruenbeck_cloud for Home Assistant.

Implementation is based on the ioBroker gruenbeck adapter implementation.

Available configuration parameter

Parameter Type Description
dslt boolean Activation of daylight saving time
buzzer boolean Activation of signal on error
buzzer_from time (HH:MM) Signal from time
buzzer_to time (HH:MM) Signal from time
push_notification boolean Activation of push notifications
email_notification boolean Activation of email notifications
water_hardness_unit integer Water hardness Unit (1 = "°dH", 2 = "°fH", 3 = "°e", 4 = "mol/m³", 5 = "ppm")
raw_water_hardness integer Water hardness value
soft_water_hardness integer Softwater hardness value
mode integer Current operation mode (1 = "Eco", 2 = "Comfort", 3 = "Power", 4 = "Individual")
mode_individual_monday integer Individual mode for Monday
mode_individual_tuesday integer Individual mode for Tuesday
mode_individual_wednesday integer Individual mode for Wednesday
mode_individual_thursday integer Individual mode for Thursday
mode_individual_friday integer Individual mode for Friday
mode_individual_saturday integer Individual mode for Saturday
mode_individual_sunday integer Individual mode for Sunday
regeneration_mode integer Regeneration mode (0 = "Auto", 1 = "Fixed")
regeneration_time_monday_1 string Custom regeneration time for Monday 1 (Format: HH:MM)
regeneration_time_monday_2 string Custom regeneration time for Monday 2 (Format: HH:MM)
regeneration_time_monday_3 string Custom regeneration time for Monday 3 (Format: HH:MM)
regeneration_time_tuesday_1 string Custom regeneration time for Tuesday 1 (Format: HH:MM)
regeneration_time_tuesday_2 string Custom regeneration time for Tuesday 2 (Format: HH:MM)
regeneration_time_tuesday_3 string Custom regeneration time for Tuesday 3 (Format: HH:MM)
regeneration_time_wednesday_1 string Custom regeneration time for Wednesday 1 (Format: HH:MM)
regeneration_time_wednesday_2 string Custom regeneration time for Wednesday 2 (Format: HH:MM)
regeneration_time_wednesday_3 string Custom regeneration time for Wednesday 3 (Format: HH:MM)
regeneration_time_thursday_1 string Custom regeneration time for Thursday 1 (Format: HH:MM)
regeneration_time_thursday_2 string Custom regeneration time for Thursday 2 (Format: HH:MM)
regeneration_time_thursday_3 string Custom regeneration time for Thursday 3 (Format: HH:MM)
regeneration_time_friday_1 string Custom regeneration time for Friday 1 (Format: HH:MM)
regeneration_time_friday_2 string Custom regeneration time for Friday 2 (Format: HH:MM)
regeneration_time_friday_3 string Custom regeneration time for Friday 3 (Format: HH:MM)
regeneration_time_saturday_1 string Custom regeneration time for Saturday 1 (Format: HH:MM)
regeneration_time_saturday_2 string Custom regeneration time for Saturday 2 (Format: HH:MM)
regeneration_time_saturday_3 string Custom regeneration time for Saturday 3 (Format: HH:MM)
regeneration_time_sunday_1 string Custom regeneration time for Sunday 1 (Format: HH:MM)
regeneration_time_sunday_2 string Custom regeneration time for Sunday 2 (Format: HH:MM)
regeneration_time_sunday_3 string Custom regeneration time for Sunday 3 (Format: HH:MM)
maintenance_interval integer Maintenance interval in days
installer_name string Installer name
installer_phone string Installer phone
installer_email string Installer email
ntp_sync bool Get date/time automatically (NTP)
fault_signal_contact bool Function fault signal contact
knx bool KNX connection
nominal_flow_monitoring bool Monitoring of nominal flow
disinfection_monitoring bool Disinfection monitoring
led_ring_mode int Illuminated LED ring mode (0 = "deactivated", 1 = "permanent lightning", 2 = "in case of failure", 3 = "in case of operation by user + failure", 4 = "in case of water treatment + operation by user + failure")
led_ring_flash_on_signal bool Illuminated LED ring flashes for pre-alarm salt supply
led_ring_brightness int LED ring Brightness [%]
residual_capacity_limit int Residual capacity limit value [%]
current_setpoint int Current setpoint [mA]
charge int Charge [mAmin]
interval_forced_regeneration int Interval of forced regeneration [days]
end_frequency_regeneration_valve int End frequency regeneration valve [Hz]
end_frequency_regeneration_valve_2 int End frequency regeneration valve 2 [Hz]
end_frequency_blending_valve int End frequency blending valve [Hz]
treatment_volume int Treatment volume [m³]
soft_water_meter_pulse_rate float Soft water meter pulse rate [l/Imp]
blending_water_meter_pulse_rate float Blending water meter pulse rate [l/Imp]
regeneration_water_meter_pulse_rate float Regeneration water meter pulse rate [l/Imp]
capacity_figure_monday int Capacity figure Monday [m³x°dH]
capacity_figure_tuesday int Capacity figure Tuesday [m³x°dH]
capacity_figure_wednesday int Capacity figure Wednesday [m³x°dH]
capacity_figure_thursday int Capacity figure Thursday [m³x°dH]
capacity_figure_friday int Capacity figure Friday [m³x°dH]
capacity_figure_saturday int Capacity figure Saturday [m³x°dH]
capacity_figure_sundday int Capacity figure Sunday [m³x°dH]
nominal_flow_rate float Nominal flow rate [m³/h]
regeneration_monitoring_time int Regeneration monitoring time [min]
salting_monitoring_time int Salting monitoring time [min]
slow_rinse float Slow rinse [min]
backwash int Backwash [l]
washing_out int Washing out [l]
minimum_filling_volume_smallest_cap float Minimum filling volume smallest cap [l]
maximum_filling_volume_smallest_cap float Maximum filling volume smallest cap [l]
minimum_filling_volume_largest_cap float Minimum filling volume largest cap [l]
maximum_filling_volume_largest_cap float Maximum filling volume largest cap [l]
longest_switch_on_time_chlorine_cell int Longest switch-on time Cl cell [min]
maximum_remaining_time_regeneration int Maximum remaining time regeneration [min]
language int Current language (1 = "German", 2 = "English", 3 = "French", 4 = "Italian", 5 = "Dutch", 6 = "Spanish", 7 = "Russian", 9 = "Danish")
programmable_output_function int Programmable output function
programmable_input_function int Programmable input function
reaction_to_power_failure int Reaction to power failure > 5 min
chlorine_cell_mode int Activate/deactivate chlorine cell
blending_monitoring int Blending monitoring
system_overloaded int System overloaded

And these are additional parameter which are provided by the API, but their meaning and/or value is not known:

Parameter Type
ppressurereg int

Feel free to open an issue if you know the meaning of them and their possible values.

Metadata

Release files for pygruenbeck-cloud 1.3.3

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

Source distribution (sdist)

Source distribution for pygruenbeck-cloud 1.3.3
File Size Uploaded
pygruenbeck_cloud-1.3.3.tar.gz 26.7 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for pygruenbeck-cloud 1.3.3
File Interpreter ABI Platform
pygruenbeck_cloud-1.3.3-py3-none-any.whl Python 3 none any Details

Total release size: 50.0 kB

Release files / pygruenbeck_cloud-1.3.3.tar.gz

Download URL pygruenbeck_cloud-1.3.3.tar.gz
Size 26.7 kB
Tags Source
SHA-256 checksum
How to use checksums
3f353631755e5cd870db606cd8879a80a132fd612670cd9742a21599584692af
BLAKE2b-256 checksum
How to use checksums
20b12a78a6f71a5a10fdaf1c57003c5384ce27af690520cbe201eb8d2b7034a6
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.1.0 CPython/3.13.5

Release files / pygruenbeck_cloud-1.3.3-py3-none-any.whl

Download URL pygruenbeck_cloud-1.3.3-py3-none-any.whl
Size 23.3 kB
Tags Python 3
SHA-256 checksum
How to use checksums
8311f93524f0a3e6bc2a90ff4c3f9babc129e5204f9f3c7feb265414b46070f3
BLAKE2b-256 checksum
How to use checksums
a7dc6cf72234d979827d4f4a2c5580cea079d6d90c677749b85e6cd046680be6
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.1.0 CPython/3.13.5

Release history Release notifications | RSS feed

This release

1.3.3 This release

2 release files

1.3.2

2 release files

1.3.1

2 release files

1.3.0

2 release files

1.2.0

2 release files

1.1.1

2 release files

1.1.0

2 release files

1.0.0

2 release files

0.2.0

2 release files

0.1.0

2 release files

0.0.4

2 release files

0.0.3

2 release files

0.0.2

2 release files

0.0.1

1 release file

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