Sensores inalámbricos y Yggio, la capa operativa de datos abierta para ciudades, propietarios inmobiliarios y operadores de transporte. Sus datos, sus operaciones, su soberanía.

LoRaWAN Manual de usuario

Square Air para LoRaWAN

Square Air está descatalogado y lo sustituye Square Air 2. Este manual se mantiene aquí para los sensores Square Air que ya están en servicio: calidad del aire interior mediante un sensor de gas de óxido metálico (IAQ, bVOC y equivalente de CO₂), con temperatura, humedad, presión y luz, y una batería de 6000 mAh.

Revisión B · noviembre de 2026 · Sensative AB

Guía rápida

1Introducción

Square Air mide la calidad del aire interior con un sensor de gas de óxido metálico (Bosch BME688): un índice de calidad del aire (IAQ), breath-VOC y un equivalente de CO₂, junto con la presión atmosférica, la temperatura, la humedad relativa y la luz. Los comunica a través de LoRaWAN. Mide 58 × 58 × 15 mm, está pensado para estancias interiores secas (IP30) y tiene dos pequeños orificios en el frontal.

Una memoria integrada registra las lecturas mientras el sensor no tiene red y las envía por LoRaWAN en cuanto vuelve a estar conectado, de modo que no se pierde ningún dato. El posicionamiento por Wi-Fi puede indicarle dónde está cada sensor. La batería está integrada (6000 mAh) y dura unos 6–7 años con medición continua, y unos 12 años si solo mide en horario de oficina ampliado (06:00–20:00, de lunes a viernes).

Funciona con cualquier servidor de red LoRaWAN (LoRaWAN 1.0.4, clase A, OTAA) y alcanza hasta 10 km con línea de visión directa. Qué mide, cuándo informa y qué envía lo decide una aplicación que se ejecuta dentro del sensor, en la Virtual Sensing Machine (VSM) de Sensative. Este manual describe la aplicación Square-air November 2026, que puede configurarse y sustituirse por una versión más reciente, por radio o con NFC. Sensative también puede ofrecer aplicaciones VSM alternativas para el mismo sensor, que le asignan una tarea diferente; consulte Qué aplicación ejecuta el sensor.

Contenido de la caja

  • Square Air, con el adhesivo ya colocado en la parte trasera

Las claves (DevEUI y AppKey) se suministran con la información de entrega. El kit de montaje con tornillos de Square se vende por separado.

Partes del sensor

Square Air de lado y de frente, con dos pequeños orificios a ambos lados del logotipo
Hay dos orificios en el frontal, a ambos lados del logotipo. Visto de frente, el orificio derecho es la entrada de aire del sensor de gas; detrás del orificio izquierdo no hay nada. Mantenga ambos orificios despejados. La zona NFC está en la parte inferior izquierda del frontal, que es donde se acerca el teléfono. En la parte trasera están el adhesivo y la etiqueta con el modelo, la región y el número de serie.

2Antes de empezar

Un sensor LoRaWAN requiere algo más de preparación que uno que se empareja con un hub. Antes de empezar, necesita lo siguiente:

El sensor transmite por radio a un gateway, el gateway al servidor de red y el servidor de red a su aplicación; los ajustes vuelven como enlace descendente (downlink)

Qué necesita

  • Un gateway (pasarela) LoRaWAN dentro del alcance, encendido y en línea
  • Una cuenta en un servidor de red LoRaWAN (por ejemplo, The Things Network, ChirpStack, Loriot o Actility), con el gateway añadido
  • Las claves del sensor: su DevEUI y su AppKey, que figuran en la información de entrega. El JoinEUI es el mismo para todos los sensores Square: 70B3D52C0001D4C3.
  • Un teléfono con NFC, para poner en marcha el sensor. La mayoría de los smartphones lo tienen; un iPhone necesita una aplicación de lectura NFC (consulte Localizar las antenas NFC).
  • Un decodificador de payload para sensores VSM de Sensative en su servidor de red o en su aplicación (consulte Decodificar los mensajes)

Elegir la ubicación

  • Para el clima interior y la calidad del aire: una pared interior a la altura de los ojos, donde el aire circule libremente junto al sensor
  • Lejos de la luz solar directa, los radiadores, otras fuentes de calor y las corrientes de aire
  • No cerca de cubos de basura, productos químicos, entradas de ventilación, puertas o ventanas, que pueden afectar considerablemente a las lecturas de calidad del aire
  • Solo en interiores: el sensor tiene grado de protección IP30, para estancias interiores secas
  • Orificios despejados: mantenga despejados los dos orificios del frontal
  • Alcance: hasta 10 km con visión directa despejada; mucho menos a través de paredes y forjados
  • El metal no es problema: a diferencia de Strips, un sensor Square puede montarse sobre metal sin que la radio se vea muy afectada. Evite solo los recintos metálicos cerrados, como un armario de acero cerrado.
Square en una pared interior a la altura de los ojos, lejos de una ventana soleada y de un radiador

Localizar las antenas NFC

El NFC solo alcanza un par de centímetros, así que el teléfono debe quedar plano sobre el sensor, con una antena encima de la otra. Para ello hay que saber dónde están ambas antenas. Lo más sencillo es mover el teléfono despacio sobre la zona indicada hasta que avise del contacto:

