> 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-es/kilo-iot-server/dashboards/adding-widgets/control-widget/switch.md).
# Interruptor
Añade un control de interruptor a un panel IoT de Kilo para alternar un dispositivo entre dos estados — encendido/apagado, abierto/cerrado.
El **Interruptor** es el tipo de control de dos estados. Es un conmutador para una condición persistente — en funcionamiento o detenido, abierto o cerrado, habilitado o deshabilitado — donde el operador alterna entre dos estados y el panel muestra cuál está activo actualmente.
## Cuándo usarlo
Usa un interruptor cuando el dispositivo mantiene un estado duradero que quieres tanto **establecer** y **ver**: habilitar o deshabilitar un **bomba**, activar un **relé**, abrir o cerrar una **válvula**, o arrancar y detener un **ventilador**. Combínalo con una métrica de estado para que el conmutador refleje la condición real del equipo, no solo el último comando enviado.
## Lo que necesitas primero
* Un dispositivo controlable — uno con comandos definidos en su **pestaña Comandos y estados** pestaña (ver [Creación de comandos](/kilo-docs-es/kilo-iot-server/devices/commands/creating-commands.md)).
* Un comando para cada estado. Puede ser un solo comando que reciba un parámetro de estado (p. ej. `ENCENDIDO, APAGADO`) o dos comandos separados.
* Un **Métrica del dispositivo** que informe del estado actual del dispositivo, para que el interruptor pueda mostrar encendido o apagado correctamente.
## Cómo configurarlo
1. Abre el panel en **modo de edición** → **Añadir widget** → **Control**.
2. **Fuente de datos** pestaña: elige la **Dispositivo** y la **Métrica del dispositivo** que refleje su estado. Haz clic en **Siguiente**.
3. **Apariencia** pestaña: introduce un **Nombre del widget**, luego en **Tipo de widget** elige **Interruptor**.
4. Configura las dos **asignaciones de estado** — el **Activado** fila y la **Apagado** fila. Para cada una:
* **Etiqueta** — cómo se llama ese estado en el widget (p. ej., "Encendido" / "Apagado").
* **Comando** *(obligatorio)* — el comando que envía este estado.
* **Valor esperado del sensor** *(obligatorio una vez que se define un comando)* — lo que lee la métrica del dispositivo cuando este estado está activo. Se completa automáticamente a partir del comando cuando es posible; edítalo si tu sensor informa de un valor diferente.
* Si el comando acepta parámetros, configura cada **Valor**.
5. Configura el **color del interruptor** para los **Activado**, **Apagado**, y **Deshabilitado** estados, activa **Mostrar etiquetas**, y activa **Mostrar nombre y última actualización**.
6. Haz clic en **Guardar**.
## Qué sucede cuando lo usas
Al alternar el interruptor se envía el comando vinculado para el estado objetivo a través del flujo de comandos del dispositivo (el mismo que usa la pestaña Estados). El widget cambia de forma optimista y luego se ajusta al estado real cuando la métrica del dispositivo responde de vuelta — así que si el dispositivo rechaza el cambio o no alcanza el nuevo estado, el interruptor vuelve a donde estaba.
## Errores comunes
* **No hay ninguna métrica de estado vinculada** — sin una métrica del dispositivo, el interruptor puede enviar comandos pero no puede mostrar el estado real. Vincula siempre la lectura que refleje encendido/apagado.
* **Valor esperado incorrecto** — si el valor esperado del sensor no coincide con lo que el dispositivo realmente informa, el interruptor parecerá desincronizado. Comprueba la *valor actual* sugerencia con el campo.
* **Solo un estado tiene un comando** — tanto las asignaciones de Encendido como las de Apagado necesitan un comando para un conmutador de dos vías.
## Ver también
* [Widget de control](/kilo-docs-es/kilo-iot-server/dashboards/adding-widgets/control-widget.md) — descripción general y los otros tipos de control
* [Comandos del dispositivo](/kilo-docs-es/kilo-iot-server/devices/commands.md) — define los comandos con los que funciona este interruptor
---
# 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-es/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.
