🛠 Se connecter au réseau cellulaire et publier un événement

Objetivos

La Boron es la tarjeta celular de la gama Particle: el modelo BRN404X incorpora un módem u-blox SARA-R510S (LTE Cat M1, bandas 2/4/5/12/13, solo América del Norte) y una EtherSIM preabastecida. Este tutorial le lleva de «firmware que funciona» a «objeto conectado»: activar la radio, esperar el registro en la red y la conexión a la nube, leer la potencia de la señal (Cellular.RSSI) y publicar eventos con Particle.publish. También verificará que la antena externa esté bien conectada — sin ella, no hay conexión celular.

Material

• 1× Particle Boron LTE (BRN404X) con antena externa obligatoria en el conector U.FL (antena flexible PARANTC41EA incluida en los kits)
• Batería LiPo o fuente de alimentación USB estable (la transmisión celular provoca picos de corriente)
• Cuenta Particle con un dispositivo ya revendicado (particle list muestra «online»)

Código completo

// Boron — connexion cellulaire + publication cloud (Device OS 4.x LTS)
SYSTEM_THREAD(ENABLED);   // le stack cloud tourne en parallèle de loop

int rssi = 0;

void setup {
    Serial.begin(9600);
    Particle.variable("rssi", rssi);
    Cellular.on;
    Cellular.connect;
    // Attendre jusqu'à 120 s : enregistrement réseau + connexion cloud
    if (waitFor( => Cellular.ready, 120000)) {
        Serial.println("Cellulaire + cloud prets");
    } else {
        Serial.println("Echec de connexion : verifier antenne et couverture");
    }
}

void loop {
    if (Cellular.ready) {              // reseau ET cloud connectes
        rssi = Cellular.RSSI;
        char buf[64];
        snprintf(buf, sizeof(buf), "%d", rssi);
        Particle.publish("boron-rssi", buf, PRIVATE);
        Serial.printf("RSSI=%d publie\n", rssi);
    }
    delay(300000);                       // 5 minutes
}

Verificación esperada

Tras la programación, el LED RGB pasa por las fases de búsqueda de red y luego permanece en modo «respiración» cian cuando todo está conectado. particle list muestra su dispositivo como «online». En la nube, el evento privado boron-rssi llega cada 5 minutos: verifíquelo con particle subscribe PRIVATE <su_cuenta> o en el flujo de eventos de la consola de Particle. El valor RSSI varía según la posición de la antena.

Errores frecuentes

• Antena celular ausente o mal conectada en el U.FL: el LED parpadea en cian indefinidamente; el conector U.FL es frágil, no lo manipule repetidamente.
• BRN404X con Device OS < 4.0.0: este modelo requiere la versión 4.x LTS, un firmware demasiado antiguo no arrancará correctamente.
• Confundir red lista y nube lista: solo Cellular.ready garantiza ambas; Cellular.connect por sí solo no es suficiente para publicar.
• Límite de tasa de publicación superado: el límite es de 4 eventos/segundo y 60/minuto; por encima, Particle.publish devuelve false.
• Los modelos LTE no están certificados en Europa y los modelos 2G/3G están obsoletos (redes apagadas en EE. UU. en 2022): verifique la cobertura de su operador antes de desplegar.