La antena NFC está en la parte inferior izquierda del frontal del sensor; en el teléfono suele estar cerca de la parte superior de la carcasa trasera
  • En el sensor: en la parte inferior izquierda del frontal, con el logotipo a lo largo del borde inferior.
  • En un teléfono Android (recomendado): active el NFC y, en los ajustes del teléfono, la vibración o un sonido para el NFC, de modo que el teléfono avise en cuanto encuentre el sensor. La antena suele estar en la cara trasera, cerca de la parte superior y a menudo junto a la cámara, pero varía de un modelo a otro; el manual del teléfono o la web del fabricante indican dónde está. Si no la encuentra, pase despacio la parte trasera del teléfono por la esquina inferior izquierda del sensor hasta que vibre.
  • Quite la funda del teléfono. Una funda protectora, sobre todo si es gruesa o lleva metal o un imán, puede dificultar el contacto NFC. Trabaje con el sensor sin funda.
  • Después, no lo mueva. Para iniciar la unión a la red, mantenga el teléfono quieto sobre el sensor durante unos 5 segundos. La vibración solo indica que el teléfono ha encontrado el sensor; no lo retire hasta que el sensor y la aplicación hayan terminado de comunicarse. Con la aplicación Hugin esto tarda unos segundos, porque primero desbloquea el sensor a través del servidor de Sensative. Si aparta el teléfono demasiado pronto, la conexión se interrumpe y tendrá que empezar de nuevo.
  • En un iPhone: utilice una aplicación de lectura NFC, como NFC Reader & Scanner de la App Store. Ábrala y pulse su botón NFC antes de tocar el sensor, de modo que muestre Ready to Scan. La antena del iPhone está en el borde superior de la cara trasera. Apoye ese borde en la esquina inferior izquierda del sensor y no lo mueva. Cuando la lectura se completa, se abre un enlace web con el número de serie del sensor. La guía de unión con NFC para iPhone (PDF) muestra cada paso con imágenes.

3Instalación paso a paso

Ocho pasos. Registre el sensor en el servidor de red antes de acercarle el teléfono. Después, únalo a la red, compruebe los ajustes y, por último, móntelo.

1

Desembalar

Compruebe el contenido y localice las claves del sensor. El sensor permanece en reposo hasta que detecta un campo NFC.

2

Registrar el sensor en el servidor de red

  1. Añada un nuevo dispositivo final en su servidor de red, con activación OTAA.
  2. Utilice estos ajustes LoRaWAN: versión MAC 1.0.4, parámetros regionales RP002-1.0.3, EIRP máxima 14 dBm y el plan de frecuencias de su región.
  3. Introduzca el DevEUI y la AppKey de la información de entrega, y el JoinEUI 70B3D52C0001D4C3. Compruébelos con cuidado, porque basta un carácter erróneo para que la unión falle.
  4. Configure la decodificación de los mensajes (consulte Decodificar los mensajes).
Listo cuando: el dispositivo aparece en el servidor de red, a la espera de su primera unión.
3

Unir el sensor a la red con NFC

Sostenga el teléfono sobre la esquina inferior izquierda del frontal de Square Air y manténgalo quieto unos 5 segundos para iniciar la unión a la red (consulte Localizar las antenas NFC, también para iPhone). El teléfono puede mostrar un enlace web con el número de serie del sensor; no hace falta abrirlo.

Registre el sensor y acerque un teléfono con NFC a la esquina inferior izquierda; en unos dos minutos el sensor se une a la red
Listo cuando: el servidor de red muestra la unión, normalmente en menos de dos minutos.
Si la red todavía no está disponible, el sensor lo vuelve a intentar una vez al día, de modo que, cuando la red esté disponible, la unión puede tardar hasta 24 horas. Con un nuevo toque NFC, el sensor lo intenta de inmediato.
4

Comprobar la señal en el lugar de montaje

Coloque el sensor donde se va a montar y siga en el servidor de red la unión y los primeros informes.

Valores orientativos: el enlace debe funcionar como mínimo con SF9. Como referencia, busque una SNR superior a −5 dB y un RSSI superior a −115 dBm, lo que deja margen respecto al límite de SF9 (unos −12,5 dB de SNR).
Con un enlace más débil, la velocidad de datos adaptativa (ADR) del servidor de red pasa a SF10–SF12. Cada mensaje tarda entonces mucho más en enviarse, lo que consume batería y capacidad de red. Si el sensor sigue en SF10–SF12 un día después de la instalación, mejore el enlace cambiando de sitio el gateway o el sensor, o añadiendo otro gateway.
5

Configurar (opcional)

Square Air viene con la aplicación Square-air. Con los ajustes predeterminados, envía los valores de calidad del aire cada 30 minutos, el nivel medio de luz cada 20 minutos cuando ha cambiado, la temperatura cuando cambia 0,5 °C, la temperatura media cada 60 minutos y la humedad cuando cambia un 2 %. Genera una alarma de calidad del aire por encima de un IAQ de 200, y alarmas de temperatura por debajo de 2 °C y por encima de 60 °C. Cambie los ajustes si necesita otra cosa.

Limitar la medición a las horas que necesite prolonga la vida de la batería: unos 12 años si solo mide en horario de oficina ampliado (06:00–20:00, de lunes a viernes), frente a unos 6–7 años con medición continua.

Para cambiarlos, consulte Cambiar los ajustes, la tabla de ajustes y los ejemplos prácticos.

6

Montar

Elija una de estas dos formas:

  1. Adhesivo: con la superficie limpia y seca, retire la película del adhesivo de la parte trasera y presione el sensor con firmeza en su sitio.
  2. Tornillos, con el kit de montaje con tornillos de Square (se vende por separado): dos placas adhesivas de 2 mm sobre una lámina de marcado. Utilice la lámina para marcar los taladros, ya sea junto al sensor u ocultos detrás de él (en ese caso, utilice tornillos de cabeza plana de perfil ultrabajo). Atornille las placas con la cara adhesiva gruesa hacia fuera, hacia el sensor (así caben las cabezas de los tornillos), retire las películas de las placas y del sensor, compruebe la alineación y presione el sensor firmemente sobre las placas.
