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 e instalación

Puck Radar para LoRaWAN

Distancia, nivel y ocupación con un radar de 60 GHz, en una carcasa IP67 con batería reemplazable. Este manual le guía desde que abre la caja hasta que el sensor está en funcionamiento, describe los métodos de radar y la aplicación VSM que lleva dentro, y deja la referencia técnica para el final.

Revisión B · noviembre de 2026 · Sensative AB

Guía rápida Página de producto Ficha de producto (PDF)

1Introducción

Puck Radar mide la distancia a lo que tenga delante con un radar coherente pulsado de 60 GHz, de 0,2 a 7 m con resolución y precisión de 1 mm, y la comunica a través de LoRaWAN como distancia, como nivel o como estado ocupado/libre. El radar no necesita luz, por lo que mide igual de día que de noche. Sus usos típicos son plazas de aparcamiento, niveles de agua en imbornales y pozos, niveles de llenado en depósitos, silos y contenedores de residuos, y espesor de nieve.

La carcasa es IP67, funciona de −30 a +80 °C y tiene una batería reemplazable de 2100 mAh. Se suministra con una de dos lentes:

  • Lente estándar: un haz ancho de unos ±60°, 30 mm de altura, 38 g. Para cubrir una zona, como una plaza de aparcamiento.
  • Lente estrecha: un haz concentrado de unos ±10°, 45 mm de altura, 43 g. Para una medición precisa a distancia, como el nivel de agua en un pozo o los residuos en un contenedor.
La lente estándar abre el haz a unos ±60°; la lente estrecha lo concentra a unos ±10°

Dos placas, dos tipos de software

Dentro de Puck hay dos placas de circuito, cada una con su propio procesador:

  • La placa de radar ejecuta el firmware del radar. Realiza la medición: qué método de radar se utiliza, con qué frecuencia, en qué rango y con qué umbral. No tiene aplicación VSM.
  • La placa LoRaWAN ejecuta el firmware y una aplicación VSM. Gestiona la red, decide qué enviar y cuándo, y además mide la temperatura y la humedad dentro de la carcasa, lee el acelerómetro para detectar movimiento e inclinación, y busca redes Wi-Fi.

Ambas placas pueden configurarse a través de LoRaWAN. In situ, la aplicación NFC Hugin trabaja con la placa LoRaWAN, y la aplicación SweIoT Toolbox se comunica con la placa de radar por Bluetooth. Consulte Cambiar los ajustes.

Funciona con cualquier servidor de red LoRaWAN (LoRaWAN 1.0.4, clase A, OTAA). Qué envía la placa LoRaWAN, y cuándo, lo decide una aplicación que se ejecuta en la Virtual Sensing Machine (VSM) de Sensative. Este manual describe la aplicación Puck-radar 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 Puck; consulte Qué aplicación ejecuta el sensor.

Contenido de la caja

  • Puck Radar, con la batería colocada
  • Un adhesivo para superficies planas

Las claves (DevEUI y AppKey) se suministran con la información de entrega. Las placas de montaje se venden por separado, y un orificio taladrado no necesita ninguna (consulte el paso 6).

Partes del sensor

Puck Radar con la lente estándar, desmontado y mostrado con el radar hacia abajo: la tapa de la lente con el radar abajo, la base con la etiqueta arriba, y las placas, la batería y la junta tórica entre ambas
Aquí Puck aparece con el radar hacia abajo. La carcasa tiene dos partes: la tapa de la lente, a través de la cual mira el radar (abajo en la imagen), y la base, con la etiqueta (arriba). La etiqueta con el modelo, la región y el número de serie está siempre en el lado opuesto al radar. Las dos partes se enroscan entre sí y se sellan con una junta tórica; la batería va dentro, entre las placas.

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:

Puck transmite por radio a un gateway, el gateway al servidor de red y el servidor de red a su aplicación; los ajustes y los comandos de radar vuelven como enlaces descendentes (downlinks)

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 Puck y Square: 70B3D52C0001D4C3.
  • Se recomienda un teléfono Android con NFC. Pone en marcha el sensor y ejecuta las dos aplicaciones que se utilizan in situ: Hugin (NFC, para la placa LoRaWAN; necesita una cuenta de usuario de Yggio, con el sensor registrado a nombre de su organización) y SweIoT Toolbox for Puck & Prism radar sensor (Bluetooth; gratuita en Google Play). Ambas son solo para Android y, con Puck, son de gran ayuda para configurar correctamente el radar, sobre todo en una aplicación nueva. Un iPhone puede poner en marcha el sensor con una aplicación de lectura NFC (consulte Localizar las antenas NFC), pero no puede ejecutar las aplicaciones.
  • Un decodificador de payload para sensores VSM de Sensative en su servidor de red o en su aplicación (consulte Decodificar los mensajes)
  • Para obtener una posición: un servicio en la nube compatible con el posicionamiento por Wi-Fi, por ejemplo Yggio

Elegir la ubicación

  • Visión despejada: no debe haber nada entre el radar y lo que mide. La suciedad, el hielo, el agua o los objetos sobre la lente o delante de ella debilitan el eco o producen uno falso.
  • Detrás de una cubierta: Puck puede medir a través de una placa de plástico plana, como una tapa, con un efecto pequeño. La placa no debe contener vidrio, metal ni carbono. Compruebe las lecturas antes de fijar una cubierta de forma definitiva.
  • Metal: el montaje sobre metal no es problema, pero no encierre Puck en metal: el metal bloquea tanto la radio como el radar.
  • Alcance: hasta 10 km con línea de visión directa despejada, mucho menos desde el interior de un pozo o de una estructura de hormigón. Compruebe la señal en el lugar definitivo (paso 4).

Cómo ve el radar

  • Qué refleja: el metal, el agua y el vidrio reflejan con fuerza. El papel, el plástico, la tela y las personas reflejan más débilmente, pero aun así se detectan. La forma importa tanto como el material. Una superficie plana funciona como un espejo: devuelve el eco solo desde el punto en el que está orientada perpendicularmente al radar, y si está inclinada, el eco se desvía; así es como se ocultan los buques furtivos. Una superficie irregular dispersa los ecos en muchas direcciones, de modo que algunos siempre vuelven. Una esquina interior devuelve el eco directamente por donde vino, que es como funciona un reflector de radar.
  • Ecos falsos: el radar también puede ver las paredes laterales, el fondo de un pozo, el soporte o una tapa por encima del sensor, así como ecos que rebotan entre ellos. Apunte el radar directamente al objetivo, mantenga el haz alejado de las paredes y limite el rango a la zona donde puede estar el objetivo (consulte Métodos de radar).
  • El agua quieta es un espejo: apunte el radar directamente hacia abajo sobre una superficie quieta, o inclínelo solo unos pocos grados. El haz tiene unos ±10° de ancho, así que con una inclinación pequeña parte de él sigue incidiendo perpendicularmente en la superficie. Una inclinación mayor desvía el haz, como la luz en un espejo, y el eco se pierde.
  • Desde dónde se mide la distancia: el punto de referencia del radar (punto cero) está dentro de la carcasa, en el plano del chip de radar: 11 mm (lente estándar) o 26 mm (lente estrecha) por detrás de la cara de la lente.
