À propos du projet

ruuvitag-gollector est une solution auto-hébergée écrite en Go qui collecte les mesures environnementales des capteurs RuuviTag via les diffusions Bluetooth Low Energy (BLE) et les transmet à une large gamme de systèmes de destination. Elle cible les systèmes Linux et utilise l'API D-Bus de BlueZ pour scanner et lire les données des capteurs. Le projet prend en charge le format RAWv2 émis par les RuuviTags fonctionnant avec le firmware 2.x ou ultérieur. Le collecteur peut envoyer les mesures à plusieurs exportateurs simultanément, notamment InfluxDB (local ou distant), PostgreSQL et TimescaleDB, AWS DynamoDB, AWS SQS, GCP Pub/Sub, MQTT et des webhooks HTTP génériques acceptant les requêtes POST JSON. Chaque exportateur est configuré indépendamment dans un fichier de configuration TOML, permettant aux utilisateurs d'envoyer les mêmes données de capteur à plusieurs destinations à la fois. La configuration est simple : les utilisateurs spécifient les adresses MAC et les noms lisibles de leurs RuuviTags, puis définissent un ou plusieurs exportateurs avec leurs détails de connexion. Des noms de colonnes personnalisés peuvent être définis pour correspondre aux schémas de base de données existants, et les colonnes inutiles peuvent être exclues. Les colonnes par défaut incluent l'heure, l'adresse MAC, le nom, la température, l'humidité, la pression, l'accélération (x/y/z), le compteur de mouvement, le numéro de mesure, le point de rosée, la tension de la batterie et la puissance TX. L'application fonctionne en deux modes : un mode de scan unique pour les tests et un mode démon pour la collecte continue. Elle nécessite que BlueZ soit installé et exécuté sur le système, et nécessite généralement des privilèges élevés pour accéder à l'adaptateur Bluetooth. Le projet est conçu pour fonctionner sur du matériel peu coûteux tel qu'un Raspberry Pi, ce qui le rend accessible pour des projets de surveillance environnementale à petite échelle ou de loisir, comme les serres, les terrariums ou la collecte de données atmosphériques. Aucun abonnement ni service cloud n'est requis pour le collecteur lui-même, bien que les utilisateurs doivent auto-héberger ou héberger dans le cloud les bases de données cibles et les outils de visualisation tels que Grafana.