No cubra los dos orificios del frontal con cinta, pintura ni etiquetas: el derecho es la entrada de aire del sensor de gas.
7

Probar

Eche el aliento sobre el sensor o sosténgalo en la mano durante un minuto, para que la temperatura y la humedad superen los umbrales.

Listo cuando: llegan a su aplicación nuevas lecturas de temperatura y humedad. Los primeros valores de calidad del aire llegan cuando ha transcurrido el Air Interval (30 minutos por defecto); descarte los primeros de todos, porque pueden proceder de un periodo incompleto.
8

Listo para funcionar

  • Registrado en el servidor de red, con el JoinEUI y la región correctos
  • Unido a la red con NFC y con los mensajes decodificados
  • Señal comprobada en el lugar definitivo: SF9 o mejor
  • Ajustes comprobados o cambiados según sea necesario
  • Montado en interiores en una pared interior, lejos del sol, del calor y de las corrientes de aire, con los orificios del frontal despejados
  • Llegan los datos de calidad del aire, temperatura, humedad y luz

4Uso del sensor

La aplicación mide la calidad del aire, la presión atmosférica, la temperatura, la humedad y la luz a intervalos regulares, y envía una actualización cuando un valor ha cambiado más de un umbral establecido o ha transcurrido un intervalo establecido. Los ajustes indicados en negrita figuran en la tabla de ajustes.

Calidad del aire

Square Air mide la calidad del aire con el sensor de gas, que también mide la presión atmosférica. El sensor de gas se pone en marcha en cuanto el sensor se ha unido a la red. Toma una muestra cada 5 minutos, y cada Air Interval (30 minutos por defecto) la aplicación envía la media de cada valor durante ese periodo. Los primeros valores tras la puesta en marcha pueden proceder de un periodo incompleto: no los tenga en cuenta.

  • IAQ (índice de calidad del aire interior): una escala de 0 (aire limpio) a 500 (aire muy contaminado), calculada a partir de los gases que detecta el sensor de gas. En torno a 50 es aire bueno, y en torno a 200 es aire contaminado típico. El sensor calibra el índice según su entorno a partir de sus lecturas recientes, por lo que la sala debe ventilarse bien (exponerse a aire fresco) una vez a la semana.
  • IAQ estático: la misma escala sin esa recalibración automática. Utilícelo donde el sensor no esté expuesto regularmente a aire fresco.
  • bVOC (equivalente de breath-VOC): compuestos orgánicos volátiles, expresados como equivalentes de breath-VOC en ppm.
  • Equivalente de CO₂: una estimación en ppm, derivada de la relación media entre los COV y el CO₂ del aliento que exhalan las personas. Square Air no tiene sensor de CO₂, por lo que no se trata de un valor de CO₂ medido. Para medir el CO₂ existe Square CO2.
  • Presión atmosférica: en hPa, con dos decimales.
El IAQ, el bVOC y el equivalente de CO₂ se ven afectados por cocinar, los alimentos, el humo, los perfumes y la emisión de gases de pinturas o muebles. Square Air puede reaccionar al humo, pero no es una alarma de incendio certificada. No está diseñado para detectar fugas de CO₂ de bombonas de gas u otros equipos.

Cómo funciona el sensor de gas

El sensor de gas es un sensor de óxido metálico. Los gases del aire se adsorben en su capa sensible, donde se oxidan o se reducen, y la señal aumenta cuanto más reactivo químicamente es el gas.

  • A qué reacciona: a la mayoría de los compuestos volátiles, y a muchos otros gases que contaminan el aire interior. No reacciona a unos pocos gases casi inertes, como el nitrógeno y el CO₂. Por eso el valor de CO₂ es un equivalente estimado a partir de los COV del aliento exhalado, y no una medición.
  • Una suma, no un solo gas: mide la suma de los COV y contaminantes del aire, no un gas concreto. Así, detecta la emisión de gases de pinturas, muebles y basura, y los niveles altos de COV procedentes de cocinar, los alimentos, el aliento exhalado y el sudor.
  • IAQ o IAQ estático: el IAQ se calibra solo según su entorno, y Bosch lo recomienda para uso móvil. El IAQ estático no se recalibra, y Bosch lo recomienda para dispositivos fijos. En la práctica: utilice el IAQ estático donde el sensor no esté expuesto regularmente a aire fresco, y el IAQ donde la sala se ventile con regularidad.

Estabilización y precisión

El sensor de gas necesita hasta 28 días de funcionamiento antes de que el IAQ y los demás valores de gas sean plenamente fiables. Junto con los valores de calidad del aire, el sensor envía tres valores de estado que muestran cuánto ha avanzado:

  • Estado de estabilización: muestra el progreso de esta calibración y estabilización iniciales.
  • Precisión del IAQ: de 0 a 3, indica la calidad de la calibración actual.
  • Estado de rodaje: el estado de arranque propio del sensor de gas.

Alarma de calidad del aire

  • Cuando el IAQ supera el IAQ Alarm Level (200 por defecto), o el IAQ estático supera el Static IAQ Alarm Level (200 por defecto), el sensor envía una alarma de calidad del aire, confirmada.
  • La alarma es un único valor: 0 = sin alarma, 1 = alarma de IAQ estático, 2 = alarma de IAQ, 3 = ambas.

