---
title: Ejemplos de interacciones entre controladores BleBox
description: "Cada controlador tiene su propio tipo de API, que se puede consultar en la pestaña «Detalles, actualización y ayuda»; por ejemplo, el sensor de temperatura tempSensor tiene el tipo de API multiSensor. La documentación detallada se encuentra en este enlace:…"
url: "https://faq.blebox.eu/es/docs/ejemplos-de-interacciones-entre-controladores-blebox/"
updated: "2026-10-08"
category: Ejemplos de interacciones entre dispositivos
---

# Ejemplos de interacciones entre controladores BleBox

Cada controlador tiene su propio tipo de API, que se puede consultar en la pestaña «Detalles, actualización y ayuda»; por ejemplo, el sensor de temperatura tempSensor tiene el tipo de API multiSensor.

La documentación detallada se encuentra en este enlace: https://technical.blebox.eu/

## switchBox

*Para acciones del tipo **«enviar URL**»:
– http://IP/s/(…REQUEST…)*

*Para acciones del tipo: **controlar otro dispositivo:*** *– (…REQUEST…)*

*donde (…REQUEST…) es el número que se describe a continuación:*

- *0 – desactiva*
- *1 – se enciende*
- *2 – cambia el estado al contrario (si estaba activado, lo desactiva, y viceversa)*

**Avanzado:**

- 1/forTime/(…TIMES…)/ns/0

*donde (…TIMES…) es el tiempo, en segundos, durante el cual debe permanecer encendido el switchBox*

*Ejemplos:*

- 1/forTime/5/ns/0: el dispositivo conectado se encenderá durante 5 segundos

## switchBox con varias salidas

*Para acciones del tipo: **«Enviar URL**»:
 – http://IP/s/(…OUTPUT…)/(…REQUEST…)*

*Para acciones del tipo: **controlar otro dispositivo:*** *– (…OUTPUT…)/(…REQUEST…)*

*donde (…OUTPUT…) es la cifra que se describe a continuación:*

- *0 – primera salida (O1)*
- *1 – segunda salida (O2)*

*donde (…REQUEST…) es el número que se describe a continuación:*

- *0 – desactiva*
- *1 – se enciende*
- *2 – cambia el estado al contrario (si estaba activado, lo desactiva, y viceversa)*

*Ejemplos:*

- 0/1: activa la salida O1
- 1/1: activa la salida O2
- 0/2: cambia el estado de la salida O1 al contrario *(si la salida estaba activada, la desactivará, y viceversa)*

**Avanzado:**

- (…OUTPUT…)/1/durante un tiempo/(…TIMES…)/ns/0

*donde (…OUTPUT…) es el número de salida (véase más arriba) y donde (…TIMES…) es el tiempo, en segundos, durante el cual debe permanecer activada la salida switchBoxD.*

*Ejemplos:*

- 0/1/forTime/5/ns/0: activa la salida O1 durante 5 segundos
- 1/1/forTime/5/ns/0: activa la salida O2 durante 5 segundos

## en LightBoxS y dimmerBox

*Para acciones del tipo **«enviar URL**»:
– http://IP/s/(…REQUEST…)*

*Para acciones del tipo: **controlar otro dispositivo:*** *– (…REQUEST…)*

*donde (…REQUEST…) es el valor de brillo en formato WW. Se representa en hexadecimal con dos caracteres (00-FF, lo que corresponde a la representación decimal: 0-255):*

- *00 – apaga*
- *FF: enciende y ajusta el brillo al 100 %*

*Ejemplos:*

- 00 – se apagará
- 19 – lo encenderá y ajustará el brillo al 10 %
- 33 – lo encenderá y ajustará el brillo al 20 %
- 4D: se encenderá y ajustará el brillo al 30 %
- 66 – lo encenderá y ajustará el brillo al 40 %
- 7F: se enciende y ajusta el brillo al 50 %
- 99: lo encenderá y ajustará el brillo al 60 %
- B3: se enciende y ajusta el brillo al 70 %
- CC: se enciende y ajusta el brillo al 80 %
- E6: se enciende y ajusta el brillo al 90 %
- FF: se enciende y ajusta el brillo al 100 %

**Avanzado en LightBoxS:**