Puck con la lente estrecha visto de lado, lente hacia el agua: el punto cero está marcado en el plano del chip de radar, 26 mm por encima de la cara de la lente
El punto cero: todas las distancias se miden desde el plano del chip de radar, 26 mm por detrás de la cara de la lente con la lente estrecha (11 mm con la lente estándar).
Cuatro trayectorias del radar en un pozo, con Puck en un soporte junto a la pared izquierda, inclinado unos grados: la trayectoria recta hacia abajo hasta la superficie del agua, una trayectoria que rebota en la pared izquierda, el agua y la pared derecha, un doble rebote entre la superficie y el sensor, y un eco de un saliente situado a dos tercios de la profundidad
Solo la primera trayectoria (verde) mide el nivel del agua. Las demás producen ecos falsos: rebotando en la pared izquierda, el agua y la pared derecha; un doble rebote entre la superficie y el sensor; y un pequeño saliente en el pozo, cuya esquina interior, donde se une a la pared, devuelve el eco directamente antes de que el radar llegue al agua.

Qué lente para cada uso

UsoLenteDónde se coloca Puck
Plaza de aparcamientoEstándar, o la estrecha si la plaza es angostaDe 10 a 300 cm por encima del suelo, encima o delante de la plaza
Nivel de agua en un pozo o imbornalEstrechaPor encima del agua, separado de las paredes laterales, inclinado unos grados para que la condensación escurra hacia un lado
Nivel de llenado en un depósito o silo, espesor de nieveEstrechaPor encima de la superficie, apuntando directamente hacia abajo
Contenedor de residuosEstrechaEncima del contenedor, mirando hacia abajo, o en una pared lateral, mirando de lado a lado por la parte superior

Localizar las antenas NFC

El NFC solo alcanza un par de centímetros, así que apoye el teléfono plano sobre Puck, antena sobre antena:

La antena NFC está en el centro de la parte superior de Puck, delante del radar; apoye el teléfono plano sobre ella
  • En Puck: en el centro de la parte superior, justo delante del radar.
  • En un teléfono Android (recomendado): active el NFC, y active la vibración o un sonido para el NFC en los ajustes del teléfono, para que el teléfono le avise en cuanto haya encontrado el sensor. La antena suele estar en la parte trasera, cerca de la parte superior, a menudo junto a la cámara, pero varía según el modelo: el manual del teléfono o el sitio web del fabricante indican dónde está. Si no la encuentra, mueva la parte trasera del teléfono lentamente sobre la parte superior de Puck hasta que el teléfono vibre.
  • Quite la funda del teléfono: una funda protectora, sobre todo si es gruesa o tiene metal o un imán, puede dificultar el contacto NFC.
  • Después, manténgalo quieto: para iniciar la unión a la red, mantenga el teléfono quieto sobre Puck durante unos 5 segundos. Con la aplicación Hugin, manténgalo ahí hasta que la aplicación haya terminado. Si lo aparta 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, para que muestre Ready to Scan, y después mantenga quieto el borde superior de la parte trasera del iPhone sobre la parte superior de Puck. 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, configure el radar para su uso y móntelo al final.

1

Desembalar

Revise Puck y localice sus claves. Compruebe qué lente tiene (consulte la Introducción). El sensor permanece inactivo 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

Apoye el teléfono plano sobre la parte superior de Puck y manténgalo quieto durante unos 5 segundos para iniciar la unión (consulte Localizar las antenas NFC, también para iPhone).

Listo cuando: el servidor de red muestra la unión, normalmente en menos de dos minutos.
Si la red aún no está accesible, Puck lo vuelve a intentar cada 5 horas (el ajuste Time between join retries). Un nuevo toque NFC inicia un intento 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

Elegir el método de radar y el rango de medición

El radar solo mide mientras Puck está unido a la red. Compruebe qué método de radar está activo, y que el método y su rango se adaptan al uso y al lugar (consulte Métodos de radar). Después, configure cuándo informa Puck: el paso de distancia, las medias y los niveles de alarma (consulte Qué datos envía).

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

¿Una aplicación nueva? Averigüe primero lo que el radar ve realmente. Active el Bluetooth del radar con la aplicación Hugin y pruebe in situ los métodos y ajustes en SweIoT Toolbox, o haga un escaneo a través de LoRaWAN para ver dónde están los ecos y con qué intensidad (consulte Una aplicación nueva y SweIoT Toolbox).
6

Montar

Elija una forma:

  1. Adhesivo, sobre una superficie lisa, seca y plana de metal o plástico. Limpie la superficie con una mezcla de alcohol isopropílico y agua (50–70 % de alcohol) y deje que se seque. No utilice el adhesivo sobre superficies aceitosas ni por debajo de +5 °C.
  2. Placa de montaje (se vende por separado): pegue Puck a la placa con el anillo adhesivo de la placa, centrado sobre la abertura. Atornille la placa a una pared o a una viga, o sujétela a un tubo o a un poste con bridas pasadas por sus ranuras.
  3. En un orificio taladrado, a ras de una pared o de un techo: taladre un orificio de 45 mm, límpielo y aplique una capa gruesa de sellador en el fondo. Coloque Puck en él, con la base hacia dentro y la lente hacia fuera, y manténgalo recto mientras el sellador fragua. No deje que el sellador ni el pegamento toquen la tapa de la lente: perturbarían el radar e impedirían abrir Puck para cambiar la batería.
  4. En un pozo o imbornal: en un soporte o con cinchas atravesando la abertura, apuntando directamente hacia abajo, al agua.
La placa de montaje de Puck: una fina placa de acero con un anillo adhesivo, cuatro orificios para tornillos y cuatro ranuras para bridas
La placa de montaje, de 52 × 43 mm, en acero de 0,8 mm.
Tres Puck en uso: en una columna de hormigón, en un soporte dentro de un imbornal de calle y sujeto con cinchas atravesando un pozo
De izquierda a derecha: en una columna de hormigón; en un soporte dentro de un imbornal; sujeto con cinchas atravesando un pozo.
Monte Puck de forma que pueda llegar a la parte superior con un teléfono (NFC) y, salvo que esté en un orificio taladrado, de forma que pueda desmontarlo para cambiar la batería.
7

Probar

Coloque algo delante del radar a una distancia conocida, o espere a las primeras mediciones del objetivo real.

Listo cuando: la distancia (y, en aparcamientos, el estado de ocupación) llega a su aplicación y coincide con la distancia real, contada desde el punto de referencia del radar.
El comando de radar test:10 hace que el radar mida cada 10 segundos durante 10 minutos, para que pueda ver al instante el efecto del montaje. Envíelo desde el menú Commands and Logs de SweIoT Toolbox, donde verá cada medición, o a través de LoRaWAN en el puerto 48, donde llega después del siguiente mensaje de Puck y solo se envían los cambios mayores que la Radar Distance Hysteresis. Si la distancia es 0, es incorrecta o salta de un valor a otro, consulte Solución de problemas antes de fijar Puck de forma definitiva.
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
  • Método de radar y rango de medición configurados para el uso
  • Montado con visión despejada del objetivo, con acceso para el NFC y la batería
  • Llegan distancias que coinciden con la distancia real

4Uso del sensor

La placa de radar mide; la aplicación VSM de la placa LoRaWAN decide qué enviar. Los ajustes indicados en negrita figuran en la tabla de ajustes y en Comandos de radar.