Luz

El sensor toma una muestra de luz cada minuto. Cada Average Lux Report Interval (20 minutos por defecto) calcula el nivel medio de luz, en lux, y lo envía, confirmado, si ha cambiado más que el Lux Threshold (100 % por defecto).

Temperatura

  • El sensor lee la temperatura cada minuto.
  • Si la temperatura ha cambiado más que el Temperature Threshold desde el último valor enviado, el sensor envía la nueva lectura.
  • Cada Average Temperature Interval, el sensor envía la temperatura media, siempre que haya cambiado más que el Average Temperature Threshold.
  • Por encima del Temperature High Alarm Level el estado de alarma pasa a «alto», y por debajo del Temperature Low Alarm Level pasa a «bajo». La alarma se envía como confirmada. Si el nivel bajo no está por debajo del nivel alto, la alarma está desactivada.

Humedad

  • El sensor toma una muestra de humedad cada minuto.
  • Si la humedad ha cambiado más que el Humidity Threshold, el sensor envía la nueva lectura.
  • Cada Humidity Interval, el sensor calcula la humedad media y la envía como confirmada si ha cambiado más que ese mismo umbral.
Si la humedad supera el 100 % (por ejemplo, por rocío), las lecturas siguientes pueden ser claramente erróneas hasta que el sensor se haya secado.

Batería y posición

Una vez a la semana, el sensor estima la batería restante y la envía como porcentaje. La estimación se basa en el tiempo de funcionamiento medido y en la energía consumida por el procesador, la radio, los sensores y los escaneos de posición. Square Air determina su posición únicamente por Wi-Fi. Una vez al día, mientras está unido a la red, busca puntos de acceso Wi-Fi y envía el resultado. Un servicio de geolocalización en la nube, como el de Yggio o Munin, convierte el escaneo en una posición.

Datos registrados

Las lecturas tomadas mientras el sensor no tiene red se guardan en su memoria y se envían por LoRaWAN cuando vuelve a estar conectado, cada una con la hora en que se registró. Para las salidas confirmadas se conserva todo el historial, hasta que la memoria se llena; para las salidas no confirmadas, solo el último valor. La aplicación NFC Hugin no puede leer el registro. Las horas proceden del reloj del sensor, que este ajusta a partir de la red: pide la hora dentro de su Device Time Max Age (30 días por defecto; consulte Registros del dispositivo), y sin hora no se registra nada.

Cómo funciona el posicionamiento por Wi-Fi

  • Solo 2,4 GHz: la radio escanea únicamente la banda de 2,4 GHz (2412–2484 MHz). Las redes que solo emiten en 5 GHz no se detectan.
  • Pasivo: el sensor escucha los puntos de acceso Wi-Fi cercanos (802.11 b/g/n) y registra sus direcciones MAC y la intensidad de su señal (RSSI). No se conecta a ninguna red, no necesita contraseña y no envía nada por Wi-Fi. Las direcciones viajan en el enlace ascendente (uplink) LoRaWAN.
  • Cuántos: hacen falta al menos 2 puntos de acceso para obtener una posición; cuantos más haya, mejor será.
  • La posición: para obtenerla hace falta un servicio en la nube que admita el posicionamiento por Wi-Fi, como Yggio (Munin y LoRa Cloud también lo hacen). El servicio busca las direcciones en una base de datos de puntos de acceso cartografiados y devuelve la posición.
  • Precisión: depende de cuántos puntos de acceso conocidos haya alrededor; en interiores suele ser de 5–20 m. Con solo uno o dos, sabrá en qué zona está el sensor, pero no en qué sala. Para mejorarla, basta con añadir puntos de acceso de 2,4 GHz de bajo coste.
  • Solo Wi-Fi: Square Air no dispone de posicionamiento por satélite.

Red e itinerancia

  • Mensajes confirmados: el servidor de red acusa recibo de las alarmas, la humedad media, la luz media y el nivel de batería, y el sensor los vuelve a enviar si no llega ningún acuse de recibo.
  • Nueva unión: si el sensor no está unido a la red, intenta unirse una vez cada 24 horas. Con un toque NFC, como en el paso 3, lo intenta de inmediato.
  • Pérdida de la red: el sensor abandona la red si no recibe nada de ella durante el Downlink Timeout (24 horas por defecto; consulte Registros del dispositivo).
  • Itinerancia (roaming): el sensor puede registrarse en hasta 15 redes LoRaWAN, por orden de prioridad. Regístrelo en cada una con el mismo DevEUI y JoinEUI, y con el último dígito de la AppKey en orden ascendente: …00 para la primera red, …01 para la segunda, y así sucesivamente. Después, configure el Roaming Network Count. Si el sensor pierde su red, prueba las siguientes por orden, y cada 24 horas vuelve a empezar por la primera. Con más de una red, cada unión tarda más y consume más energía.
  • Velocidad de datos adaptativa: el sensor sigue la velocidad de datos adaptativa (ADR) del servidor de red, que elige su velocidad de datos y su potencia de transmisión. Si pierde el contacto con la red, reduce poco a poco su velocidad de datos hasta volver a alcanzarla.

Decodificar los mensajes

