EWP Control

SmartCoolingv2.1 / EWP Controller

Super Intelligent Thermal Management System | ESP32-S3 Powered

SmartCooling bukan sekadar pengawal suhu. Ia adalah sistem Super Intelligence (SI) yang sedar situasi, mampu memprediksi kegagalan, menahan serangan siber-logik, dan beroperasi secara autonomi dalam persekitaran ekstrem. Dibina dengan arkitektur modular hibrid untuk kestabilan maksimum.

🚀 Ciri Utama & Keunikan

🧠 Super Intelligence (SI) Core

Bukan AI biasa. SI kami menggabungkan kawalan adaptif, model fizik termodinamik, dan analisis risiko masa nyata.

• Adaptive PID & Feed-Forward: Menyesuaikan parameter secara dinamik berdasarkan beban haba.
• Predictive Fault Detection: Mengesan anomali (cagaran sensor, kegagalan kipas) sebelum ia menjadi kritikal.
• Risk Score Engine: Penilaian risiko berterusan (0.0 - 1.0) untuk membuat keputusan keselamatan proaktif.
• Sensor Fusion: Menggabungkan data sensor fizik, input ECU/ECM, dan model dalaman untuk ketepatan mutlak.

Integrasi EWP Controller

SmartCoolingv2.1 menggabungkan firmware SmartCooling dengan reka bentuk EWP Controller ini. RP2350B kekal sebagai pengawal keselamatan dan actuator kritikal, manakala ESP32-S3 mengurus UI, Wi-Fi, BLE, diagnostik dan OTA. Kontrak komunikasi neutral-transport berada di docs/SMARTCOOLINGV2_1_INTEGRATION.md.

🛡️ SI Sentinel (Neural-Safe Core)

Lapisan pertahanan aktif yang melindungi integriti sistem daripada "hallucination" SI dan serangan bukan fizikal.

• Behavioral Guard: Memastikan setiap output SI berada dalam had fizikal yang selamat.
• Cyber-Logic Defense: Sanitasi input, anti-injection, dan rate limiting untuk antaramuka web & data.
• Memory Integrity Watch: Pemantauan heap/stack masa nyata dengan mekanisme canary untuk mencegah korupsi memori.
• Watchdog Bertingkat: Pemulihan automatik daripada hang atau deadlock dalam milisaat.

💾 Ketahanan Data & Kuasa

• RTC Memory Persistence: Menyimpan keadaan sistem semasa gangguan kuasa; pemulihan <500ms.
• Robust Data Logger: Triple-buffering, auto-rotation fail, dan validasi CRC32 untuk log pada MicroSD.
• Factory Reset Ganda: Pilihan reset melalui Web UI (dilindungi PIN) atau Pin Jumper Fizikal.

🏭 Konfigurasi Kilang Selamat (Secure Defaults)

Untuk melindungi perkakasan pihak ketiga, semua output dimatikan secara lalai sehingga dikonfigurasi:

• Pam & Kipas: OFF (Wajib konfigurasi manual PWM/SSR).
• Sensor Persekitaran: Tiada (Pilihan: BME280, AHT30, dll).
• MicroSD: Tidak Aktif (Aktifkan manually untuk logging).

📦 Sokongan Dual-Framework

Projek ini dibina untuk berjalan serasi pada kedua-dua ekosistem tanpa perubahan kod:

📊 Dashboard & Antara Muka

Web UI yang dibina semula sepenuhnya dengan prinsip "Liquid & Minimalist":

• Navigasi Hamburger: Menu sisi yang licin dengan indikator RGB status.
• Dashboard Real-Time: Graf suhu, output, dan metrik SI (Risk/Stability).
• Kawalan Keselamatan: Borang input dengan validasi had (bawah < atas) dan pengesahan PIN.
• Diagnostik Terintegrasi: Log peristiwa, eksport data, dan status perkakasan dalam satu pandangan.

🛠️ Struktur Projek Modular

SmartCooling/
├── CMakeLists.txt              # Konfigurasi ESP-IDF
├── platformio.ini              # Konfigurasi PlatformIO
├── sdkconfig.defaults          # Tetapan ESP-IDF
├── main/                       # Komponen utama firmware
│   ├── CMakeLists.txt
│   └── main.cpp                # Entry point
├── components/smartcooling/    # Komponen SI teras
│   ├── CMakeLists.txt
│   ├── library.json
│   ├── include/                # Header files
│   │   ├── si_core.h           # Enjin SI
│   │   ├── si_sentinel.h       # Lapisan keselamatan
│   │   ├── data_logger.h       # Sistem logging
│   │   ├── factory_config.h    # Konfigurasi kilang
│   │   └── web_assets.h        # Aset web terkompres
│   └── src/                    # Sumber implementasi
│       ├── si_core.cpp
│       └── si_sentinel.cpp
├── docs/                       # Dokumentasi
│   ├── MANUAL_PENGGUNAAN.md
│   └── PANDUAN_PEMBANGUN.md
└── tools/                      # Skrip pembangunan

📈 Status Pembangunan

🔧 Konfigurasi Asas

📄 Dokumentasi Lanjut

• 📘 Manual Penggunaan - Panduan lengkap Web UI, konfigurasi AP, dan prosedur OTA.
• 🛠️ Panduan Pembangun - Spesifikasi pin, protokol komunikasi, dan integrasi modul.

⚠️ Amaran Keselamatan

Sistem ini mengandungi ciri kawalan kuasa tinggi. Pastikan:

1. Konfigurasi kilang disemak sebelum membiarkan sistem beroperasi tanpa pengawasan.
2. Sensor dikalibrasi dengan betul untuk mengelakkan bacaan palsu.
3. Pin Jumper Factory Reset tidak tertekan secara tidak sengaja.

Dibina dengan ketahanan ekstrem sebagai keutamaan.

© 2024 SmartCooling Project. All Rights Reserved.