eGeoffrey is an open source, flexible and extensible framework, which can be used in many ways to fit more demanding people on earth's needs. It can live with you at home (no extra room needed though), or you can get its services straight from "the cloud", wherever this thing is.
- Modular: eGeoffrey is made up of different, independent components. Since they are communicating through a shared message bus, they can live everywhere, in a small Raspberry Pi or in a powerful server. They do not even need to run on the same machine: as far as they connect to the same bus and can talk, they just works, in a completely transparent way for the user.
- Portable: an eGeoffrey module is packaged and delivered as a Docker container, isolating each component from the others thus bundling applications, tools and required libraries in a portable and plug&play solution. Don't worry you don't need to know anything about Docker, eGoeffrey's abstracts any complexity of the underlying system!
- Modern Web Interface: eGeoffrey's GUI (with mobile support), can be fully customized by the user and is the easiest and simplest way to configure your eGeoffrey's instance, register new sensors, view your data, control your actuators, configure rules which will trigger one or more notification upon specific conditions.
- Extensible: eGeoffrey has been thought to be easily extended by any user. Do you need to integrate with a custom weather service not yet supported? Leverage eGeoffrey's SDK to build up even a new complex module in a minutes, without requiring any change to the core code base. Publish your package to the eGeoffrey's Marketplace to allow other users to enjoy your creation!
eGeoffrey can run in any platform but the easiest and most convenient way to let eGeoffrey be with you in your house is by purchasing a mini personal computer such as a Raspberry Pi or Orange Pi which makes ideal to have eGeoffrey on duty all the time.
Once the operating system is installed and your device will be ready, simply copy and paste the command below to run eGeoffrey installer. Do not forget to review our Getting Started guide for step-by-step instructions!
sudo bash -c "$(curl -ssL https://get.egeoffrey.com)"
Serial Gateway, Ethernet Gateway and MQTT Gateway are all supported by eGeoffrey.
Once eGeoffrey has been installed, to add the MySensors package simply run the following which will take care of downloading, installing and configuring the component:
egeoffrey-cli install egeoffrey-service-mysensors
Default configuration files are provided for all the gateways, simply go as an admin user in the web interface, under
eGeoffrey / Modules to edit the configuration of the gateway(s) you are using.
You can then easily map your MySensors sensors in eGeoffrey through the
House / Sensors / Register New Sensor menu. A wizard will guide through the process asking if it is going to act as a sensor or an actuator, which is the node_id, child_id, type and all the other required settings. Once data is starting getting in, you can visualize it in the way you like, use it in rules and correlate with all the other information eGoeffrey is already collecting.