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

Objectifs

La Boron est la carte cellulaire de la gamme Particle : le modèle BRN404X embarque un modem u-blox SARA-R510S (LTE Cat M1, bandes 2/4/5/12/13, Amérique du Nord uniquement) et un EtherSIM pré-approvisionné. Ce tutoriel vous fait passer de « firmware qui tourne » à « objet connecté » : activer la radio, attendre l'enregistrement réseau et la connexion au cloud, lire la puissance du signal (Cellular.RSSI) et publier des événements avec Particle.publish. Vous vérifierez aussi que l'antenne externe est bien branchée — sans elle, pas de cellulaire.

Matériel

• 1× Particle Boron LTE (BRN404X) avec antenne externe obligatoire sur le connecteur U.FL (antenne flex PARANTC41EA fournie dans les kits)
• carte LiPo ou alimentation USB stable (l'émission cellulaire appelle des pics de courant)
• compte Particle avec un device déjà revendoqué (particle list affiche « online »)

Code complet

// 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 : vérifier antenne et couverture");
    }
}

void loop {
    if (Cellular.ready) {              // réseau 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
}

Vérification attendue

Après le flash, la LED RVB passe par les phases de recherche réseau puis reste « respiration » cyan quand tout est connecté. particle list affiche votre device en « online ». Côté cloud, l'événement privé boron-rssi arrive toutes les 5 minutes : vérifiez-le avec particle subscribe PRIVATE <votre_compte> ou dans le flux d'événements du console Particle. La valeur RSSI varie avec la position de l'antenne.

Erreurs fréquentes

• Antenne cellulaire absente ou mal clipsée sur le U.FL : la LED clignote cyan indéfiniment ; le connecteur U.FL est fragile, ne le manipulez pas à répétition.
• BRN404X sous Device OS < 4.0.0 : ce modèle exige le 4.x LTS, un firmware trop ancien ne démarrera pas correctement.
• Confondre prêt réseau et prêt cloud : seul Cellular.ready garantit les deux ; Cellular.connect seul ne suffit pas pour publier.
• Débit de publication dépassé : la limite est de 4 événements/seconde et 60/minute ; au-delà, Particle.publish renvoie false.
• Les modèles LTE ne sont pas certifiés en Europe et les modèles 2G/3G sont dépréciés (réseaux coupés aux US en 2022) : vérifiez la couverture de votre opérateur avant de déployer.