Métodos de radar

La placa de radar mide con un método cada vez. Este manual describe los métodos 3 a 8 del firmware del radar 2.24. Cada método tiene sus propios ajustes: con qué frecuencia mide, el rango y qué intensidad debe tener un eco para contar. El método se elige y se configura con comandos de radar (consulte Comandos de radar) o en SweIoT Toolbox.

N.ºMétodoQué datos envíaUso típicoIntervalo y rango predeterminados
3WellEl eco más lejano por encima del umbral: la superficie. Los ecos más cercanos se ignoranPozos, imbornales, fosas sépticas, nivel de agua, espesor de nieveCada 300 s, 0,5–3,5 m
4BinEl eco más cercano por encima del umbral, y un indicador de ocupación tras 3 detecciones seguidasPapeleras y contenedoresCada 120 s, 0,15–1,15 m
5ParkingEl eco más fuerte, y ocupado cuando su intensidad es de 350 o másPlazas de aparcamientoCada 30 s, 0,2–1,7 m
6SeatingEl eco más fuerte, y ocupado o libre cuando coinciden varias mediciones seguidasAsientosCada 60 s, 0,24–1,24 m
7Adv_SeatingOcupado o libre, confirmado a lo largo de varias mediciones; opcionalmente, silla de ruedas u otro objetoAsientos en trenes, autobuses y salas de espera, espacios para sillas de ruedasSe configura para cada instalación
8Distance2La distancia y la intensidad de un eco en cada una de dos zonas, cada una con su propio umbral y su propia elección de ecoMedición general de distancia, dos objetivosCada 300 s; zona 1 0,20–0,47 m, zona 2 0,50–0,60 m
  • Intervalo de medición: con qué frecuencia mide el radar. Medir con menos frecuencia ahorra batería.
  • Rango: el inicio y la longitud de la ventana en la que mira el radar, hasta 7 m desde el sensor. Limítela a la zona donde puede estar el objetivo: una ventana más corta es más fiable y consume menos batería.
  • Umbral: qué intensidad debe tener un eco para contar. Un umbral más bajo capta ecos más débiles, y también más ecos falsos.
  • Promediado: varios barridos por medición, combinados como mediana o como media, estabilizan la lectura con lluvia o nieve y sobre agua en movimiento. Cada barrido adicional consume batería. También lo hacen más muestras de hardware por barrido (HWAAS).

Pozos, nivel de agua y espesor de nieve (método 3)

  • Configure el rango de modo que termine al menos 10 cm por encima del fondo del pozo, y de modo que el nivel de agua más alto previsto quede en su mitad más lejana.
  • Apunte Puck directamente hacia abajo, al agua, o inclínelo unos pocos grados, y colóquelo de forma que el haz no toque las paredes laterales; mantenga alejados de su entorno y de la zona situada por encima los objetos grandes que reflejen, como el metal.
  • En un pozo, una ligera inclinación tiene una segunda ventaja: la condensación que se forma en la lente escurre hacia un lado en lugar de quedarse delante del radar.
  • Puck mide la distancia hasta la superficie. Calcule el nivel en su aplicación: para un nivel de agua, la profundidad del pozo menos la distancia; para el espesor de nieve, la distancia al suelo sin nieve menos la distancia a la nieve.
  • Si no se encuentra la superficie (distancia 0), baje el umbral. Si las lecturas saltan por las ondulaciones, utilice más barridos o una pausa más larga entre ellos.
  • El rango adaptativo (desactivado por defecto) hace que la ventana siga a la superficie, de modo que el radar solo barre una banda estrecha a su alrededor. Eso ahorra batería; si el nivel sale de la banda, Puck vuelve a medir de inmediato el rango completo.

Contenedores de residuos (método 4)

  • Monte Puck encima del contenedor mirando hacia abajo, o en una pared lateral mirando a través de la parte superior. El rango debe llegar hasta el fondo del contenedor vacío.
  • El umbral es el ajuste principal. Los residuos blandos, como el papel, reflejan débilmente y pueden necesitar un umbral más bajo; el metal refleja con fuerza. Si las propias paredes o la tapa del contenedor producen ecos, suba el umbral o haga que el rango empiece más allá de ellas.
  • Cuanto menor es la distancia, más lleno está el contenedor.
  • Para contenedores de cualquier tamaño, desde papeleras y contenedores con ruedas hasta grandes contenedores, el método Distance2 con dos zonas también puede indicar cuándo el fondo está cubierto y cuándo el contenedor está lleno: consulte el ejemplo siguiente.

Aparcamiento (método 5)

  • Una plaza de aparcamiento se considera ocupada cuando el eco más fuerte dentro del rango es de 350 o más. Este nivel es fijo, por lo que el montaje y el rango deben hacer que un coche dé un eco fuerte y una plaza vacía uno débil.
  • Elija la lente según la anchura de la zona que debe cubrir, y haga que el rango termine donde puede estar la carrocería del coche, antes del suelo, el bordillo o el techo que haya detrás.
  • No hay filtrado: si el eco oscila en torno a 350, el estado puede cambiar de un lado a otro. Modifique el montaje o el rango.
  • Con send only changes activado en los ajustes del sistema, Puck solo comunica llegadas y salidas, lo que ahorra batería (consulte Ajustes del radar por posición).

Asientos (métodos 6 y 7)

  • Seating (6) cambia entre ocupado y libre solo cuando coinciden varias mediciones seguidas, 3 por defecto en cada sentido. Suba el umbral, o recorte el rango, si un respaldo o el borde de una mesa produce un falso ocupado.
  • Adv_Seating (7) es un método de asientos ampliado para usos exigentes de detección de ocupación: filtra los sucesos breves antes de que cambie el estado, informa solo cuando cambia el estado y, en el modo silla de ruedas, distingue una silla de ruedas de otro objeto, como el equipaje.

Dos distancias (método 8)

  • Cada zona comunica su propio eco: el más cercano, el más fuerte o el más lejano, según elija. Una zona con un final de 0 está desactivada.

Ejemplo: un contenedor de residuos con dos zonas

Con dos zonas, un Puck situado encima de una papelera, un contenedor con ruedas o un contenedor grande puede indicarle tres cosas. Supongamos que Puck está a 1,2 m por encima del fondo:

  • Zona 1, desde 0,2 m hasta justo por encima del fondo (aquí 0,2–1,1 m), con el eco más cercano elegido: la distancia a la parte superior de los residuos, es decir, el nivel de llenado.
  • Zona 2, una zona estrecha alrededor del fondo (aquí 1,15–1,25 m): mientras tenga eco, el fondo sigue siendo visible. Cuando el eco desaparece, el fondo está cubierto de residuos.
  • Ningún eco en ninguna de las zonas: el radar no ve nada más allá de 0,2 m. Lo más probable es que los residuos hayan llegado a menos de 0,2 m de Puck y el contenedor esté lleno. (Algo que cubra la lente da el mismo resultado, así que revise Puck si ocurre con un contenedor vacío).

Configúrelo con tres comandos de radar, cada uno enviado como downlink propio en el puerto 48: sys:8 selecciona el método 8; 8:600,,,,,,0.2,1.1,,,0,1.15,1.25 mide cada 10 minutos y configura la zona 1 (posiciones 7 y 8), el eco más cercano (posición 11) y la zona 2 (posiciones 12 y 13); 8:,,,,,,,,,,,,,,,,0,0 desactiva la zona de exclusión 1 (posiciones 17 y 18), para que no oculte ninguna parte de la zona 1. La zona 2 llega como distance2 y amplitude2 (consulte Mensajes).

