Skip to content

Freedomotic Smart Spaces Framework - An open source domotic framework for home and building automation

License

Unknown, Unknown licenses found

Licenses found

Unknown
copying.txt
Unknown
LICENSE.GPL
Notifications You must be signed in to change notification settings

wynged/freedomotic

 
 

Repository files navigation

Freedomotic

Official website is http://freedomotic.com

Freedomotic is a framework for home and building automation which allows to build smart spaces and ambient aware applications. Learn more at http://freedomotic.com

Freedomotic can run also on Raspberry Pi and can easily interact with DIY Arduino projects.

Starting from 2 Feb 2014, this is the freedomotic mainstream repository. Previous repository was hosted on googlecode http://code.google.com/p/freedomotic

Requirements:

  • Java Open JDK version 6 or 7 or oracle jdk (to install on ubuntu: sudo apt-get install openjdk-7-jdk)
  • Maven version 2 or 3 (to install on ubuntu: sudo apt-get install maven)
  • Any OS with java support (Linux, Windows, Mac, Solaris ...)

Development status:

  • Current released version: 5.5.0 'Bender' (released on 24 Jan 2014)
  • Version in development (HEAD of this repository): 5.6.0 'Commander'

Developers Quick Start

1) Fork freedomotic on GitHub

Create an account on https://github.com if you don't have one. Fork freedomotic following this link: https://github.com/freedomotic/freedomotic/fork Create the local clone of your online fork with this command:

git clone https://github.com/YOUR-GITHUB-USERNAME/freedomotic.git

2) Enter the new local folder

cd freedomotic

3) Compile freedomotic with maven

mvn clean install

4) IMPORTANT!!!! THIS IS REQUIRED: Copy the example-data folder into freedomotic-core/data. If you miss this step freedomotic won't start

cp -r data-example/ framework/freedomotic-core/data

5) Run freedomotic

java -jar framework/freedomotic-core/target/freedomotic-core/freedomotic.jar

As an alternative you can start freedomotic-core project from your favourite IDE. Here an example with NetBeans IDE http://freedomotic.com/content/faq-troubleshooting#Getting_started_with_netbeans

If you experience compile or startup errors please refer to http://freedomotic.com/content/faq-troubleshooting#Developers

Git reporitory is an SDK

The GIT repository is a complete SDK with all you need to code and test your freedomotic plugins. Once compiled for the first time open the freedomotic-core project with your favourite IDE and start it to try freedomotic.

To develop your own plugin you can start from the "hello-world" example project included in GIT_ROOT/plugins/devices/hello-world. Open it in your IDE, make some changes and compile. It will be automatically installed into the freedomotic runtime (freedomotic-core project). Just start freedomotic-core to try your latest changes.

Developers Documentation

Read more on the official website http://freedomotic.com/content/developers-getting-started

Try it on Raspberry Pi

We have a script to do it automatically, follow this short tutorial http://freedomotic.com/content/install-freedomotic-raspberry-pi

Give feedback

Please write on the forum http://freedomotic.com/content/forum or reach us by mail at [email protected]

About

Freedomotic Smart Spaces Framework - An open source domotic framework for home and building automation

Resources

License

Unknown, Unknown licenses found

Licenses found

Unknown
copying.txt
Unknown
LICENSE.GPL

Stars

Watchers

Forks

Packages

No packages published