Skip to content

Commit 6d04de5

Browse files
committed
Part 3 of the blog published, added section **Impatient?** which corresponds to first release
1 parent 6a78c26 commit 6d04de5

File tree

1 file changed

+28
-3
lines changed

1 file changed

+28
-3
lines changed

README.md

Lines changed: 28 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -6,9 +6,11 @@ Source code that accompanies **A Wi-Fi Switch for Domoticz using a XIAO ESP32C3:
66

77
+ [*Part 1 - Demonstration Projects*](https://sigmdel.ca/michel/ha/xiao/xiao_esp32c3_wifi_switch_1_en.html)
88
+ [*Part 2 - Asynchronious Web Page Updates*](https://sigmdel.ca/michel/ha/xiao/xiao_esp32c3_wifi_switch_2_en.html)
9-
+ *Part 3 - Better User Experience...*
9+
+ [*Part 3 - Better User Experience...*](https://sigmdel.ca/michel/ha/xiao/xiao_esp32c3_wifi_switch_3_en.html)
1010
+ [*Part 4 - Commands - version 0.0.8*](https://sigmdel.ca/michel/ha/xiao/xiao_esp32c3_wifi_switch_4_en.html)
1111

12+
+ *Part 5 - Wi-Fi Manager* - (forthcoming)
13+
1214
## Overview of the Wi-Fi Switch
1315

1416
The goal is to try to reproduce the basic functionality of Theo Arends' powerful [Tasmota](https://github.com/arendst/Tasmota) firmware which is used in many home automation devices. This is very ambitious, and consequently a step-by-step approach will be adopted. The end result will not be equivalent to Tasmota by any means but hopefully something will have been learned.
@@ -26,9 +28,32 @@ All projects are independent and self-contained.
2628

2729
Private copies of the needed libraries are provided in the shared [`libraries`](libraries) directory, so it should be possible to compile all the projects without installing any library.
2830

29-
All projects will compile and run in the PlatformIO and Arduino IDEs as long as the ESP32 platform in installed and the correct board is selected. Details are in section 6 of [A Wi-Fi Switch for Domoticz using a XIAO ESP32C3 - Part 1](https://sigmdel.ca/michel/ha/xiao/xiao_esp32c3_wifi_switch_1_en.html#compile1).
31+
All projects will compile and run in the PlatformIO and Arduino IDEs as long as the ESP32 platform in installed and the correct board is selected. In the Arduino IDE it will be necessary to specify the *Sketchbook location* in the IDE *Preferences* in order to use the private copies of the libraries. Details are in section 6 of [A Wi-Fi Switch for Domoticz using a XIAO ESP32C3 - Part 1](https://sigmdel.ca/michel/ha/xiao/xiao_esp32c3_wifi_switch_1_en.html#compile1).
32+
33+
## Impatient?
34+
35+
Just want to test-drive the latest version? Follow these steps:
36+
37+
1. Download the `xiao_esp32c3_wifi_switch.zip` archive from the current release
38+
2. Extract the `xiao_esp32c3_wifi_switch-master` directory on a drive. Let's call the full path to this directory `project_dir`.
39+
3. Copy the appropriate hardware driver, `hardware.cpp` from `project_dir/xiao_esp32c3/hdw_xxx/hardware.cpp` -where '`xxx` is `alt`, `kit`, or `mock`) to `project_dir/xiao_esp32c3/wifi_switch/hardware.cpp`.
40+
4. Edit the pin definitions in `project_dir/xiao_esp32c3/wifi_switch/hardware.cpp` if necessary.
41+
5. Edit the default values in `project_dir/xiao_esp32c3/wifi_switch/user_config.h_template` and save as `project_dir/xiao_esp32c3/wifi_switch/user_config.h`.
42+
6. If using the Arduino IDE:
43+
1. set *Preferences' Sketchbook location* to `project_dir/xiao_esp32c3/`.
44+
2. open the `project_dir/xiao_esp32c3/wifi_switch/wifi_switch.ino` sketch.
45+
3. make sure the `ESP32 by Espressif` boards definition is installed with the Boards manager.
46+
4. select the XIAO_ESP32C3 board.
47+
5. select the appropriate port.
48+
6. compile and upload the sketch.
49+
7. open the serial monitor and view the log messages to find the IP address of the XIAO.
50+
51+
7. If using PlatformIO:
52+
1. open the `project_dir/xiao_esp32c3/` project.
53+
2. compile and upload the project.
54+
55+
Good luck.
3056

31-
3257
### Opening a project in PlatformIO
3358

3459
Open a PlatformIO project by clicking on the Quick Access `Open Project` button in the Home page of PlatformIO. Then navigate to the project directory (such as `01_simplified_hdw_version`) which contains the project configuration file `platformio.ini` and click on the `Open "<project name>".

0 commit comments

Comments
 (0)