Readme text edited
Michal Zoubek
parent
ebb0e41e5f
commit
3ac6bfaa06
44
README.md
44
README.md
|
|
@ -2,7 +2,7 @@
|
||||||
|
|
||||||
This repository includes source code and firmware releases for the ESP32-cam module programmed in the Arduino IDE
|
This repository includes source code and firmware releases for the ESP32-cam module programmed in the Arduino IDE
|
||||||
|
|
||||||
This project uses other libraries. It is necessary to install them in the arduino IDE.
|
This project uses other libraries. It is necessary to install them in the Arduino IDE.
|
||||||
- App [Arduino IDE 2.3.2](https://www.arduino.cc/en/software)
|
- App [Arduino IDE 2.3.2](https://www.arduino.cc/en/software)
|
||||||
- MCU support [ESP32 2.0.15](https://github.com/espressif/arduino-esp32)
|
- MCU support [ESP32 2.0.15](https://github.com/espressif/arduino-esp32)
|
||||||
- Library [ESPAsyncWebSrv 1.2.7](https://github.com/dvarrel/ESPAsyncWebSrv)
|
- Library [ESPAsyncWebSrv 1.2.7](https://github.com/dvarrel/ESPAsyncWebSrv)
|
||||||
|
|
@ -16,12 +16,12 @@ What we need for functionality
|
||||||
- Install the necessary libraries in the Arduino IDE [ here ](#arduino_lib)
|
- Install the necessary libraries in the Arduino IDE [ here ](#arduino_lib)
|
||||||
- Arduino IDE configuration [ here ](#arduino_cfg)
|
- Arduino IDE configuration [ here ](#arduino_cfg)
|
||||||
- How to flash firmware to ESP32-cam and connect to PrusaConnect [ here ](https://help.prusa3d.com/preview/guide/esp32-cam-for-prusa-connect_673528)
|
- How to flash firmware to ESP32-cam and connect to PrusaConnect [ here ](https://help.prusa3d.com/preview/guide/esp32-cam-for-prusa-connect_673528)
|
||||||
- How to flash binnary files to ESP32-cam board from Linux/MAC/Windows [ here ](#flash_fw)
|
- How to flash binary files to ESP32-cam board from Linux/MAC/Windows [ here ](#flash_fw)
|
||||||
- How to reset configuration to factory settings [here](#factory_cfg)
|
- How to reset the configuration to factory settings [here](#factory_cfg)
|
||||||
- Status LED [ here ](#status_led)
|
- Status LED [ here ](#status_led)
|
||||||
- Schematic main board is [here](#schematic)
|
- Schematic main board is [here](#schematic)
|
||||||
- Issue with FLASH LED on the main board [here](#led_issue)
|
- Issue with FLASH LED on the main board [here](#led_issue)
|
||||||
- External WiFi antena [here](#ext_wifi)
|
- External WiFi antenna [here](#ext_wifi)
|
||||||
- Power supply [here](#power_supply)
|
- Power supply [here](#power_supply)
|
||||||
- Debug logs [here](#logs)
|
- Debug logs [here](#logs)
|
||||||
- Serial console configuration [here](#serial_cfg)
|
- Serial console configuration [here](#serial_cfg)
|
||||||
|
|
@ -29,15 +29,15 @@ What we need for functionality
|
||||||
|
|
||||||
<a name="esp32"></a>
|
<a name="esp32"></a>
|
||||||
## ESP32-CAM AI-thinker board
|
## ESP32-CAM AI-thinker board
|
||||||
It's a few dolars board with **ESP32** MCU and Camera. It's neccesary to buy a board with **camera module OV2640**. The board is sold without a programmer by default. It is possible to program it using the FTDI USB to UART converter, or purchase an official programmer for the board. We recommend purchasing a official programmer. It can save a lot of trouble with connecting and programming the board. There are currently [2 different board version](#different_mcu) but only one is compatible with the official programmer.
|
It's a few dollars board with **ESP32** MCU and Camera. It's necessary to buy a board with **camera module OV2640**. The board is sold without a programmer by default. It is possible to program it using the FTDI USB to UART converter, or purchase an official programmer for the board. We recommend purchasing an official programmer. It can save a lot of trouble with connecting and programming the board. There are currently [2 different board versions](#different_mcu), but only one is compatible with the official programmer.
|
||||||
|
|
||||||
<img src="doc/esp32-cam.jpg" width=30% height=30%>
|
<img src="doc/esp32-cam.jpg" width=30% height=30%>
|
||||||
|
|
||||||
In the next picture we can see **ESP32-CAM** board and programator for board.
|
In the following picture, we can see the **ESP32-CAM** board and the programator for the board.
|
||||||
|
|
||||||
<img src="doc/esp32_and_prog.jpg" width=30% height=30%>
|
<img src="doc/esp32_and_prog.jpg" width=30% height=30%>
|
||||||
|
|
||||||
It's neccesary use a camera version **OV2640**. If using a different camera, then it may be necessary to modify the camera's pinout, or some camera settings may not work correctly. We recommend using a camera module with a viewing angle of 120° or 160°.
|
It's necessary to use a camera version **OV2640**. If using a different camera, modification of the camera's pinout can be needed, or some camera settings may not work correctly. We recommend to use a camera module with a viewing angle of 120° or 160°.
|
||||||
|
|
||||||
These are currently known or tested camera modules:
|
These are currently known or tested camera modules:
|
||||||
|
|
||||||
|
|
@ -45,9 +45,9 @@ These are currently known or tested camera modules:
|
||||||
|-------------|------|------------|--------|-------|------------------------------------------|
|
|-------------|------|------------|--------|-------|------------------------------------------|
|
||||||
| OV2640 | 30° | 2MP | No | N/A | |
|
| OV2640 | 30° | 2MP | No | N/A | |
|
||||||
| OV2640 | 44° | 2MP | No | N/A | |
|
| OV2640 | 44° | 2MP | No | N/A | |
|
||||||
| OV2640 | 66° | 2MP | Yes | Yes | Recomended. Standard camera module |
|
| OV2640 | 66° | 2MP | Yes | Yes | Recommended. Standard camera module |
|
||||||
| OV2640 | 120° | 2MP | Yes | Yes | Recomended |
|
| OV2640 | 120° | 2MP | Yes | Yes | Recommended |
|
||||||
| OV2640 | 160° | 2MP | Yes | Yes | Recomended |
|
| OV2640 | 160° | 2MP | Yes | Yes | Recommended |
|
||||||
| OV2640 | 200° | 2MP | No | N/A | |
|
| OV2640 | 200° | 2MP | No | N/A | |
|
||||||
| OV2640 | 222° | 2MP | No | N/A | |
|
| OV2640 | 222° | 2MP | No | N/A | |
|
||||||
| OV2640IR | 160° | 2MP | Yes | Yes | |
|
| OV2640IR | 160° | 2MP | Yes | Yes | |
|
||||||
|
|
@ -78,7 +78,7 @@ At the first step we need to install support for **ESP32 board**.
|
||||||
|
|
||||||
then go to **Tools** -> **Board** -> **Boards Manager...** and install module **ESP32** by **Espressif Systems**, version **2.0.15**
|
then go to **Tools** -> **Board** -> **Boards Manager...** and install module **ESP32** by **Espressif Systems**, version **2.0.15**
|
||||||
|
|
||||||
Next step is to install the necessary libraries. Go to **Sketch** -> **Include Library** -> **Manage Libraries...** or you can use **Ctrl+Shift+I**. Then you can search for the necessary libraries and install them.
|
The next step is to install the necessary libraries. Go to **Sketch** -> **Include Library** -> **Manage Libraries...** or you can use **Ctrl+Shift+I**. Then you can search for the necessary libraries and install them.
|
||||||
|
|
||||||
- Library [ESPAsyncWebSrv by dvarrel 1.2.7](https://github.com/dvarrel/ESPAsyncWebSrv)
|
- Library [ESPAsyncWebSrv by dvarrel 1.2.7](https://github.com/dvarrel/ESPAsyncWebSrv)
|
||||||
- Library [AsyncTCP by dvarrel 1.1.4](https://github.com/dvarrel/AsyncTCP)
|
- Library [AsyncTCP by dvarrel 1.1.4](https://github.com/dvarrel/AsyncTCP)
|
||||||
|
|
@ -88,7 +88,7 @@ Next step is to install the necessary libraries. Go to **Sketch** -> **Include L
|
||||||
<a name="arduino_cfg"></a>
|
<a name="arduino_cfg"></a>
|
||||||
## Arduino IDE configuration
|
## Arduino IDE configuration
|
||||||
|
|
||||||
Board configuration in the arduino IDE 2.3.2
|
Board configuration in the Arduino IDE 2.3.2
|
||||||
- Tools -> Board -> ESP32 Arduino -> AI Thinker ESP32
|
- Tools -> Board -> ESP32 Arduino -> AI Thinker ESP32
|
||||||
- Tools -> Flash frequency -> 80MHz
|
- Tools -> Flash frequency -> 80MHz
|
||||||
- Tools -> Core Debug Level -> None
|
- Tools -> Core Debug Level -> None
|
||||||
|
|
@ -105,9 +105,9 @@ After the initial firmware upload to the MCU, it's necessary to disable this opt
|
||||||
<a name="flash_fw"></a>
|
<a name="flash_fw"></a>
|
||||||
## How to flash binnary files to ESP32-cam board from Linux/MAC/Windows
|
## How to flash binnary files to ESP32-cam board from Linux/MAC/Windows
|
||||||
|
|
||||||
To upload the firmware on the MAC or Linux platform, you must use the console. First, ensure you have installed esptool for Python. You can find it on the manufacturer's website, ESPRESSIF, [here](https://docs.espressif.com/projects/esp-at/en/latest/esp32/Get_Started/Downloading_guide.html).
|
You must use the console to upload the firmware on the MAC or Linux platform. First, ensure you have installed esptool for Python. You can find it on the manufacturer's website, ESPRESSIF, [here](https://docs.espressif.com/projects/esp-at/en/latest/esp32/Get_Started/Downloading_guide.html).
|
||||||
|
|
||||||
And command for FLASH FW is here, where **/dev/ttya0** is your serial interface for communication with the ESP32-cam board. This is command for first flash FW to MCU.
|
And command for FLASH FW is here, where **/dev/ttya0** is your serial interface for communication with the ESP32-cam board. This is the command for the first flash FW to MCU.
|
||||||
|
|
||||||
```
|
```
|
||||||
python3 -m esptool -p /dev/ttya0 -b 460800 --before default_reset --after hard_reset --chip
|
python3 -m esptool -p /dev/ttya0 -b 460800 --before default_reset --after hard_reset --chip
|
||||||
|
|
@ -144,7 +144,7 @@ However, for uploading the firmware, it's important to use this configuration of
|
||||||
- address **0x8000** - **ESP32_PrusaConnectCam.ino.partitions.bin**
|
- address **0x8000** - **ESP32_PrusaConnectCam.ino.partitions.bin**
|
||||||
- address **0x10000** - **ESP32_PrusaConnectCam.ino.bin**
|
- address **0x10000** - **ESP32_PrusaConnectCam.ino.bin**
|
||||||
|
|
||||||
Here is tool and configuration for [windows platform](https://www.espressif.com/en/support/download/other-tools)
|
Here is the tool and configuration for [windows platform](https://www.espressif.com/en/support/download/other-tools)
|
||||||
|
|
||||||
<img src="doc/how to flash chip select.jpg" width=15% height=15%>
|
<img src="doc/how to flash chip select.jpg" width=15% height=15%>
|
||||||
|
|
||||||
|
|
@ -162,7 +162,7 @@ To reset the settings to factory defaults, follow these instructions:
|
||||||
- **Plug in** the power supply.
|
- **Plug in** the power supply.
|
||||||
- Wait for **10 seconds**.
|
- Wait for **10 seconds**.
|
||||||
- After 10 seconds, the **FLASH LED will start flashing**.
|
- After 10 seconds, the **FLASH LED will start flashing**.
|
||||||
- **Disconnect** PIN **IO12** from **ground** (but do't disconnect the power supply).
|
- **Disconnect** PIN **IO12** from **ground** (but don't disconnect the power supply).
|
||||||
- After disconnecting **IO12** from **ground**, the **FLASH LED** will **stop flashing**, and the MCU will **automatically rebooted**.
|
- After disconnecting **IO12** from **ground**, the **FLASH LED** will **stop flashing**, and the MCU will **automatically rebooted**.
|
||||||
- Now the MCU is in the factory settings.
|
- Now the MCU is in the factory settings.
|
||||||
|
|
||||||
|
|
@ -202,7 +202,7 @@ One simple solution is to connect an external LED via a relay, transistor, or MO
|
||||||
|
|
||||||
<img src="doc/relay_flash_bb.png" width=40% height=40%>
|
<img src="doc/relay_flash_bb.png" width=40% height=40%>
|
||||||
|
|
||||||
Another solution is to use a LED COB or a USB LED lamp. I utilized a board from a simple USB LED lamp. The transistor has a current limitation of 500mA, and my USB lamp has a current consumption of 180mA. The original LED has a current consumption of 60-80mA, and the USB lamp has a current consumption of approximately 180mA. After calculation, the total current consumption is approximately 260mA, which falls within the current limitation of the transistor. Therefore, it is possible to solder the negative wire from the COB LED or the USB LED lamp to the transistor. The positive wire needs to be soldered to +5V.
|
Another solution is to use an LED COB or a USB LED lamp. I utilized a board from a simple USB LED lamp. The transistor has a current limitation of 500mA, and my USB lamp has a current consumption of approximately 180mA. The original LED has a current consumption of 60-80mA. After calculation, the total current consumption is approximately 260mA, which falls within the current limitation of the transistor. Therefore, it is possible to solder the negative wire from the COB LED or the USB LED lamp to the transistor. The positive wire needs to be soldered to +5V.
|
||||||
|
|
||||||
This is my USB LED lamp
|
This is my USB LED lamp
|
||||||
|
|
||||||
|
|
@ -226,7 +226,7 @@ The standard ESP32-CAM board utilizes an internal antenna on the PCB. However, t
|
||||||
<a name="power_supply"></a>
|
<a name="power_supply"></a>
|
||||||
## Power Supply
|
## Power Supply
|
||||||
|
|
||||||
The device requires a 5V power supply, with a maximum current consumption of 2A. When using the original programmer, power is supplied via a micro USB connector.
|
The device requires a 5V power supply, with a maximum current consumption of 2A. Power is supplied via a micro USB connector when using the original programmer.
|
||||||
|
|
||||||
<a name="logs"></a>
|
<a name="logs"></a>
|
||||||
## Debug logs
|
## Debug logs
|
||||||
|
|
@ -236,7 +236,7 @@ It is possible to save debug logs to a microSD card, but the card must be format
|
||||||
<a name="serial_cfg"></a>
|
<a name="serial_cfg"></a>
|
||||||
## Serial console configuration
|
## Serial console configuration
|
||||||
|
|
||||||
Currently is possible set the basicaly camera configuration during serial console. Baud speed for communication with MCU is **115200 8N1**
|
Currently, it is possible to set the basic camera configuration using the serial console. Baud speed for communication with MCU is **115200 8N1**
|
||||||
|
|
||||||
Commands for configuration have simple syntax
|
Commands for configuration have simple syntax
|
||||||
|
|
||||||
|
|
@ -244,7 +244,7 @@ Commands for configuration have simple syntax
|
||||||
|--------------|-----------|-----------|-------------|--------------------------|
|
|--------------|-----------|-----------|-------------|--------------------------|
|
||||||
| setwifissid | : | SSID | ; | \n or \r or \n\r or \r\n |
|
| setwifissid | : | SSID | ; | \n or \r or \n\r or \r\n |
|
||||||
|
|
||||||
Currently available commands are listed in the table below:
|
Currently, available commands are listed in the table below:
|
||||||
|
|
||||||
| Command | Description |
|
| Command | Description |
|
||||||
|-------------------|---------------------------------------------------------------------|
|
|-------------------|---------------------------------------------------------------------|
|
||||||
|
|
@ -253,13 +253,13 @@ Currently available commands are listed in the table below:
|
||||||
| wificonnect | Connecting to WiFi network |
|
| wificonnect | Connecting to WiFi network |
|
||||||
| mcureboot | Rebooting the MCU |
|
| mcureboot | Rebooting the MCU |
|
||||||
| commandslist | Listing currently supported commands via serial console |
|
| commandslist | Listing currently supported commands via serial console |
|
||||||
| getwifimode | Print currently WiFi mode. STA/AP/AP+STA |
|
| getwifimode | Print current WiFi mode. STA/AP/AP+STA |
|
||||||
| getwifistastatus | Print WiFi STA status. Connected/Disconnected/Connecting.... |
|
| getwifistastatus | Print WiFi STA status. Connected/Disconnected/Connecting.... |
|
||||||
| getwifistaip | Print IP address for WiFi STA |
|
| getwifistaip | Print IP address for WiFi STA |
|
||||||
| getserviceapssid | Print service AP SSID name |
|
| getserviceapssid | Print service AP SSID name |
|
||||||
| setauthtoken: | Set authentication token for Prusa Connect |
|
| setauthtoken: | Set authentication token for Prusa Connect |
|
||||||
|
|
||||||
Standard commands sequence for camera basic settings is
|
The standard command sequence for camera basic settings is
|
||||||
|
|
||||||
- setwifissid:SSID;
|
- setwifissid:SSID;
|
||||||
- setwifipass:PASSWORD;
|
- setwifipass:PASSWORD;
|
||||||
|
|
|
||||||
Loading…
Reference in New Issue