Arduino library for home automation. The Library can be used on a Arduino compatible board for home automation task via serial connection and in combination with pimatic and the pimatic-homeduino plugin.
You can either import all libraries in libraries into your Arduino IDE and open the homeduino.ino sketch or you can compile and flash using the Makefile (recommended).
The Makefile uses Arduino.mk. Because the arduino-mk version that comes with raspbian on the raspberry pi is to old, arduino-mk comes bundled as git submodule with this repository.
sudo apt-get install arduino-core avr-libc avrdude binutils-avr gcc-avr libconfig-yaml-perl libftdi1 libyaml-perl screen python-serialThen clone the homeduino repository with all submodules:
git clone --recursive https://github.com/pimatic/homeduino.gitEdit the Makefile to use the right BOARD_TAG and MONITOR_PORT. You can list all available BOARD_TAGs with: make show_boards.
You can now compile it by running make or compile and upload it with:
make uploadIf you want to connect a DS18B20 sensor to your arduino you have to checkout the onewire branch before make upload:
git checkout onewire
git submodule update --init --recursive
The onewire library disables global interrupts, this could lead to worse receiving performance!
You can use the serial monitor of the arduino IDE or the screen command.
Run
make monitorType in your message and press Ctrl+Return. You can exit it with Ctrl+a and then k. Keep in mind that it does not echo what you type.
All commands sent to homeduino are accepted with ACK or rejected with ERR. Homeduino prints an ready message on serial port open if it is ready to receive commands.
PING message
Sends back a string, can be used to check if the connection is working.
Example: PING hello
RF receive interrupt_pin
Starts receiving 433 mhz RF signals on interrupt pin interrupt_pin using RFControl. interrupt_pin can be 0 or 1.
Example: RF receive 0
When an RF signal is received it prints a message to the serial port:
RF receive 453 1992 88 9228 0 0 0 0 01020102020201020101010101010102010101010202010202020202010102010102020203
RF send digital_pin repeats b0 b1 b2 b3 b4 b5 b6 b7 pulse_sequence
Send an rf signal by its buckets and pulse sequence using RFControl.
Example: RF send 4 3 453 1992 88 9228 0 0 0 0 01020102020201020101010101010102010101010202010202020202010102010102020203
DHT type digital_pin
Reads a DHT temperature sensor of type on pin pin using DHTlib.
Example: DHT 22 3
Responds with: ACK temperature humidity or one of ERR checksum_error, ERR timeout_error, ERR unknown_error.
- digital read:
DR pin - digital write:
DW pin - analog read:
AR pin - analog write:
AW pin - pin mode:
PM mode
Example: DR 4
Responds with ACK or ACK value.