To download the library/package, go to the URL in a browser and download it as ZIP. Then, in Arduino IDE, click Sketch → Include Library → Add ZIP Library.
Taking it slow is a good approach. The Arduino IDE seems easy on the surface, but it’s temperamental.
Perhaps @Adrian_Rockall will be able to get a bin file working with that specific board. Imagining the bin is loads easier than compiling a sketch.
Flashing an Arduino sketch isn’t very hard. You just install the right boards and packages/libraries, paste the code and click Upload. I’ve done it many times, it’s very easy.
I though so too, but then I spent weeks on trying to find our why flashing the board via the Arduino IDE did not result in a working ESP32 BLE Hub. Things I ran into:
- The various libraries used by the BLE Hub software were different (newer) versions than used for the BLE Hub software. Adrian helped out by updating his BLE Hub software to work with the newer libraries that would otherwise cause compilation to fail;
- I needed to downgrade the ‘esp32’ boards set in Boards Manager to an older version to make the software work on my ESP32 board. Apparently due to changes in the Arduino IDE version and how it works with board software/libraries.
Still after getting it to compile/work, I would get strange HTTP 500 errors, while the rest of software works. Likely still some difference in the HTTP handling of my own compiled Sketch vs. the original one by Adrian, though we could not find the cause.
As I had never used Arduino IDE before and this was my first experience with an ESP32 board, I would not call my personal experience ‘very easy’
.
After I got flashing via Espressif’s flash tool working (I had to use SPI mode to DIO instead of QIO) I sticked to this method as it works without any errors and I do not have to worry about library/board/Arduido IDE versions. For users not having experience with programming an ESP32, flashing the pre-compiled software is the more easier route.
That’s a better/more detailed explenation/guide in my humble opinion.
Thanks.
Maybe I give it a try again then. ![]()
Black Iphonitis rigorosa : level 15+
@SunBeech Same here completly !
The different menus and setup options of the Arduino IDE software itself and then the many almost similar packages/libraties names and the Different versions !
Some precise (older) versions,mentioned in the github guide, even are not available (anymore). Raising eveytime an additiinal question mark above/in my head.![]()
![]()
![]()
![]()

I’m not somebody that gives up so lightly but this had so much potential choosing or forgetting/missing something that I had to give up my 1st attempt and ask here fore help also.
Maybe @Adrian_Rockall should make an extra/separate topic here for this ESP32 Switchbot bluetooth proxy/hub/relay to make sure this original Switchbot one stays more clean/pure Switchbot devices itself related.
(But at the moment I got something more (important) on my mind: Close Family members were supposed to fly back from Dubai (vacation) yesterday evening and all flights got cancelled and there were several attacks there. Even the airport got hit last night and a hotel near their hotel of their involuntary extended stay. )
I have pushed a new binary folder to GitHub for the ESP32-S3.
Really sorry to hear that. Hope everything will be OK and they return safely.
How does your ESP32-S3-Zero look like after its successful setup/flasched ?
Any led activity?
But first steps 1st. Do I need to push any of these buttons prior the flashing of the embedded s3 file ?
And what setting do I select at the start of the flashtool ? I selected ESP32-S3/Develop/USB
And set these parameters:
After it was finished I disconnected the usb-cable with the device and connected it to my powersupply. Nothing visibly changed. And no Wifi-Access point. ![]()
If you could tell me what to specifically set here I could try to connect to it without being in the list of available access points:
Could it be that I ruined/broke my (2nd) device beyond repair with the attempt of installing/flashing the older/original (not) merged . Bin file ?? ![]()
![]()
![]()
There is no LED activity.
If you have the Arduino IDE installed, open that, connect the board to the computer, and then open the serial monitor. Set the BAUD rate to 921600 and then reset the board and wait for a few minutes. You should see messages appearing.
I purchased a pack of 3 devices and programmed one via the IDE and another via the Flash tool. It does take a while for the device to start up for some reason.
What modules to select/set above ??
And the serial monitor says : invalid header 0x0a0a0a0a
And where is this reset/clear button/command ??
The invalid header message suggests it hasn’t programmed successfully.
If you hold down the button on the right (program) and the press the button on the left (reset), it will for the ESP32 in to programming mode. Then program the device again to see if that fixes it.
Another thing to try: When I programmed my ESP32 end of 2024 I had to downgrade the ‘esp32’ boards set in Boards Manager from v3.1.0-RC3 (which was installed when I installed Arduino IDE - v2.3.3 back then) to the last pe-RC version: v3.07. Not sure why the older version works, but the newer did not. You’ll likely have an even newer version installed. It might be worthwile to switch to v3.07 (you can always update to the latest version again).
You mean the B(=Boot) & R(= Reset) button on the board/device itself?
I took a better look on the specs of my board on the amazon website from which I ordered: it Says “ESP32-S3 mini” board containing the ESP32-S2-Zero chip.
Hope this doesn’t matter or @Adrian_Rockall has really the same as I have. ( See my earlier post asking about it with the amazon link is it was compatible. )
I will try everything asap within few hours if it solves the problem.
Last night I made already an attempt but my laptop/windows froze /had crashed in Ardunio IDE so I just have shut it down an went to sleep.
(Meaningwhile I test an onther & more powerful usb powersupply. Just to be sure. Nothing changed. Beginning to think the usb port is the problem bit this can’t be. Its normally used to connect my Samsung T7 SSD backup. )
Ok. That with the buttons chneged something although its not (yet) working with the flashtool.
So I started the Arduiono IDE up gaain and I might get now till :
- Build and download the code to the board.
But really don’t know how / what to to (in detail).
Building the project in the Arduino IDE is not so easy as you need to make sure the correct libraries are installed. They are listed in the readme on the repo, so you need to open the library manager to add most to them, but there a one or two that need to be added manually.
These are the boards I ordered: diymore 3PCS ESP32-S3 WiFi Bluetooth Mini Development Board Module Dual-Core Processor Based on ESP32-S3: Amazon.co.uk: Electronics & Photo
Ok.
I’ve just double clicked on the SwitchbotBLEHub.ino from the downloaded & unpacked git zip file “SwitchBotBLEHub-master”
And clicked the “play” /upload button:
After about ten seconds I’ve gotten this message:
C:\Users\SirAp\AppData\Local\Temp.arduinoIDE-unsaved202622-28596-xg5m53.dx8r\sketch_mar2b\sketch_mar2b.ino:21:10: fatal error: ESPAsyncWiFiManager.h: No such file or directory
21 | #include <ESPAsyncWiFiManager.h> // GitHub - alanswx/ESPAsyncWiFiManager: Port WiFiManager to ESP Async Server
| ^~~~~~~~~~~~~~~~~~~~~~~
compilation terminated.
exit status 1
Compilation error: ESPAsyncWiFiManager.h: No such file or directory
these/your boards look very similar to mine : https://www.amazon.nl/-/en/Waveshare-Development-ESP32-S3FH4R2-Castellated-Applications/dp/B0CHYHGYRH
That is one of the missing libraries that needs to be manually installed from GitHub - alanswx/ESPAsyncWiFiManager: Port WiFiManager to ESP Async Server






