তাপস্থাপক

সমস্ত গুগল নেস্ট থার্মোস্ট্যাট মডেল স্মার্ট ডিভাইস ম্যানেজমেন্ট (এসডিএম) এপিআই-তে সমর্থিত। এই ডিভাইসগুলো থার্মোস্ট্যাট ডিভাইস টাইপটি রিটার্ন করে:

sdm.devices.types.THERMOSTAT

বৈশিষ্ট্য

{
  "type" : "sdm.devices.types.THERMOSTAT",
  "traits" : {
    "sdm.devices.traits.Connectivity" : {
      "status" : "ONLINE"
    },
    "sdm.devices.traits.Fan" : {
      "timerMode" : "ON",
      "timerTimeout" : "2019-05-10T03:22:54Z"
    },
    "sdm.devices.traits.Humidity" : {
      "ambientHumidityPercent" : 35.0
    },
    "sdm.devices.traits.Info" : {
      "customName" : "My device"
    },
    "sdm.devices.traits.Settings" : {
      "temperatureScale" : "CELSIUS"
    },
    "sdm.devices.traits.Temperature" : {
      "ambientTemperatureCelsius" : 23.0
    },
    "sdm.devices.traits.ThermostatEco" : {
      "availableModes" : ["MANUAL_ECO", "OFF"],
      "mode" : "MANUAL_ECO",
      "heatCelsius" : 20.0,
      "coolCelsius" : 22.0
    },
    "sdm.devices.traits.ThermostatHvac" : {
      "status" : "HEATING"
    },
    "sdm.devices.traits.ThermostatMode" : {
      "availableModes" : ["HEAT", "COOL", "HEATCOOL", "OFF"],
      "mode" : "COOL"
    },
    "sdm.devices.traits.ThermostatTemperatureSetpoint" : {
      "heatCelsius" : 20.0,
      "coolCelsius" : 22.0
    }
  }
}

তাপমাত্রা এবং আর্দ্রতা

থার্মোস্ট্যাটের পারিপার্শ্বিক তাপমাত্রা পড়তে, ব্যবহার করুনতাপমাত্রা বৈশিষ্ট্য। ডিভাইসটিতে পারিপার্শ্বিক তাপমাত্রা পরিমাপ করা হয়।

থার্মোস্ট্যাটের পারিপার্শ্বিক আর্দ্রতা পড়তে, ব্যবহার করুনআর্দ্রতা বৈশিষ্ট্য। ডিভাইসটিতে পারিপার্শ্বিক আর্দ্রতা পরিমাপ করা হয়।

তাপমাত্রা স্কেল

গুগল নেস্ট থার্মোস্ট্যাট সেলসিয়াস বা ফারেনহাইট উভয় এককেই তাপমাত্রা প্রদর্শন করতে পারে, কিন্তু SDM API ব্যবহার করে স্কেলটি সেট করা যায় না। ব্যবহারকারী বর্তমানে কোন তাপমাত্রা স্কেল সেট করেছেন তা জানতে, ব্যবহার করুনসেটিংস বৈশিষ্ট্য।

মোড পরিবর্তন করুন

থার্মোস্ট্যাটের মোড দুটি ভিন্ন বৈশিষ্ট্য দ্বারা নিয়ন্ত্রিত হয়:থার্মোস্ট্যাট মোড এবংথার্মোস্ট্যাটইকো.

স্ট্যান্ডার্ড মোড

থার্মোস্ট্যাট মোডকে HEAT, COOL বা HEATCOOL-এ পরিবর্তন করতে, ThermostatMode ট্রেইটের SetMode কমান্ডটি ব্যবহার করুন।

উদাহরণস্বরূপ, স্ট্যান্ডার্ড থার্মোস্ট্যাট মোডগুলির মধ্যে একটি পরিবর্তন করতে:

POST /enterprises/project-id/devices/device-id:executeCommand
{
  "command" : "sdm.devices.commands.ThermostatMode.SetMode",
  "params" : {
    "mode" : "HEAT"
  }
}

{}

ইকো মোড

ইকো মোড চালু করতে, ThermostatEco ট্রেইটের SetMode কমান্ডে মোড হিসেবে MANUAL_ECO ব্যবহার করুন:

POST /enterprises/project-id/devices/device-id:executeCommand
{
  "command" : "sdm.devices.commands.ThermostatEco.SetMode",
  "params" : {
    "mode" : "MANUAL_ECO"
  }
}

{}

এই কমান্ডটি ইকো মোডের বর্তমান অবস্থা বা এর পরিবর্তনের উপর ভিত্তি করে অন্যান্য বৈশিষ্ট্যকে প্রভাবিত করে:

