Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/lily-osp/permainan-tebak-ayat-interaktif

Proyek ini adalah sistem berbasis Arduino yang memungkinkan pengguna mendengarkan dan menebak ayat-ayat Al-Qur'an. Sistem ini memanfaatkan komponen seperti LCD, keypad, modul MP3 DFPlayer Mini, buzzer, dan amplifier audio dengan speaker.
https://github.com/lily-osp/permainan-tebak-ayat-interaktif

al-quran arduino game hafidz tebak-ayat

Last synced: about 1 month ago
JSON representation

Host: GitHub
URL: https://github.com/lily-osp/permainan-tebak-ayat-interaktif
Owner: lily-osp
Created: 2024-07-27T17:38:19.000Z (5 months ago)
Default Branch: main
Last Pushed: 2024-08-19T19:08:39.000Z (5 months ago)
Last Synced: 2024-08-21T15:31:05.317Z (4 months ago)
Topics: al-quran, arduino, game, hafidz, tebak-ayat
Language: HTML
Homepage: https://lily-osp.github.io/Permainan-Tebak-Ayat-Interaktif/
Size: 2.17 MB
Stars: 0
Watchers: 0
Forks: 0
Open Issues: 0
Metadata Files:
- Readme: readme.md

Awesome Lists containing this project

README

        # Permainan Tebak Ayat Interaktif

## Gambaran Umum

Proyek ini adalah sistem berbasis Arduino yang memungkinkan pengguna mendengarkan dan menebak ayat-ayat Al-Qur'an. Sistem ini memanfaatkan komponen seperti LCD, keypad, modul MP3 DFPlayer Mini, buzzer, dan amplifier audio dengan speaker. Pengguna dapat memilih untuk mendengarkan ayat secara acak atau berdasarkan nomor tertentu, lalu menebak ayat yang didengar. Skor pengguna dilacak, dan sistem memberikan umpan balik melalui layar LCD dan buzzer.

## Komponen yang Digunakan

- **Arduino Board** (misalnya, Arduino Mega)

- **LiquidCrystal_I2C**: Layar LCD (20x4)

- **Keypad**: Keypad 3x4

- **DFRobotDFPlayerMini**: Modul pemutar MP3

- **Buzzer**

- **LED**

- **Audio Amplifier Module**

- **Speaker**

- **Kartu SD**: Berisi file audio (001.wav hingga 286.wav)

- **Kabel dan Breadboard**

## Diagram Rangkaian

### Koneksi

| Komponen          | Arduino Pin       |

|-------------------|-------------------|

| **Layar LCD**     |                   |

| SDA               | A4                |

| SCL               | A5                |

| **Keypad**        |                   |

| Pin baris 1       | Pin digital 5     |

| Pin baris 2       | Pin digital 4     |

| Pin baris 3       | Pin digital 3     |

| Pin kolom 1       | Pin digital 9     |

| Pin kolom 2       | Pin digital 8     |

| Pin kolom 3       | Pin digital 7     |

| Pin kolom 4       | Pin digital 6     |

| **DFPlayer Mini** |                   |

| RX                | Pin digital 10    |

| TX                | Pin digital 11    |

| VCC               | 5V                |

| GND               | GND               |

| SPK1              | Audio input+ (Amplifier)|

| SPK2              | Audio input- (Amplifier)|

| **Audio Amplifier Module**|           |

| Audio Input+      | SPK1 (DFPlayer Mini)|

| Audio Input-      | SPK2 (DFPlayer Mini)|

| Audio Output+     | Speaker+          |

| Audio Output-     | Speaker-          |

| VCC               | 5V                |

| GND               | GND               |

| **Buzzer**        |                   |

| Positif           | Pin digital 51    |

| Negatif           | GND               |

| **LED**           |                   |

| Positif           | Pin digital 50    |

| Negatif           | GND               |

## Instalasi dan Pengaturan

