--- title: "Se connecter à Crestron — CENNTIR" url: https://cenntir.com/crestron/ lang: fr --- # 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’étude] Raccordement de CENNTIR à Crestron : aucun processeur réel essayé à ce jour. La démonstration est une simulation. - [Ouvert ou fermé ?](https://cenntir.com/crestron/#ouvert-ferme) - [Ports, protocoles et identifiants](https://cenntir.com/crestron/#acces) - [Démonstration : la sonde se connecte](https://cenntir.com/crestron/#demonstration) - [Paramétrer par API, ou seulement piloter ?](https://cenntir.com/crestron/#parametrer) - [L’interface HTML5 (CH5) : comment on l’envoie](https://cenntir.com/crestron/#html5) - [SIMPL, toujours la façon de programmer ?](https://cenntir.com/crestron/#programmer) - [Ce qu’il faut demander avant d’intervenir](https://cenntir.com/crestron/#demander) - [Mini-formation en vidéo](https://cenntir.com/crestron/#formation) - [Marques et sources](https://cenntir.com/crestron/#marques) ## 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ès | Port par défaut | Identifiants | Ce qu’on y fait | |---|---|---|---| | Console texte (CTP) | 41795 ; chiffrée : 41797 | Compte administrateur du processeur | Version, adresse, programme chargé, diagnostic : les commandes de l’installateur. | | SSH et SFTP | 22, s’il est activé | Compte administrateur | La même console, et l’envoi de fichiers : programmes, interfaces HTML5. | | Page web de l’appareil | 443 | Compte administrateur, créé à la première connexion | Réseau, mises à jour, comptes et authentification. | | CIP | 41794 ; sécurisé : 41796 | IP ID déclaré dans le programme, et compte si l’authentification est active | Liaison des écrans tactiles, des modules et des applis Crestron avec le programme. Protocole propriétaire. | | API REST Crestron Home | 443, chemin `/cws/api` | Jeton « 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 HTML5 | 49200 (WebSocket sécurisé) | IP ID (0x03 par défaut), et compte si l’authentification est active | L’interface HTML5 ouverte dans un navigateur. | | API des appareils (DM NVX…) | 443, chemin `/Device/…` | Compte administrateur : cookies de session et jeton `X-CREST-XSRF-TOKEN` | Lire et modifier les réglages en JSON : nom, réseau, routage audio-vidéo. | | API XiO Cloud | Internet, HTTPS | Clé 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. - 01 Repérer le processeur - 02 S’identifier - 03 Lire la maison - 04 Agir avec accord - 05 Tracer Sonde CENNTIR · réseau de la domotique · simulation - $ audit scan --target 10.20.0.10 --ports 22,443,41794,41795,41796 - 22 · 443 · 41794 · 41795 · 41796 : ouverts - Signature Crestron : CIP 41794, console 41795, CIP sécurisé 41796 - Compte créé par l’intégrateur pour l’intervention, mot de passe tiré du coffre - $ ssh technicien@10.20.0.10 - CP4N> ver - CP4N · micrologiciel, programme chargé, adresse (sortie abrégée) - GET https://10.20.0.10/cws/api/login · Crestron-RestAPI-AuthToken: •••••••• - 200 · clé de session Crestron-RestAPI-AuthKey, valable environ 10 minutes - GET /cws/api/rooms - Salon · Pont soleil · Suite propriétaire · Cinéma - GET /cws/api/shades - Stores du salon : ouverts à 100 % - Assistant IA : « Baisse les stores du salon à moitié. » - Écriture sur un équipement : accord demandé au capitaine, code à usage unique - Accordé à 14:32 - POST /cws/api/shades/SetState {"shades":[{"id":1184,"position":32767}]} - 200 · stores du salon à 50 % - 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. | Couche | Piloter et lire | Paramétrer | Par où | |---|---|---|---| | Crestron Home, configuré à la tablette | Oui, par l’API REST et son jeton | Pas d’API publique | Appli 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 expose | En modifiant le programme | Outils du programmeur (Toolbox, SIMPL Windows, C#) ; un programme C# peut publier sa propre API de réglages | | Appareils récents (DM NVX…) | Oui | Oui, par une API REST documentée | Compte administrateur de l’appareil | | Serveur Crestron Virtual Control (VC-4) | État des programmes | Oui : programmes, instances, tables IP | API REST du serveur | | Parc dans XiO Cloud | Oui | Selon l’abonnement | Clé d’API XiO Cloud | **Si l’installateur paramètre tout à la tablette**, trois voies réalistes : - 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. - 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. - 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 - **Le modèle et l’adresse du processeur** CP4, PRO4, MC4… et son adresse sur le réseau de la domotique. - **Un compte nominatif** Créé pour l’intervention, avec les seuls droits nécessaires ; jamais un mot de passe partagé ou recopié. - **Le jeton Web API** Pour une installation Crestron Home : l’installateur le lit dans l’appli Setup et peut le changer à tout moment. - **Le programme ou son contrat** Pour un système programmé : la liste des joins, ou un contact avec le programmeur. - **L’accord écrit** Du propriétaire ou du capitaine, avec le périmètre : lecture seule, ou commandes autorisées. - **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 - [Introduction to Crestron Systems: Processors and Connectivity](https://www.youtube.com/watch?v=RbhDEi-IINM) Crestron · 9:24 · officielle La carte d’ensemble : processeurs, réseau et liaisons. - [Introduction to Crestron Systems: Crestron Toolbox™](https://www.youtube.com/watch?v=jNZr8ITamkg) Crestron · 2:00 · officielle Toolbox, l’outil de l’intégrateur, en deux minutes. ### Se connecter - [Crestron Toolbox™ Device Discovery Tool](https://www.youtube.com/watch?v=tJGpE13I-rk) Crestron Technical Institute · 4:53 · officielle Trouver les appareils Crestron présents sur le réseau. - [Crestron Toolbox™: Text Console](https://www.youtube.com/watch?v=YykZ397mElQ) Crestron Technical Institute · 5:18 · officielle La console texte : commandes, état et diagnostic. ### Crestron Home - [Crestron Home & Configure Pro 1 — Getting Started](https://www.youtube.com/watch?v=yenoi75jlYc) Crestron Technical Institute · 3:25 · officielle Premier pas avec Configure Pro, l’outil de configuration de Crestron Home. - [Crestron Home & Configure Pro 22 — Sideloading Drivers](https://www.youtube.com/watch?v=DNVyqnQ_myU) Crestron Technical Institute · 4:37 · officielle Ajouter un driver à une installation Crestron Home. ### Interfaces HTML5 - [Crestron HTML5 + VT Pro-e®: Where to start with Crestron HTML5](https://www.youtube.com/watch?v=a1UjRmXyJ58) Crestron Technical Institute · 3:36 · officielle Par où commencer une interface HTML5. - [How to Upload an HTML5 Project to a Crestron TS-1080](https://www.youtube.com/watch?v=dykezPZM2eY) AVstudio Inc · 0:45 · communauté L’envoi d’un projet HTML5 sur un écran tactile, en 45 secondes. - [CH5 Zero To Button!](https://www.youtube.com/watch?v=yLsk4NZ5ZYc) Nathan Hesson · 11:35 · communauté Du projet vide au premier bouton relié au programme. ### Programmer - [SIMPL Windows Primer Pt1 — Software, Processors & Control Methods Explained](https://www.youtube.com/watch?v=PF8cZoeF6lg) Arctic’s 8-Bit Bytes · 10:00 · communauté Les bases de SIMPL Windows : logiciels, processeurs, modes de contrôle. - [Writing C# for 4-Series™ Processors: Getting Started](https://www.youtube.com/watch?v=PDygKLNCH64) Crestron Technical Institute · 6:22 · officielle Premier programme en C# pour un processeur série 4. - [Crestron SIMPL+ Programming with Claude Code — Beginner’s Guide](https://www.youtube.com/watch?v=-WjkxPEe6p0) Arctic’s 8-Bit Bytes · 31:32 · communauté Un assistant IA (Claude Code) qui écrit du SIMPL+. ### À bord - [Azimut’s Trideck 38 uses a full Crestron control system on board](https://www.youtube.com/watch?v=MW6_OepfjSc) 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](https://docs.crestron.com/en-us/8525/Content/CP4R/Installer-Settings/Sys-Cont/Web-API.htm), [ports Ethernet (aide de Toolbox)](https://help.crestron.com/toolbox/Content/System_Info/Functions/Ethernet_Ports.htm), [guide de sécurité des systèmes résidentiels](https://fr.crestron.com/getmedia/db0e7324-f7f7-4964-af90-af7a9b05d541/mg_sr_crestron-residential-systems), [outil ch5-cli](https://www.npmjs.com/package/@crestron/ch5-utilities-cli), [API REST des DM NVX](https://sdkcon78221.crestron.com/sdk/DM_NVX_REST_API/Content/Topics/Making-API-Calls.htm), [API XiO Cloud](https://sdkcon78221.crestron.com/sdk/Crestron_XiO_Cloud_SDK/Content/Topics/Customer-Guidelines.htm). 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](https://cenntir.com/contact/)