Los mensajes son registros binarios compactos cuyo significado depende de la versión de la aplicación. Decodifíquelos con un decodificador compatible con VSM:

  • Yggio los decodifica con su traductor VSM integrado y lleva el control de la versión de la aplicación de cada sensor.
  • Otras plataformas: utilice Munin, el cliente MQTT de código abierto de Sensative. Decodifica los mensajes para cualquier servidor de red, mantiene actualizados el estado del dispositivo que necesita el decodificador y la hora del dispositivo, y resuelve las posiciones por Wi-Fi.
  • Su propia integración: el traductor VSM de código abierto es el decodificador que utiliza Munin y está disponible como paquete de Node. Su integración debe cumplir dos condiciones: guardar al menos el rulesCrc32 de cada sensor entre un mensaje y otro, y mantener el traductor actualizado, ya que las nuevas versiones de la aplicación se publican sin previo aviso. Si además guarda el resultado completo del mensaje anterior, los datos registrados también llevan la hora correcta.

Cambiar los ajustes

Hay dos formas: por radio, con enlaces descendentes (downlinks) desde su servidor de red, o in situ con la aplicación NFC Hugin. En ambos casos se suele empezar en la VSM Configuration Tool, que genera los downlinks.

  1. Elija la aplicación: por nombre y versión, o por el rulesCrc32 que el sensor envía por el puerto 15 (consulte Qué aplicación ejecuta el sensor).
  2. Elija una configuración: un perfil publicado de la Profile Library (no hay ninguno publicado para esta aplicación, consulte Perfiles publicados), o Custom para fijar sus propios valores. Cada ajuste muestra su descripción, unidad y rango.
  3. Obtenga el resultado: uno o varios downlinks para el puerto 2, o un único payload para el puerto 7, en hexadecimal o base64, para enviarlos desde su servidor de red, o bien un código QR para escanear con la aplicación NFC Hugin, que después escribe la configuración en el sensor in situ.
El sensor es un dispositivo de clase A, de modo que solo recibe un downlink justo después de enviar un uplink. Un ajuste nuevo surte efecto, como pronto, tras el siguiente mensaje del sensor, y en una red con mucho tráfico el downlink puede tardar más en llegar. Cualquier ajuste que haga que el sensor envíe con más frecuencia consume batería.

5La aplicación NFC Hugin

Hugin es una aplicación Android opcional para trabajar con el sensor in situ, mediante NFC. Necesita un teléfono Android con NFC y GPS, y una cuenta de usuario de Yggio. Además, el sensor debe estar registrado en Yggio con su organización como propietaria, porque Hugin lo comprueba en Yggio antes de dejarle trabajar con él. Acerque el teléfono al sensor como se indica en Localizar las antenas NFC. La aplicación muestra entonces el número de serie, la aplicación y su versión, el estado (por ejemplo, unido), la batería, la información del enlace y de la región, y el DevEUI. En función de sus permisos en Yggio, puede leer y aplicar perfiles de configuración, incluido uno escaneado como código QR desde la VSM Configuration Tool, y actualizar la hora y la posición del dispositivo.

La instalación, el inicio de sesión, la carga de aplicaciones y firmware y la solución de problemas se describen en el manual de la aplicación NFC Hugin.

6Mantenimiento y desmontaje

Batería

La batería está integrada (6000 mAh). En una buena red (SF7–SF9) dura unos 6–7 años con medición continua, y unos 12 años si solo mide en horario de oficina ampliado (06:00–20:00, de lunes a viernes). Los informes frecuentes y un enlace débil la acortan.

Desmontar Square Air

Pase hilo dental por detrás del sensor y corte el adhesivo con un suave movimiento de sierra.

Cambiar de servidor de red

Elimine el dispositivo del servidor de red antiguo y añádalo al nuevo. La comprobación de enlace del sensor falla entonces, y el sensor abandona la red antigua y se une a la nueva, algo que suele tardar entre uno y dos días. Con la aplicación Hugin puede reiniciarlo de inmediato (ON / OFF), pero así también se restablecen los ajustes personalizados.

Almacenamiento y eliminación

  • Almacene los sensores sin usar a una temperatura de +10 a +30 °C.
  • El sensor lleva una batería no sustituible de litio-dióxido de manganeso (LiMnO₂), una de las químicas de litio más estables. No abra el sensor, no lo perfore ni lo caliente por encima de +80 °C.
  • Cuando la batería se agote, deposite el sensor entero en un punto de recogida de pilas para su reciclaje. Es normal que la batería se hinche un poco cerca del final de su vida útil.

7Solución de problemas

