Skip to content

Commit 44f1176

Browse files
authored
Some minor fix-ups that I forgot to check-in (easytarget#168)
* Some minor fixups that I forgot to checkin * fewer branch builds
1 parent 03b0982 commit 44f1176

File tree

2 files changed

+24
-11
lines changed

2 files changed

+24
-11
lines changed

.travis.yml

Lines changed: 12 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -7,18 +7,23 @@ os:
77

88
dist: focal
99

10+
branches:
11+
only:
12+
- master
13+
14+
1015
before_script:
1116
- "export DISPLAY=:99.0"
1217
- sleep 3 # give xvfb some time to start
13-
- wget http://downloads.arduino.cc/arduino-1.8.13-linux64.tar.xz
14-
- tar xf arduino-1.8.13-linux64.tar.xz
15-
- mv arduino-1.8.13 $HOME/arduino_ide
18+
- wget http://downloads.arduino.cc/arduino-1.8.15-linux64.tar.xz
19+
- tar xf arduino-1.8.15-linux64.tar.xz
20+
- mv arduino-1.8.15 $HOME/arduino_ide
1621
- cd $HOME/arduino_ide/hardware
1722
- mkdir esp32
1823
- cd esp32
19-
- wget https://github.com/espressif/arduino-esp32/archive/refs/tags/1.0.6.tar.gz
20-
- tar -xzf 1.0.6.tar.gz
21-
- mv arduino-esp32-1.0.6/ esp32
24+
- wget https://github.com/espressif/arduino-esp32/archive/refs/tags/2.0.0.tar.gz
25+
- tar -xzf 2.0.0.tar.gz
26+
- mv arduino-esp32-2.0.0/ esp32
2227
- cd esp32/tools
2328
- python --version
2429
- python get.py
@@ -28,7 +33,7 @@ before_script:
2833
script:
2934
- cd $TRAVIS_BUILD_DIR
3035
- export PATH="$HOME/arduino_ide:$PATH"
31-
- arduino --board esp32:esp32:esp32:PartitionScheme=default,FlashFreq=80 --pref compiler.warning_level=all --save-prefs
36+
- arduino --board esp32:esp32:esp32:PSRAM=enabled,PartitionScheme=min_spiffs,CPUFreq=240,FlashMode=qio,FlashFreq=80,DebugLevel=none --pref compiler.warning_level=all --save-prefs
3237
- arduino --verbose --verify esp32-cam-webserver.ino
3338
- cp --preserve --verbose myconfig.sample.h myconfig.h
3439
- arduino --verbose --verify esp32-cam-webserver.ino

README.md

Lines changed: 12 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -1,4 +1,4 @@
1-
# ESP32-CAM example revisited. &nbsp;&nbsp;&nbsp; <span title="Master branch build status">[![CI Status](https://travis-ci.org/easytarget/esp32-cam-webserver.svg?branch=master)](https://travis-ci.org/github/easytarget/esp32-cam-webserver)</span> &nbsp;&nbsp; <span title="ESP EYE">![ESP-EYE logo](Docs/logo.svg)</span>
1+
# ESP32-CAM example revisited. &nbsp;&nbsp;&nbsp; <span title="Master branch build status">[![CI Status](https://travis-ci.com/easytarget/esp32-cam-webserver.svg?branch=master)](https://travis-ci.com/github/easytarget/esp32-cam-webserver)</span> &nbsp;&nbsp; <span title="ESP EYE">![ESP-EYE logo](Docs/logo.svg)</span>
22

33
## Taken from the ESP examples, and expanded
44
This sketch is a extension/expansion/rework of the 'official' ESP32 Camera example sketch from Espressif:
@@ -46,13 +46,17 @@ https://randomnerdtutorials.com/esp32-cam-troubleshooting-guide/
4646
The ESP itself is susceptable to the usual list of WiFi problems, not helped by having small antennas, older designs, congested airwaves and demanding users. The majority of disconnects, stutters and other comms problems are simply due to 'WiFi issues'. The AI-THINKER camera module & esp32 combination is quite susceptable to power supply problems affecting both WiFi conctivity and Video quality; short cabling and decent power supplies are your friend here; also well cooled cases and, if you have the time, decoupling capacitors on the power lines.
4747

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.
49+
* You can check the `/dump` page of the cam to see if it currently reports the camera as streaming or not.
4950

50-
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+
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.
52+
53+
Note that I do not respond to any Private Messages (via github, hackaday, or wherever) for support.
5154

5255
## Setup:
5356

5457
* For programming you will need a suitable development environment, I use the Arduino IDE, but this code should work in the Espressif development environment too.
55-
* Make sure you are using the [latest version](https://www.arduino.cc/en/main/software#download) of the IDE and then follow [This Guide](https://github.com/espressif/arduino-esp32/blob/master/docs/arduino-ide/boards_manager.md) to set up the Espressif Arduino core for the IDE.
58+
* Make sure you are using the [latest version](https://www.arduino.cc/en/main/software#download) of the IDE and then follow [This Guide](https://docs.espressif.com/projects/arduino-esp32/en/latest/installing.html) to set up the Espressif Arduino core for the IDE.
59+
* _I do not recommend or support running with development builds of either the IDE or the ESP arduino core._
5660
* If you have a development board (anything that can be programmed via a standard USB cable/jack on the board itself) you are in luck. Just plug it in and skip ahead to the [config](#config) section. Remember to set your board model.
5761
* The AI-THINKER board requires use of an external **3.3v** serial adapter to program; I use a `FTDI Friend` adapter, for more about this read AdaFruits excellent [FTDI Friend guide](https://learn.adafruit.com/ftdi-friend).
5862
* Be careful not to use a 5v serial adapter since this will damage the ESP32.
@@ -115,7 +119,11 @@ I would also like to shoutout to @jmfloyd; who suggested rotating the image in t
115119

116120
![The stream viewer](Docs/streamview.png)<br>*Standalone StreamViewer; No decoration or controls, the image is resizable, and you can doubleclick it for fullscreen*
117121

118-
![The info page](Docs/infodump.png)<br>*Boring Details*
122+
![The info page](Docs/infodump.png)<br>*Boring Details, useful when debugging or if you want to check stats*
123+
124+
### API
125+
The communications between the web browser and the camera module can also be used to send commands directly to the camera (eg to automate it, etc) and form, in effect, an API for the camera.
126+
* I have [documented this here](https://github.com/easytarget/esp32-cam-webserver/blob/master/API.md).
119127

120128
## Notes:
121129

0 commit comments

Comments
 (0)