Set up Arduino
To develop and recompile firmware, please follow the steps below to set up the development environment.
①Download and install Arduino
It is recommended to download version 1.8. X in this tutorial. Download and install the software from the Arduino official website. The specific installation process will not be demonstrated here.
②Install ESP32 and ESP8266 board libraries
ESP32 is used for Onstep firmware. ESP8266 is used for WIFI firmware.
Go to File ->Preferences to add the development board management address.
Copy the following URL into the red box.
Note that different countries and regions may not be able to download and install development boards from the following website due to network issues. If you are unable to download, please search for other available websites on your own. (e.g. Google search for Arduino installation ESP32 development board)
https://raw.githubusercontent.com/espressif/arduino-esp32/gh-pages/package_esp32_index.json
http://arduino.esp8266.com/stable/package_esp8266com_index.json
After copying is complete, click OK to close the window.
Open the development board manager and install the ESP32 and ESP8266 development boards
ESP32 Recommended version 2.0.17
ESP8266 Recommended version 2.7.4
③Install the required library
Install the libraries required for firmware compilation.
The standard kit purchased in our store only requires installation of Rtc By Makuna, recommended version 2.3.5
If you need to modify other functions on the basis of the standard kit or use other brands of Onstep kits, please install other required library files by yourself.
④Download Onstep firmware
Download the latest Onstep firmware program from Github
OnstepX firmware ：GitHub - hjd1964/OnStepX
SmartWebServer（WIFI）firmware ：GitHub - hjd1964/SmartWebServer: Smart Web Server for OnStep and OnStepX
After decompressing the file, remove the - main suffix from the file name. Otherwise, the project cannot be opened properly. After deletion, it will be as shown in the following figure.
⑤Replace Default Config file
The firmware program downloaded from Github is the default Config configuration file and has not been parameter adapted for Onstep in our store. Therefore, before compiling and modifying, it is necessary to replace the Config file with the file we provided.
Download the Config configuration file from the download center
Select the version you purchased, as shown in the picture, and choose the configuration of EXOS2 V4 Pro. Copy and replace two files with the same name in the OnstepX program file.
After the replacement is completed, open the project. At this point, the development environment has been set up. Before starting your custom modifications, compile the project once to ensure a successful compilation without any errors.
Select ESP32 Dev Module for the development board, and follow the same settings as shown in the diagram. Choose the Com port corresponding to Onstep for the Port. Choosing the wrong port will result in download failure.
Click on the top left corner ✔ Compile button, wait for a few minutes, when the bottom left corner displays' Done compiling ', it means the compilation is successful.
Now you can start your custom modifications. After each modification is completed, you can click the compile button in the upper left corner to check if there are any errors in the modifications.
OnstepX Firmware
WIFI Firmware
If an error occurs during the modification process and you forget how to change it back, simply copy and replace the two Config files again.
When all modifications have been completed and the compilation has passed without any errors, please follow the next tutorial to download the program into the control box.