Una aplicación nueva: vea lo que ve el radar

Antes de configurar un uso que no se haya hecho antes, pruébelo in situ y averigüe lo que el radar ve realmente: de dónde vienen los ecos, con qué intensidad, y cómo reflejan el haz las paredes, las instalaciones y el propio objetivo. Hay dos formas que ayudan:

  • SweIoT Toolbox: in situ, pruebe los distintos métodos y ajustes y observe los resultados directamente (consulte SweIoT Toolbox).
  • Un escaneo a través de LoRaWAN: seleccione el método 7 u 8 y envíe meth_cmd:2,start,end,sections en el puerto 48, con el inicio y el final en metros. El radar responde en el puerto 32 con la intensidad del eco a lo largo de la zona, como una lista: para cada sección, el eco más fuerte, dividido entre 10 (con 0 secciones, cada punto de medición). Por ejemplo, meth_cmd:2,0.5,2.5,40 da 40 valores de 0,5 a 2,5 m, uno cada 5 cm. La lista procede de la última medición. Los métodos 3 a 6 no disponen de este comando.

Los escaneos también permiten a una plataforma IoT como Yggio calibrar automáticamente los Puck montados: pide un escaneo a cada Puck, localiza el objetivo y los reflectores fijos, calcula las zonas y los umbrales, y los devuelve como comandos de radar, repitiendo el proceso hasta que el resultado es correcto.

Qué datos envía

La aplicación VSM de la placa LoRaWAN toma cada medición del radar y envía solo lo que ha cambiado:

  • Distancia e intensidad del eco: se envían cuando la distancia ha cambiado más que la Radar Distance Hysteresis (10 cm por defecto), o la intensidad del eco más que la Radar Amplitude Hysteresis. En el método Distance2, también se envía el eco de la zona 2.
  • Ocupado: 1 o 0, de los métodos que evalúan la ocupación: Bin, Parking, Seating y Adv_Seating.
  • Distancia media: la distancia se muestrea cada minuto y se promedia a lo largo del Average Distance Interval (24 horas por defecto). La media se envía cuando ha cambiado más que la histéresis de distancia.
  • Alarmas de distancia: configure un Distance Alarm Low Level y un High Level, en metros desde el sensor. La alarma sigue la distancia media, por lo que no reacciona más rápido que el Average Distance Interval: acorte el intervalo cuando utilice la alarma. 0 desactiva la alarma baja.
  • No se encuentra eco: cuando una medición no encuentra ningún eco por encima del umbral, el ajuste Report Failed Measurements decide qué ocurre. Desactivado (el valor predeterminado), no se envía nada y se mantiene la última distancia comunicada. Activado, Puck lo comunica como distancia 0, para que pueda saber, por ejemplo, que el objetivo ha salido del rango.
  • Tasa de detección: una vez al día, la proporción de mediciones que encontraron un eco, en porcentaje. Una caída puede indicar, por ejemplo, agua corriente o lluvia o nieve intensas que impiden al radar obtener un eco estable.

Temperatura, humedad y batería

Cada 8 horas por defecto (el periodic reports interval), Puck envía la tensión de la batería, la temperatura y la humedad, con un contador que aumenta en uno cada vez.

  • Dentro de la carcasa: la temperatura y la humedad se miden dentro del Puck sellado, no en el aire que lo rodea. La temperatura tiene una precisión de unos ±2 °C entre 0 y 30 °C, y puede ajustarse con Temperature Calibration.
  • La humedad como aviso: Puck lleva dentro gel de sílice que absorbe la humedad. Una humedad que no deja de subir significa que entra humedad o que el gel de sílice está agotado: consulte Mantenimiento. La humedad también se compara cada hora con el Humidity Alarm Level (60 % HR por defecto): cuando se alcanza, Puck envía una alarma de humedad, confirmada, para que pueda sustituirse el gel de sílice, y la anula cuando la humedad vuelve a estar 5 % HR por debajo del nivel. 0 desactiva la alarma.
  • Batería: la tensión se mide durante una medición del radar. Un único valor bajo es normal, y también lo es una tensión más baja con frío. Si se mantiene por debajo de 2,8 V a temperaturas superiores a +10 °C, cambie la batería.

Movimiento e inclinación

Puck puede avisarle cuando ha recibido un golpe, se ha movido o se ha girado. Configure el Position Check Interval (desactivado por defecto) y Puck leerá su acelerómetro con esa frecuencia, mientras esté unido a la red y en reposo, de modo que mida la gravedad. La primera comprobación establece la referencia y la envía como X, Y y Z. Cuando una comprobación posterior encuentra Puck a más del Position Moved Threshold (1,71 m/s², unos 10°, por defecto) de la referencia, vuelve a comprobarlo un minuto después; si Puck sigue desplazado, envía la nueva referencia y cuenta el movimiento. No se envía nada mientras Puck permanece en su sitio. Una comprobación detecta un cambio de orientación (inclinado o girado), no un desplazamiento que mantenga la orientación; un Puck movido y vuelto a colocar entre dos comprobaciones no se detecta, como tampoco uno perturbado durante menos de un minuto, por ejemplo por el tráfico. La referencia se pierde con un reinicio, y se envía una nueva; desactivar y volver a activar la función la conserva. Cada comprobación es una lectura de unos 0,1 s, con el acelerómetro apagado el resto del tiempo.

Posición

Una vez al día, mientras está unido a la red, Puck busca puntos de acceso Wi-Fi y envía el resultado, para que un servicio en la nube pueda determinar su posición (consulte Cómo funciona el posicionamiento por Wi-Fi).

Datos registrados

Las lecturas tomadas mientras Puck 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 de Puck, 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: Puck Radar no dispone de posicionamiento por satélite.

Red

  • Mensajes confirmados: el servidor de red acusa recibo de la distancia, la intensidad del eco, la media, las alarmas, el estado de ocupación, la tasa de detección y los informes de movimiento e inclinación, y Puck los vuelve a enviar si no llega ningún acuse de recibo, esperando entre intentos como máximo el Max time between ReSend tries (4 horas por defecto).
  • Unión: si Puck no está unido a la red, intenta unirse cada 5 horas (Time between join retries), y al menos una vez al día. Un toque NFC inicia un intento de unión de inmediato. El radar está apagado mientras Puck no está unido a la red.
  • Pérdida de la red: Puck abandona la red y vuelve a unirse si no ha recibido nada de la red durante el Time from last RX before unjoin (15 días por defecto), o durante el Downlink Timeout (consulte Registros del dispositivo).
  • Itinerancia: con un Roaming Network Count superior a 1, Puck prueba varias identidades de red sucesivamente al unirse, cambiando el último dígito de su AppKey. Cada identidad adicional cuesta tiempo y batería al unirse.
  • Velocidad de datos adaptativa: Puck 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, disponible como paquete de Node. Necesita dos cosas por su parte: debe poder almacenar al menos el rulesCrc32 de cada sensor entre mensajes, y debe mantenerse actualizado, ya que las nuevas versiones de la aplicación se publican sin previo aviso.

