update readme with useful info

2026-08-18 17:26:39 +02:00 · 2025-09-06 17:18:15 +02:00
parent 16ff3e7a47
commit d66d252d5b
2 changed files with 146 additions and 4 deletions
@@ -1,2 +1,144 @@
 # CrustCraft

+This project aims to replace the existing thermostat of a G3 Ferrari Pizza Oven with an ESP‑chip based control system, thereby improving precision, responsiveness, and overall temperature regulation.
+
+Happy baking! 🍕🛠️
+
+
+## Prerequisites
+
+| **Item**                      | **Description**                   |
+|-------                        |-------                            |
+| ESP‑32 Dev Board	            | Any WiFi‑enabled chip with at least 4 GPIO pins will do                      |
+| MAX6675 K‑Type Thermocouple   | Only a K‑type thermocouple can withstand the temperatures required  |
+| 5V Relay Module               | Atleast 10A                       |
+| Power Supply	                | 5V / 2A AC-DC adapter             |
+| Connecting Wires	            | Silicone heat resistant wiring    |
+
+
+## Clone the Repository
+
+```
+git clone https://github.com/vincvdwal/crust-craft/
+cd crust-craft
+```
+The repo contains the following layout:
+
+## Installing PlatformIO
+
+### VS Code Extension
+
+Open VS Code.
+
+Go to Extensions → Search for “PlatformIO IDE” → Install.
+Restart VS Code → PlatformIO panel appears on the left.
+
+## Project Configuration
+
+Open the project:
+
+Platform	Command
+VS Code	Double‑click `crust-craft` folder or open > File → Add Folder to Workspace.
+
+Edit platformio.ini (shown below – you can adjust as needed):
+
+
+```ini
+[env:esp32dev]
+platform = espressif32
+board = esp32dev
+framework = arduino
+
+; Optional environment for ESP8266
+[env:esp8266]
+platform = espressif8266
+board = nodemcuv2
+framework = arduino
+```
+
+## Building the Firmware
+
+Click the “Build” icon (checkboard) in VS Code’s PlatformIO toolbar.
+The output will be displayed in the Build Log pane.
+Success → you’ll see: Build Done and an `firmware.bin` file under `.pio/build`.
+
+## Uploading to the ESP via VS Code
+
+Press “Upload” (right‑hand arrow icon) in the PlatformIO bar
+→ It will compile (again if necessary) and flash to the device.
+
+## Serial Monitor
+
+Click the “Monitor” icon (plug + arrow) or `Ctrl+Alt+M`
+ 
+## Custom Configuration – Wi‑Fi Credentials
+
+The firmware stores your Wi‑Fi SSID & password in `secrets.h`.
+
+Copy the example or create a new file
+
+```bash
+cp src/secrets.example.h src/secrets.h
+```
+
+And replace the following with your Wi-Fi credentials
+
+```
+// Replace with your network credentials
+const char *ssid = "WIFI_SSID";
+const char *password = "WIFI_PWD";
+```
+
+## Installing the filesystem
+
+
+## Debugging the filesystem
+
+
+## Building and uploading the filesystem
+
+
+## Diagram
+
+```mermaid
+flowchart TD
+    subgraph MCU
+        ESP32[<b>ESP32</b><br/>3.3 V<br/>GND]<br/>
+    end
+    subgraph Sensors
+        MAX6675[<b>MAX6675</b><br/>3.3 V<br/>GND<br/>CS, SCK, SO]
+        Thermo[<b>K‑Type</b><br/>+ / -]
+    end
+    subgraph Relay
+        RELAY[<b>5 V Relay</b><br/>IN<br/>VCC(5 V)<br/>GND]
+    end
+
+    ESP32-->|3.3 V|MAX6675
+    ESP32-->|GND|MAX6675
+    ESP32-->|SCK|MAX6675
+    ESP32-->|CS|MAX6675
+    ESP32-->|GPIO15|RELAY
+    ESP32-->|GND|RELAY
+
+    Thermo-->|+|MAX6675
+    Thermo-->|-|MAX6675
+```
+
+
+## Acknowlegdements
+
+This project would not have been possible without the awesome, open‑source libraries below.
+
+|Library |	GitHub URL |	License|
+|-------|-------|-------|
+adafruit/MAX6675 library|	https://github.com/adafruit/MAX6675-library	 | BSD
+bblanchon/ArduinoJson |	https://github.com/bblanchon/ArduinoJson	|MIT
+ayushsharma82/ElegantOTA	| https://github.com/ayushsharma82/ElegantOTA |	AGPL-3.0
+ESP32Async/AsyncTCP |	https://github.com/ESP32Async/AsyncTCP	| LGPL-3.0
+ESP32Async/ESPAsyncWebServer	| https://github.com/ESP32Async/ESPAsyncWebServer |	LGPL-3.0
+
+## ToDo
+
+### Display
+
+In the long run a capacative LCD screen might be used in addition to the WebSocket connection
@@ -9,12 +9,12 @@
 ; https://docs.platformio.org/page/projectconf.html

 [env:esp32doit-devkit-v1]
-platform = espressif32
 board = esp32doit-devkit-v1
-
+platform = espressif32
 framework = arduino
-lib_compat_mode = strict
-lib_ldf_mode = chain
+
+; lib_compat_mode = strict
+; lib_ldf_mode = chain
  
 lib_deps = 
 	adafruit/MAX6675 library@^1.1.2