ProblemaSolución
No llegan valores de calidad del aireEl sensor de gas se pone en marcha en cuanto el sensor se ha unido a la red, y los valores llegan cada Air Interval (30 minutos por defecto). No tenga en cuenta los primeros valores tras la puesta en marcha.
Los valores de calidad del aire parecen inestablesEl sensor de gas necesita hasta 28 días de funcionamiento antes de que los valores sean plenamente fiables. El estado de estabilización y la precisión del IAQ (0–3) que se envían con ellos muestran cuánto ha avanzado.
El IAQ deriva o parece incorrectoVentile bien la sala una vez a la semana, para que el sensor reciba aire fresco con el que calibrarse. Donde nunca esté expuesto a aire fresco, utilice el IAQ estático. Cocinar, los alimentos, el humo, los perfumes y la pintura o los muebles nuevos también elevan los valores.
La humedad indicada es demasiado alta tras una condensaciónSi se forma agua sobre el sensor (rocío), las lecturas se ven afectadas hasta que se seca.
La temperatura indicada es demasiado alta o demasiado bajaCompruebe la ubicación. La luz solar directa, un radiador o una corriente de aire cercana falsean las lecturas.
No hay posición, o es poco precisaPara obtener una posición hace falta un servicio en la nube que admita el posicionamiento por Wi-Fi, como Yggio, y suficientes puntos de acceso de 2,4 GHz conocidos por el servicio; las redes que solo usan 5 GHz no se detectan. Consulte Cómo funciona el posicionamiento por Wi-Fi.
No ocurre nada al acercar el teléfonoCompruebe que el NFC está activado y que ha quitado la funda del teléfono. Apoye el teléfono plano sobre la esquina inferior izquierda y muévalo despacio hasta que avise del contacto; después, no lo mueva (consulte Localizar las antenas NFC).
Solicitud de unión (Join Request) en el servidor de red, pero sin Join AcceptCompruebe las claves, el JoinEUI 70B3D52C0001D4C3, la versión de LoRaWAN (1.0.4), los parámetros regionales (RP002-1.0.3) y el plan de frecuencias. En US915 y AU915, la subbanda debe coincidir con la del gateway.
No aparece nada en el servidor de redCompruebe que el gateway está encendido y en línea, y que el sensor está dentro del alcance y no dentro de un recinto metálico cerrado. Después, inicie una nueva unión con NFC, como en el paso 3.
«MIC mismatch»Las claves son incorrectas. Compruebe que pertenecen a este sensor y que están bien escritas.
Llegan mensajes, pero el decodificador no muestra lecturasNormalmente, el decodificador no ha recibido la identidad de la aplicación. Envíe 00 por el puerto 15 y compruebe que el decodificador está actualizado (consulte Qué aplicación ejecuta el sensor).
La aplicación Hugin pierde la conexiónMantenga el teléfono quieto hasta que la aplicación haya terminado (consulte Localizar las antenas NFC).
Un ajuste nuevo no surte efectoUn downlink solo llega después del siguiente mensaje del sensor, y más tarde en una red con mucho tráfico (consulte Cambiar los ajustes). Compruebe que sigue en cola y que se generó para el rulesCrc32 que comunica el sensor.
Faltan mensajes o llegan de forma irregularCompruebe el RSSI y la SNR. Es posible que el sensor esté demasiado lejos del gateway o encerrado en metal. Algunos canales también pueden sufrir interferencias en la misma banda de frecuencias, por ejemplo de un transmisor de telefonía móvil cercano o de un lector RFID.

8Referencia técnica

Para integradores. Los valores siguientes corresponden a la aplicación Square-air November 2026. Otras versiones pueden diferir: consulte la documentación de aplicaciones VSM o la VSM Configuration Tool para la suya.

Qué aplicación ejecuta el sensor

Justo después de unirse a la red, el sensor envía la identidad de su aplicación, el rulesCrc32, por el puerto 15. El decodificador la utiliza para elegir la traducción correcta, y usted la necesita para generar los downlinks adecuados. Para esta aplicación es:

AplicaciónSquare-air
VersiónNovember 2026
rulesCrc323007941823 (hex B3498CBF)
Versión anteriorSquare-air R33, rulesCrc32 114894312: consulte la revisión A de este manual

Si no recibió el mensaje, envíe 00 por el puerto 15 y el sensor volverá a enviar su identidad. La aplicación NFC Hugin también muestra in situ la aplicación y su versión.

Los ajustes, los ids y los valores predeterminados pertenecen a una versión concreta de la aplicación. Si su sensor comunica otro rulesCrc32, busque ese número en la documentación de aplicaciones VSM o en la VSM Configuration Tool en lugar de utilizar las tablas de este manual. Los sensores entregados antes de la versión de noviembre de 2026 ejecutan Square-air R33; sus ids y valores predeterminados son distintos, así que utilice para ellos la revisión A de este manual hasta que se actualicen.

Aplicaciones alternativas: además de Square-air, Sensative puede ofrecer otras aplicaciones VSM para el mismo hardware. Están disponibles en la aplicación NFC Hugin (Android) y también pueden cargarse en el sensor a través de LoRaWAN. Pregunte a Sensative qué aplicaciones se adaptan a su uso. Después de un cambio, solicite la identidad con 00 en el puerto 15 y utilice la documentación de esa aplicación.

LoRaWAN y puertos

LoRaWANMAC 1.0.4, parámetros regionales RP002-1.0.3, clase A, OTAA, EIRP máxima 14 dBm
JoinEUI70B3D52C0001D4C3 (todos los sensores Square y Puck)
PuertoDirecciónContenido
1UplinkLecturas y alarmas (consulte Mensajes)
11UplinkLas mismas salidas en forma comprimida
12UplinkDatos registrados: un mensaje guardado mientras el sensor no tenía red y enviado más tarde con la hora en que se registró
15UplinkIdentidad de la aplicación (rulesCrc32), lo primero que envía tras unirse
15Downlink00 pide al sensor que vuelva a enviar la identidad de su aplicación
23UplinkEscaneo Wi-Fi, para el posicionamiento
2DownlinkAjustes y solicitudes de lectura (consulte Ajustes en el puerto 2)
2UplinkRespuesta del sensor con sus valores actuales
7DownlinkConfiguración completa en un solo payload (consulte Configuración completa en el puerto 7)
7UplinkEl estado de esa configuración: None, Applied, Error o Dirty

Mensajes

Cada salida tiene un id y una escala. El servidor de red acusa recibo de las salidas «confirmadas».

