ThermostatTemperatureSetpoint स्कीमा

Nest Thermostat 

sdm.devices.traits.ThermostatTemperatureSetpoint

यह ट्रेट, THERMOSTAT डिवाइस टाइप के उन डिवाइसों के साथ काम करती है जिनमें टारगेट तापमान और तापमान की सीमा सेट करने की सुविधा होती है.

फ़ील्ड

फ़ील्ड ब्यौरा डेटा टाइप
heatCelsius थर्मोस्टैट के HEAT और HEATCOOL मोड के लिए, सेट किया गया तापमान सेल्सियस में. number
उदाहरण: 20.0
coolCelsius थर्मोस्टैट के COOL और HEATCOOL मोड के लिए, सेल्सियस में सेट किया गया तापमान. number
उदाहरण: 22.0

जीईटी अनुरोध और जवाब का सैंपल - HEAT

अनुरोध

GET /enterprises/project-id/devices/device-id

जवाब

{
  "name" : "enterprises/project-id/devices/device-id",
  "traits" : {
    "sdm.devices.traits.ThermostatTemperatureSetpoint" : {
      "heatCelsius" : 20.0,
    }
  }
}

GET अनुरोध और रिस्पॉन्स का उदाहरण - COOL

अनुरोध

GET /enterprises/project-id/devices/device-id

जवाब

{
  "name" : "enterprises/project-id/devices/device-id",
  "traits" : {
    "sdm.devices.traits.ThermostatTemperatureSetpoint" : {
      "coolCelsius" : 22.0
    }
  }
}

जीईटी अनुरोध और रिस्पॉन्स का उदाहरण - HEATCOOL

अनुरोध

GET /enterprises/project-id/devices/device-id

जवाब

{
  "name" : "enterprises/project-id/devices/device-id",
  "traits" : {
    "sdm.devices.traits.ThermostatTemperatureSetpoint" : {
      "heatCelsius" : 20.0,
      "coolCelsius" : 22.0
    }
  }
}

निर्देश

तापमान के सेटपॉइंट बदलने से पहले, थर्मोस्टैट को उस मोड में होना चाहिए जो कॉल की जा रही कमांड से मेल खाता हो. सेट किए गए तापमानों को बदलने के लिए इस्तेमाल होने वाले कमांड और फ़ील्ड, थर्मोस्टैट के मोड के हिसाब से अलग-अलग होते हैं.

उदाहरण के लिए, SetHeat कमांड देने से पहले, थर्मोस्टैट को HEAT मोड में होना चाहिए:

मोड निर्देश फ़ील्ड
की सुविधा चालू है SetHeat heatCelsius
COOL SetCool coolCelsius
HEATCOOL SetRange heatCelsius, coolCelsius

ध्यान दें कि सेटपॉइंट कमांड में, पैरामीटर के तौर पर सिर्फ़ सेल्सियस में तापमान दिया जा सकता है. हालांकि, Google Nest Thermostat पर तापमान को सेल्सियस या फ़ैरनहाइट में दिखाया जा सकता है.

SetHeat

जब थर्मोस्टैट HEAT मोड में होता है, तब यह कमांड टारगेट तापमान सेट करती है.

SetHeat अनुरोध और रिस्पॉन्स

अनुरोध

POST /enterprises/project-id/devices/device-id:executeCommand
{
  "command" : "sdm.devices.commands.ThermostatTemperatureSetpoint.SetHeat",
  "params" : {
    "heatCelsius" : 22.0
  }
}

जवाब

{}

SetHeat अनुरोध फ़ील्ड

फ़ील्ड ब्यौरा डेटा टाइप
heatCelsius थर्मोस्टैट के HEAT मोड में होने पर, सेट किया जाने वाला टारगेट तापमान. number
उदाहरण: 22.0

SetCool

थर्मोस्टैट के कूल मोड में होने पर, टारगेट तापमान सेट करता है.

SetCool अनुरोध और रिस्पॉन्स

अनुरोध

POST /enterprises/project-id/devices/device-id:executeCommand
{
  "command" : "sdm.devices.commands.ThermostatTemperatureSetpoint.SetCool",
  "params" : {
    "coolCelsius" : 20.0
  }
}

जवाब

{}

SetCool अनुरोध फ़ील्ड

फ़ील्ड ब्यौरा डेटा टाइप
coolCelsius थर्मोस्टैट को कूल मोड पर सेट करने के लिए सेट किया गया तापमान. number
उदाहरण: 20.0

SetRange

थर्मोस्टैट के HEATCOOL मोड में होने पर, कम से कम और ज़्यादा से ज़्यादा तापमान सेट करता है.

SetRange अनुरोध और जवाब

अनुरोध

POST /enterprises/project-id/devices/device-id:executeCommand
{
  "command" : "sdm.devices.commands.ThermostatTemperatureSetpoint.SetRange",
  "params" : {
    "heatCelsius" : 20.0,
    "coolCelsius" : 22.0
  }
}

जवाब

{}

SetRange अनुरोध फ़ील्ड

फ़ील्ड ब्यौरा डेटा टाइप
heatCelsius थर्मोस्टैट को HEATCOOL मोड पर सेट करने के दौरान, सेट किया जाने वाला कम से कम टारगेट तापमान. number
उदाहरण: 20.0
coolCelsius थर्मोस्टैट के HEATCOOL मोड में होने पर, सेट किया जा सकने वाला ज़्यादा से ज़्यादा टारगेट तापमान. number
उदाहरण: 22.0

गड़बड़ियां

इस एट्रिब्यूट के लिए, गड़बड़ी के ये कोड दिख सकते हैं:

गड़बड़ी का मैसेज RPC समस्या का हल
थर्मोस्टैट के मौजूदा मोड में, इस कमांड का इस्तेमाल नहीं किया जा सकता. FAILED_PRECONDITION ThermostatMode trait के मुताबिक, थर्मोस्टैट के बंद होने पर, कुछ थर्मोस्टैट मॉडल में ईको मोड को नहीं बदला जा सकता. ईको मोड बदलने से पहले, थर्मोस्टैट का मोड बदलकर HEAT, COOL या HEATCOOL पर सेट करना ज़रूरी है.
कूल वैल्यू, हीट वैल्यू से ज़्यादा होनी चाहिए. INVALID_ARGUMENT पक्का करें कि आपके निर्देश में heatCelsius फ़ील्ड की वैल्यू, coolCelsius फ़ील्ड की वैल्यू से कम हो.
थर्मोस्टैट के MANUAL_ECO मोड में होने पर, इस कमांड का इस्तेमाल नहीं किया जा सकता. FAILED_PRECONDITION थर्मोस्टैट के मैन्युअल ईको मोड में होने पर, तापमान सेटपॉइंट सेट नहीं किया जा सकता.

एपीआई के गड़बड़ी कोड की पूरी सूची देखने के लिए, एपीआई के गड़बड़ी कोड का रेफ़रंस देखें.