1. **Install Arduino IDE**: Unduh dan instal Arduino IDE dari [situs web Arduino](https://www.arduino.cc/en/Main/Software).

2. **Instalasi Perpustakaan**:

   - Buka Arduino IDE.

   - Pergi ke **Sketch** -> **Include Library** -> **Manage Libraries**.

   - Instal perpustakaan berikut:

     - **Wire** (Biasanya sudah terinstal)

     - **LiquidCrystal_I2C**

     - **Keypad**

     - **DFRobotDFPlayerMini**

3. **Unggah Kode**:

   - Buka kode Arduino yang disediakan (`ayat-guessing-game.ino`) di Arduino IDE.

   - Hubungkan papan Arduino ke komputer Anda.

   - Pilih papan dan port yang sesuai dari menu **Tools**.

   - Klik tombol **Upload**.

4. **Siapkan Kartu SD**:

   - Format kartu SD ke FAT32.

   - Salin file audio (001.wav hingga 286.wav) ke direktori root kartu SD.

   - Masukkan kartu SD ke modul DFPlayer Mini.

## Cara Menggunakan

1. **Nyalakan Sistem**:

   - Hubungkan Arduino ke sumber daya (USB atau catu daya eksternal).

   - Sistem akan melakukan inisialisasi, dan LCD akan menampilkan menu utama.

2. **Menu Utama**:

   - LCD akan menampilkan "Selamat Datang!" dan meminta pengguna untuk memilih mode permainan:

     - Tekan `1` untuk masuk ke mode **Dengar Ayat**.

     - Tekan `2` untuk masuk ke mode **Tebak Ayat**.

3. **Dengar Ayat**:

   - Sistem akan menanyakan apakah Anda ingin memilih track secara manual atau acak:

     - Tekan `1` untuk input manual: Sistem akan meminta nomor ayat.

     - Tekan `2` untuk memilih secara acak: Sistem akan memilih ayat secara acak.

   - Konfirmasikan pilihan Anda dengan menekan `Y` (Ya) atau batalkan dengan menekan `N` (Tidak).

   - Ayat yang dipilih akan diputar, dan LCD akan menampilkan statusnya.

4. **Tebak Ayat**:

   - Sistem akan memilih ayat secara acak untuk ditebak.

   - Setelah mendengarkan, Anda akan diminta untuk menebak nomor ayat.

   - Masukkan tebakan Anda menggunakan keypad dan konfirmasi.

5. **Skor**:

   - Tebakan yang benar meningkatkan skor Anda sebesar 1.

   - Tebakan yang salah mengurangi skor Anda sebesar 1 dan memicu buzzer.

   - Permainan berlanjut hingga skor Anda mencapai 0 (Permainan Selesai) atau 10 (Anda Menang).

## Penjelasan Kode

### Variabel dan Konstanta

- `LiquidCrystal_I2C lcd(0x22, 20, 4)`: Inisialisasi LCD dengan alamat I2C 0x22 dan dimensi 20x4.

- `Keypad keypad = Keypad(makeKeymap(keys), rowPins, colPins, ROWS, COLS)`: Inisialisasi keypad.

- `const int ledPin = 50`, `const int buzzerPin = 51`: Penugasan pin untuk LED dan buzzer.

- `int skor = 5`: Skor awal.

- `bool audioSedangDiputar = false`: Flag untuk memeriksa apakah audio sedang diputar.

- `bool sdCardStatus = false`: Status kartu SD untuk verifikasi saat sistem berjalan.

### Fungsi Setup

- Menginisialisasi LCD, komunikasi serial, dan mengatur mode pin.

- Memeriksa DFPlayer Mini dan kartu SD, kemudian menginisialisasi sistem jika semua komponen bekerja dengan baik.

### Fungsi Loop

- Menangani waktu buzzer dan status pemutaran audio dengan menggunakan `millis()` untuk non-blocking delays.

- Memeriksa input keypad dan memprosesnya sesuai kebutuhan.

- Menampilkan pesan di LCD untuk durasi tertentu dengan menggunakan `millis()`.

### Fungsi Tambahan

- `periksaKomponen()`: Memeriksa apakah DFPlayer Mini dan kartu SD berfungsi dengan baik.

- `tampilkanMenuUtama()`: Menampilkan menu utama di LCD.

- `prosesInputKeypad(char key)`: Memproses input dari keypad dan menentukan aksi yang sesuai.

## Pemecahan Masalah

- **LCD tidak menampilkan dengan benar**:

  - Periksa alamat I2C dan koneksi.

  - Pastikan perpustakaan LCD terinstal dengan benar.

- **DFPlayer Mini tidak terdeteksi**:

  - Periksa koneksi dan kartu SD.

  - Pastikan file audio diberi nama dengan benar dan ditempatkan di direktori root.

- **Buzzer tidak berfungsi**:

  - Periksa koneksi pin.

  - Pastikan pin buzzer ditugaskan dengan benar dalam kode.

- **Speaker tidak menghasilkan suara**:

  - Periksa koneksi antara DFPlayer Mini dan modul amplifier.

  - Pastikan speaker terhubung dengan benar ke modul amplifier.

## Peningkatan di Masa Depan

- Tambahkan lebih banyak mode permainan atau tantangan.

- Implementasikan fitur tambahan seperti batas waktu atau petunjuk.

- Tingkatkan antarmuka pengguna dan mekanisme umpan balik.

## Flowchart, Usecase Sequence, dan Gambar

![flowchart](flowchart.png)

![sequence](sequence.png)

![mega-pinout](mega-pinout.jpg)