"1-click" Library ecosystem installer and command-line utility for H4, H4Plugins and dependent libraries
Phil Bowles passed away in 2022, and this project has therefore received little maintenance. Hamza Hajeir has been keeping the repositories up and running. This installer version was updated from Phil Bowles' using Hamza Hajeir's environment.
NOTE: You must use the following board definition versions: For ESP8266, use 2.7.4; for the ESP32, use 1.0.6
New installer based on Phil Bowles' version 0.0.2, updated with Hamza Hajeir's environment
Added ESPAsyncUDP for ESP8266 builds of h4plugins
Github limits unauthentiated accesses to 60/hour, after that it gives you an "rate limited" error. The script makes about 12 or 13 calls when installing h4plugins, meaning that if 5 usages worldwide happen at the same time, the last will get a "rate limt" erro. No solution yet but to wait an hour and try again.
For more information, have a look at Phil Bowles' Youtube channel (instructional videos)
Watch the video! Running the h4installer
Installing the (up to) 9 libraries and further tools required by H4Plugins can be tedious, especially if you compile for both ESP32 and ESP8266. The h4installer reduces this process to a "1-click" action which automatically installs all of the required libraries, their dependencies ( if they are older than the current master branch on github) and the relevant ArduinoIDE tools.
- Downloads, unzips and installs any library in the dependency chain whose version is less than the latest public master
- Where a library requires async TCP support, downloads either (or both) of:
- Forked AsyncTCP (if user has ESP32 core boards installed)
- Forked ESPAsyncTCP (if user has ESP8266 core boards installed)
- Where a library is dependent upon Forked ESPAsyncWebserver, downloads either (or both) of:
- ESP32 sketch data uploader (if user has ESP32 core boards installed)
- LittleFS upload tool (if user has ESP8266 core boards installed)
- Installs the ESP Exception Decoder (required when submitting issues on any crash)
- Installs advanced optimised board definitions and special memory model for ITEAD SONOFF devices
- If h4plugins is installed, additionally installs (Currently on Windows systems only):
- Windows desktop UI integration to control H4 devices
- Provides flexible command-line control of H4 devcies (all OS)
Exisitng users should already be familiar with the "menagerie" and its installation roadmap
| Name | Provides | Notes | |
|---|---|---|---|
| Forked AsyncTCP | "Glue" to LwIP (ESP32) | Important bugfixes | |
| Forked ESPAsyncTCP | "Glue" to LwIP(ESP8266) | Missing features added | |
| Forked ESPAsyncWebserver | Basis of webUI in H4Plugins | Several major bugfixes | |
 |
PMB Tools | '32/'8266 HAL and utility functions | |
 |
AardvarkTCP | Simple Large-payload Async TCP | API-compatible with ESPAsyncTCP, seamless TLS/SSL |
 |
PangolinMQTT | Async MQTT Client | QoS 0/1/2 Fully 3.1.1 compliant. Large payloads |
 |
ArmadilloHTTP | Async HTTP/S Client | Simple send/callback of large payloads |
 |
H4 | Scheduler/Async Timers | |
 |
H4/Plugins | Full Async IOT Firmware | Webserver, MQTT, OTA, NTP, HTTP etc etc |
If you imagine a starting point on the roadmap, then the installer will work backwards from there to the start, installing every out-of-date library it finds on the route, making allowances for whether you have the ESP32 and/or ESP8266 core(s) installed. It also updates the ArduinoIDE tools relevant to the chosen library and installed core(s).
When you run it, it asks for that starting point library and once finished, the enitre environment is "ready to rock". It truly is a 1-click solution.
h4installerrequires Python 3. Download and install from here making sure you start with the "customised install" option and then tick the box to "Add Python to environment variables"
- Download and unzip this repo. Take care when choosing a location to unzip to as this location must be permananent: files within the repo are referenced by the command-line utility (amongst others). The author, for example, has it installed in
C:\Users\phil\Documents\h4installer
This will depend on which OS you use:
- Windows: double-click
install.batyou will be prompted for the starting library (see important note below) - Others: enter command
py install_h4plugins.py < starting library >e.g.py install_h4plugins.py PangolinMQTT
That's all there is to it! The following libaries / tools will be installed depending on the chosen starting library
The installer updates the registry with the Windows desktop UI extensions, which require administrator access. You must start install.bat using: right click / Run as Administrator
On success, you should see something resembling this:
On Windows, you will then see this "context" (right click) menu in the network explorer for all your H4 devices:
H4 Installer also adds a utility that can be run from anywhere to control your H4 devices (this is what the Network Explorer context menu handler uses [ shown above ])
Just create a Github issue
As I am not the creator, nor do I keep the libraries up-to-date, I can't and won't fix any issues. Due to Phil's passing, you may not receive any replies to issues, but you can try the following:
-
As with all H4 and H4Plugins libraries, please make sure you have read all the relevant documentation relating to the issue and watched any videos on the Youtube channel (instructional videos). Please also subscribe to the channel for notifications of news and updates.
-
If you still think there is a problem, then join the Facebook H4 Support / Discussion group and report the issue briefly there. This alerts other users to potential problems and allows an initial assessment.
-
If there is a genuine issue then you will be referred to Raising H4/H4Plugins issues after which you are advised to create a full github issue report.
-
Failing to make an initial report in the Facebook H4 Support / Discussion group and simply starting with a github issue, or failing to include all of the information required in Raising H4/H4Plugins issues is likely to result in a long delay before it gets picked up.
(c) 2021 Phil Bowles