Cambiar los ajustes

Hay dos tipos de ajustes: los ajustes de la aplicación VSM en la placa LoRaWAN (cuándo informar, alarmas, red), y los ajustes del radar en la placa de radar (método, intervalo, rango, umbral). Ambos pueden cambiarse por radio, e in situ con una aplicación:

Por LoRaWANIn situ
Ajustes de la aplicación (placa LoRaWAN)Enlaces descendentes en el puerto 2 o el puerto 7La aplicación NFC Hugin (Android), por ejemplo con un código QR de la VSM Configuration Tool
Ajustes del radar (placa de radar)Comandos de radar en el puerto 48La aplicación SweIoT Toolbox (Android), por Bluetooth
Actualizaciones de softwareNuevas aplicaciones VSMHugin: el firmware y la aplicación VSM de la placa LoRaWAN. SweIoT Toolbox: el firmware del radar, que solo puede actualizarse de esta forma

La VSM Configuration Tool genera los downlinks para ambos tipos.

  1. Elija la aplicación: por nombre y versión, o por el rulesCrc32 del mensaje del puerto 15 de Puck (consulte Qué aplicación ejecuta el sensor).
  2. Elija Custom y establezca los valores que desee. Cada ajuste muestra su descripción, su unidad y su rango. Escriba los comandos de radar en el campo Radar Module Commands, separados por ;, por ejemplo sys:3;3:600.
  3. Tome el resultado: downlinks para el puerto 2 y el puerto 48, 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.
Puck es un dispositivo de clase A: recoge un downlink justo después de cada uplink. Los ajustes surten efecto, como pronto, después del siguiente mensaje de Puck, y en una red con mucho tráfico puede tardar más. Cualquier ajuste que haga que Puck mida o envíe con más frecuencia consume batería.

5Las aplicaciones: Hugin y SweIoT Toolbox

Aplicación NFC Hugin (placa LoRaWAN)

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.

Hugin también actualiza el firmware y la aplicación VSM de la placa LoRaWAN.

SweIoT Toolbox for Puck & Prism radar sensor

SweIoT Toolbox es una aplicación Android, disponible en Google Play, que se comunica con la placa de radar por Bluetooth. No existe versión para iPhone. Utilícela in situ para leer y cambiar los ajustes del radar y para actualizar el firmware del radar.

  • Active el Bluetooth del radar con Hugin: el Bluetooth de la placa de radar está apagado la mayor parte del tiempo, por tres motivos: ahorra batería, reduce el tráfico de radio en el aire y limita quién puede acceder a la placa de radar, de acuerdo con la Ley de Ciberresiliencia de la UE (Cyber Resilience Act). Solo el propietario registrado del sensor, o los usuarios a los que el propietario haya concedido el permiso, pueden activar el Bluetooth. Para activarlo para SweIoT Toolbox, acerque el teléfono a Puck con la aplicación Hugin abierta (consulte Localizar las antenas NFC) y pulse Activate Radar Bluetooth: la placa de radar se hace visible por Bluetooth durante unos 20 segundos, así que conéctese desde SweIoT Toolbox dentro de ese tiempo. Un toque NFC sin la aplicación Hugin no activa el Bluetooth: solo hace que Puck envíe un mensaje. También puede activarlo a distancia, con un downlink LoRaWAN, por ejemplo desde Yggio: configure Radar BT Advertise trigger con el valor 1 (consulte Ajustes). En Yggio, solo los usuarios con permiso sobre el sensor pueden enviarlo. Aparte de esto, la placa de radar solo es visible por Bluetooth durante unos segundos después de cada medición.
  • En la aplicación: SweIoT Toolbox le guía para elegir un método de radar y ajustar sus ajustes principales. Su menú Commands and Logs admite los mismos comandos de radar que LoRaWAN.
  • Actualizaciones: el firmware del radar solo puede actualizarse por Bluetooth, con SweIoT Toolbox.

6Mantenimiento y desmontaje

Batería

La batería es una pila reemplazable de litio-cloruro de tionilo (LiSOCl₂), de 3,6 V y 2100 mAh, elegida porque funciona de −30 a +80 °C. Su duración depende del método de radar, de la frecuencia con la que mide el radar, del promediado y de la frecuencia con la que informa Puck. Como referencia, la batería dura mucho más de diez años en una plaza de aparcamiento medida cada 30 segundos, y en un pozo o un contenedor de residuos medido cada 10 minutos. Una buena red (SF7–SF9) ayuda; un enlace débil la acorta. Cambie la batería cuando la tensión se mantenga por debajo de 2,8 V por encima de +10 °C (consulte Temperatura, humedad y batería).

Cambiar la batería

Utilice el kit de batería de Sensative: una batería nueva, una junta tórica y un cojín de goma nuevos, y dos herramientas Star. Cambie la batería en un lugar seco.

La herramienta Star para abrir y cerrar Puck
La herramienta Star. Utilice una en cada extremo de Puck.
  1. Desmonte Puck. Coloque una herramienta Star en cada extremo y gire la tapa de la lente en sentido antihorario para abrir la carcasa. No utilice nunca otras herramientas: pueden romper la carcasa o dejarla mal cerrada.
  2. Desconecte la batería antigua de su conector y conecte la nueva. Sujete la placa de circuito con un dedo mientras tira del conector. De lo contrario, las placas pueden salir de la carcasa con él, y cuesta volver a colocarlas. No corte los cables de la batería.
  3. Coloque el cojín de goma nuevo y la junta tórica nueva, y compruebe que están bien asentados y limpios. Mantienen Puck estanco.
  4. Cierre la carcasa girándola en sentido horario, aproximadamente un cuarto de vuelta, y después apriétela por completo con las dos herramientas Star.
  5. Puck se pone en marcha de nuevo y, si ya estaba unido a la red, vuelve a unirse por sí solo. Compruebe que llegan las mediciones. Si nunca se ha unido a la red, únalo con NFC, como en el paso 3.
Puck Radar abierto, con la batería en su conector y la junta tórica azul
Puck abierto: la batería en su conector y la junta tórica azul.

Humedad

Puck está sellado, y el gel de sílice de su interior absorbe la humedad que se condensa. Si la humedad comunicada desde el interior no deja de subir, o se activa la alarma de humedad (al 60 % HR por defecto; consulte Temperatura, humedad y batería), abra Puck como se indica más arriba, revise la junta tórica y sustituya el gel de sílice.

Desmontar Puck Radar

Si está fijado con adhesivo, pase hilo dental por detrás de Puck y corte el adhesivo con un suave movimiento de sierra. Si está en una placa de montaje, desatornille o corte la placa para soltarla; la batería puede cambiarse con la placa todavía colocada.

Cambiar de servidor de red

Elimine el dispositivo del servidor de red antiguo y añádalo al nuevo. Puck pierde entonces la red antigua y se une a la nueva. Con la aplicación Hugin puede reiniciarlo de inmediato (ON / OFF), pero eso también restablece los ajustes personalizados.

Almacenamiento, seguridad y eliminación

  • Almacene los sensores y las baterías sin usar a una temperatura de +10 a +30 °C.
  • No cortocircuite la batería, no la perfore ni la caliente por encima de +80 °C. Abra Puck solo para cambiar la batería.
  • Lleve las baterías usadas a un punto de recogida de pilas, y Puck, sin la batería, a un punto de recogida de residuos electrónicos.

