patrick/OpenDTU-old
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
Software for ESP32 to talk to Hoymiles/TSUN/Solenso Inverters
199 Commits 2 Branches 144 Tags 78 MiB
C++ 63%
Vue 25.9%
C 7.4%
TypeScript 2.4%
Python 1%
Other 0.1%
c89e729dea
Go to file
tbnobody c89e729dea
Merge pull request #19 from ahinrichs/pr-fix-hwinfo-prop-types 
[webapp] HardwareInfo.vue fix prop types
2022-07-07 18:57:49 +02:00
.vscode Initial commit 2022-04-09 11:05:14 +02:00
docs Added additional documentation 2022-06-22 23:10:17 +02:00
include Rename variables to match code style 2022-07-06 19:25:30 +02:00
lib Fixed queue handling and added event log count 2022-07-04 19:36:58 +02:00
src Rename variables to match code style 2022-07-06 19:25:30 +02:00
test Initial commit 2022-04-09 11:05:14 +02:00
webapp [webapp] HardwareInfo.vue fix prop types 2022-07-06 22:03:31 +02:00
webapp_dist Added compiled appz.js.gz 2022-07-06 19:27:33 +02:00
.gitignore Added log files to .gitignore 2022-04-18 15:19:46 +02:00
auto_firmware_version.py Show current git hash in web gui 2022-06-20 20:56:50 +02:00
LICENSE Added license file 2022-06-16 10:40:15 +02:00
partitions_custom.csv Resize partitions 2022-06-15 22:07:39 +02:00
platformio.ini [firmware] add minimum platform requirement 2022-07-01 09:31:05 +02:00
README.md Added list of currently supported inverters 2022-07-01 23:12:35 +02:00

README.md

OpenDTU

Background

This project was started from this discussion (Mikrocontroller.net). It was the goal to replace the original Hoymiles DTU (Telemetry Gateway) with their cloud access. With a lot of reverse engineering the Hoymiles protocol was decrypted and analyzed.

Currently supported Inverters

  • Hoymiles HM-300
  • Hoymiles HM-350
  • Hoymiles HM-400
  • Hoymiles HM-600
  • Hoymiles HM-700
  • Hoymiles HM-800
  • Hoymiles HM-1000
  • Hoymiles HM-1200
  • Hoymiles HM-1500
  • TSUN TSOL-M800 (Maybe depending on firmware on the inverter)

Features for end users

  • Uses ESP32 microcontroller and NRF24L01+
  • Multi-Inverter support
  • MQTT support
  • Nice and fancy WebApp with visualization of current data
  • Firmware upgrade using the web UI
  • Default source supports up to 10 inverters
  • Time zone support

Features for developers

Wiring up

Schematic

Schematic

Symbolic view

Symbolic

Flashing and starting up

  • Install Visual Studio Code
  • In Visual Studio Code, install the PlatformIO Extension
  • Clone this repository (you really have to clone it, don't just download the ZIP file. During the build process the git hash gets embedded into the firmware. If you download the ZIP file a build error will occur)
  • In Visual Studio Code, choose File --> Open Folder and select the previously downloaded source code. (You have to select the folder which contains the "platformio.ini" file)
  • Adjust the COM port in the file "platformio.ini". It occurs twice:
    • upload_port
    • monitor_port
  • Select the arrow button in the status bar (PlatformIO: Upload) to compile and upload the firmware. During the compilation, all required libraries are downloaded automatically.

First configuration

  • After the initial flashing of the microcontroller, a Access Point called "OpenDTU-*" is opened. The default password is "openDTU42".
  • Use a web browser to open the address http://192.168.4.1
  • Navigate to Settings --> Network Settings and enter your WiFi credentials
  • Currently you have to look at your router to determine the IP of the newly connected device

Building

  • Building the WebApp

    • The WebApp can be build using yarn
    $ yarn install
$ yarn build
    • The updated output is placed in the 'webapp_dist' directory

  • Building the microcontroller firmware

    • Visual Studio Code with the PlatformIO Extension is required for building