Fixes:
- Enforce outer limit definitions with set_home_load method#76
Enhancements:
- Added active presets from current schedule slot to device details for direct value usage in HA entities
Notes on the set_home_load helper function:
- It allows to change the home load for the appliance only at this point. For sites with dual solarbank setup, the appliance load has a fixed share of 50% each. Starting with Anker App 2.2.1, the solarbank share can be modified if 50% is not suitable. This capability is not implemented yet and first needs to be understood and someone needs to test it who has dual bank setup. It is assumed, that this requires the new endpoint used in the set_device_load method. But the request parameter data is not clear. This method does not apply the requested changes for a single solarbank setup at all.
- It was found, that setting an incomplete schedule or missing parameters in the schedule slots may result in a complete erasure of your configured schedule for your power system.
- When the method is used and no schedule is defined, a single schedule slot for the whole day will be created using defaults or provided settings with the helper method.
- Testing for the lower power range settings have shown that the low and high power limits returned by the Cloud Api seem to get enforced. Those limits are actually 100W min and 800W max. as shown in responses for the home load schedule. So while the Api library supports a low limit of 50 W that you can set as appliance load, it is basically ignored because it is below the given limits returned from the cloud. Nevertheless, when you set 800W home load but your inverter supports just 600 W or less, damage may occur!
- Note that this method allows you to change the charge_priority level. However, depending on your setup this might be ignored as well since the charge_priority setting is only supported by Anker inverters (MI80) at this point in time.
- The allow_discharge setting reflects the switch in the Api and Anker mobile App. While the App and the Api are reflecting a 0W home load preset when the switch is off, something different is actually applied to the solarbank and this might be confusing:
- If non Anker inverter is used and 0W switch accessory is NOT installed: The switch will disable only the battery discharge for the given schedule slot. However, based on the minimum home load definitions for your configured inverter, the minimum bypass of 100 or 150 W will still be applied (although the App and Api are reflecting 0 W output preset)
- If MI80 inverter or 0W switch accessory is installed: Disabling this switch will completely block any power bypass to the house by 'cutting off' the inverter. The inverter will remain powered off. That means all solar power goes into the battery and bypass to the house is NOT possible.
Attention
The Api library does NOT verify if the set home load is suitable for your devices. It will only be applied to solarbank device types, but the limits for the attached inverter are unknown. I need to warn again at this point, that it is the USER's SOLE RISK using this Api library. If you apply too much power and cause damage to your inverters or solarbanks, and you may loose manufacturer's warranty as well !!!!!