• ইকো মোড বন্ধ থাকলে, থার্মোস্ট্যাটটি ডিফল্টভাবে সর্বশেষ সক্রিয় থাকা স্ট্যান্ডার্ড মোডে (হিট, কুল, হিটকুল বা অফ) চলে যাবে।
• যদি ইকো মোড MANUAL_ECO হয়:
• এর জন্য কমান্ড থার্মোস্ট্যাট তাপমাত্রা সেটপয়েন্ট বৈশিষ্ট্যগুলো প্রত্যাখ্যাত হয়।
• তাপমাত্রার সেটপয়েন্টগুলি ফেরত দেওয়া হয় না থার্মোস্ট্যাট তাপমাত্রা সেটপয়েন্ট বৈশিষ্ট্য।

তাপমাত্রার সেটপয়েন্ট পরিবর্তন করুন

থার্মোস্ট্যাটটি শুধুমাত্র HEAT, COOL, বা HEATCOOL মোডে থাকলেই তাপমাত্রার সেটপয়েন্ট পরিবর্তন করা যায় এবং অনুমোদিত সেটপয়েন্টগুলো থার্মোস্ট্যাটের বর্তমান মোডের সাথে সামঞ্জস্যপূর্ণ থাকে। মোডটি OFF থাকলে বা ইকো মোড MANUAL_ECO-তে সেট করা থাকলে তাপমাত্রার সেটপয়েন্ট পরিবর্তন করা যায় না।

তাপমাত্রার সেটপয়েন্ট পরিবর্তন করার আগে থার্মোস্ট্যাটটিকে অবশ্যই ব্যবহৃত কমান্ডের সাথে সঙ্গতিপূর্ণ মোডে থাকতে হবে। সেটপয়েন্ট পরিবর্তন করার জন্য কমান্ড এবং ফিল্ড থার্মোস্ট্যাট মোড অনুযায়ী ভিন্ন হয়।

উদাহরণস্বরূপ, SetHeat কমান্ডটি জারি করতে হলে, থার্মোস্ট্যাটটিকে প্রথমে HEAT মোডে থাকতে হবে:

উল্লেখ্য যে, সেটপয়েন্ট কমান্ডগুলো প্যারামিটার হিসেবে শুধুমাত্র সেলসিয়াস ডিগ্রি গ্রহণ করে, যদিও গুগল নেস্ট থার্মোস্ট্যাট সেলসিয়াস বা ফারেনহাইট উভয় ডিগ্রিতেই তাপমাত্রা প্রদর্শন করতে পারে।

উদাহরণস্বরূপ, থার্মোস্ট্যাট HEAT মোডে থাকা অবস্থায় তাপমাত্রার সেটপয়েন্ট পরিবর্তন করতে, ThermostatTemperatureSetpoint ট্রেইটের SetHeat কমান্ডটি ব্যবহার করুন:

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

{}

ইকো মোড সেটপয়েন্ট

ThermostatEco ট্রেইট দ্বারা প্রত্যাবর্তিত heatCelsius এবং coolCelsius সেটপয়েন্টগুলি ব্যবহারকারী দ্বারা সেট করা হয় এবং SDM API-এর মাধ্যমে পরিবর্তন করা যায় না।

ফ্যানটি চালু বা বন্ধ করুন

যদি থার্মোস্ট্যাটে ফ্যান ব্যবহারের সুবিধা থাকে, তবে ফ্যানটি চালু বা বন্ধ করতে Fan ট্রেইটের SetTimer কমান্ডটি ব্যবহার করুন। চালু করার সময়, আপনি ফ্যানটি কতক্ষণ চালাতে চান, তা সেকেন্ডে নির্দিষ্ট করে দিতে পারেন।

উদাহরণস্বরূপ, ফ্যানটি এক ঘণ্টা চালানোর জন্য:

POST /enterprises/project-id/devices/device-id:executeCommand
{
  "command" : "sdm.devices.commands.Fan.SetTimer",
  "params" : {
    "timerMode" : "ON",
    "duration" : "3600s"
  }
}

{}

duration ক্ষেত্রটি পূরণ না করা হলে, ফ্যানটি পূর্বনির্ধারিত ১৫ মিনিটের জন্য চলবে।

ডিভাইসের সংযোগ পরীক্ষা করুন

