Name | Modified | Size | Downloads / Week |
---|---|---|---|
Parent folder | |||
Dog2.1.x Applications | 2011-01-17 | ||
Dog2.1.x Libraries | 2011-01-17 | ||
Dog2.1.x Platform | 2011-01-17 | ||
release_notes.txt | 2011-01-18 | 2.1 kB | |
Dog2.1.0.zip | 2011-01-18 | 46.7 MB | |
readme.txt | 2011-01-17 | 3.7 kB | |
Totals: 6 Items | 46.7 MB | 0 |
Setting up the Dog2 development environment in Eclipse ---------- 1) Download the Dog2 sources from either the http://domoticdog.sourceforge.net web site or from svn 2) Import the Dog2 sources in a new (or existing) Eclipse workspace (as a set of Existing projects) 3) For clearness sake, create a new working space named Dog2 (or else) (File > New > Java Working Set) and add all the Dog2 projects to it. 4) In Eclipse, open (double click) the project "DOG2 documentation" 5) In Eclipse, open (double click) the folder "external libraries", under the "DOG2 documentation" project folder 6) Copy the osgi.cmpn.jar and osgi.core.jar files in the eclipse Plugin folder (inside the Eclipse application folder) 7) Restart Eclipse 8) In Eclipse create a new, empty, working space named Dog Helpers (or else) (File > New > Java Working Set) 9) In Eclipse, select the dogWebServerDependenciesAllInOne.psf file located in the "external libraries" folder, under the "DOG2 documentation" project folder 10) Right click on it, choose "Import" then "Team Project Set" in the Team folder 11) Click on "Next >" and then tick the "add project to working sets" checkbox and select the just created "Dog Helpers" set. Finally click on "Finish". If Eclipse (this issue is typical of the Helios release) reports "access" errors in sources (see the "Problems" tab), set "Forbidden reference" to Warning (in Eclipse Preferences > Java > Compiler > Errors/Warnings > Deprecated and restricted API); rebuild the workspace if necessary. Running Dog2 ---------------- To run Dog2, select "Run Configurations" in the Run menu and create a new OSGi frameowk configuration (if does not exist yet). Select all the bundles in the workspace (you can exclude Test* bundle and the Dog Web Server bundle, right now), deselect all the bundles under "Target Platform" and click on "Add Required Bundles" (on the right of the run configuration window). Click on Apply and then Run, Dog2 shall start without any problem. Connecting Real Plants ------------------------------ In order to connect Dog2 to a real plant (KNX or MyHome) some further steps must be accomplished: 1) Run Dog2 one time so as to enable it to create the default configuration folder (taken from the inner Dog2 structure) 2) Open the "DogConfig" folder typically located in the base directory defined by the Eclipse run configuration. In most cases such a location corresponds to the Eclipse application folder. KNX networks ------------- The KNX network configuration is defined by the KnxNetworkDriver.config file. 1) Change the "houseIP" parameter to the IP address of the KNX/IP gateway you want to connect to 2) Join the multicast address 239.192.39.238 (this may already work in your default PC setting) a) Type netstat -rn on the command line terminal (Windows cmd or Linux bash) b) Look at the routing table, if no entry is provided for the above address, add it. (in Windows this corresponds to write the command route -p ADD 239.192.39.238 MASK 240.0.0.0 <your gateway IP address> c) Check that your firewall is accepting UDP multicast connections on the port 51000 3) Change the "myIP" parameter to the IP address of your PC BTicino networks ----------------- The BTicino network configuration is defined by the BTicinoNetworkDriver.config file. 1) Change the "houseip" parameter to the IP address of the BTicino gateway you want to connect to 2) Make sure that the IP address of your PC is in the MyHome gateway trusted addresses (see BTicino documentation for more information) Home Configuration ------------------- Look at the Dog2 user guide available on http://domoticdog.sourceforge.net