The BeeSafe project is a low-cost, open source tracking device. It is designed to keep children safe by constantly monitoring their location, and alerting parents if the child leaves the designated safe zones. It consists of a Raspberry Pi 3B, and a purpose made PCB containing a u-blox SARA-G350 GSM module, through which the Pi continuously gathers location data, and processes whether the child is in a location it is supposed to be at that time, and if the child is at a place they should not be, the device sends a text message to the parent with the child’s location they can track through a web interface.
To build our project, first clone the BeeSafe Github repository with
git clone https://github.com/itsBelinda/ENG5220-2020-Team13
Next, run the installation script installBeeSafe.sh
in the root folder of the repository: this will install all required dependencies. Note: For optional dependencies, you can choose to install them or not by uncommenting or commenting them in the installation script.
Next, run the build script buildBeeSafe.sh
in the root folder of the repository: this will build the project and is ready to be ran.
For more in-depth build instructions, please see the corresponding wiki page .
To run the project as live project, ensure the build instructions were followed to create the bootloader service. If that was correctly implemented, the software should run upon the next startup.
To run the project in development, navigate into the folder /software/BeeSafePI/build/src/
in the repository, and type
./BeeSafePI
For more in-depth usage instructions, please see the corresponding wiki page .
An in-depth guide on the build and usage of the system, as well as detailed component descriptions and project management steps can be found on the project wiki. The API documentation created with Doxygen can be found here.
Do you like this project? We strongly believe in the power of Open Source, so there are many ways you could contribute to our project!
We are aware of the possibility that there may be bugs in the project, which were not immediately apparent for us (or were :P ). If you find one, do let us know by opening an issue, but please read our Bug Report Guidelines first, to make it easier to work out the problem!
Is there a feature you would like to see implemented in this project? We welcome feature requests, however before you open one, please read our guidelines for submitting one!
We welcome other contributions, too, so pull requests of patches, improvements, etc. are encouraged! By default we ask you pull the master
branch. We only ask you to be mindful, and keep pull requests in scope and relevant. If you would be interested in contributing a larger piece of work and/or it may not be in line the above tips, please do get in touch with a maintainer for a discussion!
For the coding conventions we use, please look at the wiki page discussing it in depth!
If you have any, more general feedback about our project, give us a shout by filling out this form!
Feel free to also reach out to us via email, on beesafe.uofg [at] gmail.com!
Made with ❤️ by Team BeeSafe:
Belinda Kneubuhler
Zsuzsanna Szugyi
Daniels Vasiljevs
This project is licensed under the MIT license.