⚙️ ESP32_PLC

🧠 Turn your ESP32 into a tiny Programmable Logic Controller (PLC) powered by MicroPython.

---

🪄 Overview

ESP32_PLC transforms your ESP32-WROOM-32 into a fully programmable logic controller (PLC).
You can control and interconnect GPIOs using simple terminal commands — define AND, OR, XOR, and NOT gates, or directly wire signals together in real-time.

Once uploaded as main.py, the ESP32 automatically boots into PLC mode and starts executing logic cycles continuously, just like an industrial PLC.

---

✨ Features

✅ Command-line interface (CLI) via UART or REPL
✅ Real-time logic execution in a background thread
✅ Supports logic gates:

• ➕ OR (+)
• ✖️ AND (*)
• ⛔ NOT (!)
• ⚡ XOR (^)
• ➡️ One Way Wire (diode) (=)

✅ Pin protection for flashing/memory lines
✅ Dynamic reconfiguration without reboot
✅ Built-in reset and diagnostics commands ✅ Micropython file handling for storing backup files

---

📋Supported Commands

Command	Description	Example
<pin>	Read digital input	12
<pin> = x	Set input pin	12 = x
SET <pin>	Set output pin as high	SET 12
RESET <pin>	Set output pin as low	RESET 12
<pin> = ! <in>	NOT gate	13 = ! 12
<pin> = <in1> + <in2>	OR gate	15 = 12 + 13
<pin> = <in1> * <in2>	AND gate	16 = 12 * 13
<pin> = <in1> ^ <in2>	XOR gate	17 = 12 ^ 13
<pin> = ! <in1> + <in2>	NOR gate	15 = ! 12 + 13
<pin> = ! <in1> * <in2>	NAND gate	16 = ! 12 * 13
<pin> = ! <in1> ^ <in2>	XNOR gate	17 = ! 12 ^ 13
<pin> = <Boolean Expression>	Any Boolean Expression	15 = 2 + ! ( 12 * 13 )
LIST	List configured boolean expressions	LIST
RESET HARD	Hard restart the ESP32	RESET HARD
RESET SOFT	SOft restart the ESP32	RESET SOFT
SLEEP LIGHT <int (ms)>	Enter light sleep for given time	SLEEP LIGHT 5000
SLEEP DEEP <int (ms)>	Enter deep sleep for given time	SLEEP DEEP 5000
SAVE	Create a backup file storing the current expressions	SAVE

💡 Add ? at the end of any command for debug mode to show detailed error messages.

---

🧠 Example Session

> 15 = 2 + ! ( 12 * 13 )
OK
> SET 13
OK
> 15
OK
1
> LIST
OK
Pin(15) = 2 + ! ( 12 * 13 )
> 15 = x
OK
> LIST
OK
NONE
> RESET
OK

---

🛠️ Setup Instructions

1️⃣ Flash MicroPython

Use esptool.py to flash MicroPython firmware on your ESP32:

esptool -p COMx erase-flash
esptool -p COMx write-flash 0x1000 ESP32_GENERIC-v1.xx.x.bin

2️⃣ Upload the Script

Copy main.py (this script) to your ESP32 using Arduino Lab, Thonny, ampy, or rshell.

3️⃣ Run Automatically

The script will run on startup if you save it as main.py. That means your PLC logic starts automatically when powered!

---

🚨 Pin Safety

The following pins are protected to prevent interference with flash memory or serial programming:

Type	Pins
Flash/Debug	1, 3
Flash Memory	6-11

Any attempt to use these pins will result in an error.