Adding Waveshare ESP32-S3-Eth

[jharvey]

I'm attempting to add the Waveshare ESP32-S3-ETH on the list of options. As I write this, my fork compiles and my PC can see it's WiFi. I can get the 192.168.4.1 page to display. However it complains that the camera is not detected. The web page log notes this.

[00:00:04.929 WARN setup] Startup Failure: Camera init error 0x105:ESP_ERR_NOT_FOUND on CAMERA_MODEL_Waveshare_ESP32_S3_ETH

Copy of the web page with all it's notes found here https://github.com/jharvey/ESP32-CAM_MJPEG2SD-JH/raw/refs/heads/master/Misc_Docs/Startup%20Failure.html

I modified camera_pins.h adding this

#elif defined(CAMERA_MODEL_Waveshare_ESP32_S3_ETH)
// Waveshare ESP32-S3-ETH per schematic found here https://files.waveshare.com/wiki/ESP32-S3-ETH/ESP32-S3-ETH-Schematic.pdf
#define CAM_BOARD "CAMERA_MODEL_Waveshare_ESP32_S3_ETH"
#define PWDN_GPIO_NUM    -1 //
#define RESET_GPIO_NUM   -1 // Hmmm, should this be GPIO8 Power_CAM?
#define XCLK_GPIO_NUM    3  //
#define SIOD_GPIO_NUM    48 //
#define SIOC_GPIO_NUM    47 //

#define Y9_GPIO_NUM      18 //D7
#define Y8_GPIO_NUM      15 //D6
#define Y7_GPIO_NUM      38 //D5
#define Y6_GPIO_NUM      40 //D4
#define Y5_GPIO_NUM      42 //D3
#define Y4_GPIO_NUM      46 //D2
#define Y3_GPIO_NUM      45 //D1
#define Y2_GPIO_NUM      41 //D0
#define VSYNC_GPIO_NUM   1  // Potentail for GP16, but that's normally NC
#define HREF_GPIO_NUM    2  //
#define PCLK_GPIO_NUM    39 //

#define USE_WS2812          // Use SK6812 rgb led   
#ifdef USE_WS2812
#define LED_GPIO_NUM 21    // SK6812 rgb led NOTE GPIO4 is normally NC
#else
#define LED_GPIO_NUM -1    // don't use this if not defined to be used. 
#endif
// Define SD Pins
#define SD_MMC_CLK 13      //
#define SD_MMC_CMD 11      // CMD/DI/MOSI
#define SD_MMC_D0 12       // DAT0/D0/MISO
// Define Mic Pins (DOES NOT have NATIVE Mic)
#define I2S_SD -1          // I2S Microphone
#define I2S_WS -1
#define I2S_SCK -1 

I modified appGlobals.h added CAMERA_MODEL_Waveshare_ESP32_S3_ETH, and commenting out the default #define

// User's ESP32S3 cam board
#elif defined(CONFIG_IDF_TARGET_ESP32S3)
//#define CAMERA_MODEL_FREENOVE_ESP32S3_CAM
...
//#define CAMERA_MODEL_XENOIONEX
#define CAMERA_MODEL_Waveshare_ESP32_S3_ETH
//#define AUXILIARY
#endif

I'm not sure what to do about GPIO8, which provides power to the camera module. This issue could be my problem. I added this to line 27 of ESP32-CAM_MJPEG2SD-JH.ino I tried HIGH, LOW, as well I tried GPIO8 for the reset in camera_pins.h. So far it still fails to find the camera. I'll see if I can

  pinMode(8, OUTPUT); //Set pin 13 as an 'output' pin as we will make it output a voltage.   
  digitalWrite(8, HIGH); //HIGH); //This turns on pin 13/supplies it with 3.3 Volts. 

I know this board works, I was able to get a Waveshare demo to display video stream over it's ethernet connector. Any suggestions / comments / help would be welcomed. I don't know much about the camera signals, I'll likely attempt to connect connect a scope to see if I see anything interesting.

[s60sc]

Not familiar with that board
Pin setup looks ok
Check if camera is receiving power - a GPIO cannot supply power to the cam, it can only switch a mosfet which supplies power

[jharvey]

Power supply looks like this. Power_CAM is connected to GPIO8.

[jharvey]

I guess I'll review the Waveshare code to see if I can find a timing issue with that power pin. I'm not sure why they used power like this instead of the reset pin.

[s60sc]

similar setup to CAMERA_MODEL_AI_THINKER with pin switching mosfet which supplies power to LDOs
try assign GPIO8 to PWDN_GPIO_NUM

[jharvey]

Winner winner chicken dinner. I've got a picture now. It gets really hot. So heat sink will be added soon.

Next up let's see if I can get the LED to do something.

[jharvey]

I seem to be having some troubles with the WS2812 lamp. Perhaps I'm not following how this lamp should work.

My serial monitor and web log both note this.
10:22:34.651 -> [00:00:04.892 setupLamp] Setup WS2812 Lamp Led on pin 4

