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
- <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 sensortype– tipo de sensorvalue– valor actualstate– 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óniconSet(solostate/extended) – icono asignado al sensorname(solo «state/extended») – nombre que se le ha dado al sensor