- offon/last —> cambia el estado: apagado / último estado (último nivel de luminosidad)
- onlast —> siempre activa el último estado
- inc/XX —> aumenta el brillo actual en XX (hex)
- dec/XX —> reduce el brillo actual en XX (hex)
- x/(…EFFECT_ID…) —> activa el efecto con el ID indicado (0-9)
- x/(…EFFECT_ID…)/forTime/(…TIME_S…) —> activa el efecto indicado durante el tiempo especificado
- XX/colorFadeMs/(…TIME_MS…) —> activa el nivel de brillo indicado con el tiempo de aumento de brillo establecido
- XX/forTime/(…TIME_S…) —> activa el nivel de luminosidad indicado durante el tiempo establecido
- s/XX/colorFadeMs/(…TIME_MS…)/forTime/(…TIME_S…) —> activa el nivel de brillo indicado durante el tiempo establecido, con un tiempo de aumento de brillo predeterminado

*donde XX es un valor comprendido entre 0 y FF, (…TIME_S…) es el tiempo en segundos, (…TIME_MS…) es el tiempo de atenuación en milisegundos y (…EFFECT_ID…) es un dígito: el número del efecto de la aplicación (0-9).*

**dimmerBox avanzado:**

- offon/last —> cambia el estado: apagado / último estado (último nivel de luminosidad)
- offon/toggle —> cambia el estado: apagado / encendido (máx. 100 %)
- offon/XX —> cambia el estado: off / XX (brillo en HEX 00-FF)
- onlast —> siempre activa el último estado
- onfull —> siempre se activa al máximo (igual que /s/FF)
- off —> desactiva (igual que /s/00)
- inc/XX —> aumenta el brillo actual en XX (hex)
- dec/XX —> reduce el brillo actual en XX (hex)

## wLighBox (5CH) y pixelBox

**Acciones**(órdenes) **para el producto en LightBox y pixelBox:**

*Para acciones del tipo: **«Enviar URL**»:
 – http://IP/s/(…CHANNELS…)*

*Para acciones del tipo: **controlar otro dispositivo:*** *– (…CHANNELS…)*

*donde (…CHANNELS…) son 5 valores de brillo (RR-GG-BB-WW-CW). Se expresan en formato hexadecimal, con dos caracteres por cada color o canal de la cinta LED (00-FF, lo que equivale a la notación decimal: 0-255), respectivamente:*

- RR – es decir, 00-FF (0-255) – intensidad del color rojo / canal 1
- GG —es decir, 00-FF (0-255)—: intensidad del color verde / canal 2
- BB —es decir, 00-FF (0-255)—: brillo del color azul / canal 3
- WW —es decir, 00-FF (0-255)—: brillo del color blanco cálido / canal 4
- CW —es decir, 00-FF (0-255)—: brillo del color blanco frío / canal 5

*Escala de luminosidad recalculada:*

- 00 – brillo al 0 %
- 19 – luminosidad del 10 %
- 33 – brillo del 20 %
- 4D – luminosidad del 30 %
- 66 – brillo al 40 %
- 7F – brillo al 50 %
- 99 – brillo al 60 %
- B3 – brillo al 70 %
- CC – brillo al 80 %
- E6 – brillo al 90 %
- FF – brillo al 100 %

*Ejemplos:*

- 0000000000: apaga la tira LED / todos los canales apagados
- FF00000000: activa el color rojo / canal 1 activado, el resto desactivado
- 00FF000000: activa el color verde / canal 2 activado, el resto desactivado
- 0000FF0000: activa el color azul / canal 3 activado, el resto desactivado
- 000000FF00: activa el color blanco cálido / canal 4 activado, el resto desactivado
- 00000000FF: activa el color blanco frío / canal 5 activado, el resto desactivado

- FFFFFF0000: activa el color blanco (rojo, verde, azul)
- FFFF000000: activa el color amarillo (rojo, verde)
- FF00FF0000: activa el color fucsia (rojo, azul)
- 00FFFF0000: activa el color cian (verde, azul)
- FF7F000000: activa el color naranja (rojo, 50 % de verde)

**Avanzado:**

- offon/último

*activará o desactivará el último color o nivel de brillo configurado para los canales. En otras palabras, si la tira LED está encendida, se apagará; si está apagada, se encenderá con el último color configurado.*

- (…CANALES…)/durante un tiempo/(…VECES…)