SalidaIdTamaño y escalaUnidadConfirmadaSe envía
air_iaqB84 bytesÍndice IAQ, 0–500NoCada Air Interval
air_static_iaqBC4 bytesÍndice IAQ, 0–500NoCada Air Interval
air_breath_voc_equivalentBB4 bytes, × 0,01ppm (equivalente de breath-VOC)NoCada Air Interval
air_co2B94 bytesppm (equivalente de CO₂)NoCada Air Interval
air_pressureBA4 bytes, × 0,01hPaNoCada Air Interval
air_run_in_status, air_stab_status, air_iaq_accuracyA7 A8 A91 byte cada unoestado; precisión del IAQ 0–3NoCon los valores de calidad del aire
air_iaq_alarm821 byte0 = ninguna, 1 = IAQ estático, 2 = IAQ, 3 = ambasSíCuando el IAQ o el IAQ estático supera su nivel de alarma
luxB52 bytesluxNoCuando el nivel de luz cambia más que el Lux Threshold
averageLux912 bytesluxSíCada Average Lux Report Interval, si ha cambiado más que el Lux Threshold
tempB02 bytes, × 0,01°CNoAnte un cambio mayor que el Temperature Threshold
averageTempB12 bytes, × 0,01°CNoCada Average Temperature Interval, si ha cambiado más que el Average Temperature Threshold
tempAlarm811 byte0 = sin alarma, 1 = alta, −1 = bajaSíCuando cambia el estado de alarma
humidityB32 bytes, × 0,01% HRNoAnte un cambio mayor que el Humidity Threshold
averageHumidity902 bytes, × 0,01% HRSíCada Humidity Interval, si ha cambiado más que el Humidity Threshold
batteryPercent801 byte% (estimado)SíUna vez a la semana

Ajustes

Los valores predeterminados son aquellos con los que arranca el sensor. El id es el que se usa en un downlink por el puerto 2. Los valores se envían en los pasos indicados: un ajuste en pasos de 0,01 se envía como cien veces su valor.

AjusteNombre en la aplicaciónIdFunciónUnidadRangoPredeterminado
Air Intervalair_interval_minutesAAEl periodo durante el que se promedian los valores de calidad del aire antes de enviarlos. El sensor de gas toma muestras cada 5 minutos, así que utilice un múltiplo de 5.minutos5–12530
IAQ Alarm Levelair_iaq_alarm_levelBECuando el IAQ supera este valor, se envía una alarma de calidad del aire.índice IAQ0–1000200
Static IAQ Alarm Levelair_static_iaq_alarm_levelBDCuando el IAQ estático supera este valor, se envía una alarma de calidad del aire.índice IAQ0–1000200
Lux ThresholdluxTresholdPercentB6Variación del nivel de luz a partir de la cual se envía la luz o la luz media.%1–32 767100
Average Lux Report IntervalaverageLuxIntervalMinutesA6Con qué frecuencia se calcula el nivel medio de luz, que se envía cuando ha cambiado.minutos2–12720
Temperature ThresholdtempHysteresisB2Cambio de temperatura a partir del cual se envía una nueva lectura. Los cambios menores no se comunican, lo que ahorra batería y tiempo de emisión.°C, pasos de 0,010,1–1270,5
Average Temperature IntervalaverageTempIntervalMinutesA2Con qué frecuencia se envía la temperatura media, si ha cambiado más que el Average Temperature Threshold.minutos2–12760
Average Temperature ThresholdaverageTempHysteresisA1Variación de la temperatura media a partir de la cual se envía.°C, pasos de 0,10–12,70,1
Temperature Low Alarm LeveltempAlarmLowLevelA3Nivel de alarma bajo. Debe ser inferior al nivel alto; de lo contrario, la alarma queda desactivada.°C−50 a +702
Temperature High Alarm LeveltempAlarmHighLevelA4Nivel de alarma alto, por defecto cerca de la temperatura ambiente máxima del producto. Debe ser superior al nivel bajo; de lo contrario, la alarma queda desactivada.°C−50 a +8060
Humidity ThresholdhumidityTresholdB4Cambio de humedad a partir del cual se envía la humedad o la humedad media. Un valor superior a 100 equivale, en la práctica, a desactivarlo.% HR, pasos de 0,010,1–1002
Humidity IntervalaverageHumidityIntervalMinutesA5Con qué frecuencia se calcula la humedad media.minutos1–12760
Roaming Network CountroamNetworkCountA0Número de identidades de red LoRaWAN que se prueban sucesivamente (consulte Red e itinerancia).número1–151

Registros del dispositivo

Pertenecen al firmware del sensor y no a la aplicación, pero la aplicación los utiliza y pueden cambiarse de la misma manera. No los cambie si no tiene un motivo concreto.

RegistroNombreIdFunciónUnidadRangoPredeterminado
Downlink TimeoutLINKCHECK_TIMED0Tiempo que pasa el sensor sin recibir nada de la red antes de abandonarla y quedar sin unión. Cualquier downlink, incluido un acuse de recibo, reinicia la cuenta. A partir de la mitad de ese tiempo, todos los uplinks se envían como confirmados; a partir del 80 %, el sensor también envía sus propias comprobaciones de enlace. 0 desactiva la comprobación.segundos300–2 592 00086 400 (24 horas)
Device Time Max AgeDEVICE_TIME_MAX_AGECDTiempo durante el que el sensor confía en su reloj. A partir de la mitad de este tiempo, pide la hora a la red LoRaWAN con la solicitud estándar DeviceTime (DeviceTimeReq, LoRaWAN 1.0.3 y posteriores): primero al cabo de un minuto y después a intervalos que se duplican hasta unas 68 horas, hasta que obtiene una respuesta. El servidor de red debe responder a las solicitudes DeviceTime. 0 lo desactiva; en ese caso el sensor no tiene hora y las lecturas tomadas sin red no se registran.segundos0–4 294 967 2952 592 000 (30 días)

