Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Jump to bottom

Add device Pool Heatpump Fairland X20 series #2191

Closed
wants to merge 2 commits into from
Closed

Add device Pool Heatpump Fairland X20 series #2191

wants to merge 2 commits into from

Conversation

abipster
Copy link

@abipster abipster commented Aug 10, 2024 •
edited
Loading

Add support for the Fairland X20 series of Pool Heatpumps
https://www.fairland.com.cn/product/inverx20-inverter-pool-heat-pump.html

Supported functions/sensors:

  • operation mode: OFF, HEAT, COOL, AUTO(HEAT/COOL)
  • preset modes: SILENT, SMART, BOOST (called turbo on the Fairland App)
  • switching between °C and °F
  • Set the desired temperature in the range 18-40 °C and 64-104 °F
  • Current temperature
  • Power factor in percent
  • Current Power in watts
  • 2 Fault sensors (details below)
  • binary sensors for operation modes

Fault error 1: ["E1", "E2", "E3", "E4", "E5", "E6", "E7", "E8", "E9", "EA", "EB", "ED", "P0", "P1", "P2", "P3", "P4", "P5", "P6", "P7", "P8", "P9", "PA", "F1", "F2", "F3", "F4", "F5", "F6", "F7"]

Fault error 2: ["F8", "F9", "Fb", "Fa"]

I could only identify "E3" as "No water flow" and "E5" as "abnormal power supply"

fairland-x20-data-model.json
fairland-x20-dps-sample.json

Screenshot 2024-08-23 at 14 57 06

@Asino123
Copy link

Add support for the Fairland X20 series of Pool Heatpumps https://www.fairland.com.cn/product/inverx20-inverter-pool-heat-pump.html

Supported functions/sensors:

  • operation mode: OFF, HEAT, COOL, AUTO(HEAT/COOL)
  • preset modes: SILENT, SMART, BOOST (called turbo on the Fairland App)
  • switching between °C and °F
  • Set the desired temperature in the range 18-40 °C and 64-104 °F
  • Current temperature
  • Power factor in percent
  • Current Power in watts
  • 2 Fault sensors (details below)
  • binary sensors for operation modes

Fault error 1: ["E1", "E2", "E3", "E4", "E5", "E6", "E7", "E8", "E9", "EA", "EB", "ED", "P0", "P1", "P2", "P3", "P4", "P5", "P6", "P7", "P8", "P9", "PA", "F1", "F2", "F3", "F4", "F5", "F6", "F7"]

Fault error 2: ["F8", "F9", "Fb", "Fa"]

I could only identify "E3" as "No water flow" and "E5" as "abnormal power supply"

fairland-x20-data-model.json fairland-x20-dps-sample.json

Hi I wanted to buy the Fairland X20 pump but I can't understand if it is compatible with tuya and home assistant. Do you know? thanks

make-all
make-all reviewed Aug 22, 2024
View reviewed changes
Copy link
Owner

@make-all make-all left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This seems to match the poolsystem_ips100max that was recently added, only the "Show ..." binary sensors and error_2 attributes are missing from that config, but could easily be added as optional if needed.

I don't really understand the "Show ..." sensors - are they user config options for what is shown on the device's built in display, or are they informing the app which optional features are supported by the specific device?

I don't think either of those cases should use binary_sensor for these, but what exactly to do depends on the details.

custom_components/tuya_local/devices/fairland_x20_heatpump.yaml
- dps_val: 4
value: true
- value: false
- entity: binary_sensor
Copy link
Owner

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Why would this be a binary_sensor, not a switch? Same for the other two "Show..." items.

Copy link
Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Yes, it does look like it matches the poolsystem_ips100max, when I started working on this it didn't exist yet.
After some testing, it appears that the Show ... are just to inform the info to display on the app. I initially though they would be something we could act on but apparently not.

Shall I close this PR since the poolsystem_ips100max has already been added?

Copy link
Owner

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

OK, I will add the additional dps as optional attributes on the relevant entities in case they are useful to someone.

@abipster
Copy link
Author

Add support for the Fairland X20 series of Pool Heatpumps https://www.fairland.com.cn/product/inverx20-inverter-pool-heat-pump.html
Supported functions/sensors:

  • operation mode: OFF, HEAT, COOL, AUTO(HEAT/COOL)
  • preset modes: SILENT, SMART, BOOST (called turbo on the Fairland App)
  • switching between °C and °F
  • Set the desired temperature in the range 18-40 °C and 64-104 °F
  • Current temperature
  • Power factor in percent
  • Current Power in watts
  • 2 Fault sensors (details below)
  • binary sensors for operation modes

Fault error 1: ["E1", "E2", "E3", "E4", "E5", "E6", "E7", "E8", "E9", "EA", "EB", "ED", "P0", "P1", "P2", "P3", "P4", "P5", "P6", "P7", "P8", "P9", "PA", "F1", "F2", "F3", "F4", "F5", "F6", "F7"]
Fault error 2: ["F8", "F9", "Fb", "Fa"]
I could only identify "E3" as "No water flow" and "E5" as "abnormal power supply"
fairland-x20-data-model.json fairland-x20-dps-sample.json

Hi I wanted to buy the Fairland X20 pump but I can't understand if it is compatible with tuya and home assistant. Do you know? thanks

Hi! I have it integrated with tuya-local, using the configurations in this PR but apparently the support for it was already added under the name poolsystem_ips100max.

Fairland produces a lot of equipment that is rebranded and sold under other names. You should be OK with the current version of tuya-local

make-all added a commit that referenced this pull request Aug 23, 2024
@make-all
Poolsystems IPS100Max: add compatible Fairland X20
5a905ea 
Add some optional dps from PR #2191
@make-all
Copy link
Owner

Poolsystems IPS100Max is also a recent addition in PR #2171, and is still unreleased.

@make-all make-all closed this Aug 23, 2024
@abipster
Copy link
Author

Poolsystems IPS100Max is also a recent addition in PR #2171, and is still unreleased.

What do you think of renaming the poolsystem_ips100max to the fairland since it is the main brand? and just mention that poolsystem is one of the rebrands

@make-all
Copy link
Owner

I'm not sure which is the main brand. Probably both are selling a white labelled product from China.

@abipster
Copy link
Author

From what I could find Fairland is the "white label" brand from China but I can't say for sure

make-all added a commit that referenced this pull request Aug 23, 2024
@make-all
Rename poolsystems_ips100max to fairland_x20_poolheatpump
9fa397b 
Fairland seems to be the original manufacturer, Poolsystems is a local
German rebranding.

Since this has not been released yet, it can be renamed, unlike other
apparent Fairland rebrandings that are already released.

PR #2191, #2171
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Reviewers

@make-all make-all make-all left review comments

Assignees
No one assigned
Labels
None yet
Projects
Tuya Local
Archived in project
Milestone
No milestone
Development

Successfully merging this pull request may close these issues.
3 participants
@abipster @Asino123 @make-all