README.md

MyDomoAtHome

DOMO/REST Gateway between Domoticz and Imperihome ISS


  

Features and goals

The initial goal is to provide a REST API to ImperiHome ISS that would only allow to see the current state of sensors and interact with them in case of an actuator.

M1 Goal reached

• Free
• Multi-platform (Linux, Mac OS X, Windows)
• Support major type of sensors/feature of Domoticz
  • Weather and Environmental sensors
  • Energy sensors (Electricity, Gas, Water)
  •  Switches
  • Thermostat
• Dependency-less
• Perl Dancer 1 engine
• MPD based players support (Volumio...)

Next M2 milestone will provide extended support to other platforms with Docker and Synology

• Extended platform (support)
  • Provide Docker images
  • Provide Synology package
• Perl Dancer2 engine
• Auto updatable
• Kodi support
• Support every single type of sensors/feature of Domoticz
  • Dynamic room creation
  • RGB lamps
  • Alarm pannel

Standalone installation (PI, cubie, odroid, intel...)

Install procedure

• cd ~/domoticz/
• git clone https://github.com/empierre/MyDomoAtHome MyDomoAtHome
• cd MyDomoAtHome
• cp config.yml.def config.yml
• edit config.yml with your values
• edit MyDomoAtHome.sh and change the path line 16 to your home installation
• sh ./run_once.sh

Running the service

The default port is now 3001.

Start the service:

sudo service MyDomoAtHome.sh start

Stop the service :

sudo service MyDomoAtHome.sh stop

Restart the service :

sudo service MyDomoAtHome.sh reload

Update:

• cd ~/domoticz/MyDomoAtHome
• sh ./update-mdah.sh

Docker installation

Duplicate the image

docker pull epierre/mydomoathome

Launch the process

Remember to change the IP below and authorize in Domoticz the docker IP range docker run --name=mydomoathome --env domo_path="http://ip:8080" -it --rm -p 3001:3001 epierre/mydomoathome

Check running docker processes

docker ps

Stoping a docker process

docker stop DOCKER_ID (found from the docler ps)

Testing the installation

• Check the domoticz is accessible from the hosting machine: curl http://domoticz_ip:domoticz_port/json.htm?type=devices&filter=all&used=true&order=Name
• Check the MDAH returns the result from the hosting machine: curl http://gateway_ip:gateway_port/devices

Support:

• Tracking: https://github.com/empierre/MyDomoAtHome/issues
• English : http://www.domoticz.com/forum/viewtopic.php?f=5&t=2713
• French : http://easydomoticz.com/forum/viewtopic.php?f=12&t=573
• Send domoticz.db for an undetected device: domoticz at e-nef.com

Q&A

• Remember to add the gateway in the local networks under setup in domoticz !