7Solución de problemas

ProblemaSolución
La distancia es 0, o no se encuentra nadaUna distancia 0 significa que una medición no encontró ningún eco por encima del umbral (solo se envía con Report Failed Measurements activado). El objetivo está fuera del rango, o su eco es demasiado débil. Compruebe Start y Length of range, y después baje el umbral (consulte Métodos de radar).
Distance2: ningún eco de una zonaCompruebe que los rangos de las dos zonas y de las zonas de exclusión están bien configurados. Una zona de exclusión que cubre una zona de detección oculta todos los ecos que hay en ella.
La distancia es incorrectaEl radar ve otra trayectoria: una pared lateral, el fondo, el soporte o una tapa. Apunte Puck directamente al objetivo, acorte el rango, suba el umbral o utilice la lente estrecha (consulte Cómo ve el radar).
Las lecturas saltan con lluvia, nieve o sobre agua en movimientoUtilice más barridos por medición, con la mediana activada, o una pausa más larga entre barridos (consulte Ajustes del radar por posición). Ambas cosas consumen batería. La tasa de detección diaria muestra con qué frecuencia encuentra el radar un eco estable.
No hay mediciones, aunque Puck se ha unido a la redEl radar solo mide mientras Puck está unido a la red. Lea los ajustes del radar con sys? en el puerto 48: compruebe el método y que el radar está activo (posición 6).
Un comando de radar recibe como respuesta *El comando no se ha aceptado. Compruebe su formato y sus valores (consulte Comandos de radar), y lea los valores actuales con sys? o, para un método, por ejemplo con 3?.
SweIoT Toolbox no encuentra el radarActive el Bluetooth con la aplicación Hugin, para lo que se necesitan permisos de acceso al sensor en Yggio, y conéctese en unos 20 segundos; o envíe el Radar BT Advertise trigger. SweIoT Toolbox es solo para Android.
La humedad interior no deja de subir, o se activa la alarma de humedadEntra humedad, o el gel de sílice está agotado. Revise la junta tórica y sustituya el gel de sílice (consulte Mantenimiento). La alarma se anula sola cuando la humedad vuelve a estar 5 % HR por debajo del Humidity Alarm Level.
No hay informes de movimiento ni de inclinaciónEl Position Check Interval es 0 por defecto, lo que desactiva la función. Configúrelo (consulte Movimiento e inclinación). Un desplazamiento que mantenga la orientación, o un Puck movido y vuelto a colocar entre dos comprobaciones, no se detecta.
La tensión de la batería es bajaCompruebe primero la temperatura: la tensión baja con frío. Si se mantiene por debajo de 2,8 V por encima de +10 °C, cambie la batería.
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 parte superior de Puck y muévalo lentamente hasta que indique el contacto; después, manténgalo quieto (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 (EU868).
No aparece nada en el servidor de redCompruebe que el gateway está encendido y en línea, y que Puck está dentro del alcance y no dentro de un recinto metálico. 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).
Un ajuste nuevo no surte efectoUn downlink solo llega después del siguiente mensaje de Puck, y más tarde en una red con mucho tráfico. Compruebe que sigue en cola y que se generó para el rulesCrc32 que comunica su Puck.
Faltan mensajes o llegan de forma irregularCompruebe el RSSI y la SNR. Es posible que Puck esté demasiado lejos del gateway, o en el fondo de un pozo o de una estructura de hormigón. 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.
No hay posiciónPara obtener una posición se necesita un servicio en la nube que admita el posicionamiento por Wi-Fi, por ejemplo Yggio, y suficientes puntos de acceso de 2,4 GHz conocidos al alcance. Consulte Cómo funciona el posicionamiento por Wi-Fi.

8Referencia técnica

Para integradores. Los valores siguientes corresponden a la aplicación Puck-radar 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, Puck 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ónPuck-radar
VersiónNovember 2026
rulesCrc32961870689 (hex 3954FB61)
Versión anteriorPuck-radar R31–R33, rulesCrc32 1946060128: consulte la revisión A de este manual

Si no recibió el mensaje, envíe 00 por el puerto 15 y Puck 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 Puck 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 Puck entregados antes de la versión de noviembre de 2026 ejecutan Puck-radar R31–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 Puck-radar, Sensative puede ofrecer otras aplicaciones VSM para la placa LoRaWAN de Puck. Están disponibles en la aplicación NFC Hugin (Android) y también pueden cargarse a través de LoRaWAN. Pregunte a Sensative qué aplicaciones se adaptan a su uso.

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 Puck y Square)
PuertoDirecciónContenido
1UplinkLecturas y alarmas (consulte Mensajes)
11UplinkLas mismas salidas en forma comprimida
12UplinkDatos registrados: un mensaje almacenado mientras Puck no tenía red, 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 a Puck que vuelva a enviar la identidad de su aplicación
23UplinkEscaneo Wi-Fi, para el posicionamiento
2DownlinkAjustes de la aplicación y solicitudes de lectura (consulte Ajustes en el puerto 2)
2UplinkRespuesta de Puck con sus valores actuales
7DownlinkConfiguración completa en un solo payload, incluidos los comandos de radar (consulte Configuración completa en el puerto 7)
7UplinkEl estado de esa configuración: None, Applied, Error o Dirty
48DownlinkUn comando de radar, como texto (consulte Comandos de radar)
32UplinkLa respuesta de la placa de radar, como texto

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
distance912 bytes, × 0,001mSíAnte un cambio mayor que la Radar Distance Hysteresis
amplitude902 bytesintensidad del ecoSíAnte un cambio mayor que la Radar Amplitude Hysteresis
distance2, amplitude293 922 bytes cada uno; distancia × 0,001m, intensidad del ecoSíZona 2 del método Distance2, junto con la zona 1
occupied801 byte1 = ocupado, 0 = libreSíEn los métodos que evalúan la ocupación, cuando cambia
distanceAverage942 bytes, × 0,001mSíCada Average Distance Interval, si ha cambiado
averageDistanceAlarm811 byte0 = ninguna, 1 = baja, 2 = alta, 3 = ambasSíCuando cambia el estado de alarma
radarDetectionPercentageDay952 bytes% de mediciones con ecoSíUna vez al día
radarVoltage_VB42 bytes, × 0,001VNoCon los informes periódicos
tempB62 bytes, × 0,01°C, dentro de la carcasaNoCon los informes periódicos
humidityB52 bytes, × 0,01% HR, dentro de la carcasaNoCon los informes periódicos
humidityAlarm821 byte0 = sin alarma, 1 = alarmaSíCuando la humedad interior alcanza el Humidity Alarm Level, y cuando vuelve a estar 5 % HR por debajo
positionX, positionY, positionZ99 9A 9B4 bytes cada uno, × 0,001m/s² (gravedad en cada eje)SíCon el Position Check Interval configurado: la orientación de referencia, en la primera comprobación y después de cada movimiento
positionMoves9C4 bytesdesplazamientos desde la puesta en marchaSíCon la nueva referencia después de cada desplazamiento
periodicReportsCounterBB4 bytesrecuentoNoCon cada informe periódico
nfcContactCount984 bytesrecuentoSíTras un toque NFC, para que Puck responda incluso con el radar apagado

