CENNTIR
Se connecter à Crestron

Se brancher sur un système Crestron, dans une villa ou à bord.

Crestron pilote la lumière, les stores, le climat et l’audiovisuel de nombreuses villas et de nombreux yachts. Ce qui est ouvert, ce qui est fermé, les identifiants à demander, ce qu’une API permet vraiment, et comment une sonde CENNTIR s’y brancherait.

À l’étudeRaccordement de CENNTIR à Crestron : aucun processeur réel essayé à ce jour. La démonstration est une simulation.

Ouvert ou fermé ?

Ni l’un ni l’autre : tout passe par un compte.

  • Fermé : le protocole des écrans et des modules (CIP), le programme du processeur et les outils de l’intégrateur, réservés au réseau des revendeurs Crestron.
  • Ouvert avec un compte : la console texte, la page web des appareils, l’envoi de fichiers, l’API REST de Crestron Home (avec un jeton) et l’API documentée des appareils récents.
  • Dans le nuage : XiO Cloud, l’outil de gestion de parc de Crestron, a une API sur abonnement.

Les processeurs de la série 4 sortent d’usine avec l’authentification activée : à la première connexion, on crée le compte administrateur. Il n’y a donc pas de mot de passe d’usine à connaître ; on travaille avec le compte de l’intégrateur, ou un compte qu’il crée pour l’intervention. Sur les générations précédentes, l’authentification devait être activée par l’installateur : c’est l’un des premiers points à vérifier.

Ports, protocoles et identifiants

Ce que l’on rencontre sur le réseau d’un système Crestron. Ce sont les ports par défaut : l’intégrateur peut les changer.

AccèsPort par défautIdentifiantsCe qu’on y fait
Console texte (CTP)41795 ; chiffrée : 41797Compte administrateur du processeurVersion, adresse, programme chargé, diagnostic : les commandes de l’installateur.
SSH et SFTP22, s’il est activéCompte administrateurLa même console, et l’envoi de fichiers : programmes, interfaces HTML5.
Page web de l’appareil443Compte administrateur, créé à la première connexionRéseau, mises à jour, comptes et authentification.
CIP41794 ; sécurisé : 41796IP ID déclaré dans le programme, et compte si l’authentification est activeLiaison des écrans tactiles, des modules et des applis Crestron avec le programme. Protocole propriétaire.
API REST Crestron Home443, chemin /cws/apiJeton « Web API » de l’appli Crestron Home Setup (Settings › System Control Options › Web API Settings)Lire et commander pièces, scènes, lumières, stores, thermostats et capteurs.
XPanel HTML549200 (WebSocket sécurisé)IP ID (0x03 par défaut), et compte si l’authentification est activeL’interface HTML5 ouverte dans un navigateur.
API des appareils (DM NVX…)443, chemin /Device/…Compte administrateur : cookies de session et jeton X-CREST-XSRF-TOKENLire et modifier les réglages en JSON : nom, réseau, routage audio-vidéo.
API XiO CloudInternet, HTTPSClé d’abonnement (en-tête XiO-subscription-key) et identifiant de compte, une fois l’accès API activéInventaire et état du parc ; certaines fonctions demandent l’abonnement Premium.

Démonstration : la sonde se connecte

Ce que ferait une sonde CENNTIR placée sur le réseau de la domotique, avec un compte et un jeton fournis par l’intégrateur : repérer le processeur, s’identifier, lire la maison, agir après accord, tout tracer. Simulation sur des adresses fictives.

  1. 01 Repérer le processeur
  2. 02 S’identifier
  3. 03 Lire la maison
  4. 04 Agir avec accord
  5. 05 Tracer

Sonde CENNTIR · réseau de la domotique · simulation

  1. $ audit scan --target 10.20.0.10 --ports 22,443,41794,41795,41796
  2. 22 · 443 · 41794 · 41795 · 41796 : ouverts
  3. Signature Crestron : CIP 41794, console 41795, CIP sécurisé 41796
  4. Compte créé par l’intégrateur pour l’intervention, mot de passe tiré du coffre
  5. $ ssh technicien@10.20.0.10
  6. CP4N> ver
  7. CP4N · micrologiciel, programme chargé, adresse (sortie abrégée)
  8. GET https://10.20.0.10/cws/api/login · Crestron-RestAPI-AuthToken: ••••••••
  9. 200 · clé de session Crestron-RestAPI-AuthKey, valable environ 10 minutes
  10. GET /cws/api/rooms
  11. Salon · Pont soleil · Suite propriétaire · Cinéma
  12. GET /cws/api/shades
  13. Stores du salon : ouverts à 100 %
  14. Assistant IA : « Baisse les stores du salon à moitié. »
  15. Écriture sur un équipement : accord demandé au capitaine, code à usage unique
  16. Accordé à 14:32
  17. POST /cws/api/shades/SetState {"shades":[{"id":1184,"position":32767}]}
  18. 200 · stores du salon à 50 %
  19. Journal · 14:32 · stores du salon 100 → 50 % · demandé par l’assistant IA · accordé par le capitaine · API Crestron Home

