From 0d3d71aec98996eed1170d6a254de2e6df2c1712 Mon Sep 17 00:00:00 2001 From: rstrouse <47839015+rstrouse@users.noreply.github.com> Date: Mon, 23 Jan 2023 15:26:26 -0800 Subject: [PATCH] Updated Compiling the Firmware (markdown) --- Compiling-the-Firmware.md | 12 +++++++----- 1 file changed, 7 insertions(+), 5 deletions(-) diff --git a/Compiling-the-Firmware.md b/Compiling-the-Firmware.md index ec6a718..cbcede2 100644 --- a/Compiling-the-Firmware.md +++ b/Compiling-the-Firmware.md @@ -1,11 +1,11 @@ -I developed this using the painfully awful Arduino IDE v1.8. I originally installed v2.0 then found out you cannot upload the file data to it so use v1.8 and save yourself several hours of searching through forums for functions that are not supported even several years after its release. If you are using VS Code then you are on your own. The good news is that you only need this during the initial install and all follow on work for the module is user friendly. +I developed this using the painfully awful Arduino IDE v1.8. I originally installed v2.0 then found out you cannot upload the file data to it. Download v1.8 (legacy) and save yourself several hours of searching through forums for functions that are not supported on 2.0 even several years after its release. If you are using VS Code then you are on your own since I don't have any experience with it. The good news is that you only need this during the initial install and all follow on work for the module is user friendly. -Don't waste your time on Arduino IDE v2.0. As of January 2023, it is incomplete, and it exists only for tortured souls in search of a never realized promise. Don't do it you will be disappointed. If this situation improves I will be back to update my recommendations. +Did I mention that you shouldn't waste your time on Arduino IDE v2.0. As of January 2023, it is incomplete, and it exists only for tortured souls in search of a never realized promise. Don't do it you will be disappointed. If this situation improves I will be back to update my recommendations. First compile and upload the firmware to the ESP32. Then upload the data using the Sketch Data upload tool. You will be happy to know that once the initial install is done you don't have to go through all these hoops to update the firmware or the LittleFS file system if you are using an ESP32S-WROOM-32 module. I created a utility that is part of the software to do this task but it is a chicken/egg thing where you need the hen on the ESP32 to hatch the egg. You can install the future firmware and the applicaton files remotely. So you can put the ESPSomfy RTS module into a remote location. # Prerequisites -You must first install the Arduino IDE v1.8 which you will find on the [Arduino Software Site](https://www.arduino.cc/en/software). Install what they call the `Legacy IDE` for the platform you are developing on. Then follow the instructions to configure it for your ESP32 board. Make sure you use a USB data cable not one of the ones that is only for charging. If you cannot connect to your ESP32 then this is likely the problem. +You must first install the Arduino IDE v1.8 which you will find on the [Arduino Software Site](https://www.arduino.cc/en/software). Install what they call the `Legacy IDE` for the platform you are developing on. Then follow the instructions to configure it for your ESP32 board. Make sure you use a ***USB data cable*** not one of the ones that is only for charging. If you cannot connect to your ESP32 then this is likely the problem. To compile the firmware you will need to include four libraries. To install them, navigate to `Sketch` -> `Install Library`. Some of these libraries may be installed by default when you installed the Arduino IDE. They are listed below in the least likelihood of being installed already. @@ -22,10 +22,12 @@ This project uses the file system on the ESP32. Follow the instructions found h # Compile and Upload -Once you have set up the environment press the arrow button at the top left of the Arduino IDE and it will begin compiling the software then upload when it is done. If it is successful it will show in the console area at the bottom of the IDE. +Once you have set up the environment press the arrow button at the top left of the Arduino IDE and it will begin compiling the software then upload when it is done. Bear in mind that this takes a bit of time to compile. If it is successful it will show in the console area at the bottom of the IDE. # Upload the File System -All of the files required to build the file system are included in the `/data/` directory of the repository. When you click on the menu `Tool` -> `ESP32 Sketch Data Upload` it will compress these files into the file system layout and upload it to the ESP32. If you have the Serial Monitor open, close it before you perform this operation as it will fail if it is open. +All of the files required to build the file system are included in the `/data/` directory of the repository. When you click on the menu `Tool` -> `ESP32 Sketch Data Upload` it will compress these files into the file system layout and upload it to the ESP32. If you have the Serial Monitor open, close it before you perform this operation as it will fail if it is open. + +The good news is that it will give you some innocuous message about how the port is busy. So you don't do something silly like shut everything down, open the serial monitor and try it repeatedly. Once you have completed compiling and uploading the sketch you are done with the arduous part. Hopefully you have not spent all your F-Bombs on this process and have some left for bombing other targets. I am seeking easier ways so if you have a suggestion feel free to open an issue describing it.