Skip to content

Commit 04a94ed

Browse files
committed
[ci skip] Add link to common issues in discussions
1 parent f4bde8b commit 04a94ed

File tree

1 file changed

+12
-13
lines changed

1 file changed

+12
-13
lines changed

README.md

Lines changed: 12 additions & 13 deletions
Original file line numberDiff line numberDiff line change
@@ -13,7 +13,7 @@ But expanded with:
1313
* Over The Air firmware updates
1414
* Lots of minor fixes and tweaks, documentation etc.
1515

16-
And 'reduced' by removing the Face Recognition features
16+
And 'reduced' by removing the Face Recognition features
1717
* **If you want to try the Face Recognition features** please use the [`3.x` maintenance branch](https://github.com/easytarget/esp32-cam-webserver/tree/3.x), which still recieves bugfixes, but is not receiving any further development.
1818
* They were a demo, only worked in low resolution modes, did not preserve the face database between power cycles, and were of little use in real-world applications.
1919
* There are other (specialised) sketches for the ESP-CAM that do use face recognitioni more effectively, if this is your thing :-)
@@ -33,7 +33,7 @@ I have four [AI-THINKER ESP32-CAM](https://github.com/raphaelbs/esp32-cam-ai-thi
3333
https://github.com/raphaelbs/esp32-cam-ai-thinker
3434
* The AI thinker wiki can be quite informative, when run through an online translator and read sensibly:
3535
https://wiki.ai-thinker.com/esp32-cam
36-
* Default pinouts are also included for WRover Kit, ESP Eye and M5Stack esp32 camera modules.
36+
* Default pinouts are also included for WRover Kit, ESP Eye and M5Stack esp32 camera modules.
3737
I do not have any of these boards, so they are untested by me. Please [let me know](https://github.com/easytarget/esp32-cam-webserver/issues) if you find issues or have a board not [in the list](./camera_pins.h).
3838

3939
## Troubleshooting:
@@ -48,7 +48,11 @@ The ESP itself is susceptible to the usual list of WiFi problems, not helped by
4848
A basic limitation of the sketch is that it can can only support one stream at a time. If you try to connect to a cam that is already streaming (or attempting to stream) you will get no response and, eventually, a timeout. The stream itself is a [MJPEG stream](https://en.wikipedia.org/wiki/Motion_JPEG), which relies on the client (the web browser) to hold the connection open and request each new frame in turn via javascript. This can cause errors when browsers run into Javascript or caching problem, fail to request new frames or refuse to close the connection.
4949
* You can check the `/dump` page of the cam to see if it currently reports the camera as streaming or not.
5050

51-
The existing [issues list](https://github.com/easytarget/esp32-cam-webserver/issues?q=is%3Aissue) on Github is a good place to start if you have a specific issue not covered above.
51+
A lot of common issues with this sketch are discussed and covered in the discussion forums:
52+
53+
https://github.com/easytarget/esp32-cam-webserver/discussions/categories/common-issues
54+
55+
The existing [issues list](https://github.com/easytarget/esp32-cam-webserver/issues?q=is%3Aissue) on Github is a good place to start if you have a specific issue not covered above or in the forums.
5256

5357
Note that I do not respond to any Private Messages (via github, hackaday, or wherever) for support.
5458

@@ -74,7 +78,7 @@ Is pretty simple, You just need jumper wires, no soldering really required, see
7478
Download the latest release of the sketch from https://github.com/easytarget/esp32-cam-webserver/releases/latest
7579
- You can get the latest stable development release by cloning / downloading the `master` branch of the repo.
7680

77-
This will give you an archive file with the Version number in it, eg.`esp32-cam-webserver-3.0.zip`. Tou need to unpack this into your Arduino sketch folder, and then you need to rename the folder you just extracted to remove the version number, eg.`esp32-cam-webserver-3.0` becomes `esp32-cam-webserver`.
81+
This will give you an archive file with the Version number in it, eg.`esp32-cam-webserver-4.0.zip`. You need to unpack this into your Arduino sketch folder, and then you need to **rename the folder you extracted to remove the version number**, eg.`esp32-cam-webserver-4.0` becomes `esp32-cam-webserver`.
7882

7983
Once you have done that you can open the sketch in the IDE by going to the `esp32-cam-webserver` sketch folder and selecting `esp32-cam-webserver.ino`.
8084

@@ -84,7 +88,7 @@ By default the sketch assumes you have an AI-THINKER board, it creates an Access
8488

8589
To make a permanent config with your home wifi settings, different defaults or a different board; copy (or rename) the file `myconfig.sample.h` in the sketch folder to `myconfig.h` and edit that, all the usable defaults are in that file. Because this is your private copy of the config it will not get overwritten if you update the main sketch!
8690

87-
### Programming
91+
### Programming
8892

8993
Assuming you are using the latest Espressif Arduino core the `ESP32 Dev Module` board will appear in the ESP32 Arduino section of the boards list. Select this (do not use the `AI-THINKER` entry listed in the boiards menu, it is not OTA compatible, and will caus the module to crash and reboot rather than updating if you use it.
9094
![IDE board config](Docs/ota-board-selection.png)
@@ -107,7 +111,7 @@ Go to the URL given in the serial output, the web UI should appear with the sett
107111

108112
The WiFi details can be stored in an (optional) header file to allow easier code development, and a camera name for the UI title can be configured. The lamp and status LED's are optional, and the lamp uses a exponential scale for brightness so that the control has some finess.
109113

110-
All of the face recognition code has been removed as of V4.0; this reduces the code size enough to allow OTA programming while improving compile and programming times.
114+
All of the face recognition code has been removed as of V4.0; this reduces the code size enough to allow OTA programming while improving compile and programming times.
111115

112116
The compressed and binary encoded HTML used in the example has been unpacked to raw text, this makes it much easier to access and modify the Javascript and UI elements. Given the relatively small size of the index page there is very little benefit from compressing it.
113117

@@ -141,15 +145,10 @@ Contributions are welcome; please see the [Contribution guidelines](CONTRIBUTING
141145

142146
Time allowing; my Current plan is:
143147

144-
V4
145-
* Remove face recognition entirely;
146-
* **Done**, see the `NoFace` branch :sunglasses:
147-
* Not optional, this is a code and maintenance nightmare. V3 can be maintained on a branch for those who need it.
148+
V4
148149
* Investigate using SD card to capture images
149-
* Implement OTA and a better network stack for remembering multiple AP's, auto-config etc.
150-
* **Basic OTA is Done**, see the `NoFace` branch.
150+
* Implement a better network stack for remembering multiple AP's, auto-config etc.
151151
* Advanced (web upload) OTA might be nice to have if possible
152-
* For the Network setup I want to implement https://github.com/Hieromon/AutoConnect
153152
* UI Skinning/Theming
154153
* OSD
155154
* Temperature/humidity/pressure sensor support (bme20,dht11)

0 commit comments

Comments
 (0)