Le code source de ce package est en ligne sur : https://github.com/myconstellation/constellation-packages/tree/master/Nest

Installation

Prérequis : créer un jeton de sécurité Nest

Pour installer le package Nest dans votre Constellation vous allez avoir besoin d’un jeton de sécurité pour autoriser le package à se connecter au service Nest.

Etape 1 : Créer un compte développeur Nest

Pour commencez donc par créer un compte sur https://developers.nest.com :

Etape 2 : Créer un produit Nest

Créez ensuite un “Product” en cliquant sur le bouton “Create New Product” :

Vous devrez alors fournir les informations sur votre “Produit”. Par exemple nommez-le “Constellation”.

Vous devrez également définir les autorisations accordées à ce produit : activer les différents services (Thermostat, Away, etc..) en “Read / Write” si vous souhaitez contrôler vos équipements Nest.

Une fois votre produit Nest créé, vous obtiendrez votre “Product ID” et “Product Secret” que vous gardez sous la main :

Etape 3 : Générer le jeton de sécurité pour le package Constellation

Vous pouvez maintenant générer un jeton de sécurité qui sera utilisé par le package Constellation.

Vous avez deux méthodes :

1. Via un script Powershell (à partir d’un poste Windows)
2. Manuellement

Pour la première méthode, téléchargez ce fichier ici, il s’agit d’un script Powershell à exécuter sur un poste Windows (voir le code source ici).

Une fois téléchargé sur votre poste Windows, ouvrez une invite de commande Powershell et lancez le script en passant en paramètre votre “Product ID” et “Product Secret” :

GetNestAccessToken.ps1 <<product ID>> <<product Secret>>

Vous devez valider le fait d’exécuter un script téléchargé sur Internet en entrant la lettre “O” en majuscule.

Le script ouvrira votre navigateur Internet sur une page de Nest vous demandant votre autorisation pour activer le produit que vous avez créé ci-dessus :

Il suffit de cliquer sur le bouton “Accepter” :

Vous obtiendrez en retour un code PIN temporaire :

Copiez alors ce code PIN dans le script PowerShell et celui ci vous retournera l’AccessToken (le jeton de sécurité) :

Ce jeton est également copié automatiquement dans votre presse-papier ! Vous pouvez maintenant le “coller” où vous souhaitez ! Gardez-le pour l’installation du package Constellation ci-dessous.

Installation du package Constellation

Depuis le “Online Package Repository” de votre Console Constellation, déployez le package Nest :

Une fois le package télécharger votre repository local, sélectionnez la sentinelle sur laquelle déployer le package.

Pour finir, sur la page de Settings, vous devez obligatoirement définir le jeton de sécurité obtenu précédemment pour accéder à votre compte Nest.

Si vous avez utiliser le script Powershell, l’AccessToken est déjà dans votre presse-papier, il suffit simplement de le coller dans la page de settings :

Bien entendu vos  pouvez également déployer ce package manuellement dans la configuration de votre Constellation :

<package name="Nest">
  <settings>
    <setting key="AccessToken" value="xxxxx" />
  </settings>
</package>

Détails du package

Les Settings

Les StateObjects

Vous retrouverez autant de StateObjects que d’objet et de structure Nest rattachés à votre compte :

Les MessageCallbacks

Le package expose un MessageCallback :

Quelques exemples

• Piloter et réguler la température avec un package C#
• Piloter le thermostat depuis un Dashboard HTML
• Synchroniser le mode absence du thermostat Nest avec l’alarme

The post Nest : pilotez et surveillez vos objets Nest dans votre Constellation appeared first on Constellation.