ClimateControl QML Type

Provides an interface to the climate control. More...

Import Statement: import QtIvi.VehicleFunctions 1.0
Instantiates: QIviClimateControl
Inherits:

AbstractZonedFeature

Properties

Methods

Detailed Description

The QIviClimateControl provides an interface to the climate control of the vehicle.

The climate control properties are divided into two categories: central or zoned. The central properties are exposed directly through the QIviClimateControl and the zoned properties are exposed through zone objects. The zones are retrieved using the zoneAt method.

The QIviClimateControl expects a single backend to be available. It is recommended to use it with discoveryMode set to AutoDiscovery.

Property Documentation

airConditioningEnabled : bool

Holds whether the air conditioning is enabled.


airflowDirections : QtIviVehicleFunctionsModule::AirflowDirections

Holds the combination of flags indicating the areas where airflow is on.

Available values are:

ConstantDescription
WindshieldDirect airflow along the windshield.
DashboardDirect airflow through the dashboard.
FloorDirect airflow to the floor.

automaticClimateFanIntensityLevel : int

Holds the intensity level of the fan when the climateMode is set to AutoClimate.


climateMode : QtIviVehicleFunctionsModule::ClimateMode

value holds the climate mode

Available values are:

ConstantDescription
ClimateOffThe climate system is turned off.
ClimateOnThe climate system is turned on.
AutoClimateThe climate system is in automatic mode and is adjusting some parts of the system automatically. E.g. lower the fan speed when the targetTemperature is reached.

defrostEnabled : bool

Indicates whether the defrost mode is enabled. Usually that means that the fans are on the highest level to remove ice from the windshield.


discoveryMode : enumeration

Holds the mode that is used for the autoDiscovery

Available values are:

ConstantDescription
NoAutoDiscoveryNo auto discovery is done and the ServiceObject needs to be set manually.
AutoDiscoveryTries to find a production backend with a matching interface and falls back to a simulation backend if not found.
LoadOnlyProductionBackendsOnly tries to load a production backend with a matching interface.
LoadOnlySimulationBackendsOnly tries to load a simulation backend with a matching interface.

If necessary, auto discovery is started once the feature creation is completed.

Note: If you change this property after the feature is instantiated, make sure to call startAutoDiscovery() to search for a new service object.


discoveryResult : enumeration

The result of the last autoDiscovery

Available values are:

ConstantDescription
NoResultIndicates that no auto discovery was started because the feature has already assigned a valid ServiceObject.
ErrorWhileLoadingAn error has happened while searching for a backend with a matching interface.
ProductionBackendLoadedA production backend was loaded, as a result of auto discovery.
SimulationBackendLoadedA simulation backend was loaded, as a result of auto discovery.s

fanSpeedLevel : int

Holds the fan speed level


heaterEnabled : bool

Indicates whether the heater is enabled.


isInitialized : bool

Indicates whether the feature has been initialized with all the values from the backend.

The property is true once the backend sends the QIviFeatureInterface::initializationDone signal to indicate that all values have now been initialized with values from the backend.

See also isValid and QIviFeatureInterface::initializationDone.


isValid : bool

Indicates whether the feature is ready for use.

The property is true if the feature is ready to be used, otherwise false. Not being ready usually indicates that no suitable service object could be found, or that automatic discovery has not been triggered.

The backend still might not have sent all properties yet and is not fully initialized. Use isInitialized instead to know when the feature holds all correct values.

See also QIviServiceObject, discoveryMode, and isInitialized.


outsideTemperature : int

Holds the outside temperature of the zone expressed in centigrades


outsideTemperatureLabel : QString

The outside temperature expressed as a string, e.g. "mild"


recirculationEnabled : bool

Indicates whether the recirculation is currently running.


recirculationMode : QtIviVehicleFunctionsModule::RecirculationMode

Holds the current recirculation mode

Available values are:

ConstantDescription
RecirculationOffThe recirculation is turned off.
RecirculationOnThe recirculation is turned on.
AutoRecirculationThe recirculation is turning off and on automatically depending on the air quality.

recirculationSensitivityLevel : int

Holds the sensitivity level of the recirculation system when the recirculationMode is set to AutoRecirculation.


seatCooler : int

Holds the seat cooler level


seatHeater : int

Holds the seat heater level


serviceObject : ServiceObject

Sets the service object for the feature.

As Features only expose the front API facing the developer, a service object implementing the actual function is required. This is usually retrieved through the auto discovery mechanism.

The setter for this property returns false if the QIviServiceObject is already set to this particular instance or the QIviServiceObject isn't accepted by the feature.

See also discoveryMode.


steeringWheelHeater : int

Holds the steering wheel heater level


targetTemperature : qreal

Holds the target temperature of the zone expressed in centigrades


zoneSynchronizationEnabled : bool

Indicates whether the zone synchronization is enabled.

Which zones and properties are synchronized is controlled by the backend implementing it.


Method Documentation

enumeration startAutoDiscovery()

Performs an automatic discovery attempt.

The feature tries to locate a single ServiceObject that implements the required interface.

If no ServiceObject is found, the feature remains invalid. If more than one ServiceObject is found, the first instance is used.

This function returns either the type of the backend that was loaded; or an error.

If the discoveryMode is set to QIviAbstractFeature::NoAutoDiscovery, this function does nothing and returns QIviAbstractFeature::NoResult.

Return values are:

ConstantDescription
NoResultIndicates that no auto discovery was started because the feature already has a valid ServiceObject assigned.
ErrorWhileLoadingIndicates an error has occurred while searching for a backend with a matching interface.
ProductionBackendLoadedA production backend was loaded, as a result of auto discovery.
SimulationBackendLoadedA simulation backend was loaded, as a result of auto discovery.

See also Dynamic Backend System and QIviServiceManager.


© 2020 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.