*donde (…CHANNELS…) son los 4 valores de intensidad (véase más arriba) y donde (…TIMES…) es el tiempo, en segundos, durante el cual debe mantenerse la intensidad o el color establecido.*

- x/(…EFFECT_ID…)

*donde (…EFFECT_ID…) es un número: el número del efecto de la aplicación (0-9).*

*Ejemplos:*

- offon/last: *activa o desactiva el último ajuste de color o brillo de los canales.*
- FF00000000/forTime/5: activará el color rojo durante 5 segundos
- x/0: desactiva el efecto
- x/1: activa el efecto número 1
- x/5: activa el efecto número 5

## shutterBox

*Para acciones del tipo **«enviar URL**»:
– http://IP/s/(…REQUEST…)*

*Para acciones del tipo: **controlar otro dispositivo:*** *– (…REQUEST…)*

*donde (…REQUEST…) es un carácter o un valor (en caso de que se haya realizado la calibración en el controlador) que se describe a continuación:*

- u – abrir
- d – cerrar
- s – alto
- n – siguiente comando de la secuencia (el siguiente comando en la secuencia abrir-parar-cerrar-parar)
- f – posición favorita (solo con el controlador calibrado)

*Ejemplos:*

- u – provocará que se abra
- d – provocará el cierre
- s – provocará una parada
- n- ejecutará el siguiente comando de la secuencia abrir-parar-cerrar-parar
- f – hará que el dispositivo se desplace hasta la posición favorita

**Avanzado:**

- p/(…VALUE_PERCENTAGE…)
- t/(…VALUE_PERCENTAGE…)

*donde (…VALUE_PERCENTAGE…) es un número comprendido entre 0 y 100 que indica el porcentaje de cierre (solo con un controlador calibrado).*

*Ejemplos:*

- p/0: provocará la apertura (equivalente a «u»)
- p/100: provocará el cierre (equivalente a d)
- p/50: hará que la puerta se cierre hasta la mitad
- t/0: provocará un ajuste mínimo de las lamas en función del motor
- t/100: provocará el ajuste máximo de las lamas en función del motor
- t/50: ajustará las lamas en función del motor

## rollerGate

*Para acciones del tipo **«enviar URL**»:
– http://IP/s/(…REQUEST…)*

*Para acciones del tipo: **controlar otro dispositivo:*** *– (…REQUEST…)*

*donde (…REQUEST…) es el carácter que se describe a continuación:*

- o – abrir
- c – cerrar
- s – alto
- n – siguiente comando de la secuencia (el siguiente comando en la secuencia abrir-parar-cerrar-parar)
- w – posición de paso/ventilación (solo con el controlador calibrado)

*Ejemplos:*

- o – provocará que se abra
- c – provocará el cierre
- s – provocará una parada
- n: ejecutará el siguiente comando de la secuencia «abrir-parar-cerrar-parar»
- w – hará que el coche se desplace hasta la posición favorita, los pasos de peatones o la ventilación

**Avanzado:**

- p/(…VALUE_PERCENTAGE…)

*donde (…VALUE_PERCENTAGE…) es un número comprendido entre 0 y 100 que indica el porcentaje de cierre de la puerta (solo con un controlador calibrado).*

*Ejemplos:*

- p/0: provocará la apertura (equivalente a o)
- p/100: provocará el cierre (equivalente a c)
- p/50: hará que la puerta se cierre hasta la mitad

## gateBox

*Para acciones del tipo **«enviar URL**»:
– http://IP/s/(…REQUEST…)*

*Para acciones del tipo: **controlar otro dispositivo:*** *– (…REQUEST…)*

*donde (…REQUEST…) es el carácter que se describe a continuación:*

- p – activa la primera salida (impulso en la entrada del pulsador del controlador de la puerta)
- s – controla la segunda salida (impulso en la entrada del pulsador del controlador de la puerta), (no disponible en el caso del doorBox)

*Ejemplos:*

- p – activará la salida del primero
- s – activará la salida número dos (no disponible en el caso del doorBox)

## saunaBox

**Acciones**(órdenes) **para el producto saunaBox:**

*Para acciones del tipo **«enviar URL**»:
– http://IP/s/(…REQUEST…)*

*Para acciones del tipo: **controlar otro dispositivo:*** *– (…REQUEST…)*

