MELCloud & MELCloud Home API for Node.js - v60.5.0
    Preparing search index...

    Interface ClassicDeviceAtaFacade

    Facade for Air-to-Air (ATA) devices, exposing the ATA group operations on a single device by treating it as a group of one — MELCloud's native group endpoints only address zones (building/floor/area), so a device emulates them against its own state.

    interface ClassicDeviceAtaFacade {
        data: Readonly<ClassicListDeviceData<T>>;
        devices: readonly ClassicDeviceAny[];
        errorMessage: string | null;
        exists: boolean;
        fetch: () => Promise<Readonly<ClassicListDeviceDataAta>>;
        flags: Record<keyof ClassicUpdateDeviceData<T>, number>;
        getEnergy: (query: ReportQuery) => Promise<Result<ClassicEnergyDataAta>>;
        getEnergyReport: (
            query?: ReportQuery,
        ) => Promise<Result<ReportChartLineOptions>>;
        getErrorLog: (query: ErrorLogQuery) => Promise<Result<ClassicErrorLog>>;
        getFrostProtection: () => Promise<Result<ProtectionState | null>>;
        getGroup: () => Promise<Result<ClassicGroupState>>;
        getHolidayMode: () => Promise<Result<HolidayModeState | null>>;
        getHourlyTemperatures: (
            hour?: Hour,
        ) => Promise<Result<ReportChartLineOptions>>;
        getInternalTemperatures: (
            query?: ReportQuery,
        ) => Promise<Result<ReportChartLineOptions>>;
        getMemberOperationModes: (
            options: { poweredOnly: boolean },
        ) => ClassicOperationMode[];
        getOperationModes: (
            query?: ReportQuery,
        ) => Promise<Result<ReportChartPieOptions>>;
        getSignalStrength: (hour?: Hour) => Promise<Result<ReportChartLineOptions>>;
        getTemperatureRange: (
            mode?: ClassicOperationMode | HomeOperationMode,
        ) => TemperatureRange | null;
        getTemperatures: (
            query?: ReportQuery,
        ) => Promise<Result<ReportChartLineOptions>>;
        getTiles: (
            device?: boolean | ClassicDeviceAny,
        ) => Promise<Result<ClassicTilesData>>;
        getValues: () => Promise<Result<ClassicGetDeviceData<0>>>;
        id: number;
        isAvailable: boolean;
        isInError: boolean;
        name: string;
        notifySync: (params?: { type?: ClassicDeviceType }) => Promise<void>;
        power: boolean;
        rssi: number;
        type: 0;
        updateFrostProtection: (update: ProtectionUpdate) => Promise<void>;
        updateGroupState: (state: ClassicGroupState) => Promise<void>;
        updateHolidayMode: (update: HolidayModeUpdate) => Promise<void>;
        updatePower: (value?: boolean) => Promise<void>;
        updateValues: (
            data: ClassicUpdateDeviceDataAta,
        ) => Promise<ClassicSetDeviceDataAta>;
    }

    Hierarchy (View Summary)

    Index
    data devices errorMessage exists fetch flags getEnergy getEnergyReport getErrorLog getFrostProtection getGroup getHolidayMode getHourlyTemperatures getInternalTemperatures getMemberOperationModes getOperationModes getSignalStrength getTemperatureRange getTemperatures getTiles getValues id isAvailable isInError name notifySync power rssi type updateFrostProtection updateGroupState updateHolidayMode updatePower updateValues
    data: Readonly<ClassicListDeviceData<T>>
    devices: readonly ClassicDeviceAny[]

    All devices managed by this facade.

    errorMessage: string | null

    The fault as MELCloud words it, in the account's language, when the dialect carries a text on the unit (Classic ErrorMessages); null on a dialect that only flags it (Home) and while there is no fault.

    exists: boolean

    Whether the underlying entity still exists in the registry. Non-throwing staleness check — see EntityNotFoundError for the throwing counterpart surfaced by other accessors.

    fetch: () => Promise<Readonly<ClassicListDeviceDataAta>>

    Fetch the latest device data after syncing.

    flags: Record<keyof ClassicUpdateDeviceData<T>, number>

    Bitfield flags mapping each updatable property to its effective flag value.

    getEnergy: (query: ReportQuery) => Promise<Result<ClassicEnergyDataAta>>

    Fetch energy consumption report. ATA and ATW only.

    getEnergyReport: (
        query?: ReportQuery,
    ) => Promise<Result<ReportChartLineOptions>>

    Fetch the energy report as line chart data (kWh buckets). ATA and ATW only: types without an energy report resolve an empty chart.

    getErrorLog: (query: ErrorLogQuery) => Promise<Result<ClassicErrorLog>>

    Retrieve the error log for all devices in this facade.

    getFrostProtection: () => Promise<Result<ProtectionState | null>>

    Get the current frost protection settings, null when never configured.

    getGroup: () => Promise<Result<ClassicGroupState>>

    Read this device's current state projected as a group state.

    getHolidayMode: () => Promise<Result<HolidayModeState | null>>

    Get the current holiday mode settings, null when never configured.

    getHourlyTemperatures: (hour?: Hour) => Promise<Result<ReportChartLineOptions>>

    Fetch hourly temperature report. ATW only.

    getInternalTemperatures: (
        query?: ReportQuery,
    ) => Promise<Result<ReportChartLineOptions>>

    Fetch internal temperature report. ATW only.

    getMemberOperationModes: (
        options: { poweredOnly: boolean },
    ) => ClassicOperationMode[]

    Member operation modes in the one group vocabulary (Classic-numbered), treating the device as a group of one — no wire call.

    Type Declaration

      • (options: { poweredOnly: boolean }): ClassicOperationMode[]

      • Parameters

        • options: { poweredOnly: boolean }

          Member filter.

          • poweredOnly: boolean

            true answers empty when the unit is powered off.

        Returns ClassicOperationMode[]

        The device's own mode, alone or absent.

    getOperationModes: (
        query?: ReportQuery,
    ) => Promise<Result<ReportChartPieOptions>>

    Fetch operation mode usage as pie chart data.

    getSignalStrength: (hour?: Hour) => Promise<Result<ReportChartLineOptions>>

    Fetch WiFi signal strength report as line chart data.

    getTemperatureRange: (
        mode?: ClassicOperationMode | HomeOperationMode,
    ) => TemperatureRange | null

    Setpoint bounds enforced for an operation mode — the cross-dialect read: a caller needs no knowledge of which API backs the device.

    Type Declaration

    getTemperatures: (
        query?: ReportQuery,
    ) => Promise<Result<ReportChartLineOptions>>

    Fetch temperature history as line chart data.

    getTiles: (
        device?: boolean | ClassicDeviceAny,
    ) => Promise<Result<ClassicTilesData>>

    Fetch tile overview data, optionally selecting a specific device.

    getValues: () => Promise<Result<ClassicGetDeviceData<0>>>

    Fetch current device values from the Classic API; on success the registry model catches up with the answer.

    id: number
    isAvailable: boolean
    isInError: boolean

    true while the unit reports a fault of its own (Classic HasError, Home isInError).

    name: string
    notifySync: (params?: { type?: ClassicDeviceType }) => Promise<void>

    Trigger a sync callback for downstream consumers.

    power: boolean

    Whether the unit is powered on.

    rssi: number

    Last-reported Wi-Fi signal strength, in dBm.

    type: 0
    updateFrostProtection: (update: ProtectionUpdate) => Promise<void>

    Update frost protection settings with temperature clamping.

    updateGroupState: (state: ClassicGroupState) => Promise<void>

    Apply a group state to this device.

    updateHolidayMode: (update: HolidayModeUpdate) => Promise<void>

    Enable or disable holiday mode.

    updatePower: (value?: boolean) => Promise<void>

    Turn all devices in this facade on or off.

    updateValues: (
        data: ClassicUpdateDeviceDataAta,
    ) => Promise<ClassicSetDeviceDataAta>

    Send updated device values, clamping temperatures to valid ranges. A change set the synced state already holds is refused with NoChangesError, before any wire call.

    Settings
    Member Visibility

    On This Page
    Properties