Skip to content

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 

History

2 Commits
Β 
Β 

Repository files navigation

ApisNode β€” Smart Beehive Monitoring System

ApisNode Website Open Apiary Project Wall Display Fleet Dashboard ESP-IDF Flutter AWS

ApisNode is a production-deployed smart beehive monitor β€” 30 real-time metrics per hive (environmental, acoustic, vibration, and gas/VOC fingerprint), AI-powered daily colony health reports, and over-the-air firmware updates for precision apiculture.

🌐 Live at apisnode.com β€” includes a live telemetry dashboard pulling data from production hives and an AI beekeeping assistant powered by Amazon Bedrock.

🐝 Open Apiary Project β€” our proposed 501(c)(3) non-profit initiative deploying free ApisNode beehive monitors to beekeepers nationwide to combat Colony Collapse Disorder.


What It Does

ApisNode continuously monitors beehive health using a custom ESP32-C6 sensor node installed inside the hive. Every wake cycle it captures 30 real-time metrics β€” temperature, humidity, barometric pressure, hive tilt, a 10-band acoustic spectrum, a 6-band vibration spectrum, and a 10-step gas (VOC) fingerprint β€” transmits them via encrypted LoRa radio to an always-on gateway, and relays them to the cloud for AI-powered daily colony health analysis.

No WiFi needed at the hive. No manual data collection. No interrupting the bees.


System Architecture

β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”
β”‚                     APIARY (Edge Hardware)                       β”‚
β”‚                                                                  β”‚
β”‚  β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”   LoRa 916 MHz    β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β” β”‚
β”‚  β”‚   ApisNode      β”‚  AES-128-GCM ──►  β”‚     ApisMind         β”‚ β”‚
β”‚  β”‚  (In-Hive)      β”‚  70B / 60s        β”‚   (Gateway)          β”‚ β”‚
β”‚  β”‚  ESP32-C6       β”‚ ◄── CONFIG ──────  β”‚   ESP32-C6           β”‚ β”‚
β”‚  β”‚  Battery-Poweredβ”‚                   β”‚   Wall-Powered       β”‚ β”‚
β”‚  β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜                   β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”¬β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜ β”‚
β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”Όβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜
                                                     β”‚ WiFi / MQTT / TLS
                                          β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β–Όβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”
                                          β”‚      AWS Cloud        β”‚
                                          β”‚  IoT Core β†’ DynamoDB  β”‚
                                          β”‚  Lambda β†’ Bedrock     β”‚
                                          β”‚  (Claude 4.5 Haiku)   β”‚
                                          β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”¬β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜
                        β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”Όβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”
                        β”‚                            β”‚                            β”‚
               β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β–Όβ”€β”€β”€β”€β”€β”€β”€β”€β”        β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β–Όβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”     β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β–Όβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”
               β”‚  Mobile App     β”‚        β”‚   Wall Display       β”‚     β”‚  Fleet Dashboard     β”‚
               β”‚  Flutter        β”‚        β”‚ display.apisnode.com β”‚     β”‚ fleet.apisnode.com   β”‚
               β”‚  iOS / Android  β”‚        β”‚   Live Spectrograms  β”‚     β”‚   OTA Management     β”‚
               β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜        β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜     β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜

Hardware

Two complementary ESP32-C6 devices work together at each apiary:

ApisNode β€” In-Hive Sensor Node

Battery-powered, installed between frames. Spends nearly all time in deep sleep, waking every 60 seconds for a Sense β†’ DSP β†’ Transmit β†’ Sleep cycle.

Sensor Measurements
Bosch BME688 Temperature, humidity, barometric pressure, 10-step gas (VOC) heater-scan fingerprint
ADXL362 Accelerometer 6-band vibration spectral analysis (10–1000 Hz), hive tilt
Knowles PDM Microphone 10-band audio spectral analysis (100–3600 Hz), colony sound level

ApisMind β€” Outdoor Gateway

Wall-powered, installed outside the apiary. Runs a continuous LoRa receiver β€” no polling or timing synchronization needed. Bridges the apiary radio network to AWS IoT Core over WiFi/MQTT/TLS and provides an outdoor environmental baseline for AI weather correlation.

