Firmware MeshCore Observer

Firmware experimental para observers MeshCore de Mesh Galicia, baseado en Offband MeshCore Firmware.

Esta compilación corrixe un problema de Offband v1.3.0 polo que os paquetes MQTT parseados de máis de 512 bytes eran descartados pola cola interna. Os adverts MeshCore completos superaban habitualmente ese límite e podían chegar ao broker só polo tema raw, pero non polo tema packets que consume MeshCore Hub.

A corrección amplía o tamaño máximo de cada mensaxe da cola de 512 a 1024 bytes e reduce a súa profundidade de 16 a 8 entradas. A memoria estática reservada permanece en 8 KiB.

Estado

Versión experimental probada fisicamente por Mesh Galicia en:

• Heltec WiFi LoRa 32 V3;
• Heltec WiFi LoRa 32 V4.3.

Confirmouse en uso real:

• conexión Wi-Fi e MQTT;
• publicación nos temas raw, packets e status;
• recepción de adverts completos;
• procesamento dos adverts e das súas localizacións en MeshCore Hub;
• funcionamento continuado durante case 24 horas sen perdas observadas de advertisements entre os paquetes recibidos polos observers e os rexistros correspondentes do Hub.

Na validación de 24 horas analizáronse 2.961 advertisements recibidos polos catro observers de proba e todos quedaron rexistrados no Hub.

Non é unha versión oficial do proxecto Offband.

Dispositivos incluídos

• Heltec WiFi LoRa 32 V3 — probada fisicamente.
• Heltec WiFi LoRa 32 V4.3 — probada fisicamente mediante o ambiente V4 de Offband.

Offband distribúe actualmente un único ambiente de compilación para a familia Heltec V4. Mesh Galicia validou esta compilación na revisión V4.3.

A Heltec V4.2 non se considera actualmente compatible nin validada por Mesh Galicia. Nunha unidade V4.2 probada observouse un fallo de arranque despois dunha instalación completa correcta, polo que non se recomenda empregar esta compilación nesa revisión ata dispoñer de máis probas.

Non uses estes ficheiros noutras revisións ou modelos sen comprobar previamente a compatibilidade.

Descargas

Os binarios están en:

firmware/offband-v1.3.0-mesh-gal-adverts-190240ae/
├── BUILD-INFO.txt
├── SHA256SUMS
├── heltec-v3/
│   ├── bootloader.bin
│   ├── firmware.bin
│   ├── firmware-merged.bin
│   └── partitions.bin
└── heltec-v4/
    ├── bootloader.bin
    ├── firmware.bin
    ├── firmware-merged.bin
    └── partitions.bin

Verifica sempre que escolliches a carpeta correspondente á túa placa.

Actualizar un observer Offband existente

Para actualizar un observer que xa executa o ambiente companion_observer_wifi compatible:

1. Descarga o firmware.bin correspondente á placa.
2. Actualiza só a partición da aplicación.
3. Non borres a flash completa.
4. Non escribas o ficheiro merged durante unha actualización normal.
5. Reinicia o dispositivo e comproba a conexión Wi-Fi e MQTT.

Ao non borrar a flash, deberían conservarse a identidade, o nome, a configuración Wi-Fi, os brokers MQTT e o resto dos datos almacenados en NVS.

A conservación da configuración é o comportamento esperado pola arquitectura da actualización, pero convén conservar unha copia dos parámetros importantes antes de actualizar. Esta ruta debe validarse de forma controlada no observer concreto antes de presentala como garantía absoluta.

Actualización con esptool

O firmware.bin é unha imaxe de aplicación, non unha imaxe completa. A dirección exacta da partición de aplicación debe obterse da táboa de particións do dispositivo ou do procedemento oficial empregado para instalar esa versión.

Non escribas firmware.bin en 0x0.

Instalación desde cero ou recuperación

Para unha placa nova, unha reinstalación completa ou unha recuperación:

1. Descarga firmware-merged.bin da carpeta da túa placa.
2. Entra no bootloader se a placa non é detectada:
   • mantén pulsado PRG/BOOT;
   • pulsa e solta RST/RESET;
   • mantén PRG/BOOT un ou dous segundos máis;
   • solta o botón.
3. Borra a flash se queres unha instalación completamente limpa.
4. Escribe firmware-merged.bin na dirección 0x0.
5. Reinicia e configura novamente o observer.

Exemplo:

esptool.py \
  --chip esp32s3 \
  --port /dev/ttyACM0 \
  erase_flash

esptool.py \
  --chip esp32s3 \
  --port /dev/ttyACM0 \
  --baud 460800 \
  write_flash \
  0x0 firmware-merged.bin

Unha instalación completa borra ou substitúe a configuración anterior. Haberá que configurar de novo Wi-Fi, identidade ou nome, posición e brokers MQTT.

Verificación SHA-256

Desde a carpeta da versión:

sha256sum -c SHA256SUMS

Procedencia e reproducibilidade

Base:

• proxecto: OffbandMesh/meshcore-firmware;
• versión: offband-v1.3.0;
• commit base: bfdbb33a125e8ecfb8b1ca6bc4c2943b6a44a0bb.

Corrección Mesh Galicia:

• commit: 190240ae51739c7fa61b7673ffca296ffafc8384;
• ambiente V3: Heltec_v3_companion_observer_wifi;
• ambiente V4: heltec_v4_companion_observer_wifi.

O parche fonte está dispoñible en:

patches/0001-permite-publicar-adverts-completos-por-mqtt.patch

Licenza

O código orixinal publícase baixo licenza MIT. Consérvase o texto da licenza no ficheiro LICENSE.

Os binarios entréganse sen garantía. O flasheo de firmware pode borrar a configuración ou deixar temporalmente o dispositivo sen arrancar se se emprega un ficheiro, modelo ou dirección incorrectos.