> For the complete documentation index, see [llms.txt](https://docs.kiloiot.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.kiloiot.io/kilo-docs-fr/kilo-iot-server/dashboards/adding-widgets/control-widget/switch.md).
# Interrupteur
Ajoutez un contrôle Interrupteur à un tableau de bord Kilo IoT pour basculer un appareil entre deux états — marche/arrêt, ouvert/fermé.
Le **Interrupteur** est le type de contrôle à deux états. C’est un interrupteur bascule pour une condition persistante — en marche ou arrêté, ouvert ou fermé, activé ou désactivé — où l’opérateur passe d’un état à l’autre et le tableau de bord indique lequel est actuellement actif.
## Quand l’utiliser
Utilisez un Switch lorsque l’appareil conserve un état durable que vous souhaitez à la fois **définir** et **voir**: pour activer ou désactiver un **pompe**, alimenter un **relais**, ouvrir ou fermer une **vanne**, ou démarrer et arrêter un **ventilateur**. Associez-le à une métrique d’état afin que l’interrupteur reflète l’état réel de l’équipement, et non seulement la dernière commande envoyée.
## Ce qu’il vous faut d’abord
* Un appareil commandable — dont les commandes sont définies dans son **onglet Commandes et états** onglet (voir [Création de commandes](/kilo-docs-fr/kilo-iot-server/devices/commands/creating-commands.md)).
* Une commande pour chaque état. Il peut s’agir d’une seule commande qui prend un paramètre d’état (par ex. `MARCHE, ARRÊT`) ou deux commandes distinctes.
* Un **Métrique de l’appareil** qui renvoie l’état actuel de l’appareil, afin que l’interrupteur puisse afficher correctement l’état activé ou désactivé.
## Comment le configurer
1. Ouvrez le tableau de bord dans **mode d’édition** → **Ajouter un widget** → **Contrôle**.
2. **Source de données** onglet : choisissez le **Appareil** et le **Métrique de l’appareil** qui reflète son état. Cliquez **Suivant**.
3. **Apparence** onglet : saisissez un **Nom du widget**, puis sous **Type de widget** choisissez **Interrupteur**.
4. Configurez les deux **liaisons d’état** — l' **Activé** ligne et la **Arrêt** ligne. Pour chacune :
* **Étiquette** — comment cet état est nommé sur le widget (par ex. « Activé » / « Désactivé »).
* **Commande** *(obligatoire)* — la commande envoyée par cet état.
* **Valeur attendue du capteur** *(requis une fois qu’une commande est définie)* — la valeur lue par la métrique de l’appareil lorsque cet état est actif. Elle est remplie automatiquement à partir de la commande lorsque c’est possible ; modifiez-la si votre capteur renvoie une valeur différente.
* Si la commande prend des paramètres, définissez chacun **Valeur**.
5. Définissez la **couleur de l’interrupteur** pour les **Activé**, **Arrêt**, et **Désactivé** états, activez/désactivez **Afficher les libellés**, et activez/désactivez **Afficher le nom et la dernière mise à jour**.
6. Cliquez sur **Enregistrer**.
## Ce qui se passe lorsque vous l’utilisez
Basculer l’interrupteur envoie la commande associée à l’état cible via la chaîne de commandes de l’appareil (la même que celle utilisée par l’onglet States). Le widget bascule de manière optimiste, puis se synchronise avec l’état réel une fois que la métrique de l’appareil répond — ainsi, si l’appareil refuse le nouvel état ou ne l’atteint pas, l’interrupteur revient à sa position précédente.
## Erreurs courantes
* **Aucune métrique d’état liée** — sans métrique de l’appareil, l’interrupteur peut envoyer des commandes mais ne peut pas afficher l’état réel. Liez toujours la mesure qui reflète l’état activé/désactivé.
* **Valeur attendue incorrecte** — si la valeur attendue du capteur ne correspond pas à ce que l’appareil renvoie réellement, l’interrupteur semblera désynchronisé. Vérifiez l’ *valeur actuelle* indication à côté du champ.
* **Un seul état possède une commande** — les liaisons On et Off doivent toutes deux avoir une commande pour un interrupteur à deux positions.
## Voir aussi
* [Widget de contrôle](/kilo-docs-fr/kilo-iot-server/dashboards/adding-widgets/control-widget.md) — aperçu et les autres types de commande
* [moteur Device Commands](/kilo-docs-fr/kilo-iot-server/devices/commands.md) — définissent les commandes sur lesquelles cet interrupteur agit
---
# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.
## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:
```
GET https://docs.kiloiot.io/kilo-docs-fr/kilo-iot-server/dashboards/adding-widgets/control-widget/switch.md?ask=&goal=
```
`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
