Eine deutschsprachige README_DE.md findest du hier.
Een nederlandse vertaling README_NL.md vind je hier.
Help on translation to other languages are welcome.
Current beta release is version 0.5b. The compiled binary can be installed on a Wemos D1 mini(and generally on any ESP8266 based board - but without guarantee ). Or download the code compile it yourself (see required libraries below).
The current arduino beta image is able to communicate with the Panasonic Aquarea H-series (and most probably from new J-series as well ,since PCB look identical).
If you want to compile this image yourself be sure to use the mentioned libraries and support for a filesystem on the esp8266 so select the correct flash option in arduino ide for that.
When starting for the first time a open-wifi-hotspot will be visible allowing you to config your wifi network and your mqtt server.
If you ever want to factory reset, just double reset the esp8266 within 0.1 second. It will then format the filesystem and remove the wifi setting and start the wifi hotspot again.
After configuring and booting the image will be able to read and talk to your heatpump. The GPIO13/GPIO15 connection will be used for communications so you can keep your computer/uploader connected to the board if you want.
Serial 1 (GPIO2) can be used to connect another serial line (GND and TX from the board only) to read some debugging data.
All received data will be sent to different mqtt topics (see below for topic descriptions). There is also a 'panasonic_heat_pump/log' mqtt topic which provides debug logging and a hexdump of the received packets (if enabled in the web portal).
You can connect a 1wire network on GPIO4 which will report in seperate mqtt topics (panasonic_heat_pump/1wire/sensorid). See more information below.
Updating the firmware is as easy as going to the firmware menu and, after authentication with username 'admin' and password you provided during setup, uploading the binary there.
A json output of all received data (heatpump and 1wire) is available at the url http://heishamon.local/json (replace heishamon.local with the ip address of your heishamon device if MDNS is not working for you).
Within the 'integrations' folder you can find examples how to connect your automation platform to the HeishaMon.
Below you can find some technical details about the project. How to build your own cables. How to build you own PCB etc.
Comunication can be established thru one of sockets: CN-CNT or CN-NMODE, with are hardwired/shortcuted ,so there is no possible to use them booth at the same time for more then one device (except sniffing).
Comunication parameters: TTL 5V UART 9600,8,E,1
CN-CNT Pin-out (from top to bottom)
1 - +5V (250mA)
2 - 0-5V TX
3 - 0-5V RX
4 - +12V (250mA)
5 - GND
CN-NMODE Pin-out (from left to right)
"Warning! As printed on the PCB, the left pin is pin 4 and right pin is pin 1. Do not count 1 to 4 from left!
4 - +5V (250mA)
3 - 0-5V TX
2 - 0-5V RX
1 - GND
Use some 24 AWG shielded 4-conductors cable.
Currently the PCB's are in (beta) production. We suggest to wait a while for them to be tested.
Soon you will be cable to order one of the PCB design directly from the project owners but ofcourse
we will share the schematics also. For now these are some schematics we are testing or have tested.
PCD Designs from the project members
Picture Wemos D1 beta
Picture ESP12-F
boards:
esp8266 by esp8266 community version 2.6.3 Arduino
Current list of documented MQTT topics can be found here
The software also supports ds18b20 1-wire temperature sensors reading. A proper 1-wire configuration (with 4.7kohm pull-up resistor) connected to GPIO4 will be read each 30 secs and send at the panasonic_heat_pump/1wire/"sensor-hex-address" topic.
To get information from heat pump, "magic" packet should be send to CN-CNT:
71 6c 01 10 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 12
Current list of documented bytes decrypted can be found here