{"_id":"5ac27f95cc79a40038748908","project":"5511fc8c0c1a08190077f90c","version":"5511fc8d0c1a08190077f90f","category":"568ecb1cbdb9260d00149d42","user":"59440f773ab6710037ab2196","updates":[],"next":{"pages":[],"description":""},"createdAt":"2018-04-02T19:08:05.153Z","link_external":false,"link_url":"","githubsync":"","sync_unique":"","hidden":false,"api":{"results":{"codes":[]},"settings":"","auth":"required","params":[],"url":""},"isReference":false,"order":3,"body":"[block:callout]\n{\n  \"type\": \"warning\",\n  \"title\": \"All New BuzzBox Users: Read This Before Getting Started!\",\n  \"body\": \"To make things as easy as possible for you, make SURE you do these two things before bringing your BuzzBox to your hive:\\n\\n1. Turn the On/Off switch to the OFF position, place the solar panel in some sunlight (don't expose the circuits to weather though!), and make sure the RED LED charge indicator light is ON. Let the unit charge for 24 hours before doing anything else.\\n2. Bring your BuzzBox near your WiFi access point and register the unit with the app FULLY before taking the unit to your hive. \\n\\nDoing these two things will help you avoid many common issues. Thank you for joining the BuzzBox network!\"\n}\n[/block]\n\n[block:image]\n{\n  \"images\": [\n    {\n      \"image\": [\n        \"https://files.readme.io/655ad65-BuzzBox_-_v1.04_-_Docs_-_How_it_Works-01.jpg\",\n        \"BuzzBox - v1.04 - Docs - How it Works-01.jpg\",\n        6667,\n        3750,\n        \"#736c5f\"\n      ]\n    }\n  ]\n}\n[/block]\n\n[block:api-header]\n{\n  \"type\": \"basic\",\n  \"title\": \"Overview\"\n}\n[/block]\nThe BuzzBox is an internet connected device designed to monitor the conditions and health of your bee hive. It incorporates a range of sensors, microcontrollers, radio communication, AI neural-networks, server technologies and mobile device applications to achieve this.\n\n\n[block:api-header]\n{\n  \"title\": \"Sensor Readings\"\n}\n[/block]\n\n[block:parameters]\n{\n  \"data\": {\n    \"0-0\": \"Audio Recordings\",\n    \"0-1\": \"20 - 3150 Hz\",\n    \"1-0\": \"Hive Temperature\\n(Temperature Accuracy 0.2 ºC)\",\n    \"1-1\": \"0 - 65 ºC\",\n    \"2-0\": \"Hive Humidity\\t\\n(Humidity Accuracy 2%)\",\n    \"3-0\": \"External Temperature\",\n    \"4-0\": \"External Humidity\",\n    \"2-1\": \"0 - 100%\",\n    \"3-1\": \"Local weather station dependent\",\n    \"4-1\": \"Local weather station dependent\",\n    \"6-0\": \"Wind Speed\",\n    \"5-0\": \"Atmospheric Pressure\",\n    \"5-1\": \"Local weather station dependent\",\n    \"6-1\": \"Local weather station dependent\",\n    \"7-0\": \"Wind Direction\",\n    \"7-1\": \"Local weather station dependent\",\n    \"8-0\": \"Weather Forecast\",\n    \"8-1\": \"0 - 5 Day\",\n    \"9-0\": \"Geolocation\",\n    \"9-1\": \"Global\",\n    \"h-0\": \"Measurements\",\n    \"h-1\": \"Range\"\n  },\n  \"cols\": 2,\n  \"rows\": 10\n}\n[/block]\n\n[block:parameters]\n{\n  \"data\": {\n    \"0-0\": \"Geolocation\",\n    \"h-0\": \"Data Availability\",\n    \"0-1\": \"Global\",\n    \"1-0\": \"Audio Playback\",\n    \"2-0\": \"Raw Data Redirects\",\n    \"3-0\": \"Raw Data Download\",\n    \"3-1\": \"Yes\",\n    \"2-1\": \"Yes\",\n    \"1-1\": \"Yes\"\n  },\n  \"cols\": 2,\n  \"rows\": 4\n}\n[/block]\nOnce properly setup and installed, you can view your hives conditions at any time using the OSBeehives mobile app.  The BuzzBox reports every 20 - 60 minutes to the CloudAI using your home's WiFi Access Point .  The Cloud AI then pushes this data to your mobile app.\n[block:image]\n{\n  \"images\": [\n    {\n      \"image\": [\n        \"https://files.readme.io/41a08f6-BuzzBox_-_v1.04_-_Docs_-_How_it_Works-01-min-2.png\",\n        \"BuzzBox - v1.04 - Docs - How it Works-01-min-2.png\",\n        6667,\n        3750,\n        \"#fbc12f\"\n      ],\n      \"caption\": \"\"\n    }\n  ]\n}\n[/block]\nThe BuzzBox is mounted on the side of a beehive and has a through-wall port that 'listens' to the insides of the hive.  \n[block:image]\n{\n  \"images\": [\n    {\n      \"image\": [\n        \"https://files.readme.io/853d26d-ea59fe5-13.jpg\",\n        \"ea59fe5-13.jpg\",\n        1600,\n        900,\n        \"#edcaa1\"\n      ],\n      \"caption\": \"\"\n    }\n  ]\n}\n[/block]\nA weather-proof enclosure protects the sensitive electronics from wind, rain and... bees.\n[block:image]\n{\n  \"images\": [\n    {\n      \"image\": [\n        \"https://files.readme.io/2b6d497-BuzzBox---v1.04---Docs---How-it-Works.jpg\",\n        \"BuzzBox---v1.04---Docs---How-it-Works.jpg\",\n        1600,\n        900,\n        \"#343631\"\n      ]\n    }\n  ]\n}\n[/block]\n\n[block:api-header]\n{\n  \"title\": \"Setup Mode\"\n}\n[/block]\nThe BuzzBox arrives to you in Setup Mode, indicated by a blinking BLUE LED on the PCB.  You can use the OSBeehives mobile app to set up the BuzzBox to connect to your home's WiFi network and monitor your BuzzBox through the app.  (See 'BuzzBox Setup Guide')\n[block:html]\n{\n  \"html\": \"<div>\\n<video autoplay loop src=\\\"https://s3-us-west-2.amazonaws.com/osbhdocs/Videos/Temp-01.mp4\\\" autoplay poster=\\\"posterimage.jpg\\\">\\nSorry, your browser doesn't support embedded videos, \\nbut don't worry, you can <a href=\\\"https://s3-us-west-2.amazonaws.com/osbhdocs/Videos/Temp-01.mp4\\\" autoplay poster=\\\"posterimage.jpg\\\">download it</a>\\nand watch it with your favorite video player!\\n</video>\\n</div>\\n\\n<style>\\nvideo {\\n  max-width: 100%;\\n}\\n</style>\"\n}\n[/block]\nIf you need to change the WiFi network, you can always put the BuzzBox back in Setup Mode by holding the SETUP button on the PCB for ~10 seconds (with the device turned on).  If your LED is not lighting up, press RESET first.\n[block:image]\n{\n  \"images\": [\n    {\n      \"image\": [\n        \"https://files.readme.io/22130c2-Screen_Shot_2018-04-12_at_11.00.09_AM.png\",\n        \"Screen Shot 2018-04-12 at 11.00.09 AM.png\",\n        1168,\n        651,\n        \"#393939\"\n      ]\n    }\n  ]\n}\n[/block]\n\n[block:html]\n{\n  \"html\": \"<div>\\n<video autoplay loop src=\\\"https://s3-us-west-2.amazonaws.com/osbhdocs/Videos/Reset.mp4\\\">\\nSorry, your browser doesn't support embedded videos, \\nbut don't worry, you can <a href=\\\"https://s3-us-west-2.amazonaws.com/osbhdocs/Videos/Reset.mp4\\\">download it</a>\\nand watch it with your favorite video player!\\n</video>\\n</div>\\n\\n<style>\\nvideo {\\n  max-width: 100%;\\n}\\n</style>\"\n}\n[/block]\n\n[block:api-header]\n{\n  \"title\": \"Normal Operation\"\n}\n[/block]\nOnce set up, the BuzzBox enters it's normal cycle of operation.  The BuzzBox periodically wakes up to report data to the server.  The server then processes this data and pushes reports to the OSBeehives mobile app.  The frequency of reading is based around the charge level of the lithium ion battery.  This ranges from every 20 minutes - 60 minutes (full battery - low battery).\n\nWhen the BuzzBox wakes up, it checks the battery level, then connects to the WiFi network (breathing cyan on LED).  Once connected, sensor measurements are sent to the servers, then the audio stream is started (D7 LED turns BLUE).  The audio stream lasts for 10 seconds, then closes the connection.  Once the audio has been successfully transmitted, the device goes back to sleep.\n[block:callout]\n{\n  \"type\": \"success\",\n  \"title\": \"The Music Test\",\n  \"body\": \"Once you've set up your BuzzBox, you can always test the readings by *bumping* the Box.  This wakes it up and records new data/sound, if you play some music while doing this, you should be able to hear this recording through the OSBeehives App!\"\n}\n[/block]\n\n[block:html]\n{\n  \"html\": \"<div>\\n<video autoplay loop src=\\\"https://s3-us-west-2.amazonaws.com/osbhdocs/Videos/Reading.mp4\\\">\\nSorry, your browser doesn't support embedded videos, \\nbut don't worry, you can <a href=\\\"https://s3-us-west-2.amazonaws.com/osbhdocs/Videos/Reading.mp4\\\">download it</a>\\nand watch it with your favorite video player!\\n</video>\\n</div>\\n\\n<style>\\nvideo {\\n  max-width: 100%;\\n}\\n</style>\"\n}\n[/block]\n\n[block:callout]\n{\n  \"type\": \"info\",\n  \"title\": \"LED Codes\",\n  \"body\": \"The BuzzBox incorporates a Particle.io WiFi SoC called the Photon.  The LED codes can be found in their documentation:  \\n\\nhttps://docs.particle.io/guide/getting-started/modes/photon/\\nhttps://docs.particle.io/support/troubleshooting/troubleshooting-support/photon/\"\n}\n[/block]\nThe OSBeehives mobile app displays the most recent measurements of your BuzzBox (timestamped) along with some historical trends.  There is a space for giving feedback on the audio classification (beehive state).\n[block:image]\n{\n  \"images\": [\n    {\n      \"image\": [\n        \"https://files.readme.io/929ee0a-Screen_Shot_2018-04-12_at_7.39.43_AM.png\",\n        \"Screen Shot 2018-04-12 at 7.39.43 AM.png\",\n        1215,\n        659,\n        \"#f7f5f2\"\n      ],\n      \"caption\": \"Screenshot of app screens\"\n    }\n  ]\n}\n[/block]\n\n[block:callout]\n{\n  \"type\": \"success\",\n  \"title\": \"User Feedback\",\n  \"body\": \"Your feedback on the audio classification lets you play an important part in directly improving the technology for everyone.  It immediately helps the AI system learn how to correctly classify the state of your beehive!\"\n}\n[/block]\nThe solar panel charges the lithium-ion battery, which powers the BuzzBox.  The battery is designed to last 2.5 days (from full charge) without any external charge.  The solar panel should be oriented towards the path of the sun (pointing south if in the northern hemisphere / pointing north if in the southern hemisphere).  The panel is powerful enough to fully charge the battery in one day, even at high latitudes and lower light conditions.\n[block:image]\n{\n  \"images\": [\n    {\n      \"image\": [\n        \"https://files.readme.io/f78e999-DSC_3448.jpg\",\n        \"DSC_3448.jpg\",\n        1600,\n        900,\n        \"#c0b4ae\"\n      ],\n      \"caption\": \"\"\n    }\n  ]\n}\n[/block]\n\n[block:api-header]\n{\n  \"title\": \"Your WiFi Access Point\"\n}\n[/block]\nThe WiFi signal strength is an important factor in successfully monitoring and reporting your hive's data.  WiFi is generally designed to work within a 100m/300ft unobstructed range.  Walls and other structures will change the effective range of your WiFi network.  Your particular router and router settings (transmit level) will also affect the range of the BuzzBox.  The OSBeehives app provides a measurement of the signal strength your BuzzBox is seeing from your WiFi router.  A weak signal could result in missed measurements and lost data.  If your signal is weak, please consider moving the BuzzBox closer to your WiFi router, or adding a 'WiFi signal booster' to your home.\n\n[block:image]\n{\n  \"images\": [\n    {\n      \"image\": [\n        \"https://files.readme.io/06f41d0-extender-house-diagram-enlarged.png\",\n        \"extender-house-diagram-enlarged.png\",\n        835,\n        587,\n        \"#a3905d\"\n      ],\n      \"caption\": \"\"\n    }\n  ]\n}\n[/block]\n\n[block:parameters]\n{\n  \"data\": {\n    \"h-0\": \"WiFi Signal Strength\",\n    \"h-1\": \"dBm\",\n    \"0-0\": \"Strong\",\n    \"0-1\": \"-20 to -45\",\n    \"1-0\": \"Medium\",\n    \"1-1\": \"-45 to -65\",\n    \"2-0\": \"Weak\",\n    \"2-1\": \"-65 to -80\"\n  },\n  \"cols\": 2,\n  \"rows\": 3\n}\n[/block]","excerpt":"Learn How the BuzzBox Beehive Health Monitoring Platform Works.","slug":"how-it-works","type":"basic","title":"How It Works","__v":0,"parentDoc":null,"childrenPages":[]}