My lamp button is set to manual, and it's greyed out here. When I click it I get no change in the LED, it stays off.

Edit Config has this.

My camera_pins.h has this

#define USE_WS2812
#define LED_GPIO_NUM     4  // WS2812B rgb led NOTE GPIO21 is normally NC

Should I expect when I click that grey flashlight that the LED should come on?

[s60sc]

thats a microphone icon, lamp control is under Camera Control
is correct pin defined? waveshare wiki states:

This program uses GPIO21 to control a WS2812 RGB LED

[jharvey]

How do I control the lamp?

[jharvey]

@s60sc I verified with a different example program the WS2818 is on GPIO21 not 4. I'm trying to get this working with 21 instead of 4.

I posted my current files here https://github.com/jharvey/ESP32-CAM_MJPEG2SD that should show any additional details which may not be summarized below.

In camera_pins.h I have the below. The camera and SD card work, so I'm reasonably certain this configuration is being used properly by the #define statements.

#define PCLK_GPIO_NUM    39 //

#define USE_WS2812          // This board has a WS2812 RGB LED, so lets define it. 
#define LED_GPIO_NUM     21  // WS2812B rgb led NOTE GPIO21 is normally NC, schematic notes it should be GPIO4, but it's 21

// Define SD Pins
#define SD_MMC_CLK 7        //
#define SD_MMC_CMD 6        // CMD/DI/MOSI
#define SD_MMC_D0 5         // DAT0/D0/MISO

I tried changing that to the below, which seems to be the more common method for specifying the RGB led. However it produces the same results, lamp not included and appears the lamp is not working.

#define USE_WS2812 // Use SK6812 rgb led   
#ifdef USE_WS2812
#define LED_GPIO_NUM 21 // WS2812B rgb led NOTE GPIO21 is normally NC, schematic notes it should be GPIO4, but it's 21
#else
#define LED_GPIO_NUM -1 // no LED 
#endif

In the web interface edit-config --> peripherals it notes it's trying to use pin 4 for the lamp. When I attempt to change it to 21, it produces an error message saying it's not included. Here's the web log snippet.

[00:00:07.519 loop] =============== Total tasks: 18 ===============

[00:00:09.475 isNight] Night time
[01:47:27.295 showLocalTime] Got current time from browser: 11/05/2025 01:47:27 with tz: GMT0
[01:29:47.303 wsHandler] Websocket connection: 53
[01:29:50.377 wsHandler] Websocket connection: 53
[01:30:01.080 WARN updateStatus] Trying to config lampPin but feature not included
[01:30:03.532 setAlarm] Alarm scheduled at 12/05/2025 01:00:00
[01:30:04.107 getExtIP] External IP: 24.245.125.239
[01:30:04.114 doAppPing] Daily rollover

Does this mean I need to do a #define or something like that? I noodled around in the code but didn't manage to find any that need to be defined. I'm not sure why the lamp would not be included.

In arduino-ide tools I enabled erase all flash. However that didn't help. I think I managed to clear my browser cache as well, but still no luck.

Any suggestions or comments would be welcomed.

[s60sc]

in appGlobals.h
#define INCLUDE_PERIPH false // peripherals.cpp (servos, PIR, led etc)
set to true

[jharvey]

LED is confirmed to be working.

I would like to encourage adding the below to camera_pins.h this board has working SD, camera, RGB light. Of course other features could be added to the provided IO headers.

#elif defined(CAMERA_MODEL_Waveshare_ESP32_S3_ETH)
// Waveshare ESP32-S3-ETH per schematic found here https://files.waveshare.com/wiki/ESP32-S3-ETH/ESP32-S3-ETH-Schematic.pdf
#define CAM_BOARD "CAMERA_MODEL_Waveshare_ESP32_S3_ETH"
#define PWDN_GPIO_NUM    8  // Drives MOSFET's for camera power supplies. 
#define RESET_GPIO_NUM   -1 // 
#define XCLK_GPIO_NUM    3  // Clock
#define SIOD_GPIO_NUM    48 // SIO_DAT
#define SIOC_GPIO_NUM    47 // SIO_CLK

#define Y9_GPIO_NUM      18 // D7
#define Y8_GPIO_NUM      15 // D6
#define Y7_GPIO_NUM      38 // D5
#define Y6_GPIO_NUM      40 // D4
#define Y5_GPIO_NUM      42 // D3
#define Y4_GPIO_NUM      46 // D2
#define Y3_GPIO_NUM      45 // D1
#define Y2_GPIO_NUM      41 // D0
#define VSYNC_GPIO_NUM   1  // Potential for GP16, but that's normally NC
#define HREF_GPIO_NUM    2  //
#define PCLK_GPIO_NUM    39 //

#define USE_WS2812          // This board has a WS2812 RGB LED, so lets define it. 
#define LED_GPIO_NUM     21  // WS2812B RGB led NOTE GPIO21 is normally NC, schematic notes it should be GPIO4, but it's 21