Ajustes

Los valores predeterminados son aquellos con los que arranca Puck. 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
Radar Distance HysteresisdistanceHysteresisA2Variación de la distancia a partir de la cual se envía una nueva distancia o una nueva media.m, pasos de 0,010–1,270,10
Radar Amplitude HysteresisamplitudeHysteresisB0Variación de la intensidad del eco a partir de la cual se envía un nuevo valor.intensidad del eco0–32 767250
Average Distance IntervalaverageDistanceIntervalMinutesB1Periodo en el que se calcula la distancia media. Las alarmas se basan en la media.minutos2–32 7671440
Distance Alarm Low LevelaverageDistanceLowAlarmLevelB2Alarma cuando la distancia media está por debajo de este nivel. 0 = desactivada.m, pasos de 0,010–327,670
Distance Alarm High LevelaverageDistanceHighAlarmLevelB3Alarma cuando la distancia media está por encima de este nivel.m, pasos de 0,010–327,670
Report Failed MeasurementsreportFailedDistanceMeasurementsA30 = una medición sin ningún eco por encima del umbral no se envía. 1 = se envía como distancia 0.activado/desactivado0–10
Interval between periodic reportsperiodicReportsIntervalA4Con qué frecuencia se envían la tensión de la batería, la temperatura y la humedad.horas0–2508
Humidity Alarm LevelhumidityAlarmLevelA5La humedad dentro de la carcasa a la que se envía la alarma de humedad, comprobada cada hora. 0 desactiva la alarma.% HR0–10060
Position Check IntervalpositionCheckIntervalMinutesBDCon qué frecuencia comprueba Puck su orientación para el informe de movimiento e inclinación. 0 desactiva la función: no se lee el acelerómetro y no se envía nada.minutos0–32 7670 (desactivado)
Position Moved ThresholdpositionMovedThreshold_m_s2BECuánto debe alejarse de la referencia el vector de gravedad medido para que Puck se considere movido, como longitud de la diferencia. Una inclinación de un ángulo lo desplaza 2 g sen(ángulo/2): 0,86 m/s² para 5°, 1,71 para 10°, 3,41 para 20°, 5,08 para 30° y 9,81 para 60°.m/s², pasos de 0,0010,3–19,61,71
Temperature CalibrationtemperatureUserCalibrationBCCompensación que se suma a la temperatura.°C, pasos de 0,01−10 a +100
Radar BT Advertise triggerradarBtAdvertiseTriggerA1Con 1, la placa de radar se hace visible por Bluetooth, para SweIoT Toolbox.activado/desactivado0–10
Time between join retriestimeBetweenJoinAttemtsB8Cuánto espera Puck entre intentos de unión cuando no está unido a la red.minutos0–32 767300
Time from last RX before unjointimeBeforeUnjoinB9Cuánto tiempo puede pasar Puck sin oír la red antes de volver a unirse.horas0–32 767360
Max time between ReSend triesmaxResendWaitTimeBAEspera máxima entre intentos cuando un mensaje confirmado no recibe acuse de recibo.segundos0–5 184 000 (60 días)14 400
Roaming Network CountroamNetworkCountA0Número de identidades de red LoRaWAN que se prueban sucesivamente (consulte Red).número1–151

Registros del dispositivo

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

RegistroNombreIdFunciónUnidadRangoPredeterminado
Downlink TimeoutLINKCHECK_TIMED0Cuánto tiempo pasa Puck sin recibir nada de la red antes de abandonarla y quedar sin unir. Cualquier downlink, incluido un acuse de recibo, reinicia el tiempo. A partir de la mitad del tiempo, todos los uplinks se envían como confirmados; a partir del 80 %, Puck también envía sus propias comprobaciones de enlace. 0 desactiva la comprobación.segundos300–2 592 00028 800 (8 horas) en esta aplicación
Device Time Max AgeDEVICE_TIME_MAX_AGECDCuánto tiempo confía Puck 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 respuesta. El servidor de red debe responder a las solicitudes DeviceTime. 0 lo desactiva: Puck no tiene entonces hora, y las lecturas tomadas sin red no se registran.segundos0–4 294 967 2952 592 000 (30 días)

Salir de la red

Para que Puck salga de la red de inmediato, escriba 1 (no unido) en su registro DEVICE_STATE: envíe C8 00 00 00 01 por el puerto 2 (base64 yAAAAAE=). Después vuelve a unirse igual que cuando pierde la red (consulte Red). Las lecturas tomadas mientras no está unido se guardan y se envían cuando vuelve a unirse.

Puck no confirma este downlink aunque se envíe como confirmado, por lo que no puede provocar reenvíos en bucle. Aun así, envíelo sin confirmar.

Perfiles publicados

Para esta aplicación no se han publicado perfiles listos para usar. Puck 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: una Radar Distance Hysteresis de 0,05 m en pasos de 0,01 se envía como 5. Puck 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 Puck.

Leer valores

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

Downlink en el puerto 2Puck responde con
04Temperatura actual, en centésimas de grado
05Humedad actual, en centésimas de punto porcentual
A2La Radar Distance Hysteresis configurada 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.

Comandos de radar

La placa de radar admite comandos de texto breves. Envíe cada uno como downlink en el puerto 48, en ASCII; la VSM Configuration Tool los genera automáticamente a partir del campo Radar Module Commands. La placa de radar responde en el puerto 32, como texto: una respuesta que empieza por = significa que el comando se ha aceptado, * significa un error. Aproximadamente una hora después de un cambio (60 minutos por defecto), la placa de radar también envía los ajustes con los que funciona ahora, para que pueda confirmarlos.

ComandoFunción
sys?Leer los ajustes del sistema
sys:3Seleccionar el método 3 (Well). El primer ajuste del sistema es el método
3?Leer los ajustes del método 3 (funciona con cada método)
3:600Establecer el primer ajuste del método 3, el intervalo de medición, en 600 s
4:600,,0.15,1.2Establecer varios ajustes del método 4 a la vez, por posición. Una posición vacía conserva ese ajuste, y los ajustes posteriores al último indicado se quedan como están
measureMedir una vez, ahora
test:10Modo de prueba: medir cada 10 s durante 10 minutos y después volver al funcionamiento normal. Útil durante la instalación
meth_cmd:2,0.5,2.5,40Métodos 7 y 8: un escaneo de 0,5 a 2,5 m en 40 secciones (consulte Una aplicación nueva)
versionLeer la versión del firmware del radar
restartReiniciar la placa de radar
factoryRestablecer todos los ajustes del radar (de sistema y de métodos) a los valores de fábrica

Ajustes del radar por posición

Los ajustes de cada método forman una cadena de valores, separados por comas, en un orden fijo. Los ajustes que un usuario cambia normalmente, con sus valores predeterminados:

