Head over to the discord server to discuss this firmware: https://discord.gg/zw377qhj9c
Firmware source code for ESP32 and ESP8266 that is compatible with SimHub. It's derived from what SimHub lets you setup, but tweaked with a thin compatibility layer for the ESP32 and ESP8266.
ESP8266 is cheaper and more powerful that most arduinos boards and fairly popular in the IoT Community. The ESP32 is a very handy little monster to use too.
- Download this code
- Install Git
- Install VSCode and Platformio
- Open with VSCode
- Adjust it however you need
- Upload it to your device
It's better in almost every way than Arduino IDE, but more generic and more strict. It's worth learning it, trust me.
SimHub assumes there is a serial port that it can talk to, and a certain protocol that accounts for errors Automatic Repeat Request.
Instead of having a local device connected to the computer directly, we create a "virual com port" that forwards all communication to a certain IP.
On the Microcontroller side, we modify the code to create a socket server receiving data on the right port, we put that data in a buffer (similar to the serial port) and we allow the modified Arduino SimHub client to consume it from the buffer, as if it was a normal seial connection.
Set the preprocessor directive called INCLUDE_WIFI to true (in src/main.cpp). Set DEBUG_TCP_BRIDGE to true as well, and set monitor_speed = 115200 in platformio.ini.
Upload a WiFi enabled firmware. Connect USB to computer and open the serial monitor with 115200 baud rate (to catch debug messages). Power the ESP up.
(If you hardcoded WiFi credentials already, skip this paragraph) It will itself create a new WiFi network (ESP-{a bunch of letters and numbers}) that you can connect to from your phone or computer. Connect to that network and navigate to http://192.168.4.1, observe a captive portal. Configure your WiFi and then disconnect.
Once the ESP is connected to a network, it won't create its own. The device should output the IP address it's using, write it down, you'll need it.
If you have access to your router settings, it's worth setting a static ip address or a DHCP reservation to the ESP.. that way you won't have to reconfigure the virtual port every few reconnections.
Download Perle TruePort. Install it. Configure a new COM port. Forward the data to the IP address of your ESP. Check the manual on the section called "Configuring the COM Port Connection" > "Access Device Server Serial Port" Follow the instructions to set it up in LITE mode. .. and that should be it.
SimHub should see the virtual port as a normal COM port, and it should be able to "scan it" and do the normal handshake process to query and use it. After confirming everything works, you can upload a new ESP firmware without debug logging.
Some Arduino APIs for the ESP32 are different, so not everything will work out of the box, but I got the WiFi bridge working and the ShakeIt fans with some effort, as you need to use different includes etc. It's very likely that other features that I haven't tested will need tweaks. But if you're willing to experiment with this, feel free to do so. Checkout this PR #1 as an example of the things you need to do to achieve compatibility.
- Open
platformio.ini, comment out the ESP8266 env and Uncomment the ESP32 env. Also specify your board in the env, by default is set to something likeesp32doit-devkit-v1because I owned this board, but there are tons of boards for the ESP32, as you can see here. Click on one and it will show you what's its id. - Make sure to use the correct pin numbers for the ESP32 as opposed to aliases such as D1, D2, D3.. etc
