Configuration d’exécution

La configuration d’exécution contient les réglages propres à une balance : réseau, URL d’ingestion, jeton de balance, calibration et intervalle de mesure.

Elle se fait après l’installation du firmware. Cela évite de mettre des secrets dans le firmware et permet d’utiliser le même fichier de firmware pour plusieurs balances.

Activer le mode configuration

Le mode configuration s’active automatiquement quand la balance n’a pas encore de configuration valide, quand une configuration enregistrée est invalide ou quand le firmware installé est prévu uniquement pour configurer la carte.

Pour l’activer manuellement, réveillez ou redémarrez la balance en appuyant sur le bouton de configuration. Sur les cartes actuelles, ce bouton est généralement BOOT. La LED doit indiquer que la balance attend la configuration, généralement en bleu.

Une fois ce mode actif, choisissez la méthode la plus pratique pour votre situation.

Modes de configuration

Mode	Quand l’utiliser	Accès
Configurateur	Avec un ordinateur et un câble USB, sans installer d’outil.	/firmware/configurator
Portail WiFi	Sans fil, depuis un ordinateur, un téléphone ou une tablette. C’est le plus pratique sur le terrain quand la balance ne peut pas être branchée à un ordinateur.	http://192.168.4.1/
CLI bee-config	Pour automatiser la configuration ou préparer plusieurs cartes.	Terminal local

Configurateur

Le configurateur s’ouvre dans le navigateur. Il permet de configurer une balance branchée en USB, sans installer de logiciel sur l’ordinateur.

Ouvrir le configurateur

Pour l’utiliser :

1. Branchez la balance en USB.
2. Entrez en mode configuration avec le bouton de configuration. La LED doit s’allumer en bleu.
3. Ouvrez le configurateur.
4. Cliquez sur Connecter, choisissez le port de la balance, puis renseignez les champs.
5. Cliquez sur Enregistrer.
6. Cliquez sur Déconnecter et lancer un cycle pour quitter le mode configuration.

Les champs secrets sont masqués. Si un secret est déjà enregistré, laissez le champ vide pour le conserver.

Le bouton URL recommandée remplit l’adresse d’ingestion adaptée au transport du firmware connecté. Pour une balance 4G, il utilise HTTP. Pour une balance WiFi, il utilise HTTPS.

Les champs APN, utilisateur et mot de passe 4G sont dans les options avancées : dans la plupart des cas, vous pouvez les laisser vides.

L’intervalle de mesure est saisi en secondes. Bee Thing recommande au moins 15 minutes entre deux mesures, soit 900 secondes.

Portail WiFi

Le portail WiFi permet de configurer la balance sans câble USB. La balance crée temporairement un réseau WiFi local nommé BeeThing-Config.

1. Branchez ou réveillez la balance.
2. Entrez en mode configuration avec le bouton de configuration.
3. Attendez que la LED indique le portail WiFi, généralement en bleu-vert / cyan avec une animation.
4. Connectez votre téléphone, tablette ou ordinateur au réseau BeeThing-Config.
5. Utilisez le mot de passe beething-config.
6. Ouvrez http://192.168.4.1/ dans un navigateur.

Certains téléphones indiquent que ce réseau n’a pas d’accès Internet. C’est normal : le réseau sert seulement à configurer la balance.

CLI bee-config

La CLI configure la balance par USB depuis un terminal. Elle est pratique pour les ateliers, les tests et l’automatisation.

Exemple WiFi :

bee-config set wifi.ssid "Rucher WiFi"
bee-config set wifi.password "secret"
bee-config set ingress.url "https://example.test/metrics"
bee-config set scale.token "bt_scale_token"
bee-config set hx711.scale_factor "1234.5"
bee-config set hx711.tare_offset "42"
bee-config validate
bee-config save
bee-config run

Exemple 4G :

bee-config set cellular.apn ""
bee-config set cellular.username ""
bee-config set cellular.password ""
bee-config set cellular.sim_pin ""
bee-config set ingress.url "http://bee-thing.uiguig.ovh/metrics"
bee-config set scale.token "bt_scale_token"
bee-config validate
bee-config save
bee-config run

Dans la plupart des cas, vous pouvez laisser l’APN vide. Si la connexion 4G échoue, renseignez l’APN fourni par l’opérateur.

Le transport cellulaire actuel supporte uniquement HTTP. Une URL HTTPS ne fonctionnera pas avec ce transport.

Voir l’état de la balance

Quand la balance est en mode configuration :

bee-config show

La réponse indique notamment pourquoi la balance est entrée en mode configuration :

config.mode.reason=config button wakeup

Si la commande time out, la balance n’est probablement pas en mode configuration. Elle a pu faire son cycle normal puis retourner dormir.