Comando ZONES — Descarga de Geocercas
Descarga hacia el equipo un archivo binario de geocercas (zones) por HTTP y gestiona el slot cargado. La descarga es asíncrona: el comando retorna de inmediato y el resultado final llega cuando termina.
¿Para qué sirve?
🗺️ Casos de uso principales:
- ⬇️ Provisionar el equipo con un set de geocercas alojado en un servidor (HTTP GET)
- 🔄 Actualizar las geocercas de forma remota sin reconfigurar punto por punto
- ⏹️ Cancelar una descarga en curso si se lanzó por error o cambió el archivo
- 🗑️ Borrar el slot de geocercas cargado en el equipo
- 🔍 Consultar si hay geocercas cargadas, su versión, CRC y tamaño
El módulo de almacenamiento de geocercas debe estar habilitado en el equipo. Si no lo está, SZONES responde RZONES,ERR,mode_off y QZONES responde RZONES,DISABLED.
Comandos
| Operación | Sintaxis | Respuesta inmediata |
|---|---|---|
| Descargar | SZONES"url" | RZONES,START |
| Cancelar descarga | SZONESC | RZONESC |
| Borrar slot | SZONESD | RZONESD |
| Consultar estado | QZONES | RZONES,LOADED|EMPTY|DISABLED |
Descarga (SZONES)
La URL debe ir entre comillas. Admite un prefijo opcional para forzar el canal:
| Prefijo | Canal |
|---|---|
| (sin prefijo) | WiFi con fallback a modem |
W: | Fuerza WiFi |
M: | Fuerza modem |
>SZONES"http://host/zones.bin"<
>RZONES,START<La descarga corre en una tarea separada, de modo que el parser queda libre para procesar otros comandos (por ejemplo SZONESC para cancelar por la misma vía). Al terminar, el equipo emite el resultado final:
| Resultado | Descripción |
|---|---|
RZONES,OK,ver=…,crc=0x…,elem=…,size=… | Descarga válida, geocercas cargadas |
RZONES,CANCELED | Cancelada por el usuario (SZONESC) |
RZONES,ERR,<motivo> | Error durante la descarga |
>SZONES"http://host/zones.bin"<
>RZONES,START<
// ... descarga en curso ...
>RZONES,OK,ver=3,crc=0x1A2B3C4D,elem=25,size=8192<Errores de inicio
| Respuesta | Causa |
|---|---|
RZONES,ERR,mode_off | El módulo de geocercas no está habilitado |
RZONES,ERR,bad_url_format | La URL no está correctamente entre comillas |
RZONES,ERR,busy_or_nomem | Ya hay una descarga en curso o no hay memoria |
Cancelar descarga (SZONESC)
Cancela la descarga en curso. Es idempotente: si no hay descarga activa, no hace nada.
>SZONESC<
>RZONESC<Al cancelar, la partición puede quedar con datos parciales; en la próxima recarga el CRC falla y no se carga. El siguiente SZONES"…" arranca limpio.
Borrar slot (SZONESD)
Descarga y borra el slot de geocercas del equipo. Es el alias limpio del comando legacy SZONES**D (que se mantiene por compatibilidad hacia atrás).
>SZONESD<
>RZONESD<
>SZONES**D< // legacy equivalente
>RZONES**D<Consultar estado (QZONES)
>QZONES<
>RZONES,LOADED,ver=3,crc=0x1A2B3C4D,elem=25,size=8192<| Respuesta | Significado |
|---|---|
RZONES,LOADED,ver=…,crc=0x…,elem=…,size=… | Hay geocercas cargadas |
RZONES,EMPTY | Módulo habilitado, sin geocercas cargadas |
RZONES,DISABLED | Módulo de geocercas deshabilitado |
| Campo | Descripción |
|---|---|
| ver | Versión del archivo de geocercas |
| crc | CRC del archivo (hexadecimal) |
| elem | Cantidad de elementos (geocercas) |
| size | Tamaño del archivo en bytes |