How It Works · OSBeehives

{"_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: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 a sophisticated device that monitors the conditions and health of your bee hive. It incorporates many pieces of technology to achieve this. A range of sensors, microcontrollers, radio communication, AI neural-networks, server technologies and mobile device applications combine to make this a unique, user-friendly beekeeping essential.\n\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). \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":"BuzzBox Beehive Health Monitoring","slug":"how-it-works","type":"basic","title":"How It Works","__v":0,"parentDoc":null,"childrenPages":[]}

[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 a sophisticated device that monitors the conditions and health of your bee hive. It incorporates many pieces of technology to achieve this. A range of sensors, microcontrollers, radio communication, AI neural-networks, server technologies and mobile device applications combine to make this a unique, user-friendly beekeeping essential. 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). [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]