🍡 Demo Cara Pemasangan Mochi DFPlayer

🛒 Daftar komponen

ℹ️ Semua modul memakai kabel titik-ke-titik, tanpa PCB. Kabel jumper dupont boleh untuk uji coba di breadboard, tapi untuk rakitan akhir lebih awet disolder.

🔧 Langkah rakit interaktif

Rute kabel di gambar hanya ilustrasi. Yang penting pin ke pin-nya. Tombol keyboard ← → juga bisa dipakai. Diagram lengkap dan tabel ada di Diagram kabel.

💾 Siapkan kartu SD DFPlayer

Pakai kartu microSD ≤ 32 GB, format FAT32.

Format kartu, salin isi sd/mp3/ ke root berurutan (DFPlayer memakai urutan salin), lalu folder lagu /01.

/0001.mp3 … /0048.mp3      suara animasi + Chronos, disalin PERTAMA
/01/001.mp3 …              lagu Pemutar MP3, disalin SESUDAHNYA

Di macOS, hapus file ._* dan .DS_Store. Cek isi kartu: python firmware/tools/daftar_trek.py --sd /path/ke/kartu.

Masukkan kartu ke slot DFPlayer sebelum menyalakan perangkat.

Nomor trek tiap model dan cara menambah suara: Animasi & suara.

⚡ Flash firmware

Buka Instalasi firmware di Chrome atau Edge di komputer.

Tahan tombol BOOT di ESP32-C3, colok USB-C, lalu lepas BOOT.

Klik Install, pilih port, centang Erase untuk pemasangan pertama, tunggu sampai selesai.

Cabut lalu colok lagi USB-C.

💡 TTP223 tidak perlu disolder: jenis sensor dideteksi saat nyala. Mau memaksa? Build sendiri dengan -DMOCHI_TOUCH_ACTIVE_HIGH (lihat build sendiri). Pin BUSY ke GPIO5? Tambahkan -DMOCHI_PIN_DF_BUSY=5.

✅ Uji nyala pertama

Cek	Yang harus terjadi	Kalau tidak
Layar	Lampu latar nyala, klip `wajah/senyum_kedip` langsung main	Cek SCL 4, SDA 6, DC 3, RES 10, BLK 7, VCC 3V3. Modul 8 pin: CS ke GND
Suara	Suara model terdengar dari speaker (`0019.mp3` untuk `wajah/senyum_kedip`)	VCC DFPlayer 5V, GPIO20 → 1 kΩ → RX, kartu FAT32, `0001`–`0048` di root disalin berurutan
Ketuk 1×	Animasi berhenti, layar gelap. Ketuk lagi: main	Cabut-colok tanpa menyentuh sensor (deteksi jenis sensor saat nyala). Kabel I/O → GPIO1, VCC 3V3
Ketuk 2×	Model berikutnya	Ketuk lebih cepat (jeda ≤ 0,35 dtk)
Tahan 2 dtk	Menu terbuka	Kalau langsung "tahan" terus: polaritas sentuh terbalik
Serial 115200	`Mochi DFPlayer 0.7.1, 14 model …`, `sentuh GPIO1: …`, `MPU6050 siap` (kalau dipasang)	`MPU6050 tidak ada`: cek SDA 8, SCL 9, 3V3

Serial monitor lewat USB: pio device monitor (115200). Daftar gejala lain: Kalau ada masalah.

⚠️ Catatan penting

🔊 Jangan pernah menyambung kaki speaker ke GND atau ke GPIO. SPK_1 dan SPK_2 adalah output amplifier jembatan (BTL) di DFPlayer.

⚡ DFPlayer butuh 5V (pin 5V / VBUS ESP). Layar, TTP223, dan MPU6050 tetap 3V3.

📌 GPIO9 pin strap: jangan ditarik ke GND saat boot. GPIO20/21 adalah UART0 chip, log ESP keluar lewat USB CDC.

🔋 Pasang kapasitor 100–470 µF dekat VCC–GND DFPlayer supaya tidak reset atau "plok" saat suara keras.

🔗 Semua GND disatukan: ESP, layar, TTP223, DFPlayer, MPU6050, kapasitor.

📏 Kabel SPI layar (SCL, SDA, DC) sependek mungkin. SPI jalan di 40 MHz; kabel panjang bikin gambar bergaris.