Merge pull request #101 from mattdavis90/flow-optimization

feat: add flow temperature optimization to TadoX

src/tadox.ts

@@ -1,5 +1,6 @@
 import type {
   ActionableDevice,
+  FlowTemperatureOptimization,
   Power,
   XFeatures,
   XHomeSummary,
@@ -261,4 +262,59 @@ export class TadoX extends BaseTado {
     );
     return response.isDomesticHotWaterCapable;
   }
+
+  /**
+   * Get the Flow Temperature Optimization settings.
+   *
+   * @param home_id - The unique identifier of the home.
+   * @returns Flow Temperature Optimization settings.
+   */
+  async getFlowTemperatureOptimization(home_id: number): Promise<FlowTemperatureOptimization> {
+    return this.apiCallX(
+      `https://hops.tado.com/homes/${home_id}/settings/flowTemperatureOptimization`,
+    );
+  }
+
+  /**
+   * Enable Flow Temperature Optimization settings.
+   *
+   * @param home_id - The unique identifier of the home.
+   * @returns if changed.
+   */
+  async enableFlowTemperatureOptimization(home_id: number): Promise<string> {
+    return this.apiCallX(
+      `https://hops.tado.com/homes/${home_id}/settings/flowTemperatureOptimization`,
+      "patch",
+      { autoAdaptation: { enabled: true } },
+    );
+  }
+
+  /**
+   * Disable Flow Temperature Optimization settings.
+   *
+   * @param home_id - The unique identifier of the home.
+   * @returns if changed.
+   */
+  async disableFlowTemperatureOptimization(home_id: number): Promise<string> {
+    return this.apiCallX(
+      `https://hops.tado.com/homes/${home_id}/settings/flowTemperatureOptimization`,
+      "patch",
+      { autoAdaptation: { enabled: false } },
+    );
+  }
+
+  /**
+   * Set the Flow Temperature Optimization max temperature.
+   *
+   * @param home_id - The unique identifier of the home.
+   * @param temperature - The max. temperature.
+   * @returns if changed.
+   */
+  async setFlowTemperatureOptimization(home_id: number, temperature: number): Promise<string> {
+    return this.apiCallX(
+      `https://hops.tado.com/homes/${home_id}/settings/flowTemperatureOptimization`,
+      "patch",
+      { maxFlowTemperature: temperature },
+    );
+  }
 }

src/types/index.ts

@@ -1096,3 +1096,17 @@ export type XHomeSummary = {
   isHeatPumpInstalled: boolean;
   supportsFlowTemperatureOptimization: boolean;
 };
+
+export type FlowTemperatureOptimization = {
+  maxFlowTemperature: number;
+  maxFlowTemperatureConstraints: {
+    min: number;
+    max: number;
+  };
+  openThermDeviceSerialNumber: string;
+  hasMultipleBoilerControlDevices: boolean;
+  autoAdaptation: {
+    enabled: boolean;
+    maxFlowTemperature: number;
+  };
+};