যদি ডিভাইসটি কমান্ডে সাড়া না দেয় বা ইভেন্ট না পাঠায়, অথবা আপনি ডিভাইস-সম্পর্কিত API থেকে কোনো ত্রুটি পান, তাহলে ব্যবহার করুনসংযোগ ডিভাইসটি অফলাইন আছে কিনা তা পরীক্ষা করার জন্য এর কানেক্টিভিটি চেক করুন। ডিভাইসটির ইন্টারনেট সংযোগ পরীক্ষা করুন এবং নিশ্চিত করুন যে নেস্ট সার্ভিসটি চালু আছে।

আপনার ইভেন্ট চালু থাকলে, ডিভাইসটি অফলাইন হয়ে গেছে তা নির্দেশ করে আপনি একটি রিসোর্স ইভেন্টও পেয়ে থাকবেন:

{
  "eventId" : "6ac04910-dab8-40c0-8d16-63645e9b801c",
  "timestamp" : "2019-01-01T00:00:01Z",
  "resourceUpdate" : {
    "name" : "enterprises/project-id/devices/device-id",
    "traits" : {
      "sdm.devices.traits.Connectivity" : {
        "status" : "OFFLINE"
      }
    }
  },
  "userId": "AVPHwEuBfnPOnTqzVFT4IONX2Qqhu9EJ4ubO-bNnQ-yi",
  "resourceGroup" : [
    "enterprises/project-id/devices/device-id"
  ]
}

ডিভাইসের ইভেন্টগুলিতে প্রতিক্রিয়া জানান

কোনো ট্রেইট ফিল্ডে পরিবর্তন করা হলে একটি ইভেন্ট তৈরি হয়। উদাহরণস্বরূপ, থার্মোস্ট্যাটের HVAC স্ট্যাটাস HITING-এ পরিবর্তিত হলে আপনি নিম্নলিখিত resourceUpdate ইভেন্টটি পাবেন:

{
  "eventId" : "1dc5ae6d-7334-4a71-8bb1-3e50d452a322",
  "timestamp" : "2019-01-01T00:00:01Z",
  "resourceUpdate" : {
    "name" : "enterprises/project-id/devices/device-id",
    "traits" : {
      "sdm.devices.traits.ThermostatHvac" : {
        "status" : "HEATING"
      }
    }
  },
  "userId": "AVPHwEuBfnPOnTqzVFT4IONX2Qqhu9EJ4ubO-bNnQ-yi",
  "resourceGroup" : [
    "enterprises/project-id/devices/device-id"
  ]
}

এই ডিভাইস টাইপের সাথে যুক্ত সমস্ত বৈশিষ্ট্যের জন্য ইভেন্ট ট্রিগার করা হয়। ইন্টিগ্রেশনের অংশ হিসেবে যদি কোনোভাবে সেগুলিতে প্রতিক্রিয়া জানানোর প্রয়োজন হয়, তাহলে ইভেন্টগুলি সক্ষম করুন ।

ঘটনাগুলির সময়

উল্লেখ্য যে, HVAC অবস্থার পরিবর্তনের জন্য কোনো ইভেন্ট এবং থার্মোস্ট্যাট মোড পরিবর্তনের জন্য কোনো ইভেন্ট একই সময়ে ডেলিভার নাও হতে পারে।

উদাহরণস্বরূপ, HVAC সিস্টেমকে সুরক্ষিত রাখার জন্য কখনও কখনও একটি থার্মোস্ট্যাটের হিটিং বা কুলিং মোড চালু হতে বিলম্ব হয়। এই পরিস্থিতিতে, থার্মোস্ট্যাট মোড পরিবর্তন করলে প্রাথমিকভাবে শুধুমাত্র ইভেন্ট পাঠানো হতে পারে। থার্মোস্ট্যাট মোড এবং থার্মোস্ট্যাট তাপমাত্রা সেটপয়েন্ট বৈশিষ্ট্যের পরিবর্তন, সাথে থার্মোস্ট্যাটএইচভ্যাক সিস্টেমটি প্রকৃতপক্ষে চালু হওয়ার পরে বৈশিষ্ট্য পরিবর্তনের তথ্যটি একটি পৃথক ইভেন্ট হিসাবে পাঠানো হয়। যদি HVAC সিস্টেমটি চালু হতে কোনো বিলম্ব না থাকত, তাহলে তিনটি ইভেন্টই একই সময়ে পাঠানো হতো।

ত্রুটি

এই ডিভাইসটির ক্ষেত্রে নিম্নলিখিত ত্রুটি কোড(গুলি) প্রদর্শিত হতে পারে:

এপিআই ত্রুটি কোডগুলির সম্পূর্ণ তালিকার জন্য এপিআই ত্রুটি কোড রেফারেন্স দেখুন।