// Define SD Pins
#define SD_MMC_CLK 7        //
#define SD_MMC_CMD 6        // CMD/DI/MOSI
#define SD_MMC_D0 5         // DAT0/D0/MISO
// Chip select pin is GPIO4, this has 10k pull up, so non-configured pin will default to being selected, but beware that pin may be important. 

My board settings can be found here https://github.com/jharvey/ESP32-CAM_MJPEG2SD/blob/master/Misc_Docs/Waveshare_ESP32-S3-ETH/Arduino-Tools-Menu-settings.png

It appears that the yellobyte driver is similar and includes features for the onboard JTAG debugger. It seems like it's still in development and doesn't seem to always show up. I understand the ESP32-S3 intergrated JTAG debugger got initial support in 2.3.0, so the internal JTAG is still very young at the time of writing this. I also includes a copy of my launch.json file incase it's useful. https://github.com/jharvey/ESP32-CAM_MJPEG2SD/blob/master/Misc_Docs/Waveshare_ESP32-S3-ETH/Arduino_IDE_Board-Manager.png

[jharvey]

I see you already imported the file ~2 weeks ago. Line 558 is pin 4, it should be updated to pin 21

Issue tracker created #609

[Julian-Hines]

To: JHarvey;
I have used the standard s60sc WiFi based sketch on one of my projects and was thinking of trying to convert it to use a Waveshare POE camera unit, but gave up when I realised it was beyond my current C++ skills. Then I found a link to your version and thought "this is a godsend"! So I foolishly went out and bought more cameras, a POE router etc. I have the option of just reverting to the standard sketch, I would prefer to get your version working.

The trouble is; when I attempt to compile it, I get two types of error (I have kept the 'master' part of the name as I do not want to overwrite my current version, but changed the name of the .ino file to match, so that is not the source of the problems):

C:\Users\jules\Documents\Arduino\Projects\Window\ESP32-CAM_MJPEG2SD-master\ESP32-CAM_MJPEG2SD-master\motionDetect.cpp:59:71: error: 'jpg_scale_t' has not been declared
59 | static bool jpg2rgb(const uint8_t* src, size_t src_len, uint8_t* out, jpg_scale_t scale);
| ^~~~~~~~~~~
C:\Users\jules\Documents\Arduino\Projects\Window\ESP32-CAM_MJPEG2SD-master\ESP32-CAM_MJPEG2SD-master\motionDetect.cpp: In function 'bool checkMotion(camera_fb_t*, bool, bool)':
C:\Users\jules\Documents\Arduino\Projects\Window\ESP32-CAM_MJPEG2SD-master\ESP32-CAM_MJPEG2SD-master\motionDetect.cpp:184:54: error: 'jpg_scale_t' was not declared in this scope
184 | if (!jpg2rgb((uint8_t*)fb->buf, fb->len, rgb_buf, (jpg_scale_t)scaling)) return motionStatus;
| ^~~~~~~~~~~
C:\Users\jules\Documents\Arduino\Projects\Window\ESP32-CAM_MJPEG2SD-master\ESP32-CAM_MJPEG2SD-master\motionDetect.cpp: At global scope:
C:\Users\jules\Documents\Arduino\Projects\Window\ESP32-CAM_MJPEG2SD-master\ESP32-CAM_MJPEG2SD-master\motionDetect.cpp:367:71: error: 'jpg_scale_t' has not been declared
367 | static bool jpg2rgb(const uint8_t* src, size_t src_len, uint8_t* out, jpg_scale_t scale) {
| ^~~~~~~~~~~
C:\Users\jules\Documents\Arduino\Projects\Window\ESP32-CAM_MJPEG2SD-master\ESP32-CAM_MJPEG2SD-master\motionDetect.cpp: In function 'bool jpg2rgb(const uint8_t*, size_t, uint8_t*, int)':
C:\Users\jules\Documents\Arduino\Projects\Window\ESP32-CAM_MJPEG2SD-master\ESP32-CAM_MJPEG2SD-master\motionDetect.cpp:374:19: error: 'esp_jpg_decode' was not declared in this scope; did you mean 'esp_jpeg_decode'?
374 | esp_err_t res = esp_jpg_decode(src_len, scale, _jpg_read, _rgb_write, (void*)&jpeg);
| ^~~~~~~~~~~~~~
| esp_jpeg_decode
exit status 1

Compilation error: 'jpg_scale_t' has not been declared

I am currently using Arduino IDE 2.3.6 and copied all your settings etc. I have tried various potential solutions and, whilst I can remove the jpg_scale_t error, using esp_jpeg_decode just seems to lead to more errors.

Any suggestions?

[jharvey]

Hmm my copy is probably broken. I was working on a PCB layout then got distracted by life. I understand the original repo has had many changes from when I was last messing around with it. I had issues with the POE as I ordered the non POE version of the wave share boards. I recall I was able to get it to work over WiFi when powered external.

I understand another person has made good progress with the wave share boards. I've been away from this for a while now.

[s60sc]

see #628
compile with arduino-ep32 library v3.2.1 until code rewoked for v3.3.0

[Julian-Hines]

Thanks, compiled correctly.