Côté CENNTIR, l’API REST de Crestron Home relève d’une fiche de connecteur HTTPS, et la console d’une fiche SSH : à écrire, puis à qualifier sur une première installation.

Paramétrer par API, ou seulement piloter ?

L’API de Crestron Home pilote ce que l’installateur a construit ; elle ne le construit pas. Créer une pièce, ajouter un appareil, définir une scène : cela se fait dans l’appli Crestron Home Setup, sur tablette ou sur ordinateur, avec le compte administrateur du processeur, ou dans Configure Pro, l’outil des revendeurs. Aucune API publique ne fait ce travail à leur place.

CouchePiloter et lireParamétrerPar où
Crestron Home, configuré à la tabletteOui, par l’API REST et son jetonPas d’API publiqueAppli Crestron Home Setup (iPad, Mac, PC) ou Configure Pro, avec le compte administrateur ; Configurator en ligne et code de déploiement, avec un compte revendeur myCrestron
Système programmé (SIMPL, C#)Ce que le programme exposeEn modifiant le programmeOutils du programmeur (Toolbox, SIMPL Windows, C#) ; un programme C# peut publier sa propre API de réglages
Appareils récents (DM NVX…)OuiOui, par une API REST documentéeCompte administrateur de l’appareil
Serveur Crestron Virtual Control (VC-4)État des programmesOui : programmes, instances, tables IPAPI REST du serveur
Parc dans XiO CloudOuiSelon l’abonnementClé d’API XiO Cloud

Si l’installateur paramètre tout à la tablette, trois voies réalistes :

  1. Garder la tablette pour la configuration, et brancher l’assistant IA sur l’API REST pour l’usage courant : scènes, stores, climat, état des capteurs.
  2. Préparer la configuration dans le Configurator en ligne de Crestron, puis la déployer sur le processeur par un code : c’est l’outil prévu, avec un compte revendeur.
  3. Faire ce que fait l’installateur, avec son compte, dans l’appli de configuration sur un ordinateur : une sonde CENNTIR sait piloter l’écran d’un ordinateur, mais ce n’est pas une API, et ce n’est pas essayé sur Crestron.

Ce que nous excluons : la rétro-ingénierie des échanges de l’appli, le contournement de l’authentification et les mots de passe par défaut.

L’interface HTML5 (CH5) : comment on l’envoie

Les écrans tactiles Crestron récents affichent des interfaces HTML5 : une application web (HTML, CSS, JavaScript, avec Angular, React ou Svelte au besoin), dessinée dans Crestron Construct ou écrite avec la bibliothèque CH5 de Crestron. La même interface peut aussi s’ouvrir dans un navigateur (XPanel).

L’envoyer est facile : deux commandes de l’outil ch5-cli de Crestron (paquet npm), avec le compte de l’écran.

npx ch5-cli archive -p salon-v1 -d dist -o sortie
npx ch5-cli deploy -p -H 10.20.0.31 -t touchscreen sortie/salon-v1.ch5z
  • La première commande produit une archive .ch5z ; la seconde l’envoie par SFTP et demande le compte de l’écran (-p).
  • Cible touchscreen pour un écran ; web (ou controlsystem) pour publier sur le processeur la version navigateur (XPanel), ouverte ensuite à https://processeur/projet/index.html : option XPanel activée dans le projet, WebSocket sécurisé 49200, IP ID 0x03 par défaut ou ?ipId= dans l’adresse.
  • Dans les réglages de l’écran, la table IP indique le processeur et l’IP ID à joindre.

Savoir quoi brancher, c’est l’autre moitié. Les boutons d’une interface CH5 parlent au programme du processeur par des « joins » numérotés (marche-arrêt, valeurs, textes), décrits dans un contrat (Contract Editor, fichier .cse2j). Sans le programme ou ce contrat, on ne sait pas quel numéro allume quoi : le débogueur SIMPL de Toolbox permet de les observer, mais la liste vient de l’intégrateur. Sur une installation Crestron Home, on passe plutôt par l’API REST ou par un driver.

Une interface CH5 est un projet web, comme ceux que CENNTIR dessine déjà pour tablettes et Android TV : l’assistant IA peut la produire et la sonde du bord l’envoyer avec ch5-cli, à qualifier sur un premier écran.

SIMPL, toujours la façon de programmer ?

Oui, mais ce n’est plus la seule.

  • SIMPL Windows (programmation par blocs) et SIMPL+ (modules en texte) restent pris en charge et très répandus, en particulier sur les installations existantes.
  • C# (SIMPL# Pro) : la voie actuelle sur les processeurs série 4 et sur Crestron Virtual Control ; le kit de développement est publié sur NuGet et suivi (version de septembre 2026).
  • Crestron Home : pas de programmation ; configuration avec l’appli Setup ou Configure Pro, extensions par des drivers écrits en C#.
  • Interfaces : HTML5 (CH5) avec Crestron Construct, à côté de VT Pro-e, l’outil historique.

Les assistants IA écrivent déjà du SIMPL+ et des interfaces CH5 (voir la mini-formation). Le programme reste à compiler, à charger et à essayer avec les outils Crestron, par le programmeur de l’installation.

Ce qu’il faut demander avant d’intervenir

  1. Le modèle et l’adresse du processeur CP4, PRO4, MC4… et son adresse sur le réseau de la domotique.
  2. Un compte nominatif Créé pour l’intervention, avec les seuls droits nécessaires ; jamais un mot de passe partagé ou recopié.
  3. Le jeton Web API Pour une installation Crestron Home : l’installateur le lit dans l’appli Setup et peut le changer à tout moment.
  4. Le programme ou son contrat Pour un système programmé : la liste des joins, ou un contact avec le programmeur.
  5. L’accord écrit Du propriétaire ou du capitaine, avec le périmètre : lecture seule, ou commandes autorisées.
  6. Les règles du réseau Le réseau de la domotique et ce qui peut y entrer. Un processeur ne s’expose jamais directement sur Internet.

Mini-formation en vidéo

13 vidéos, 1 h 37 au total, dans l’ordre où les regarder, en anglais. « Officielle » signale une vidéo de Crestron ou du Crestron Technical Institute ; les autres viennent d’intégrateurs et de formateurs.

Comprendre l’architecture

  1. Introduction to Crestron Systems: Processors and Connectivity (nouvel onglet) Crestron · 9:24 · officielle La carte d’ensemble : processeurs, réseau et liaisons.
  2. Introduction to Crestron Systems: Crestron Toolbox™ (nouvel onglet) Crestron · 2:00 · officielle Toolbox, l’outil de l’intégrateur, en deux minutes.

Se connecter

  1. Crestron Toolbox™ Device Discovery Tool (nouvel onglet) Crestron Technical Institute · 4:53 · officielle Trouver les appareils Crestron présents sur le réseau.
  2. Crestron Toolbox™: Text Console (nouvel onglet) Crestron Technical Institute · 5:18 · officielle La console texte : commandes, état et diagnostic.

Crestron Home

  1. Crestron Home & Configure Pro 1 — Getting Started (nouvel onglet) Crestron Technical Institute · 3:25 · officielle Premier pas avec Configure Pro, l’outil de configuration de Crestron Home.
  2. Crestron Home & Configure Pro 22 — Sideloading Drivers (nouvel onglet) Crestron Technical Institute · 4:37 · officielle Ajouter un driver à une installation Crestron Home.

Interfaces HTML5

  1. Crestron HTML5 + VT Pro-e®: Where to start with Crestron HTML5 (nouvel onglet) Crestron Technical Institute · 3:36 · officielle Par où commencer une interface HTML5.
  2. How to Upload an HTML5 Project to a Crestron TS-1080 (nouvel onglet) AVstudio Inc · 0:45 · communauté L’envoi d’un projet HTML5 sur un écran tactile, en 45 secondes.
  3. CH5 Zero To Button! (nouvel onglet) Nathan Hesson · 11:35 · communauté Du projet vide au premier bouton relié au programme.

Programmer

  1. SIMPL Windows Primer Pt1 — Software, Processors & Control Methods Explained (nouvel onglet) Arctic’s 8-Bit Bytes · 10:00 · communauté Les bases de SIMPL Windows : logiciels, processeurs, modes de contrôle.
  2. Writing C# for 4-Series™ Processors: Getting Started (nouvel onglet) Crestron Technical Institute · 6:22 · officielle Premier programme en C# pour un processeur série 4.
  3. Crestron SIMPL+ Programming with Claude Code — Beginner’s Guide (nouvel onglet) Arctic’s 8-Bit Bytes · 31:32 · communauté Un assistant IA (Claude Code) qui écrit du SIMPL+.

À bord

  1. Azimut’s Trideck 38 uses a full Crestron control system on board (nouvel onglet) Crestron EMEA · 3:11 · officielle Un yacht entièrement piloté par Crestron.

Les liens ouvrent YouTube dans un nouvel onglet. Les cours complets du Crestron Technical Institute demandent un compte Crestron.

Marques et sources

Crestron, Crestron Home, Crestron Toolbox, SIMPL, XiO Cloud et Crestron Construct sont des marques de Crestron Electronics, Inc. CENNTIR n’est ni revendeur ni partenaire de Crestron.

Sources : réglages Web API de Crestron Home, ports Ethernet (aide de Toolbox), guide de sécurité des systèmes résidentiels, outil ch5-cli, API REST des DM NVX, API XiO Cloud. Les chemins et en-têtes de l’API REST de Crestron Home sont repris d’intégrations publiées par des tiers ; ils n’ont pas été essayés par CENNTIR.

Un système Crestron à bord ou dans une villa ?

Nous partons de votre installation et de l’accord de l’intégrateur pour qualifier une première connexion, en lecture seule d’abord.

Parler de votre installation →