https://github.com/avan1235/esp32-cam

https://github.com/avan1235/esp32-cam

Last synced: about 10 hours ago
JSON representation

• Host: GitHub
• URL: https://github.com/avan1235/esp32-cam
• Owner: avan1235
• Created: 2022-11-10T18:46:27.000Z (almost 2 years ago)
• Default Branch: master
• Last Pushed: 2023-07-01T16:14:41.000Z (over 1 year ago)
• Last Synced: 2023-07-01T17:23:47.084Z (over 1 year ago)
• Language: C
• Size: 76.2 KB
• Stars: 0
• Watchers: 1
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md

Awesome Lists containing this project

README

        
# ESP32-CAM web server camera

## Project goals

- ✅ provide custom environment for development on ESP32-CAM with Docker and CLion

- ✅ implement ESP32 camera stream over websocket

- ✅ implement ESP32 camera stream over http multipart

- ✅ implement ESP32 control using REST API

- ✅ add options to create access point or connect to an existing station

- ✅ provide simple js client served by ESP32

- ✅ provide sample of python client with opencv

## Running project

Use environment defined in [`env`](./env) directory. It contains script for starting and stopping

docker environment with ESP IDF with camera installed.

You can easily connect to this environment from CLion. Just use toolchains configuration

and select a remote toolchains option to connect to image over ssh.

By default, script shares with docker image `/DISPLAY_DEV/ttyUSB0` device which is usually an ESP32

module connected to USB port. You should adjust this configuration to your needs and rerun

[`start.sh`](./env/start.sh) script (you can add `--no-device` option as well).

## Build configuration

You should configure your build with

```bash

idf.py menuconfig

```

executed in remote container.

It allows to change compiler options and log level as well as manage all modules from ESP IDF.

It is standard procedure to update configuration from IDF when version of SDK has changed.

## Flashing project

To flash project to ESP32, open terminal on remote container with action

`Open Remote Host Terminal` (you can find it with `Ctrl+Shift+A`) and use

```bash

idf.py flash monitor

```

After flashing compiled program to ESP32, serial monitor will be opened in console,

so you can easily debug log data in terminal. You can stop it with `Ctrl+]`

## Running clients

### Browser clients

You can find two browser clients implementation available in the firmware: 

1. websocket client after opening `http://[esp-ip]/`

2. http multipart client after opening `http://[esp-ip]/stream`

### Code clients

You can find sample python websocket client in [camera_demo.py](./client/camera_demo.py) file.

It connects with websocket protocol and samples frame from camera. It needs a proper configuration

of camera IP (if you connect to camera AP then it might work out of the box).