*donde (…REQUEST…) es el número que se describe a continuación:*

- 0 – desactivar la calefacción
- 1 – Activa la calefacción con la última temperatura programada

*Ejemplos:*

- 0: desactivará la calefacción
- 1 – activará la calefacción con la última temperatura programada

**Avanzado:**

- t/(…TEMPERATURE_X100…)

*donde (…TEMPERATURE_X100…) es la temperatura multiplicada por 100, es decir, de -5500 a 12500 (de -55 a +125).*

*Ejemplos:*

- t/0: ajusta la temperatura a 0 grados (no enciende ni apaga la sauna)
- t/125: ajusta la temperatura a 125 grados (no enciende ni apaga la sauna)
- t/60: ajusta la temperatura a 60 grados (no enciende ni apaga la sauna)

## thermoBox

*Para acciones del tipo **«enviar URL**»:
– http://IP/s/(…REQUEST…)*

*Para acciones del tipo: **controlar otro dispositivo:*** *– (…REQUEST…)*

*donde (…REQUEST…) es el número que se describe a continuación:*

- 0 – apagar el controlador
- 1 – Enciende el regulador con la última temperatura programada
- 3 – activa el modo BOOST

*Ejemplos:*

- 0: desactivará la calefacción
- 1 – activará la calefacción con la última temperatura programada

**Avanzado:**

- 1/t/(…TEMPERATURE_X100…)
- 0/t/(…TEMPERATURE_X100…)
- t/(…TEMPERATURE_X100…)
- t/inc/(…TEMPERATURE_X100…)
- t/dec/(…TEMPERATURE_X100…)

*donde (…TEMPERATURE_X100…) es la temperatura multiplicada por 100, es decir, de -5500 a 12500 (de -55 a +125).*

*Ejemplos:*

- 1/t/2300: activará el regulador y ajustará la temperatura a 23 grados
- t/2000: ajustará la temperatura a 20 grados (no enciende ni apaga el regulador)
- t/2250: ajustará la temperatura a 22,5 grados (no enciende ni apaga el regulador)
- 0/t/2100: apagará el regulador y ajustará la temperatura a 21 (por ejemplo, para la próxima temporada de calefacción)
- t/inc/100: provocará un aumento de la temperatura de 1 grado
- t/dec/50: reducirá la temperatura en 0,5 grados

## actionBox

*Para acciones del tipo **«enviar URL**» (atención: a diferencia de otros controladores)
: http://IP/t/(…REQUEST…)*

*Para acciones del tipo: **controlar otro dispositivo:*** *– (…REQUEST…)*

*donde (…REQUEST…) es **/**, donde:*

- ***<número del botón>** es un número del 0 al 3 (correspondiente al número del botón del actionBox marcado del 1 al 4)*
- ***<número del disparador>*** es el disparador configurado en actionBox:
  - 1 – pulsación breve
  - 2 – pulsación prolongada
  - 3 – Flanco descendente (por ejemplo, al soltar un botón)
  - 4 – flanco ascendente (por ejemplo, al pulsar un botón)
  - 5 – la pendiente (por ejemplo, tanto al soltar como al apretar)

*Ejemplos:*

- 0/1
- 2/5

## multiSensor

**Acciones**(órdenes) **para el producto saunaBox:**

*Para acciones del tipo **«Enviar URL**»:
– http://IP/(…ENDPOINT…)*

*donde (…ENDPOINT…) es la ruta que se describe a continuación:*

- *`state` –* devuelve el estado **básico** de los sensores (id, type, value, state, trend, elapsedTimeS)
- `state/extended` – mostrará los datos completos de los sensores, junto con sus nombres e iconos

### Tipos de sensores (`type` en respuesta a `state`)

- `temperature` – temperatura
- Otros tipos, en función del modelo o la configuración de las sondas: véase `api/probes/state`

### Campos que describen un sensor individual

- *`id` –* número de sensor
- `type` – tipo de sensor
- `value` – valor actual
- `state` – estado de la medición (código numérico)
- `trend` – dirección de la tendencia del valor (código numérico)
- `elapsedTimeS` – tiempo (s) transcurrido desde la última medición
- *`iconSet` (solo `state/extended`)*– icono asignado al sensor
- *`name` (solo «`state/extended`»)* – nombre que se le ha dado al sensor