Perfiles publicados

Para esta aplicación no hay perfiles predefinidos publicados. El sensor arranca con los valores predeterminados de la tabla de ajustes; para cambiarlos, utilice Custom en la VSM Configuration Tool.

Ajustes en el puerto 2

Un downlink por el puerto 2 es una lista de registros de 5 bytes cada uno: un byte para el id del ajuste y, a continuación, el valor como entero de 32 bits con signo, empezando por el byte más significativo. El valor se expresa en los pasos propios del ajuste: un umbral de temperatura de 0,2 °C en pasos de 0,01 se envía como 20. Los valores negativos se escriben en complemento a dos, de modo que −10 se convierte en FF FF FF F6. El sensor aplica los valores y responde por el puerto 2 con los valores que tiene ahora.

Los ids pertenecen a una versión concreta de la aplicación. Otra versión puede utilizar el mismo id para un ajuste distinto, de modo que un downlink generado para una versión puede cambiar el ajuste equivocado en otra. Genere siempre el downlink para el rulesCrc32 que comunica el propio sensor.

Leer valores

Un downlink de uno a cuatro bytes por el puerto 2 es una solicitud de lectura: el sensor devuelve el valor actual de cada id que contiene.

Downlink en el puerto 2El sensor responde con
04Temperatura actual del aire, en centésimas de grado
05Humedad actual del aire, en centésimas de punto porcentual
06Presión atmosférica actual
0BNivel de luz actual
B2El Temperature Threshold configurado actualmente (cualquier id de ajuste funciona del mismo modo)

Configuración completa en el puerto 7

La VSM Configuration Tool también puede empaquetar una configuración en un único payload para el puerto 7. Empieza con el CRC de la aplicación y termina con una suma de comprobación de la configuración (configCrc32). El sensor comunica el resultado por el puerto 7: None, Applied, Error o Dirty.

Ejemplo práctico 1: calidad del aire cada 15 minutos

Promediar y enviar los valores de calidad del aire cada 15 minutos en lugar de cada 30. Los ejemplos se han construido con el formato de registro de Ajustes en el puerto 2 para el rulesCrc32 3007941823 y se han comprobado con el traductor VSM de código abierto; el payload del puerto 7 incluye la identidad de la aplicación y la suma de comprobación, tal como lo genera la VSM Configuration Tool. Envíe uno de los payloads, el del puerto 2 o el del puerto 7, no ambos.

AjusteValorSe envía comoRegistro
Air Interval15 min15AA 00 00 00 0F
Puerto 2 (hex)AA 00 00 00 0F
Puerto 2 (base64)qgAAAA8=
O puerto 7 (hex)B3 49 8C BF 02 05 AA 00 00 00 0F 00 2D 8C A8 68

Ejemplo práctico 2: una alarma de calidad del aire más temprana

Generar la alarma de calidad del aire cuando el IAQ supere 150 en lugar de 200.

AjusteValorSe envía comoRegistro
IAQ Alarm Level150150BE 00 00 00 96
Puerto 2 (hex)BE 00 00 00 96
Puerto 2 (base64)vgAAAJY=
O puerto 7 (hex)B3 49 8C BF 02 05 BE 00 00 00 96 00 31 3F B2 CA

9Especificaciones

SensoresCalidad del aire (sensor de gas de óxido metálico, Bosch BME688: IAQ, IAQ estático, bVOC y equivalente de CO₂), presión atmosférica, temperatura, humedad, luz
IAQ0–500; desviación entre sensores ±15 %
Precisión de temperatura±0,2 °C
Precisión de humedad±3 % HR (10–90 % HR)
Precisión de presión atmosférica±0,6 hPa absoluta (300–1100 hPa); ±0,12 hPa relativa (900–1100 hPa)
Rango de medición de luz1–65 000 lux
RadioLoRaWAN 1.0.4, clase A, OTAA; JoinEUI 70B3D52C0001D4C3
Planes de frecuenciasEU868 · US915 · AU915 · AS923-1 · AS923-2 · KR920 · IN865
AlcanceHasta 10 km con visión directa
ConfiguraciónNFC (Android) y por radio
AplicaciónAplicación VSM Square-air (noviembre de 2026)
PosicionamientoGeoposicionamiento por Wi-Fi mediante un servicio en la nube
MemoriaRegistro de datos integrado, que se envía por LoRaWAN cuando el sensor vuelve a conectarse
BateríaLiMnO2 integrada, 6000 mAh; unos 6–7 años con medición continua, unos 12 años midiendo solo de 06:00 a 20:00, de lunes a viernes
Grado de protección IPIP30, interiores
Temperatura de funcionamiento−20 a +60 °C
Humedad de funcionamiento10–90 % HR
Almacenamiento+10 a +30 °C
Dimensiones58 × 58 × 15 mm
Peso65 g
MontajeAdhesivo, o el kit opcional de montaje con tornillos de Square

10Soporte

Fuentes: Sensative Docs, Square Air (dic. 2024), incluida su descripción del sensor de gas, FAQ Square & Puck y Hugin NFC application; las fuentes y la documentación de la aplicación en el repositorio vsm-applications de Sensative (Square-air, 10 de noviembre de 2026) y las definiciones de producto en dots-builds; VSM translator (código abierto); especificaciones a partir de los datos de producto de sensative.com; posicionamiento por Wi-Fi: Semtech, Wi-Fi geolocation with LoRa Edge.