Also handles BLE provisioning (WiFi credentials, IoT certificates, LoRa config) and store-and-forward resilience via SD card queue when connectivity drops.


Sensing & DSP

Every wake cycle, ApisNode runs on-chip FFT-based feature extraction with 5Γ— burst averaging for stability:

πŸ”Š Audio Analysis β€” 10 Spectral Bands (100–3600 Hz)

Band Range What It Detects
0 100–150 Hz Baseline colony hum, pre-swarm energy build
1 150–200 Hz Worker piping, pre-swarm frequency shift
2 200–260 Hz Swarming indicator, waggle dance overlap
3 260–350 Hz Colony fundamental tone, queen quacking
4 350–420 Hz Queen quacking β†’ tooting transition
5 420–500 Hz Queen tooting (piping), active swarming
6 500–600 Hz Full-spectrum swarming excitation
7 600–800 Hz Harmonics, broadband distress
8 800–1500 Hz Hissing, defensive behavior
9 1500–3600 Hz Broadband hissing (upper range)

πŸ“³ Vibration Analysis β€” 6 Spectral Bands (10–1000 Hz)

Band Range What It Detects
0 10–50 Hz External disturbance, mechanical impact
1 50–100 Hz Colony metabolic baseline
2 100–200 Hz Transitional activity, lower harmonics
3 200–300 Hz Waggle dance (primary foraging diagnostic)
4 300–500 Hz Queen presence indicator
5 500–1000 Hz Broadband stress, disease markers

Per-Band AGC: Each frequency band independently tracks its own baseline via exponential moving average, ensuring every band maintains consistent visibility regardless of absolute energy level.

🌬️ Gas (VOC) Analysis β€” 10-Step Heater Scan (100–400 Β°C)

The BME688's gas sensor is stepped through 10 heater setpoints (100, 150, 200, 250, 280, 300, 320, 350, 375, 400 Β°C) in forced mode each cycle, building a volatile-organic-compound fingerprint far richer than a single gas reading. Temperature and humidity are sampled first with the heater off, so the ambient readings stay clean.

Shifts in this 10-point profile β€” tracked against the colony's own baseline β€” flag changes in hive air chemistry: nectar curing, propolis and brood volatiles, or contamination worth a closer look at the next inspection. Each step is logβ‚‚-encoded against a shared reference for compact LoRa transmission.


AI Colony Health Analysis

A daily Lambda (EventBridge-triggered) fuses multiple data sources and calls Amazon Bedrock (Claude 4.5 Haiku) to generate per-hive health reports:

β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”
β”‚                    LLM Prompt Context                     β”‚
β”œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”¬β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€-─
β”‚ Bee Science KB    β”‚ Curated peer-reviewed research by     β”‚
β”‚                   β”‚ sensor modality (acoustics, vibration,β”‚
β”‚                   β”‚ air quality, temperature, seasonal)   β”‚
β”œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”Όβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€
β”‚ 24h Telemetry     β”‚ In-hive sensors + outdoor ApisMind   β”‚
β”‚                   β”‚ weather baseline (hyper-local)        β”‚
β”œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”Όβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€
β”‚ Inspection Notes  β”‚ 7-day voice-transcribed field         β”‚
β”‚                   β”‚ observations + AI-extracted labels    β”‚
β”œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”Όβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€
β”‚ Prior Analysis    β”‚ Previous health scores, detected      β”‚
β”‚                   β”‚ issues, and recommended actions       β”‚
β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”΄β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜

Output per hive: health score (0–100), status (healthy/warning/critical), detected issues, and actionable recommendations β€” surfaced in the mobile app.


Wireless Communication

LoRa P2P β€” ApisNode ↔ ApisMind

All in-apiary communication uses LoRa sub-GHz radio with hardware encryption:

Parameter Value
Frequency 916 MHz (US915 quiet channel)
Spreading Factor SF10
Bandwidth 125 kHz
TX Power 14 dBm
Encryption AES-128-GCM (4-byte tag, fixed IV)
Packet Size 70 bytes per reading
TX Interval 60 seconds (configurable)

Zero-Touch Pairing

