Skip to content

Commit 7f583d4

Browse files
committed
Merge branch 'develop'
2 parents d65f99a + 4e7798a commit 7f583d4

10 files changed

+2254
-1
lines changed

.gitignore

Lines changed: 6 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -30,3 +30,9 @@
3030
*.exe
3131
*.out
3232
*.app
33+
34+
pio
35+
.vscode/.browse.c_cpp.db*
36+
.vscode/c_cpp_properties.json
37+
.vscode/launch.json
38+
.vscode/ipch

M5StackCoreS3_CameraWebServer.jpg

86.5 KB
Loading

README.en.md

Lines changed: 97 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,97 @@
1+
# M5StackCoreS3_CameraWebServer
2+
3+
[日本語](README.md)
4+
5+
<img src="./M5StackCoreS3_CameraWebServer.jpg" width="480">
6+
7+
## Overview
8+
Porting of [espressif/arduino-esp32](https://github.com/espressif/arduino-esp32) example [CameraWebServer](https://github.com/espressif/arduino-esp32/blob/master/libraries/ESP32/examples/Camera/CameraWebServer) to M5Stack CoreS3 (GC0308).
9+
Access CoreS3 from a browser via WiFi to control the camera and receive streaming.
10+
11+
12+
## Required libraries
13+
* [M5Unified](https://github.com/m5stack/M5Unified)
14+
* [es32-camera](https://github.com/espressif/esp32-camera/tree/master)
15+
However, If you set platform = espressif32 and framework = arduino in platformio, esp32-camera is included in the package, so you do not need to specify es32-camera in lib_deps.
16+
* [gob_GC0308](https://github.com/GOB52/gob_GC0308)
17+
* WiFi connection available
18+
19+
## How to use
20+
Once executed, the IP address will be displayed on the screen and on the serial monitor.
21+
(This is an example, so the actual IP will vary depending on the environment.)
22+
```
23+
setup(): Camera ready use: http;//192.168.1.20 to connect
24+
```
25+
Access that IP address from your browser.
26+
27+
### When WiFi connection fails
28+
The connection is made as follows,
29+
assuming that CoreS3 has the SSID / Password of the already connected it stored.
30+
```cpp
31+
// main.cpp
32+
WiFi.begin(); // Connects to credential stored in the hardware.
33+
```
34+
Please save the credential in some way or rewrite the source.
35+
```cpp
36+
// main.cpp
37+
WiFi.begin("Your SSID", "Your password");
38+
```
39+
40+
## Browser screen description
41+
### Basic settings
42+
* Resolution
43+
The currently set camera resolution is displayed. The resolution cannot be changed.
44+
* Contrast
45+
Change the contrast.
46+
* Special Effect
47+
Change the special effect.
48+
49+
|Menu|Description|
50+
|---|---|
51+
|NoEffect|No effect|
52+
|Negative|Negative effect|
53+
|Grayscale|Grayscale effect|
54+
|RedTint|Red tint effect|
55+
|GreenTint|Green tint effect|
56+
|BlueTint|Blue tint effect|
57+
|Sepia|Sepia effect|
58+
59+
* WB Mode
60+
Change the white balance.
61+
62+
|Menu|Description|
63+
|---|---|
64+
|Auto|Automatic|
65+
|Sunny|Sunny|
66+
|Cloudy|Cloudy|
67+
|Office|Fluorescent light|
68+
|Home|Light bulb|
69+
70+
* Gain
71+
Change the gain.
72+
* H-Mirror
73+
Changes the horizontal image inversion.
74+
* V-Flip
75+
Changes the vertical image inversion.
76+
* Color Bar
77+
Color bar display ON/OFF.
78+
* Get Still
79+
Obtains a still image.
80+
* Start/Stop Stream
81+
Start/Stop receiving stream.
82+
* Save
83+
Download incoming images.
84+
* X
85+
Stop receiving stream.
86+
87+
### Advanced settings
88+
* Register Get/Set
89+
The values can be set and retrieved for the camera registers.
90+
Refer to data sheets and other sources for register and function information.
91+
**Caution** <ins>Be careful not to set inappropriate values to inappropriate registers. </ins>
92+
93+
## Changes from the original
94+
* The application is now dedicated to M5Stack Core3.
95+
* M5Unified base to work.
96+
* Modified html for GC0308.
97+
* Functions not present in GC0308 were omitted.

README.md

Lines changed: 99 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1 +1,99 @@
1-
# M5StackCoreS3_CameraWebServer
1+
# M5StackCoreS3_CameraWebServer
2+
3+
[English](README.en.md)
4+
5+
<img src="./M5StackCoreS3_CameraWebServer.jpg" width="480">
6+
7+
## 概要
8+
[espressif/arduino-esp32](https://github.com/espressif/arduino-esp32)[CameraWebServer](https://github.com/espressif/arduino-esp32/blob/master/libraries/ESP32/examples/Camera/CameraWebServer) を M5Stack CoreS3 向けに移植した物です。
9+
WiFi 経由でブラウザから CoreS3 へアクセスし、カメラの制御とストリーミング受信を行います。
10+
11+
12+
## 必要な物
13+
* [M5Unified](https://github.com/m5stack/M5Unified)
14+
* [es32-camera](https://github.com/espressif/esp32-camera/tree/master)
15+
platformio で platform = espressif32, framework = arduino なら同梱なので必要無し
16+
* [gob_GC0308](https://github.com/GOB52/gob_GC0308)
17+
* WiFi 接続可能な環境
18+
19+
## 使い方
20+
実行すると、画面とシリアルモニタに接続先 IP アドレスが表示されます。
21+
下記は例なので実際は環境によって IP は異なります
22+
```
23+
setup(): Camera ready use: http;//192.168.1.20 to connect
24+
```
25+
ブラウザからその IP アドレスへアクセスしてください。
26+
27+
### WiFi 接続ができない時
28+
接続は以下のように行っています。CoreS3 に接続済みの SSID / Password が保存されていることが前提です。
29+
30+
```cpp
31+
// main.cpp
32+
WiFi.begin(); // Connects to credential stored in the hardware.
33+
```
34+
何某かの手段で情報を保存するか、ソースを書き換えてください。
35+
```cpp
36+
// main.cpp
37+
WiFi.begin("Your SSID", "Your password");
38+
```
39+
40+
## ブラウザ画面説明
41+
### 基本機能
42+
* Resolution
43+
現在設定されているカメラの解像度を表示しています。解像度変更はできません。
44+
* Contrast
45+
コントラストを変更します。
46+
* Special Effect
47+
エフェクトをかけます。
48+
49+
|メニュー|説明|
50+
|---|---|
51+
|NoEffect|エフェクト無し|
52+
|Negative|ネガポジ変換|
53+
|Grayscale|グレイスケール化|
54+
|RedTint|赤化|
55+
|GreenTint|緑化|
56+
|BlueTint|青化|
57+
|Sepia|セピア化|
58+
59+
* WB Mode
60+
ホワイトバランスを変更します。
61+
62+
|メニュー|説明|
63+
|---|---|
64+
|Auto|自動|
65+
|Sunny|晴天|
66+
|Cloudy|曇天|
67+
|Office|蛍光灯|
68+
|Home|電球|
69+
70+
* Gain
71+
ゲインを変更します。
72+
73+
* H-Mirror
74+
水平方向の画像反転を変更します。
75+
* V-Flip
76+
垂直方向の画像反転を変更します。
77+
* Color Bar
78+
カラーバー表示の ON/OFF
79+
* Get Still
80+
静止画像取得
81+
* Start/Stop Stream
82+
ストリーム受信の開始/終了
83+
* Save
84+
受信画像をダウンロードします。
85+
* X
86+
ストリームの終了
87+
88+
### 拡張機能
89+
* Register Get/Set
90+
カメラのレジスタに対しての値の設定、取得ができます。
91+
レジスタと機能についてはデータシートなどを参考にしてください。
92+
**注意** <ins>適切でない値を適切でないレジスタへ設定しないように気をつけてください。</ins>
93+
94+
## オリジナルからの変更点
95+
* M5StackCore3 専用のアプリケーションになった。
96+
* M5Unified ベースで動作するようにした。
97+
* GC0308 用に html を修正した。
98+
* GC0308 に無い機能を割愛した。
99+

0 commit comments

Comments
 (0)