MétodoPosición: ajuste (predeterminado)
3 Well1: intervalo, s (300) · 2: HWAAS, 1–63 (20) · 3: inicio del rango, m (0,500) · 4: longitud del rango, m (3,000) · 5: barridos por medición (3) · 10: rango adaptativo, m, 0 = desactivado (0) · 11: mediana, 1 = activada (1) · 12: umbral (200) · 13: pausa entre barridos, ms (1000) · 14: perfil de radar, 1–5 (2)
4 Bin1: intervalo, s (120) · 2: HWAAS (20) · 3: inicio del rango, m (0,150) · 4: longitud del rango, m (1,000) · 5: umbral (290) · 6: desplazamiento sumado a la distancia, mm (0)
5 Parking1: intervalo, s (30) · 2: HWAAS (10) · 3: inicio del rango, m (0,200) · 4: longitud del rango, m (1,500)
6 Seating1: intervalo, s (60) · 2: HWAAS (30) · 3: inicio del rango, m (0,240) · 4: longitud del rango, m (1,000) · 5: umbral (200) · 6: desplazamiento, mm (0) · 7: mediciones seguidas para pasar a ocupado (3) · 8: y para pasar a libre (3)
8 Distance2Dos zonas, cada una con su propio umbral y su propia elección de eco, y hasta dos zonas de exclusión (posiciones 7–22; consulte el ejemplo anterior)

Por ejemplo, 3:,,,,,,,,,,,150 baja el umbral del método Well a 150 y deja el resto como está.

Los ajustes del sistema forman también una cadena. La posición 1 es el método, y la posición 8, send only changes (0 = desactivado), hace que Puck envíe solo los resultados que han cambiado, como las llegadas y salidas en una plaza de aparcamiento: sys:,,,,,,,1. Deje los demás ajustes del sistema tal como se entregan. En particular, no cambie nunca el ajuste de transporte (posición 7): puede desconectar la placa de radar de LoRaWAN.

  • HWAAS: muestras promediadas en el chip del radar para cada punto. Más muestras reducen el ruido, pero cuestan tiempo y batería.
  • Perfil de radar: un perfil más alto da más señal para distancias largas, como pozos profundos, a costa de la resolución de distancia.

Ejemplo práctico 1: imbornal, nivel de agua cada 10 minutos y alarma de inundación

Seleccionar el método Well y medir cada 10 minutos. Promediar a lo largo de 30 minutos en lugar de 24 horas, y generar la alarma cuando el agua llegue a menos de 1 m de Puck. Los ejemplos se han construido con el formato de registro de Ajustes en el puerto 2 y los comandos de radar para el rulesCrc32 961870689, 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 los downlinks en orden o el único payload del puerto 7, no ambos.

AjusteValorSe envía comoRegistro
Radar Module Commandssys:3;3:600dos comandos de radarsys:3 y 3:600 en el puerto 48
Average Distance Interval30 min30B1 00 00 00 1E
Distance Alarm Low Level1,00 m100B2 00 00 00 64
PuertoDownlink (hex)Base64
2B1 00 00 00 1E B2 00 00 00 64sQAAAB6yAAAAZA==
4873 79 73 3A 33c3lzOjM=
4833 3A 36 30 30Mzo2MDA=
O 739 54 FB 61 02 0A B1 00 00 00 1E B2 00 00 00 64 30 05 73 79 73 3A 33 30 05 33 3A 36 30 30 00 4C 5F C1 59

Ejemplo práctico 2: contenedor de residuos de 1,2 m de profundidad, comprobado cada 10 minutos

Seleccionar el método Bin, medir cada 10 minutos en un rango de 0,15 m a 1,35 m y enviar una nueva distancia con cada cambio de 5 cm.

AjusteValorSe envía comoRegistro
Radar Module Commandssys:4;4:600,,0.15,1.2dos comandos de radarsys:4 y 4:600,,0.15,1.2 en el puerto 48
Radar Distance Hysteresis0,05 m5A2 00 00 00 05
PuertoDownlink (hex)Base64
2A2 00 00 00 05ogAAAAU=
4873 79 73 3A 34c3lzOjQ=
4834 3A 36 30 30 2C 2C 30 2E 31 35 2C 31 2E 32NDo2MDAsLDAuMTUsMS4y
O 739 54 FB 61 02 05 A2 00 00 00 05 30 05 73 79 73 3A 34 30 0F 34 3A 36 30 30 2C 2C 30 2E 31 35 2C 31 2E 32 00 87 9D 91 68

Ejemplo práctico 3: un aviso más temprano para el gel de sílice y una comprobación de inclinación cada hora

Enviar la alarma de humedad ya al 50 % HR dentro de la carcasa, y comprobar una vez por hora si Puck se ha movido o girado.

AjusteValorSe envía comoRegistro
Humidity Alarm Level50 % HR50A5 00 00 00 32
Position Check Interval60 min60BD 00 00 00 3C
PuertoDownlink (hex)Base64
2A5 00 00 00 32 BD 00 00 00 3CpQAAADK9AAAAPA==
O 739 54 FB 61 02 0A A5 00 00 00 32 BD 00 00 00 3C 00 FE 13 F4 A2

9Especificaciones

RadarRadar coherente pulsado de 60 GHz (Acconeer A111)
Rango de medición0,2–7 m, resolución y precisión de 1 mm; la distancia se mide desde el punto de referencia del radar dentro de la carcasa, 11 mm (estándar) o 26 mm (estrecha) por detrás de la cara de la lente
HazLente estándar unos ±60°, lente estrecha unos ±10°
Métodos de radarWell, Bin, Parking, Seating, Adv_Seating, Distance2 (firmware del radar 2.24)
Otros sensoresTemperatura (típica ±2 °C a 0–30 °C) y humedad, dentro de la carcasa, con alarma de humedad para el gel de sílice; acelerómetro 3D para movimiento e inclinación
PosicionamientoEscaneo Wi-Fi una vez al día; se necesita un servicio en la nube compatible con el posicionamiento por Wi-Fi
MemoriaRegistro de datos integrado, que se envía por LoRaWAN cuando Puck se conecta
RadioLoRaWAN 1.0.4, clase A, OTAA; JoinEUI 70B3D52C0001D4C3
Plan de frecuenciasEU868
Alcance (radio)Hasta 10 km con visión directa
ConfiguraciónAmbas placas por LoRaWAN; in situ con Hugin (NFC, Android) y SweIoT Toolbox (Bluetooth, Android)
ActualizacionesPlaca LoRaWAN: firmware y aplicación VSM con Hugin, aplicaciones VSM también por LoRaWAN. Placa de radar: firmware solo por Bluetooth, con SweIoT Toolbox
AplicaciónAplicación VSM Puck-radar (noviembre de 2026)
BateríaLiSOCl₂ reemplazable, 3,6 V, 2100 mAh; mucho más de diez años, según el método y la frecuencia de medición
Grado de protección IPIP67, sellado con junta tórica
Temperatura de funcionamiento−30 a +80 °C
Temperatura de almacenamiento+10 a +30 °C
DimensionesØ 45 × 30 mm (lente estándar) o Ø 45 × 45 mm (lente estrecha)
Peso38 g (lente estándar) · 43 g (lente estrecha), batería incluida
MontajeAdhesivo incluido; placas de montaje vendidas por separado; orificio taladrado, soporte o cinchas

10Soporte

Fuentes: Sensative Docs, Puck Radar (consultado el 31 de octubre de 2026); PUCK Radar Sensor User Manual, firmware del radar 2.24; ficha de producto de Puck Radar, Rev B; las fuentes y la documentación de la aplicación en el repositorio vsm-applications de Sensative (Puck-radar, 10 de noviembre de 2026) y las definiciones de producto en dots-builds; la VSM Configuration Tool y la VSM application documentation en GitHub para la versión anterior; 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.