New ApisNodes auto-pair with ApisMind on first boot. The gateway enforces a βˆ’20 dBm RSSI threshold β€” the node must be within ~1–2 feet of the gateway to exchange keys. No manual configuration required.

Delta OTA Firmware Updates

Both devices support remote over-the-air firmware updates using binary delta patches:

Path Typical Patch Size Transfer Time
ApisMind (WiFi) 20–90 KB ~12 seconds
ApisNode (LoRa relay) 8–30 KB ~90 seconds

Cloud Infrastructure (AWS Serverless)

Deployed via AWS CDK:

  • IoT Core β€” MQTT broker receiving encrypted telemetry from ApisMind gateways
  • DynamoDB β€” Telemetry store with TTL lifecycle and adaptive time-bucketed downsampling
  • Lambda β€” REST API (API Gateway), daily AI analysis, inspection labeling, fleet management
  • Amazon Bedrock β€” Claude 4.5 Haiku for daily colony health reports and interactive chat
  • Cognito β€” JWT authentication with server-side device ownership enforcement
  • S3 β€” Firmware binaries, OTA delta patches, inspection audio/transcripts
  • Amplify β€” Web dashboard hosting with automatic deploys

Applications

πŸ“± Mobile App (Flutter β€” iOS & Android)

BLE device provisioning, animated 30-metric dashboard, real-time spectrograms, AI health reports with interactive chat, voice-to-label hive inspections, remote device management (reboot, recalibration, OTA triggers).

πŸ–₯️ Wall Display β€” display.apisnode.com

Always-on kiosk dashboard for wall-mounted screens. Live mini-graphs, 2D spectrograms with date/time axes, battery history, 1H–30D time range selector. Timestamp-based X positioning makes offline gaps visually apparent.

πŸ“Š Fleet Dashboard β€” fleet.apisnode.com

Admin fleet monitoring β€” firmware version tracking, OTA deployment management, device health overview.

🌐 ApisNode Website β€” apisnode.com

Public product website featuring a live telemetry dashboard from production hives, a live AI beekeeping chat grounded in real sensor data, and daily published AI colony health reports from monitored apiaries across New Mexico, Florida, and Montana.


Open Apiary Project β€” openapiaryproject.org

The Open Apiary Project is our proposed 501(c)(3) non-profit initiative dedicated to combating Colony Collapse Disorder.

The mission: Deploy free ApisNode beehive monitor kits to beekeepers nationwide β€” building the world's most comprehensive anonymized apiary health database to support CCD research, pollination forecasting, and regional disease outbreak detection.

US beekeepers lose an average of 40–50% of managed colonies per year. The pollinators responsible for one-third of the US food supply face an existential threat. Continuous, non-invasive monitoring is a critical tool for early detection and intervention.

Learn more and get involved β†’ openapiaryproject.org


Tech Stack

Layer Technology
Firmware ESP-IDF v5.5.1, C/C++, FreeRTOS
Radio Seeed Wio-E5 (STM32WLE5), LoRa AT commands
Sensors Bosch BME688 (SPI), ADXL362 (SPI), Knowles PDM (I2S)
DSP On-chip FFT, per-band AGC via EMA, 10-step BME688 gas heater scan
Mobile Flutter 3.x (Dart), iOS & Android
Cloud AWS CDK v2, Lambda, DynamoDB, IoT Core, Bedrock, Cognito, S3, Amplify
AI Amazon Bedrock β€” Claude 4.5 Haiku
OTA detools delta patches, heatshrink compression, SHA256, ESP-IDF rollback
Web Vanilla HTML/CSS/JS, AWS Amplify

License

Proprietary β€” Β© Acid Canyon LLC. All rights reserved.

The source code for this project is closed-source. This repository serves as a public technical overview.

For inquiries: apisnode.com Β· openapiaryproject.org

About

Smart beehive monitor - 30 real-time hive metrics: acoustics, vibration, gas (VOC) fingerprint, temperature & tilt. Off-grid LoRa mesh, AWS serverless cloud, Flutter app, daily AI colony health reports. Live at apisnode.com

Topics

Resources

Stars

3 stars

Watchers

1 watching

Forks

Releases

Packages

Contributors