SmartSensorMonitor

SmartSensorMonitor adalah sistem monitoring lokal berbasis Arduino Uno R3. Data suhu, kelembapan, gerakan, dan keadaan cahaya dikirim melalui USB Serial ke aplikasi Windows, lalu diteruskan melalui WebSocket LAN ke dashboard Android.

Status rilis

SmartSensorMonitor v1.0.0 dirilis pada 16 Juli 2026 dari commit ab3cd46ade37744010910dcb30adc0fd63d5857d. MVP dan Milestone 0–7 telah selesai. Unduh paket resmi melalui GitHub Release v1.0.0.

Fitur utama

• Firmware Arduino dengan JSON newline protocolVersion 1 dan telemetry setiap dua detik.
• GUI Windows SmartSensorMonitor.exe dengan auto-port, status koneksi, telemetry, log, dan endpoint Android.
• Dashboard Android Qt Quick/QML dengan Status Nilai, Status Sensor, Ringkasan Sistem, dan card Cahaya.
• Reconnect serial/WebSocket, validasi input, mode mock, dan CLI SmartSensorBridge.exe untuk diagnosis.
• Paket Windows portable, ikon Windows/Android, dan clean-machine acceptance.

Arsitektur

DHT22 + PIR + LDR digital
→ Arduino Uno R3
→ USB Serial
→ SmartSensorMonitor pada Windows
→ WebSocket LAN
→ Android Dashboard

Sensor dan wiring ringkas

Sensor	Pin Arduino	Fungsi
DHT22/AM2302 DATA	D2	Suhu dan kelembapan
PIR OUT	D3	Deteksi gerakan
LDR digital DO	D4	LOW = Terang, HIGH = Gelap

Semua modul menggunakan common GND. LDR hanya memberikan status digital Terang/Gelap, bukan nilai lux atau analog. Pulse Sensor tidak digunakan pada MVP; field pulseRaw, bpm, dan pulseOk tetap tersedia untuk kompatibilitas protokol.

Cara menggunakan Windows

1. Unduh dan ekstrak SmartSensorMonitor-Windows-x64.zip dari GitHub Release.
2. Jika Windows melaporkan VCRUNTIME140_1.dll hilang, jalankan vc_redist.x64.exe yang tersedia dalam paket.
3. Hubungkan Arduino Uno R3 melalui USB.
4. Jalankan SmartSensorMonitor.exe, lalu tekan Aktifkan Bridge.
5. Jika Windows Defender Firewall meminta izin, izinkan SmartSensorMonitor hanya pada Private networks. Jangan menonaktifkan firewall secara permanen.

Menghubungkan Android

Pastikan Windows dan Android berada pada LAN yang sama. Salin endpoint yang ditampilkan GUI, misalnya ws://<IP-Windows>:8765, masukkan ke aplikasi Android, lalu tekan Connect. USB Android dan ADB tidak dibutuhkan untuk runtime normal setelah APK terpasang.

Prerequisite

Pengguna akhir hanya memerlukan Windows 10/11 x64, Arduino melalui USB, jaringan lokal, Android, dan Microsoft Visual C++ Redistributable x64 bila runtime tersebut belum tersedia. Qt SDK, Visual Studio, CMake, Ninja, Git, VS Code, Android SDK, dan ADB tidak diperlukan untuk penggunaan normal.

Build dari source

Development utama dilakukan di macOS dengan C++17, Qt 6.11, CMake, Ninja, PlatformIO, dan Qt for Android. Build Windows menggunakan MSVC 2022 x64 dan Qt 6.11.1. Lihat Desktop Bridge, Android, dan Windows Deployment.

Testing

Acceptance final mencakup firmware DHT22/PIR/LDR, transisi Terang → Gelap → Terang, GUI Windows, Android end-to-end, stop/start, disconnect/reconnect, clean-machine, ikon, dan unit test Windows 4/4. Detail tersedia di Testing Strategy.

Struktur repository

• firmware/ — firmware produksi, dummy, dan diagnostik.
• shared/ — model, parser, serializer, validator, dan classifier C++.
• desktop/ — Bridge core, CLI, dan GUI Windows.
• android-app/ — aplikasi Android C++/QML.
• packaging/ — panduan dan notices paket runtime.
• docs/ — dokumentasi teknis dan status proyek.

Release dan checksum

• Windows ZIP: 50.428.050 byte; SHA-256 B7E12269E695EAE43F912EC5646E58B994A32BE6DCB27500F7FED398895AA65B.
• Android APK Debug arm64-v8a: 27.811.900 byte; SHA-256 7812f5f681f3ec494245ea3bf2c26195977b0aab9a390bd922c5e7ea2f631f18.

APK memakai package com.smartsensormonitor.app dan debug signing.

Troubleshooting

• Arduino tidak terdeteksi: periksa kabel, Device Manager, COM Port, dan aplikasi lain yang mengunci serial.
• Android terus Connecting: periksa endpoint GUI, subnet LAN, port 8765, dan izin firewall Private.
• VCRUNTIME140_1.dll hilang: instal redistributable dari vc_redist.x64.exe dalam paket.

Known limitations

• WebSocket v1 memakai ws:// pada LAN tepercaya tanpa TLS/autentikasi; jangan expose port 8765 ke internet.
• Windows executable belum ditandatangani secara digital.
• APK masih Debug-signed dan permission storage dari template deployment Qt tetap menjadi known limitation pasca-rilis.
• Installer penuh, AAB, histori data, grafik, dan auto-discovery belum termasuk v1.0.0.

Kontribusi

Baca CONTRIBUTING.md, Project Charter, Development Roadmap, dan AI Context sebelum membuat perubahan.