BuzzBoard - Open Source Package

PCB Design

An open-source reference design is provided for you using similar sensors and specs to our BuzzBox product: https://github.com/opensourcebeehives/BuzzBoard_hardware

Application Firmware

An open-source reference firmware is provided for you: https://github.com/opensourcebeehives/BuzzBoard_firmware

Backend Setup

To have your BuzzBoard connect to OSBeehives servers and show data in the mobile app, you must set up a few items.

Particle Cloud

  • set up your personal account through Particle.io
  • register your BuzzBoard's built-in Photon to your Particle.io account. Once you do this (via WiFi or Particle-CLI) you will see the device listed in the Particle Console

Measurements Webhook

  • From the Particle.io Console, click on 'Integrations', the 'New Integration'.
  • Setup the webhook to connect to OSBeehives Measurements API:

Event: measurements
ID: 59e6907deef5d45d7fc7dd6b
Target: osbeehives.com
Full URL: https://api.osbeehives.com/v2/measurements
Request Type: JSON
Request Format: POST

Under the custom JSON formatting, please input the following template:

{
  "name": "{{PARTICLE_EVENT_NAME}}",
  "data": "{{PARTICLE_EVENT_VALUE}}",
  "coreid": "{{PARTICLE_DEVICE_ID}}",
  "published_at": "{{PARTICLE_PUBLISHED_AT}}",
  "userid": "{{PRODUCT_USER_ID}}",
  "fw_version": "{{PRODUCT_VERSION}}",
  "public": "{{PARTICLE_EVENT_PUBLIC}}",
  "device_id": "{{PARTICLE_DEVICE_ID}}",
  "temp_c_in": "{{T_in}}",
  "rhumidity_in": "{{RH_i}}",
  "battery_charge": "{{soc}}",
  "battery_health": "{{soh}}",
  "solar_charge": "{{chg}}",
  "current": "{{I}}",
  "power": "{{P}}",
  "rssi": "{{RSSI}}",
  "wifi_packet_loss": "{{w_r}}",
  "audio_packet_loss": "{{a_r}}",
  "location_accuracy": "{{acc}}",
  "lon": "{{lon}}",
  "lat": "{{lat}}"
}
{
  "Content-Type": "application/json",
  "Accept": "application/json"
}

For further documentation around webhooks on Particle.io please visit https://docs.particle.io/guide/tools-and-features/webhooks/

Audio Server

You must send audio stream to the correct URL in your custom BuzzBoard firmware code. Bee sure that you update to the latest code repository from GitHub!

Over-the-Air (OTA) Firmware Updates

You can use the Particle.io Console to remotely update and manage your application firmware on your devices.