How It Works

Learn How the BuzzBox Beehive Health Monitoring Platform Works.

[block:callout] { "type": "warning", "title": "All New BuzzBox Users: Read This Before Getting Started!", "body": "To make things as easy as possible for you, make SURE you do these two things before bringing your BuzzBox to your hive:\n\n1. Turn the On/Off switch to the OFF position, place the solar panel in some sunlight (don't expose the circuits to weather though!), and make sure the RED LED charge indicator light is ON. Let the unit charge for 24 hours before doing anything else.\n2. Bring your BuzzBox near your WiFi access point and register the unit with the app FULLY before taking the unit to your hive. \n\nDoing these two things will help you avoid many common issues. Thank you for joining the BuzzBox network!" } [/block] [block:image] { "images": [ { "image": [ "https://files.readme.io/655ad65-BuzzBox_-_v1.04_-_Docs_-_How_it_Works-01.jpg", "BuzzBox - v1.04 - Docs - How it Works-01.jpg", 6667, 3750, "#736c5f" ] } ] } [/block] [block:api-header] { "type": "basic", "title": "Overview" } [/block] The BuzzBox is an internet connected device designed to monitor the conditions and health of your bee hive. It incorporates a range of sensors, microcontrollers, radio communication, AI neural-networks, server technologies and mobile device applications to achieve this. [block:api-header] { "title": "Sensor Readings" } [/block] [block:parameters] { "data": { "0-0": "Audio Recordings", "0-1": "20 - 3150 Hz", "1-0": "Hive Temperature\n(Temperature Accuracy 0.2 ºC)", "1-1": "0 - 65 ºC", "2-0": "Hive Humidity\t\n(Humidity Accuracy 2%)", "3-0": "External Temperature", "4-0": "External Humidity", "2-1": "0 - 100%", "3-1": "Local weather station dependent", "4-1": "Local weather station dependent", "6-0": "Wind Speed", "5-0": "Atmospheric Pressure", "5-1": "Local weather station dependent", "6-1": "Local weather station dependent", "7-0": "Wind Direction", "7-1": "Local weather station dependent", "8-0": "Weather Forecast", "8-1": "0 - 5 Day", "9-0": "Geolocation", "9-1": "Global", "h-0": "Measurements", "h-1": "Range" }, "cols": 2, "rows": 10 } [/block] [block:parameters] { "data": { "0-0": "Geolocation", "h-0": "Data Availability", "0-1": "Global", "1-0": "Audio Playback", "2-0": "Raw Data Redirects", "3-0": "Raw Data Download", "3-1": "Yes", "2-1": "Yes", "1-1": "Yes" }, "cols": 2, "rows": 4 } [/block] Once properly setup and installed, you can view your hives conditions at any time using the OSBeehives mobile app. The BuzzBox reports every 20 - 60 minutes to the CloudAI using your home's WiFi Access Point . The Cloud AI then pushes this data to your mobile app. [block:image] { "images": [ { "image": [ "https://files.readme.io/41a08f6-BuzzBox_-_v1.04_-_Docs_-_How_it_Works-01-min-2.png", "BuzzBox - v1.04 - Docs - How it Works-01-min-2.png", 6667, 3750, "#fbc12f" ], "caption": "" } ] } [/block] The BuzzBox is mounted on the side of a beehive and has a through-wall port that 'listens' to the insides of the hive. [block:image] { "images": [ { "image": [ "https://files.readme.io/853d26d-ea59fe5-13.jpg", "ea59fe5-13.jpg", 1600, 900, "#edcaa1" ], "caption": "" } ] } [/block] A weather-proof enclosure protects the sensitive electronics from wind, rain and... bees. [block:image] { "images": [ { "image": [ "https://files.readme.io/2b6d497-BuzzBox---v1.04---Docs---How-it-Works.jpg", "BuzzBox---v1.04---Docs---How-it-Works.jpg", 1600, 900, "#343631" ] } ] } [/block] [block:api-header] { "title": "Setup Mode" } [/block] The BuzzBox arrives to you in Setup Mode, indicated by a blinking BLUE LED on the PCB. You can use the OSBeehives mobile app to set up the BuzzBox to connect to your home's WiFi network and monitor your BuzzBox through the app. (See 'BuzzBox Setup Guide') [block:html] { "html": "<div>\n<video autoplay loop src=\"https://s3-us-west-2.amazonaws.com/osbhdocs/Videos/Temp-01.mp4\" autoplay poster=\"posterimage.jpg\">\nSorry, your browser doesn't support embedded videos, \nbut don't worry, you can <a href=\"https://s3-us-west-2.amazonaws.com/osbhdocs/Videos/Temp-01.mp4\" autoplay poster=\"posterimage.jpg\">download it</a>\nand watch it with your favorite video player!\n</video>\n</div>\n\n<style>\nvideo {\n max-width: 100%;\n}\n</style>" } [/block] If you need to change the WiFi network, you can always put the BuzzBox back in Setup Mode by holding the SETUP button on the PCB for ~10 seconds (with the device turned on). If your LED is not lighting up, press RESET first. [block:image] { "images": [ { "image": [ "https://files.readme.io/22130c2-Screen_Shot_2018-04-12_at_11.00.09_AM.png", "Screen Shot 2018-04-12 at 11.00.09 AM.png", 1168, 651, "#393939" ] } ] } [/block] [block:html] { "html": "<div>\n<video autoplay loop src=\"https://s3-us-west-2.amazonaws.com/osbhdocs/Videos/Reset.mp4\">\nSorry, your browser doesn't support embedded videos, \nbut don't worry, you can <a href=\"https://s3-us-west-2.amazonaws.com/osbhdocs/Videos/Reset.mp4\">download it</a>\nand watch it with your favorite video player!\n</video>\n</div>\n\n<style>\nvideo {\n max-width: 100%;\n}\n</style>" } [/block] [block:api-header] { "title": "Normal Operation" } [/block] Once set up, the BuzzBox enters it's normal cycle of operation. The BuzzBox periodically wakes up to report data to the server. The server then processes this data and pushes reports to the OSBeehives mobile app. The frequency of reading is based around the charge level of the lithium ion battery. This ranges from every 20 minutes - 60 minutes (full battery - low battery). When the BuzzBox wakes up, it checks the battery level, then connects to the WiFi network (breathing cyan on LED). Once connected, sensor measurements are sent to the servers, then the audio stream is started (D7 LED turns BLUE). The audio stream lasts for 10 seconds, then closes the connection. Once the audio has been successfully transmitted, the device goes back to sleep. [block:callout] { "type": "success", "title": "The Music Test", "body": "Once you've set up your BuzzBox, you can always test the readings by *bumping* the Box. This wakes it up and records new data/sound, if you play some music while doing this, you should be able to hear this recording through the OSBeehives App!" } [/block] [block:html] { "html": "<div>\n<video autoplay loop src=\"https://s3-us-west-2.amazonaws.com/osbhdocs/Videos/Reading.mp4\">\nSorry, your browser doesn't support embedded videos, \nbut don't worry, you can <a href=\"https://s3-us-west-2.amazonaws.com/osbhdocs/Videos/Reading.mp4\">download it</a>\nand watch it with your favorite video player!\n</video>\n</div>\n\n<style>\nvideo {\n max-width: 100%;\n}\n</style>" } [/block] [block:callout] { "type": "info", "title": "LED Codes", "body": "The BuzzBox incorporates a Particle.io WiFi SoC called the Photon. The LED codes can be found in their documentation: \n\nhttps://docs.particle.io/guide/getting-started/modes/photon/\nhttps://docs.particle.io/support/troubleshooting/troubleshooting-support/photon/" } [/block] The OSBeehives mobile app displays the most recent measurements of your BuzzBox (timestamped) along with some historical trends. There is a space for giving feedback on the audio classification (beehive state). [block:image] { "images": [ { "image": [ "https://files.readme.io/929ee0a-Screen_Shot_2018-04-12_at_7.39.43_AM.png", "Screen Shot 2018-04-12 at 7.39.43 AM.png", 1215, 659, "#f7f5f2" ], "caption": "Screenshot of app screens" } ] } [/block] [block:callout] { "type": "success", "title": "User Feedback", "body": "Your feedback on the audio classification lets you play an important part in directly improving the technology for everyone. It immediately helps the AI system learn how to correctly classify the state of your beehive!" } [/block] The solar panel charges the lithium-ion battery, which powers the BuzzBox. The battery is designed to last 2.5 days (from full charge) without any external charge. The solar panel should be oriented towards the path of the sun (pointing south if in the northern hemisphere / pointing north if in the southern hemisphere). The panel is powerful enough to fully charge the battery in one day, even at high latitudes and lower light conditions. [block:image] { "images": [ { "image": [ "https://files.readme.io/f78e999-DSC_3448.jpg", "DSC_3448.jpg", 1600, 900, "#c0b4ae" ], "caption": "" } ] } [/block] [block:api-header] { "title": "Your WiFi Access Point" } [/block] The WiFi signal strength is an important factor in successfully monitoring and reporting your hive's data. WiFi is generally designed to work within a 100m/300ft unobstructed range. Walls and other structures will change the effective range of your WiFi network. Your particular router and router settings (transmit level) will also affect the range of the BuzzBox. The OSBeehives app provides a measurement of the signal strength your BuzzBox is seeing from your WiFi router. A weak signal could result in missed measurements and lost data. If your signal is weak, please consider moving the BuzzBox closer to your WiFi router, or adding a 'WiFi signal booster' to your home. [block:image] { "images": [ { "image": [ "https://files.readme.io/06f41d0-extender-house-diagram-enlarged.png", "extender-house-diagram-enlarged.png", 835, 587, "#a3905d" ], "caption": "" } ] } [/block] [block:parameters] { "data": { "h-0": "WiFi Signal Strength", "h-1": "dBm", "0-0": "Strong", "0-1": "-20 to -45", "1-0": "Medium", "1-1": "-45 to -65", "2-0": "Weak", "2-1": "-65 to -80" }, "cols": 2, "rows": 3 } [/block]