Xiaozhi Logo
Xiaozhi Indonesia Platform AI & IoT
Marketplace Flasher Dokumentasi Masuk

Panduan

Dokumentasi Pengguna

Panduan lengkap menggunakan Xiaozhi Indonesia.

🚀 Alur Cepat Mulai Dari Nol (Zero to Hero)
Panduan berurutan untuk pengguna baru. Dari board ESP32 kosong hingga asisten suara XiaoZhi aktif 100% dengan otak lokal di xiaozhiscig.biz.id.
✨ 5 Langkah Praktis
1
Langkah 1
Flash Firmware
2
Langkah 2
Setup Wi-Fi
3
Langkah 3
Pairing 6 Digit
4
Langkah 4
Salin MCP
5
Langkah 5
Aktif di Server
1

Langkah 1: Flash Firmware Resmi ke ESP32

💻 Dilakukan di PC / Laptop
Hubungkan board ESP32 Anda ke komputer menggunakan kabel data USB Type-C yang mendukung transfer data (bukan sekadar kabel casan).
  1. Buka menu Web Serial Flasher di tab browser Google Chrome, Microsoft Edge, Opera, atau Brave.
  2. Pilih opsi Preset Resmi (misal ESP32-S3 N16R8 atau ESP32-C3).
  3. Klik tombol hitam "Pilih & Hubungkan Port COM", lalu pilih port USB ESP32 Anda (Espressif USB JTAG/CDC).
  4. Klik tombol "Mulai Flash Firmware" dan tunggu hingga progress mencapai 100%.
⚡ Buka Web Serial Flasher 💡 Tidak butuh install Python atau driver tambahan!
2

Langkah 2: Hubungkan & Konfigurasi Wi-Fi Rumah

📱 Dilakukan di HP / Smartphone
Setelah firmware berhasil terpasang, ESP32 akan menyala dan memancarkan sinyal hotspot mandiri agar Anda dapat memasukkan kata sandi Wi-Fi rumah.
  1. Buka pengaturan Wi-Fi di HP atau Laptop Anda, lalu sambungkan ke jaringan bernama XiaoZhi-XXXX atau Xichi-Setup (tanpa kata sandi).
  2. Buka peramban (Chrome / Safari) lalu kunjungi alamat: http://192.168.4.1.
  3. Pada tab Jaringan Wi-Fi, pilih nama router Wi-Fi rumah Anda (wajib frekuensi 2.4 GHz) dan ketik kata sandinya.
  4. Pada tab Pengaturan Hardware, tentukan tipe modul layar Anda (misal ST7789 240x280 atau Tanpa Layar / Headless).
  5. Klik Simpan Konfigurasi. ESP32 otomatis me-restart dan tersambung ke internet rumah Anda.
⚠️ Peringatan Wi-Fi: Chip ESP32 hanya mendukung sinyal 2.4 GHz. Jangan sambungkan ke jaringan 5 GHz.
3

Langkah 3: Ambil Kode 6 Digit & Hubungkan di xiaozhi.me

☁️ Di Website xiaozhi.me
Begitu ESP32 berhasil terhubung ke router internet rumah Anda, perangkat akan meminta aktivasi pairing dari server cloud resmi Xiaozhi.
  1. Perhatikan layar LCD board Anda atau dengarkan speaker: ESP32 akan menampilkan/menyebutkan Kode Pairing 6 Digit (contoh: A8B2C9).
  2. Buka peramban baru dan masuk ke situs resmi pusat: https://xiaozhi.me.
  3. Masuk (Login) ke akun Anda, lalu klik menu Device / Tambah Perangkat Baru.
  4. Ketik Kode 6 Digit yang muncul di perangkat Anda, lalu klik konfirmasi untuk mendaftarkan board.
🌐 Buka Situs xiaozhi.me Board ESP32 Anda kini telah terdaftar resmi di server Xiaozhi.
4

Langkah 4: Salin URL / Token WebSocket MCP

📋 Dari Dashboard xiaozhi.me
Untuk menyambungkan XiaoZhi ke fitur-fitur lokal (Musik YouTube, Smart Home, Memori Percakapan, dan 66 Tools), Anda perlu mengambil alamat endpoint MCP peranti:
  1. Di dashboard xiaozhi.me, klik perangkat ESP32 Anda yang baru saja ditambahkan.
  2. Buka tab menu Integrasi / Pengaturan Lanjutan / MCP Endpoint (*Model Context Protocol*).
  3. Anda akan menemukan alamat URL WebSocket atau Token koneksi, formatnya menyerupai contoh berikut:
wss://api.xiaozhi.me/v1/mcp/ws?token=xxxxxxxxxxxxxxxx Contoh Endpoint
📖 Butuh panduan visual dengan tangkapan layar (screenshot)?
Buka tab MCP Setup & Slot untuk melihat posisi persis tombol "+ Tambah Perangkat" dan tab "Integrasi MCP" di xiaozhi.me.
🚀 Buka Menu Matrix Slot MCP
👉 Klik tombol Salin (Copy) pada URL atau Token tersebut untuk dipasang pada server Anda di Langkah 5.
5

Langkah 5: Tempel & Aktifkan di xiaozhiscig.biz.id

🚀 Website Ini Selesai 100%
Langkah terakhir untuk mengaktifkan seluruh integrasi cerdas XiaoZhi di server Anda sendiri:
  1. Buka menu Integrasi MCP / Matrix Slot pada website ini (atau klik menu Slot MCP di sidebar kiri).
  2. Pilih slot yang ingin digunakan (misal Slot 1).
  3. Tempelkan (*Paste*) URL / Token MCP yang Anda salin dari Langkah 4 ke dalam kolom input.
  4. Klik tombol "Hubungkan Sekarang".
  5. Animasi radar akan berputar dan status berubah menjadi 🟢 Berhasil Terhubung ke XiaoZhi!.
🚀 Buka Pengaturan Matrix Slot MCP
🎉 Selamat! XiaoZhi Anda kini sudah aktif penuh dan siap diajak berbicara, memutar lagu YouTube Music, mengendalikan Smart Home relay, dan mengakses 66 Tools cerdas.
⚡ Panduan Pinout & Cara Penggunaan ESP32-S3 N16R8 (CAM & Standar Non-CAM)
Firmware ini mendukung chip ESP32-S3 N16R8 (16MB Flash + 8MB Octal PSRAM) baik versi dengan modul kamera (CAM) maupun board standar biasa tanpa modul kamera.
💡 Tips Kompatibilitas Board Biasa (Non-CAM):
Firmware memiliki proteksi fail-safe otomatis. Jika board Anda tidak memiliki modul kamera, driver tidak akan crash atau panic, melainkan otomatis melewati inisialisasi kamera dan berjalan normal 100% untuk suara, YouTube, dan MCP tools.
🌐 Alur Konfigurasi Awal (Web Portal 192.168.4.1)
1
Sambungkan ke Hotspot Wi-Fi Bawaan
Saat menyala pertama kali (LED berkedip hijau), hubungkan HP atau Laptop Anda ke hotspot Wi-Fi bernama XiaoZhi-XXXX atau Xichi-Setup (tanpa kata sandi).
2
Buka Portal Konfigurasi di Browser
Buka browser dan kunjungi alamat http://192.168.4.1 untuk membuka portal konfigurasi perangkat keras dan jaringan.
3
Pilih SSID Wi-Fi & Kata Sandi
Pada tab Jaringan Wi-Fi, pilih nama router Wi-Fi Anda (frekuensi 2.4 GHz) lalu masukkan kata sandi dengan benar.
4
Pengaturan Modul Layar & Rotasi
Pada tab Pengaturan Hardware, pilih tipe modul layar yang sesuai:
  • ST7789 240x280 1.69" (8-Pin SPI, CS=GPIO 45): Modul layar IPS 1.69" resolusi 240x280.
  • ST7789 240x240 1.3" (7-Pin / 8-Pin SPI, CS=GPIO 45 atau GND): Modul layar TFT IPS 1.3 inch resolusi 240x240 (driver ST7789).
  • ST7789 240x240 1.54" (8-Pin SPI, CS=GPIO 45): Modul layar IPS 1.54" resolusi 240x240.
  • OLED SSD1306 128x64 0.96" (I2C): Layar OLED monokrom 0.96 inch I2C.
  • OLED SH1106 128x64 0.96" / 1.3" (I2C): Layar OLED monokrom 1.3 inch chip driver SH1106 I2C.
  • Tanpa Layar (Headless Audio Only): Mode audio saja tanpa layar (hemat daya & membebaskan pin).
  • Rotasi Layar: Pilih 0° (Normal) atau 180° (Terbalik) sesuai orientasi perakitan casing.
5
Profil Audio I2S
Pilih INMP441 Mic + MAX98357A Spk (Simplex I2S). Pinout otomatis dikunci pada jalur aman (Mic: GPIO 1, 2, 42 | Speaker: GPIO 39, 40, 41) tanpa bentrok.
6
Modul Kamera ESP32-S3
• Untuk ESP32-S3 Biasa (Tanpa CAM): Pilih Kamera Nonaktif (Hemat Daya & Bebas Pin).
• Untuk ESP32-S3 CAM: Pilih tipe sensor yang terpasang (misal OV2640 2-Megapixel atau OV5640 5-Megapixel).
7
Simpan & Reboot Otomatis
Klik tombol Simpan Konfigurasi. Sistem akan menyimpan data ke NVS Flash dan me-reboot ESP32. Setelah menyala, ESP32 otomatis tersambung ke router Wi-Fi Anda.
📺 Pilihan Modul Layar pada Konfigurasi Web Portal (192.168.4.1)
Daftar tipe modul layar yang didukung pada firmware ESP32-S3 N16R8, nilai NVS internal, dan konfigurasi sambungan kabel (wiring):
Pilihan Modul Layar Value NVS Deskripsi & Wiring Sambungan
ST7789 240x280 1.69"
(8-Pin SPI, CS=GPIO 45) 		st7789_240x280_8p Untuk: Modul layar ST7789 1.69" resolusi 240x280 yang memiliki pin CS (offset Y=20).
Wiring: SCL=19, SDA=20, DC=47, RST=21, CS=45, BLK=38.
ST7789 240x240 1.3"
(7-Pin / 8-Pin SPI, CS=45 / GND) 		st7789_240x240_7p
atau st7789_240x240_8p 		Untuk: Modul layar TFT IPS 1.3" resolusi 240x240 chip driver ST7789 (tersedia model 7-pin tanpa CS maupun 8-pin dengan CS).
Wiring: GND=GND, VCC=3.3V, SCL=19, SDA=20, RES=21, DC=47, BLK=38, CS=45 (atau ke GND jika model 7-Pin).
ST7789 240x240 1.54"
(8-Pin SPI, CS=GPIO 45) 		st7789_240x240_8p Untuk: Modul layar ST7789 1.54" resolusi 240x240 8-Pin dengan jalur CS ke GPIO 45.
Wiring: SCL=19, SDA=20, DC=47, RST=21, CS=45, BLK=38.
OLED SSD1306 128x64 0.96"
(I2C) 		oled_128x64 Untuk: Layar OLED monokrom 0.96 inch I2C.
Wiring: SDA=GPIO 20, SCL=GPIO 19, VCC=3.3V, GND=GND.
OLED SH1106 128x64 0.96" / 1.3"
(I2C) 		oled_sh1106_128x64 Untuk: Layar OLED monokrom 1.3 inch dengan chip driver SH1106 (I2C).
Wiring: SDA=GPIO 20, SCL=GPIO 19, VCC=3.3V, GND=GND.
Tanpa Layar
(Headless Audio Only) 		headless Untuk: Mode audio saja tanpa layar (hemat daya & membebaskan pin I/O).
💡 Tips Rotasi Layar: Di Web Portal Wi-Fi (192.168.4.1), Anda juga dapat mengatur rotasi tampilan antara 0° (Normal) atau 180° (Terbalik) sesuai orientasi fisik pemasangan modul layar di dalam enclosure casing Anda.
🎮 Panduan Lengkap Fungsi Ke-3 Tombol Fisik (Dual Mode)
Perangkat dilengkapi 3 tombol fisik taktil serbaguna dengan dukungan gestur cerdas (Klik 1x, Klik 2x Cepat, Klik 3x Cepat, dan Tekan Tahan / Long Press). Fungsi tombol otomatis beradaptasi sesuai mode aktif saat ini:
🔄 Cara Berpindah Antar Mode (Switch Mode):
• Dari XiaoZhi ke Chronchi: Tekan 3x Cepat Tombol BOOT (GPIO 0) atau 2x Cepat Tombol VOL DOWN (GPIO 46).
• Dari Chronchi kembali ke XiaoZhi: Tekan 3x Cepat Tombol BOOT (GPIO 0) atau 2x Cepat Tombol VOL DOWN (GPIO 46).
🤖 1. Fungsi Tombol pada Mode XiaoZhi (Voice Assistant AI & YouTube Multimedia)
Tombol & Pin Gestur Fungsi Utama Deskripsi / Keterangan
Tombol 1: BOOT
GPIO 0 		Klik 1x Bicara / Stop / Interupsi • Stop lagu YouTube jika sedang diputar.
• Interupsi suara AI jika AI sedang berbicara.
• Mulai mendengarkan tanpa wake-word jika standby (Toggle Chat).
Klik 2x Putar Lagu Uji YouTube Langsung memutar lagu pengujian audio remix dari YouTube secara instan.
Klik 3x Switch ke Mode Chronchi Beralih ke mode Smartwatch / BLE companion (jam pintar).
Tekan Tahan (>3s) Reset / Portal Wi-Fi Membuka kembali hotspot Web Config (192.168.4.1) untuk ganti SSID / Wi-Fi.
Tombol 2: VOL UP
GPIO 14 		Klik 1x Volume +10% / Zoom In • Naikkan volume speaker +10%.
• Jika live streaming kamera aktif di layar: Zoom In (1x → 2x → 3x hingga 10x).
Klik 2x Rotasi Layar 180° Memutar tampilan layar ST7789 180 derajat seketika tanpa perlu restart.
Tekan Tahan Volume Maksimal (100%) Mengatur volume speaker langsung ke batas tertinggi 100% MAX.
Tombol 3: VOL DOWN
GPIO 46 		Klik 1x Volume -10% / Zoom Out • Turunkan volume speaker -10%.
• Jika live streaming kamera aktif di layar: Zoom Out perkecil gambar.
Klik 2x Switch ke Mode Chronchi Beralih antara mode Asisten Suara AI dan mode Jam Pintar / BLE Companion.
Tekan Tahan Mute Suara (0%) Membisukan audio seketika (Volume 0%).
⌚ 2. Fungsi Tombol pada Mode Chronchi (Smartwatch & Phone Companion via Chronos BLE)
Tombol & Pin Gestur Fungsi Utama Deskripsi / Keterangan
Tombol 1: BOOT
GPIO 0 		Klik 1x Ganti Layar (Cycle Screen) Berpindah layar secara berurutan:
Jam Utama ➔ Navigasi Maps ➔ Notifikasi ➔ Cuaca ➔ Kontrol Musik ➔ Status HP ➔ kembali ke Jam.
Klik 2x Toggle Dark / Light Mode Mengganti mode warna tema tampilan jam (Gelap / Terang / Preset Tema).
Klik 3x Switch ke Mode XiaoZhi Kembali ke mode Asisten Suara AI XiaoZhi.
Tekan Tahan (1.5 detik) Find Phone (Cari Ponsel) Mengirim sinyal Bluetooth BLE ke ponsel agar berdering kencang untuk dicari saat terselip.
Tombol 2: VOL UP
GPIO 14 		Klik 1x Camera Shutter / Next Music • Jika kamera HP sedang dibuka: Ambil Foto (Shutter Remote Nirkabel).
• Jika pemutar musik HP sedang aktif: Lagu Berikutnya (Next Track).
Klik 2x Rotasi Layar 180° Memutar tampilan layar sebesar 180 derajat seketika.
Tombol 3: VOL DOWN
GPIO 46 		Klik 1x Previous Track Musik Kembali ke lagu sebelumnya pada pemutar musik smartphone.
Klik 2x Switch ke Mode XiaoZhi Beralih kembali ke Mode Asisten Suara AI XiaoZhi.
🗣️ Daftar Lengkap Perintah Suara XiaoZhi (Voice Commands & Tools)
Anda dapat berbicara langsung ke XiaoZhi dalam bahasa Indonesia alami. Firmware telah dilengkapi berbagai tools MCP bawaan untuk mengontrol perangkat keras, media, dan sistem:
🔊 Kontrol Suara & Volume Speaker
• "Naikkan volume" / "Keraskan suaranya" (+10%)
• "Turunkan volume" / "Kecilkan suaranya" (-10%)
• "Setel volume ke 80 persen" (0 - 100%)
• "Berapa volume audio sekarang?"
💡 Kontrol Kecerahan & Redup Layar
• "Redupkan layar" / "Turunkan kecerahan"
• "Terangkan layar" / "Naikkan kecerahan layar"
• "Atur kecerahan layar ke 50 persen" (0 - 100%)
• "Ubah tema ke mode gelap (dark mode)" / "Mode terang"
📶 Reset & Konfigurasi Ulang Wi-Fi
• "Tolong reset Wi-Fi" / "Ganti Wi-Fi" / "Buka konfigurasi Wi-Fi"
• Proteksi Dialog Konfirmasi: AI akan memastikan dengan bertanya:
"Apakah Anda yakin ingin masuk ke mode konfigurasi Wi-Fi? Jawab ya untuk konfirmasi, atau batal."
Setelah dijawab "Ya", hotspot setup otomatis aktif.
🎵 Pemutaran Musik YouTube Streaming
• "Putar lagu [judul lagu / nama artis]" (misal: "Putar lagu Bohemian Rhapsody")
• "Putar musik santai lofi" / "Putar lagu dangdut terbaru"
• "Hentikan musik" / klik 1x tombol BOOT untuk stop musik.
• Audio ditranscode ke Ogg/Opus mono 24kHz super hemat bandwidth.
📷 Kamera AI, Vision & Live Streaming
• Vision AI: "Coba lihat apa yang saya pegang", "Jelaskan benda ini".
• Live Streaming Layar: "Mulai live streaming kamera" / "Tampilkan kamera di layar".
• Zoom Kamera: "Zoom in kamera" / "Zoom out kamera" (hingga 10x).
• Mode Cermin: "Ubah jadi cermin" / "Matikan mode cermin".
• Resolusi: "Ubah resolusi ke VGA (640x480)" / "Ubah ke QVGA".
• Tutup Kamera: "Tutup kamera" / "Hentikan streaming".
ℹ️ Status Sistem & Spesifikasi Hardware
• "Berapa sisa baterai alat ini?" (membaca kapasitas baterai LiPo/Li-ion).
• "Spesifikasi alat ini apa saja?" (AI menyebutkan chip ESP32-S3, RAM 8MB PSRAM, Flash 16MB, kamera OV5640, LCD ST7789, mic INMP441, audio amp MAX98357A).
• "Apa saja fungsi tombol di perangkat ini?" (AI membacakan panduan 3 tombol fisik).
⌚ Panduan Lengkap Mode Chronchi (Smartwatch & Phone Companion via Chronos App)
Mode Chronchi mengubah ESP32-S3 Anda menjadi pendamping jam pintar (smartwatch) nirkabel yang terhubung langsung ke ponsel cerdas Anda melalui koneksi Bluetooth Low Energy (BLE) menggunakan aplikasi Chronos (gratis untuk Android dan iOS).
1
Cara Menghubungkan ke Smartphone (Pairing BLE)
1. Unduh dan pasang aplikasi Chronos dari Google Play Store atau Apple App Store.
2. Pastikan Bluetooth di smartphone Anda dalam kondisi menyala (ON).
3. Alihkan perangkat ke Mode Chronchi (tekan 3x tombol BOOT atau 2x tombol VOL DOWN).
4. Di aplikasi Chronos, masuk ke tab Watch / Devices, lalu tekan tombol Scan.
5. Pilih perangkat bernama Chronchi untuk menyambungkan.
6. Ikon Bluetooth di sudut kiri atas layar jam akan berubah menjadi Hijau menandakan koneksi aktif!
2
Daftar 6 Layar Utama Chronchi (Dapat Diganti dengan 1x Klik Tombol BOOT)
1. ⌚ Layar Jam Utama (Watchface)
• Jam digital besar (sinkron waktu otomatis dari HP, format 12h/24h).
• Kalender hari dan tanggal otomatis.
• Status koneksi Bluetooth BLE.
• Baterai Bar Visual (Tanpa Angka): Menampilkan sisa daya dalam bentuk kapsul baterai bar (Hijau >50%, Oranye >20%, Merah ≤20%, dan Cyan + petir saat charging).
• Smart Glance capsule di bagian bawah.
2. 💬 Layar Notifikasi HP Real-Time
• Menerima pesan masuk dari WhatsApp, Telegram, SMS, Panggilan Telepon (Caller ID), Gmail, Instagram, dll.
• Menampilkan ikon aplikasi, nama pengirim, waktu masuk, dan isi pesan teks secara jelas.
3. 🗺️ Layar Navigasi Google Maps
Saat navigasi rute aktif di Google Maps HP:
• Menampilkan ikon visual belokan dinamis (belok kiri, kanan, putar balik, bundaran, lurus).
• Nama jalan yang harus dituju.
• Sisa jarak belokan (misal 150m), estimasi waktu tiba (ETA), sisa durasi perjalanan, dan kecepatan kendaraan.
4. ⛅ Layar Cuaca & Suhu Real-Time
• Suhu lingkungan terkini (°C) dari lokasi ponsel.
• Kondisi cuaca (Cerah, Hujan, Berawan, Badai).
• Suhu maksimum/minimum (High/Low), kelembapan udara (%), tekanan udara (hPa), indeks UV, dan nama kota/lokasi.
5. 🎵 Layar Kontrol Musik Smartphone
• Mengontrol Spotify, YouTube Music, Apple Music.
• Menampilkan judul lagu, nama artis, nama aplikasi musik, progress bar durasi lagu, dan status Play/Pause.
• Tombol fisik dapat digunakan untuk ganti lagu (Next/Prev).
6. 📱 Layar Status Ponsel (Phone Status)
• Level Baterai Ponsel: Ditampilkan dalam bentuk visual progress bar horizontal (tanpa angka).
• Jaringan Seluler: Menampilkan tipe jaringan ponsel (4G LTE, 5G, Wi-Fi).
• Sinyal Ponsel: Indikator bar kekuatan sinyal seluler (●●●○ 3/4).
3
Fitur-Fitur Spesial Tambahan Chronchi
• 🔍 Find Phone (Cari Ponsel): Tekan tahan Tombol BOOT selama 1.5 detik. Ponsel Anda akan langsung berdering keras meskipun sedang dalam mode diam/silent, memudahkan Anda menemukan ponsel yang terselip.
• 📸 Wireless Camera Remote Shutter: Buka aplikasi kamera di smartphone Anda, lalu klik 1x Tombol VOL UP (GPIO 14) untuk mengambil foto tanpa perlu menyentuh layar HP.
• ⏰ Smart Alarm Alert: Menampilkan peringatan alarm bergetar secara otomatis pada layar saat jadwal alarm di aplikasi Chronos berbunyi.
• 🎨 Kustomisasi Tema Visual: Sesuaikan warna aksen jam dan mode Light/Dark langsung dari menu Chronos atau klik 2x Tombol BOOT.
📌 Referensi Pinout Hardware ESP32-S3
Tabel pemetaan pin GPIO hardware untuk ESP32-S3 N16R8 (Simplex Dual I2S Bus, Layar ST7789/OLED, Kamera OV5640, dan Tombol Kendali):
🎙️ & 🔊 Audio I2S (INMP441 Microphone & MAX98357A Speaker Amplifier)
Modul Pin Modul Pin ESP32-S3 Keterangan & Catu Daya
Microphone
INMP441 (I2S Input) 		VDD / GND 3.3V / GND Catu daya stabil 3.3V & Ground bersama
L/R GND Wajib ke Ground (Mono channel kiri)
SCK GPIO 2 Serial Bit Clock (I2S Input)
WS GPIO 1 Word Select / Left-Right Clock
SD GPIO 42 Serial Data Masuk dari Mic
Speaker Amplifier
MAX98357A (I2S Output) 		VIN / GND 5V / GND Disarankan 5V (atau 3.3V) & Ground bersama
BCLK GPIO 40 Bit Clock Speaker (I2S Output)
LRC GPIO 41 Left / Right Clock (WS) Speaker
DIN GPIO 39 Serial Data Keluar ke Amplifier
GAIN / SD_MODE Opsional Gain default 9dB (GND) atau 12dB (lepas)
🖥️ Tabel Pinout Lengkap ST7789 240x240 (1.3" & 1.54") ➔ ESP32-S3
Modul layar TFT 1.3 inch resolusi 240x240 IPS (Driver ST7789) sangat populer untuk speaker XiaoZhi karena dimensinya yang ringkas, sudut pandang lebar, dan reproduksi warna cerah:
Pin Modul ST7789 Fungsi Pin Sambungkan ke Pin ESP32-S3 Keterangan
GND Ground GND Ground bersama
VCC Power 3.3V (atau 5V) 3.3V direkomendasikan
SCL / SCK SPI Clock GPIO 19 DISPLAY_CLK_PIN
SDA / MOSI SPI Data In GPIO 20 DISPLAY_MOSI_PIN
RES / RST Reset GPIO 21 DISPLAY_RST_PIN
DC / RS Data / Command GPIO 47 DISPLAY_DC_PIN
BLK / BL / LED Backlight Control GPIO 38 DISPLAY_BACKLIGHT_PIN
CS (jika ada 8-Pin) Chip Select GPIO 45 (atau ke GND) Lihat catatan di bawah
📌 Catatan Tambahan Layar ST7789 240x240:
  1. Jika Layar Anda Model 7-Pin (Tanpa Pin CS): Modul TFT 1.3" ST7789 umumnya berformat 7-Pin (GND, VCC, SCL, SDA, RES, DC, BLK). Pada modul ini pin CS internal sudah dihubungkan permanen ke GND pada PCB modul (SPI Mode 3, CS dinonaktifkan). Anda cukup menyambungkan 7 pin tersebut langsung ke ESP32-S3 sesuai tabel di atas tanpa perlu jalur CS.
  2. Jika Layar Anda Model 8-Pin (Ada Pin CS): Sambungkan pin CS layar ke GPIO 45 pada ESP32-S3, atau Anda juga bisa menghubungkannya langsung ke pin GND untuk menghemat pin.
  3. Tegangan VCC: Disarankan menggunakan 3.3V untuk kestabilan sinyal logika SPI driver ST7789 dan menghindari suhu berlebih.
  4. Kontrol Kecerahan Backlight: Sambungkan pin BLK ke GPIO 38 untuk mengaktifkan pengaturan kecerahan layar melalui perintah suara AI ("Redupkan layar", "Terangkan layar") atau melalui portal web.
🖥️ Pinout Modul Layar Lainnya (ST7789 240x280 1.69" & OLED I2C)
Tipe Layar Pin ESP32-S3 Keterangan Jalur Sinyal
ST7789 1.69" IPS LCD
(240x280 8-Pin SPI) 		SCL / SCLK = GPIO 19 SPI Clock Pulsa
SDA / MOSI = GPIO 20 SPI Master Out Slave In Data
DC / RS = GPIO 47 Data / Command Selector
RES / RST = GPIO 21 Hardware Reset Pin Layar
CS = GPIO 45 Chip Select Layar (Active Low)
BLK / BL = GPIO 38 Backlight LED Control (LEDC PWM Kecerahan)
OLED SSD1306 / SH1106
(128x64 I2C) 		SDA = GPIO 20 I2C Serial Data
SCL = GPIO 19 I2C Serial Clock
🔘 Tombol Fisik (Active Low) & Sensor Baterai ADC
Fungsi Pin ESP32-S3 Wiring & Keterangan
Tombol 1: BOOT / Action GPIO 0 Kaki 1 ke GPIO 0, Kaki 2 ke GND (Internal Pull-Up aktif)
Tombol 2: Volume UP GPIO 14 Kaki 1 ke GPIO 14, Kaki 2 ke GND (Internal Pull-Up aktif)
Tombol 3: Volume DOWN GPIO 46 Kaki 1 ke GPIO 46, Kaki 2 ke GND (Internal Pull-Up aktif)
Sensor Pembaca Baterai GPIO 3 (ADC1 CH2) Tegangan baterai via pembagi tegangan (voltage divider 2x 100kΩ) ke ADC (Rasio 1:2)
🔋 Skema Rangkaian Sensor Pembaca Baterai (Voltage Divider ADC - Opsional)
GPIO 3 (ADC1 CH2)
Jika Anda ingin XiaoZhi bertenaga baterai portabel (LiPo / Li-ion 1S 3.7V - 4.2V) dan dapat mendeteksi persentase daya serta animasi baterai pada layar, pasang rangkaian pembagi tegangan 2 resistor 100kΩ (toleransi 1%) berikut: 
[ BAT + ] (Positif Baterai, maks 4.2V)
    │
   ┌┴┐
   │ │  R1 (Resistor 100kΩ)
   └┬┘
    │
    ├───────────────────────► Pin ADC ESP32 (GPIO 3)
    │
   ┌┴┐
   │ │  R2 (Resistor 100kΩ)
   └┬┘
    │
    └───────────────────────► GND ESP32 & [ BAT - ] (Ground Baterai)
💡 Cara Kerja: Rangkaian ini membagi tegangan baterai 4.2V menjadi 2.1V (aman di bawah batas maksimum ADC 3.3V ESP32). Firmware otomatis mengalikan kembali dengan faktor 2.0x sehingga pembacaan voltase dan persen baterai akurat. Anda juga bisa menanyakan status baterai via suara: "Berapa sisa baterai sekarang?".
📶 Konfigurasi Multi-SSID Backup & Gaya Animasi Layar
Portal konfigurasi 192.168.4.1 menyediakan fitur fleksibel untuk keandalan jaringan internet tanpa putus serta kustomisasi visual ekspresi layar:
A
Pilihan Mode 1 Wi-Fi vs Multi-SSID Failover (Backup Wi-Fi)
Pada tab Jaringan Wi-Fi, terdapat tombol pilihan mode koneksi:
  • Mode 1 Wi-Fi (Utama): Menyimpan 1 jaringan Wi-Fi tetap (misal Wi-Fi rumah).
  • Mode Multi Wi-Fi (Failover Otomatis): Anda dapat mendaftarkan beberapa SSID sekaligus dengan sistem prioritas:
    • Prioritas 1 (Utama): Wi-Fi rumah atau router utama.
    • Prioritas 2 (Cadangan 1): Hotspot pribadi dari smartphone Anda.
    • Prioritas 3 (Cadangan 2): Wi-Fi kantor atau modem cadangan.
💡 Sistem Failover Cerdas: Jika Wi-Fi utama mati lampu atau di luar jangkauan, ESP32 otomatis memindai dan menyambung ke Wi-Fi Cadangan dalam hitungan detik tanpa perlu masuk ke mode setup ulang!
B
Gaya Tampilan & Animasi Layar (Klasik vs Dinamis)
Tergantung modul layar yang dipilih pada tab Pengaturan Hardware:
  • Animasi Ekspresi Dinamis (LCD ST7789 IPS): Menampilkan animasi wajah AI yang hidup (mata berkedip santai saat standby, melebar saat mendengarkan, memutar bola mata saat berpikir, dan animasi mulut yang bergerak selaras dengan intonasi suara bicara).
  • Animasi Klasik / Minimalis (OLED SSD1306): Menampilkan animasi gelombang audio (waveform), ikon ekspresi klasik monokrom, serta teks bar status yang sangat hemat memori dan daya.
  • Kustomisasi Tema Jam (Mode Chronchi): Saat beralih ke mode Chronchi, tampilan jam digital memiliki beberapa pilihan tema visual elegan dengan indikator baterai bar visual (tanpa angka) dan sinkronisasi data BLE.
🚀 Panduan Pinout & Cara Penggunaan ESP32-C3 Super Mini / Pro (Dual-Mode Edition)
Firmware khusus untuk mikrokontroler ESP32-C3 RISC-V 32-bit Single-Core @ 160MHz (4MB Flash, ~400KB SRAM internal). Dirancang sebagai solusi smart speaker AI yang sangat compact, efisien, hemat daya, dan hemat biaya (~Rp 91.000 total perakitan).
⚠️ Perhatian Khusus Arsitektur Audio ESP32-C3 (Shared Clock Full Duplex):
ESP32-C3 hanya memiliki 1 periferal I2S. Oleh karena itu, modul Microphone (INMP441) dan Amplifier Speaker (MAX98357A) wajib berbagi pin Clock (BCLK = GPIO 5, WS/LRC = GPIO 6) secara paralel bersamaan pada mode Full Duplex.
🔄 Sistem Dual-Boot Saling Eksklusif (Mutual Exclusion):
• Mode XiaoZhi (Voice Assistant AI): Mengaktifkan Wi-Fi, audio I2S (Mic + Spk), WakeNet wake word, WebSocket AI Cloud, dan streaming musik YouTube.
• Mode Chronchi (OLED Smart Companion): Wi-Fi dan I2S dimatikan sepenuhnya agar radio Bluetooth Low Energy (BLE) dapat berjalan 100% stabil pada sisa RAM 400KB ESP32-C3 tanpa bentrok frekuensi 2.4GHz.
🌐 Alur Konfigurasi Wi-Fi & Pilihan Wake Word (Web Portal 192.168.4.1)
Saat menyala pertama kali atau saat tombol reset ditekan, hubungkan smartphone/laptop Anda ke hotspot bernama XiaoZhi-XXXX lalu buka browser ke alamat http://192.168.4.1:
1
Pilihan Mode 1 Wi-Fi vs Multi-SSID Failover Otomatis
Anda dapat mendaftarkan 1 SSID atau beberapa SSID Wi-Fi cadangan (Prioritas 1: Wi-Fi Rumah, Prioritas 2: Hotspot HP, Prioritas 3: Wi-Fi Kantor). Jika Wi-Fi utama terputus, ESP32-C3 otomatis beralih ke Wi-Fi cadangan dalam hitungan detik.
2
Pilihan Model Wake Word (Kata Pemicu Suara Bawaan)
Pada portal konfigurasi, tersedia menu pemilihan model deteksi kata pemicu (WakeNet On-Device) tanpa memerlukan koneksi cloud:
1. "Hi Jason" (hijason) — Default
Paling direkomendasikan. Respon sangat cepat, akurasi tinggi, dan minim false trigger pada kebisingan ruangan.
2. "Hi Lexin" (hilexin)
Kata pemicu resmi Espressif Lexin. Stabil dan cocok untuk pengucapan bahasa Inggris standar.
3. "Hi ESP" (hiesp)
Kata pemicu singkat 2 suku kata untuk panggilan cepat dan responsif.
4. "Ni Hao Xiaozhi" (nihaoxiaozhi)
Kata pemicu klasik Xiaozhi berbahasa Mandarin.
💡 Tampilan Standby Dinamis di Layar OLED:
Saat dalam kondisi standby, layar OLED otomatis menampilkan petunjuk pemicu suara sesuai pilihan Anda, contoh: Standby, say: Hi Jason. Dilengkapi fitur cooldown 2 detik agar AI tidak terpanggil berulang kali.
🎮 Panduan Lengkap Fungsi Tombol Fisik ESP32-C3 (Dual-Mode)
Navigasi tombol dibuat efisien dan multifungsi menggunakan kombinasi gestur cerdas (Klik 1x, Klik 2x Cepat, Klik 3x, dan Tekan Tahan):
🔄 Cara Berpindah Mode (XiaoZhi ↔ Chronchi):
• Metode Cepat (Fast Switch): Tekan Klik 2x Cepat pada Tombol Utama (GPIO 3) untuk beralih mode seketika tanpa masuk menu!
• Metode Visual Menu: Tahan Tombol Utama (GPIO 3) selama 2.5 detik hingga menu SELECT MODE muncul di layar OLED, lalu klik singkat untuk memilih dan tahan 2 detik untuk konfirmasi.
Tombol & Pin Gestur Fungsi Utama Deskripsi / Keterangan
Tombol 1: Utama
GPIO 3 (Active Low) 		Klik 1x (Singkat) Bicara / Stop / Interupsi • Mulai bicara manual (Push-to-Talk).
• Interupsi suara AI saat AI sedang berbicara.
• Instant Stop Musik: Langsung menghentikan lagu YouTube yang sedang berputar (0 ms latency).
Klik 2x Cepat Fast Switch Mode (XiaoZhi ↔ Chronchi) Beralih langsung antara mode Asisten Suara AI XiaoZhi dan mode Smartwatch BLE Chronchi secara instan.
Tahan 2.5 Detik Visual Menu (SELECT MODE) Membuka menu grafis pemilihan mode di layar OLED. Klik singkat untuk mengganti pilihan dan tahan 2 detik untuk konfirmasi.
Klik 3x (di Mode Chronchi) Hapus Konfigurasi Wi-Fi Menghapus data SSID dan kata sandi Wi-Fi dari NVS Flash seketika tanpa perlu membuka portal setup.
Tombol 2: Sekunder
GPIO 2 (Active Low) 		Klik 1x (Singkat) Toggle Hands-Free (ON/OFF) Mengaktifkan mode bicara hands-free otomatis. Anda bisa berbicara terus menerus tanpa menyentuh tombol. Jika hening >12 detik, perangkat masuk ke mode standby hemat daya.
Tekan Tahan 5 Detik Reset SSID & Reboot Membersihkan kredensial Wi-Fi lama di NVS dan melakukan reboot mikrokontroler.
🗣️ Daftar Lengkap Perintah Suara XiaoZhi (ESP32-C3 Edition)
ESP32-C3 mendukung perintah suara alami dalam bahasa Indonesia dengan latensi rendah:
🔊 Kontrol Suara & Volume Speaker
• "Naikkan volume" / "Keraskan suaranya" (+10%)
• "Turunkan volume" / "Kecilkan suaranya" (-10%)
• "Setel volume ke 80 persen" (0 - 100%)
• "Berapa volume audio sekarang?"
📶 Reset Wi-Fi via Suara (Dialog Aman)
• "Tolong reset Wi-Fi" / "Ganti Wi-Fi"
• AI akan meminta konfirmasi terlebih dahulu:
"Apakah Anda yakin ingin masuk ke mode konfigurasi Wi-Fi? Jawab ya atau batal."
• Jawab "Ya" untuk membuka hotspot setup.
🎵 Pemutaran Musik YouTube (Adaptive Bitrate)
• "Putar lagu [judul lagu / nama penyanyi]"
• "Putar musik santai lofi"
• "Hentikan musik" atau tekan 1x tombol GPIO 3.
• Menggunakan format Ogg/Opus mono 24kHz dengan adaptive bitrate 11kbps super hemat RAM untuk ESP32-C3!
ℹ️ Status Sistem & Daya Baterai
• "Berapa sisa baterai alat ini?" (membaca tegangan baterai 1S via ADC1 CH1 GPIO 1).
• "Spesifikasi alat ini apa saja?" (AI membacakan chip ESP32-C3, RAM 400KB, Flash 4MB, I2S Mic + Spk, OLED SSD1306).
• "Apa saja fungsi tombol di perangkat ini?"
⌚ Panduan Lengkap Mode Chronchi di ESP32-C3 (Smartwatch & BLE Companion)
Mode Chronchi mengubah ESP32-C3 Anda menjadi pendamping jam pintar meja (smart desk clock & notification hub) melalui koneksi Bluetooth Low Energy (BLE) yang terhubung ke aplikasi Chronos atau ESPBridge (Android / iOS).
1
Cara Menghubungkan ke Smartphone via Bluetooth BLE
1. Beralih ke Mode Chronchi dengan menekan Klik 2x Cepat pada GPIO 3.
2. Layar OLED akan menampilkan logo Chronchi dan BLE advertising otomatis aktif.
3. Di smartphone, pasang aplikasi Chronos (Play Store / App Store) atau ESPBridge APK.
4. Nyalakan Bluetooth HP, scan perangkat BLE bernama Chronchi, lalu pilih Pair / Connect.
5. Layar OLED menampilkan status ESPBridge READY dan sinkronisasi data langsung aktif!
2
Data & Layar yang Tampil pada Layar OLED SSD1306 (128x64)
1. ⌚ Layar Home (Clock & Status)
• Jam digital besar tersinkronisasi otomatis dari ponsel.
• Hari, tanggal, dan bulan otomatis.
• Indikator status koneksi Bluetooth BLE.
• Indikator baterai perangkat & status charging.
2. 💬 Notifikasi HP Real-Time & Getar (Haptic)
• Menampilkan pesan masuk dari WhatsApp, Telegram, SMS, Caller ID panggilan masuk, serta notifikasi aplikasi.
• Getaran Taktil (Haptic Pulse): Setiap kali pesan masuk, motor getar (GPIO 20) otomatis bergetar 2x denyut pendek (100ms ON, 80ms OFF, 100ms ON).
• Teks nama pengirim dan isi pesan tampil selama 7 detik di layar OLED.
3. 🗺️ Navigasi Turn-by-Turn Google Maps
• Saat bernavigasi di ponsel, layar OLED menampilkan arah belokan rute (maneuver), jarak belokan (misal 150m), dan nama jalan tujuan.
4. ⛅ Cuaca & Suhu Real-Time
• Menampilkan suhu lingkungan aktual (°C) dan kondisi cuaca dari GPS smartphone secara real-time.
5. 📱 Status Ponsel (Phone Status)
• Level sisa baterai ponsel, status charging ponsel, dan indikator kekuatan sinyal seluler.
6. 📶 BLE Wi-Fi Provisioning
• Anda dapat mengirim konfigurasi nama SSID dan password Wi-Fi baru langsung dari aplikasi smartphone via BLE tanpa perlu membuka mode web portal hotspot!
3
🔔 Fitur Temukan Perangkat (Find My Device) dari Chronos & ESPBridge
Ketika Anda lupa menaruh perangkat atau ingin mencarinya melalui smartphone:
1. Buka aplikasi Chronos dan tekan menu Find Watch / Temukan Perangkat (atau kirim perintah FIND di ESPBridge).
2. Bunyi Dentangan Bell Nyaring Maksimal: Speaker amplifier I2S MAX98357A (3W) seketika membunyikan nada dentang bell ganda (Ding-Dong! 2048 Hz & 1706 Hz) pada volume maksimal 100% secara berulang.
3. Alarm Getar Berdenyut: Motor getar aktif berdenyut secara ritmik (350ms ON, 250ms OFF) agar perangkat mudah ditemukan meski tertutup barang atau di tempat gelap.
4. Tampilan Layar OLED: OLED menampilkan popup peringatan CARI PERANGKAT - Panggilan dari Chronos.
5. Matikan Dering: Tekan tombol fisik GPIO 3 sekali pada perangkat ESP32 untuk langsung membungkam suara bell dan mematikan getaran seketika!
📌 Referensi Pinout Hardware ESP32-C3 Mini
Tabel pemetaan pin GPIO hardware untuk ESP32-C3 Super Mini (I2S Shared-Clock Audio, Layar OLED I2C, Tombol, dan Sensor Baterai):
🎙️ & 🔊 Audio I2S Bus (Shared Clock Full Duplex: INMP441 + MAX98357A)
Modul Pin Modul Pin ESP32-C3 Keterangan & Wiring Sambungan
Microphone
INMP441 		VDD / GND 3.3V / GND Catu daya stabil 3.3V & Ground bersama
L/R GND Wajib ke GND (mono channel kiri)
SCK GPIO 5 Bit Clock bersama (Paralel ke BCLK MAX98357A)
WS GPIO 6 Word Select bersama (Paralel ke LRC MAX98357A)
SD GPIO 4 Serial Data Masuk dari Mic
Amplifier Speaker
MAX98357A 		VIN / GND 5V (USB/VBUS) / GND Wajib 5V untuk suara jernih & kencang
BCLK GPIO 5 Bit Clock bersama (Paralel dari SCK INMP441)
LRC GPIO 6 Word Select bersama (Paralel dari WS INMP441)
DIN GPIO 7 Serial Data Keluar ke Amplifier
📺 Layar OLED SSD1306 128x64 (I2C)
Pin Modul OLED Pin ESP32-C3 Keterangan & Fungsi
VCC / GND 3.3V / GND Catu daya layar 3.3V & Ground
SDA GPIO 0 I2C Serial Data
SCL GPIO 10 I2C Serial Clock
🔘 & 🔋 Tombol Fisik & Sensor Baterai 1S
Komponen / Fitur Pin ESP32-C3 Wiring & Keterangan
Tombol Utama (Bicara / Fast Mode Switch) GPIO 3 Active Low: Kaki 1 ke GPIO 3 & Kaki 2 ke GND
Tombol Sekunder (Hands-free / Reset SSID) GPIO 2 Active Low: Kaki 1 ke GPIO 2 & Kaki 2 ke GND
Sensor Pembagi Tegangan Baterai 1S GPIO 1 (ADC1_CH1) Titik tengah resistor pembagi tegangan 100kΩ / 100kΩ dari BAT+
🔌 Apa itu MCP?

MCP (Model Context Protocol) adalah jembatan komunikasi cerdas yang menghubungkan perangkat suara XiaoZhi (ESP32) dengan sistem backend Xiaozhi Indonesia. Dengan menghubungkan MCP, XiaoZhi dapat mengakses seluruh ekosistem fitur: Knowledge Base dokumen, 63 Tools MCP, Pemutar Musik & Playlist YouTube, kontrol Smart Home IoT, pencarian web, dan riwayat obrolan secara real-time.

ℹ️ Prasyarat Awal: Pastikan perangkat ESP32 Anda telah selesai di-flash firmware dan berhasil terkoneksi ke jaringan Wi-Fi. Saat Wi-Fi terhubung, ESP32 akan mengeluarkan suara atau menampilkan 6 Digit Kode Pairing / Bind Code di layar OLED/TFT (misal: 482910). Kode inilah yang digunakan untuk menghubungkan perangkat ke akun xiaozhi.me.
📋 Langkah-Langkah Menghubungkan MCP ke Xiaozhi Indonesia
1
Buka xiaozhi.me & Tambahkan Perangkat
Kunjungi portal resmi https://xiaozhi.me dan login ke akun XiaoZhi Anda.
Di halaman dashboard utama, klik tombol biru "+ Tambah Perangkat" yang terletak di pojok kanan atas.
Masukkan 6 Digit Kode Pairing yang muncul dari perangkat ESP32 Anda, lalu klik konfirmasi untuk mendaftarkan perangkat.
Tombol Tambah Perangkat di xiaozhi.me
🔍 Klik tombol + Tambah Perangkat di xiaozhi.me
2
Buka Konfigurasi Perangkat (Configure)
Setelah perangkat berhasil ditambahkan dengan kode 6 digit, kartu agen / perangkat Anda akan muncul di daftar (misal bernama "Agen tanpa nama" atau nama kustom Anda).
Klik tombol "Konfigurasikan" (atau Konfigurasik...) di bagian bawah kartu perangkat tersebut untuk membuka menu setelan agen.
Kartu Agen dan Tombol Konfigurasikan
⚙️ Klik tombol Konfigurasik... pada kartu agen perangkat
3
Pilih Tab "Perluasan" & Salin MCP Endpoint URL
Pada jendela popup pengaturan agen yang terbuka:
  1. Pilih tab "Perluasan" di baris navigasi atas (di sebelah Pengakuan Pembicara).
  2. Gulir ke bawah ke bagian "Layanan Kustom", lalu klik untuk membuka opsi "MCP Endpoint".
  3. Pastikan Endpoint Status bertuliskan ● Online.
  4. Pada kotak URL endpoint, Anda akan melihat alamat koneksi yang diawali dengan wss://api.xiaozhi.me/mcp/?token=....
  5. Klik ikon Salin (Copy) yang ada di sebelah kanan kolom URL untuk menyalin seluruh tautan endpoint ke clipboard.
Tab Perluasan dan Menu MCP Endpoint
📋 Buka tab Perluasan > MCP Endpoint > Klik Ikon Salin
⚠️ PENTING: Pastikan Anda menyalin SELURUH URL LENGKAP yang diawali dengan wss:// (contoh: wss://api.xiaozhi.me/mcp/?token=eyJhbGciOi...), jangan hanya menyalin bagian token acaknya saja!
4
Masuk ke xiaozhiscig.biz.id & Buka Menu "MCP XiaoZhi"
Buka portal website xiaozhiscig.biz.id dan login ke akun Anda.
Di menu sidebar sebelah kiri, klik menu "MCP XiaoZhi" (atau Anda juga dapat mengakses form input "Koneksi XiaoZhi" langsung di halaman Dashboard).
5
Tempelkan URL MCP Endpoint & Simpan
Di halaman MCP XiaoZhi, tempelkan (paste) URL endpoint yang sudah disalin tadi ke kolom input "URL MCP / Token Endpoint".
Klik tombol "Simpan" atau "Hubungkan".
Sistem server Xiaozhi Indonesia akan segera melakukan jabat tangan (handshake) WebSocket dengan endpoint XiaoZhi Anda.
Format URL yang ditempel: wss://api.xiaozhi.me/mcp/?token=eyJhbGciOiJFUzI1Ni...
6
Simpan di xiaozhi.me & Verifikasi Status Terhubung
Kembali ke tab/jendela xiaozhi.me, lalu klik tombol biru "Simpan" di pojok kanan bawah modal konfigurasi untuk memastikan pengaturan tersimpan.
Tunggu 3-5 detik:
  • Di dashboard xiaozhiscig.biz.id, indikator status radar akan berubah menjadi ● Terhubung.
  • Di xiaozhi.me, status MCP Endpoint akan menampilkan ● Online.
🎉 Selamat! Perangkat XiaoZhi Anda kini telah terhubung penuh dengan Xiaozhi Indonesia. Anda bisa langsung mencoba memanggil XiaoZhi: "XiaoZhi, putarkan lagu favorit" atau "XiaoZhi, nyalakan lampu ruang tamu"!
⚠️ Troubleshooting & Kendala Umum MCP
Jika status MCP tidak kunjung "Terhubung" atau muncul pesan error:
  • Cek Format URL: Pastikan URL diawali dengan wss://api.xiaozhi.me/mcp/?token= dan tidak terpotong saat di-copy.
  • Status Wi-Fi ESP32: Pastikan board ESP32 Anda tetap menyala dan terhubung dengan jaringan internet yang stabil.
  • Token Baru: Jika token kedaluwarsa atau berubah, klik ikon refresh di samping "Endpoint Status" pada xiaozhi.me untuk membuat URL baru, lalu salin dan tempel ulang di xiaozhiscig.biz.id.
  • Tombol Simpan: Jangan lupa klik tombol biru "Simpan" di modal xiaozhi.me setelah menghubungkan.
🎧

Tutorial & Cara Penggunaan: Musik & Playlist

Panduan praktis cara mengelola lagu favorit Anda di Web Dashboard, menggunakan fitur Siap Putar Cepat (Audio Cache) agar lagu tidak tersendat, serta daftar perintah suara terlengkap untuk speaker XiaoZhi ESP32.

⚡ Playlist Musik (Diputar Instan & Lancar)

Lagu tersimpan di server. Sekali dipanggil lewat suara, speaker langsung berbunyi seketika tanpa jeda, stabil, dan bebas putus-putus.

🌐 Putar Bebas Musik Apa Saja (YouTube)

Ingin lagu di luar playlist? Anda tetap bisa memutar lagu apa saja di YouTube. Cukup sebutkan judul lagunya ke Xiaozhi.

1
Cara Menambahkan Lagu ke Playlist (Web Dashboard)
Tambahkan lagu favorit Anda langsung dari antarmuka web dashboard:
  1. Buka menu Playlist pada sidebar dashboard.
  2. Klik tombol merah ➕ Tambah Lagu di kanan atas tabel.
  3. Tempel link video musik dari YouTube (contoh: https://www.youtube.com/watch?v=... atau https://youtu.be/...) atau link TikTok (contoh: https://vt.tiktok.com/...).
  4. Sistem otomatis mendeteksi Judul Lagu, Artis/Uploader, dan Durasi secara instan.
  5. Klik Simpan Lagu. Lagu langsung tersimpan ke playlist dan server otomatis menyiapkan audionya di latar belakang.
2
Aturan Durasi & Kuota Playlist
Agar penyimpanan server tetap rapi dan optimal bagi seluruh pengguna:
⚡ 1 Lagu Versi Panjang (Maks. 1 Jam 10 Menit):
Setiap pengguna diizinkan menyimpan 1 lagu berdurasi panjang hingga maksimal 1 jam 10 menit (sangat cocok untuk kompilasi lagu santai, podcast, murottal Al-Qur'an, atau musik fokus belajar).
⏱️ Lagu Lainnya (Maksimal 10 Menit):
Setelah kuota 1 lagu panjang digunakan, lagu-lagu berikutnya dibatasi maksimal 10 menit per video.
🚫 Live Stream Otomatis Ditolak:
Video siaran langsung (live stream) tidak dapat disimpan ke playlist karena tidak memiliki durasi selesai yang pasti.
3
Status Kesiapan Lagu & Unduh Cache (Anti Putus-putus)
Agar lagu dapat diputar dengan lancar tanpa tersendat di speaker Xiaozhi, server secara otomatis menyiapkan file lagu Anda terlebih dahulu:
  • ⚡ 100% Siap Diputar: File lagu sudah tersimpan sempurna di server. Saat Anda panggil lewat suara, speaker langsung memutarnya seketika tanpa jeda dan sangat stabil.
  • ⏳ Mengunduh (X%): Server sedang menyiapkan file lagu di latar belakang. Anda dapat melihat persentase proses unduhannya secara langsung di tabel playlist.
  • ⚠️ Belum Di-cache: Lagu baru saja ditambahkan dan menunggu giliran unduh. Anda tetap bisa memutarnya secara langsung lewat internet.
💡 Tombol "Unduh Semua Cache": Pada halaman playlist web, Anda cukup mengklik tombol "⚡ Unduh Semua Cache" agar server menyiapkan seluruh lagu playlist secara otomatis satu per satu.
🗑️ Pembersihan Otomatis: Saat Anda menghapus lagu dari playlist, file di server akan otomatis ikut terhapus bersih sehingga ruang penyimpanan Anda tetap rapi.
4
Daftar Perintah Suara ke Xiaozhi (Voice Commands)
Kendalikan seluruh pemutaran musik langsung dengan berbicara ke speaker Xiaozhi:
🎵 1. Putar Berdasarkan Nomor Playlist
"Xiaozhi, putar playlist nomor 1"
"Xiaozhi, mainkan lagu nomor 3"
Memutar lagu sesuai urutan nomor di playlist akun Anda.
🎶 2. Putar Berdasarkan Judul Lagu Playlist
"Xiaozhi, putar lagu Bohemian Rhapsody dari playlist"
"Xiaozhi, putar DJ Haning di playlist"
Mencocokkan judul lagu yang tersimpan di playlist Anda.
❓ 3. Perintah Playlist Umum (Tanya Pilihan)
"Xiaozhi, putar playlist saya"
"Xiaozhi, putar lagu di playlist"
Xiaozhi akan merespons ramah: menanyakan nomor atau judul lagu mana yang mau diputar sambil menyebutkan pilihan lagunya.
⚡ 4. Cek Status Kesiapan Lagu
"Xiaozhi, cek status cache playlist saya"
"Xiaozhi, lagu mana yang sudah siap diputar lancar?"
Xiaozhi menginfokan lagu mana yang sudah 100% siap putar lancar dan mana yang masih dalam proses unduh.
📋 5. Cek Seluruh Daftar Lagu Playlist
"Xiaozhi, sebutkan lagu di playlist saya"
"Xiaozhi, apa saja lagu di playlist saya?"
Xiaozhi membacakan daftar lagu yang tersimpan di akun Anda.
🌐 6. Putar Lagu Bebas dari YouTube
"Xiaozhi, putar lagu Denny Caknan"
"Xiaozhi, setel musik lofi hip hop santai"
Jika tidak ada di playlist, Xiaozhi otomatis mencarinya langsung di YouTube dan memutarnya ke speaker.
⏹️ 7. Hentikan Pemutaran Musik
"Xiaozhi, hentikan musik" / "Xiaozhi, matikan lagu" / "Xiaozhi, stop musik"
Menghentikan pemutaran audio di speaker secara seketika.
🔔 Peringatan Otomatis Kestabilan Audio:
Jika Anda meminta memutar lagu playlist yang cachenya belum selesai diunduh, Xiaozhi akan tetap memutarkannya lewat internet dan secara otomatis memberikan peringatan suara singkat: "Perhatian: Lagu ini masih dalam proses persiapan (X%). Pemutaran langsung mungkin berpotensi tersendat jika jaringan internet kurang stabil."
🏠 Panduan Lengkap Smart Home & Relay Nyata XiaoZhi

Xiaozhi Indonesia menyediakan dua mode ekosistem Smart Home yang dapat digunakan secara fleksibel: Smart Home Virtual (simulasi interaktif di web) dan Hardware Relay Nyata (modul relay fisik 24/7 berbasis MQTT & ESP32 untuk mengontrol saklar lampu, pompa, dan peranti listrik riil).

🎛️

Mode 1: Smart Home Virtual

Simulasi Web Interaktif

Simulasi saklar lampu & perangkat rumah langsung di layar browser tanpa memerlukan hardware relay fisik. Sangat cocok untuk menguji perintah suara dan integrasi MCP.

🎛️ Buka Smart Home Virtual
⚡

Mode 2: Relay Nyata (Fisik 24/7)

Hardware Fisik Modul Relay Optocoupler

Kontrol modul relay optocoupler asli yang tersambung ke beban listrik riil (lampu 220V, pompa air, stopkontak, kipas) via broker MQTT latensi rendah.

⚡ Buka Pengaturan Relay Nyata
🔌 Skema Pengkabelan Hardware Relay Fisik (ESP32 & Optocoupler)
Modul relay yang umum digunakan adalah modul 1, 2, 4, atau 8 Channel dengan Optocoupler Isolation (Active-LOW trigger). Berikut adalah cara menghubungkan board ESP32 Anda ke modul relay:
Pin Modul Relay Koneksi ke ESP32 Keterangan / Fungsi
VCC VIN / 5V ESP32 Catu daya koil relay (5V DC dari USB atau adaptor eksternal).
GND GND ESP32 Ground bersama antara modul relay dan board ESP32.
IN 1 GPIO 4 (Default S3/C3/Classic) Sinyal kontrol Channel 1 (Lampu Ruang Tamu / Saklar 1).
IN 2 GPIO 5 (S3/C3) / GPIO 16 (Classic) Sinyal kontrol Channel 2 (Lampu Kamar / Saklar 2).
IN 3 & IN 4 GPIO 6 & GPIO 7 (S3) / GPIO 17 & 18 (Classic) Sinyal kontrol Channel 3 & Channel 4 (Dapur, Teras, dll).
⚡ Diagram Terminal Saklar Listrik PLN 220V (Beban Bebas): 
[ Fasa PLN (Live 220V) ] ──────────────────────┐
                                                ▼
                                         ┌──────────────┐
                                         │  COM (Common)│
                                         │   RELAY      │
                                         │  NO (Norm.Op)│
                                         └──────┬───────┘
                                                │ (Kabel Fasa Terkontrol)
                                                ▼
                                         ┌──────────────┐
                                         │  LAMPU /     │
                                         │  BEBAN AC    │
                                         └──────┬───────┘
                                                │
[ Netral PLN (Neutral) ] ───────────────────────┴─────────────────────────┘
Prinsip Kerja Terminal:
• COM (Common): Masukan kabel fasa utama dari stopkontak/PLN.
• NO (Normally Open): Sambungkan ke beban listrik. Dalam keadaan normal sirkuit terputus (lampu mati). Ketika relay dipicu ON oleh ESP32, kontak NO akan tersambung ke COM dan lampu menyala.
• NC (Normally Closed): Kontak tertutup saat relay mati (jarang digunakan untuk lampu rumah biasa).
⚠️ PERINGATAN KESELAMATAN TEGANGAN TINGGI (220V AC):
Arus listrik bolak-balik (AC) 220V dari PLN sangat berbahaya dan berisiko sengatan mematikan jika tersentuh. Selalu pastikan MCB / Sekring rumah dalam posisi OFF (Padam) saat merakit kabel ke terminal relay, dan gunakan isolasi pembungkus kabel atau box panel tertutup yang aman.
⚡ Cara Setup & Flash Firmware Relay Nyata (24/7 Non-Stop)
1
Buka Menu Relay Nyata & Tambah Ruangan
Masuk ke menu Relay Nyata di sidebar. Klik "+ Tambah Ruangan / Device", beri nama ruangan (misal: Ruang Tamu), dan tentukan jumlah relay (1 s/d 8 channel).
2
Download Paket Project Arduino (1-Klik ZIP)
Pada kartu ruangan yang baru dibuat, klik tombol "📦 Download Project ZIP". File ZIP ini sudah otomatis berisi sketch xiaozhi_esp32_relay_24h.ino dan file xiaozhi_relay_config.h yang telah terkonfigurasi dengan Client ID, Token Otentikasi, dan Topik MQTT unik ruangan Anda.
3
Isi Wi-Fi Rumah & Flash via Arduino IDE
Ekstrak file ZIP, buka dengan Arduino IDE, masukkan nama Wi-Fi dan kata sandi rumah Anda pada baris WIFI_SSID & WIFI_PASSWORD, lalu klik Upload ke board ESP32 Anda.
4
Perangkat Otomatis Online 24/7
ESP32 akan otomatis tersambung ke broker MQTT resmi mqtt.xiaozhiscig.biz.id (Port 1883). Di dashboard web, status ruangan akan berubah menjadi 🟢 Online (Tersambung) dengan indikator latensi real-time.
📋 Daftar Ruangan Default & Channel Virtual
Channel Ruangan Perangkat Terhubung Contoh Perintah Suara
CH 1 Ruang Tamu Lampu Utama "XiaoZhi, nyalakan lampu ruang tamu"
CH 2 Dapur Lampu & Exhaust Fan "XiaoZhi, matikan lampu dapur"
CH 3 Kamar Mandi Lampu Kamar Mandi "XiaoZhi, nyalakan lampu kamar mandi"
CH 4 Kamar Tidur Utama Lampu Tidur / Saklar 4 "XiaoZhi, matikan lampu kamar tidur"
CH 5 Teras Depan Lampu Sorot Teras "XiaoZhi, nyalakan lampu teras depan"
CH 6 Garasi / Pagar Alarm / Pintu Garasi "XiaoZhi, nyalakan alarm garasi"
CH 7 Kamar Anak / Kamar 2 Lampu Meja Belajar "XiaoZhi, matikan lampu kamar dua"
CH 8 Ruang Tamu / AC Saklar AC / Pendingin "XiaoZhi, hidupkan AC ruang tamu"
🎤 Ragam Contoh Perintah Suara (Voice Commands)
💡 Kontrol Saklar Tunggal:
  • "Nyalakan lampu ruang tamu"
  • "Matikan lampu dapur"
  • "Hidupkan lampu teras"
  • "Padamkan saklar kamar tidur"
🏠 Kontrol Serentak (Grup):
  • "Nyalakan semua lampu rumah"
  • "Matikan seluruh saklar"
  • "Matikan semua perangkat"
  • "Hidupkan semua relay"
🔍 Pengecekan Status:
  • "Bagaimana status smart home?"
  • "Lampu mana saja yang sedang menyala?"
  • "Apakah lampu teras menyala?"
  • "Status saklar kamar tidur bagaimana?"
🔧 Daftar 66 Tools MCP Xiaozhi

Xiaozhi terhubung dengan 66 Tools MCP berstandar ilmiah, memori semantik vektor, profil persona pengguna, dan realtime. Tools ini otomatis dipanggil oleh Xiaozhi saat mendengarkan pertanyaan atau instruksi suara kamu.

🎓 1. Pembelajaran & Akademik (Study Suite)
solve_study_problem
Menyelesaikan soal latihan/ujian secara bertahap: Identifikasi data (Diketahui/Ditanya), Teori/Rumus dasar, Langkah kalkulasi step-by-step, Jawaban akhir, dan Tips agar tidak terjebak.
🗣️ "Xiaozhi, bantu selesaikan soal bola dilempar ke atas dengan kecepatan awal 20 m/s, berapa tinggi maksimumnya?"
explain_concept
Menjelaskan konsep rumit dengan 2 tingkat penjelasan: Definisi Akademik Resmi (cocok untuk ujian/tugas) dan Analogi Sederhana Dunia Nyata (ELI5) agar langsung paham logikanya.
🗣️ "Jelaskan apa itu Polymorphism dalam pemrograman dengan analogi sederhana."
quiz_me
Membuat kuis latihan interaktif (pilihan ganda atau esai singkat) berdasarkan topik yang sedang dipelajari lengkap dengan kunci jawaban dan pembahasan.
🗣️ "Xiaozhi, uji saya dengan 3 soal kuis tentang Hukum Termodinamika."
lookup_formula
Mencari rumus cepat, unit satuan SI, dan variabel untuk Matematika, Fisika, Kimia, atau Ekonomi.
🗣️ "Apa rumus menghitung gaya gravitasi Newton?"
academic_english_helper
Membantu penulisan akademik bahasa Inggris: proofreading grammar, pemilihan kata formal untuk abstrak/skripsi, dan parafrase anti-plagiarisme.
🗣️ "Perbaiki kalimat abstrak bahasa Inggris ini agar lebih formal dan akademis."
lookup_kbbi
Mengecek ejaan baku, bentuk tidak baku, kelas kata (nomina, verba, adjektiva), dan definisi resmi bahasa Indonesia menurut KBBI.
🗣️ "Kata yang baku itu mempesona atau memukau menurut KBBI?"
search_wikipedia
Mengambil informasi ensiklopedia faktual resmi dari Wikipedia bahasa Indonesia secara ringkas dan bebas halusinasi.
🗣️ "Siapa itu Alan Turing dan apa pengaruhnya bagi dunia komputer menurut Wikipedia?"
🧠 2. Analisis Spesialis (Filsafat, Psikologi & IT)
detect_logical_fallacy
Membedah argumen, opini, atau teks debat untuk mendeteksi cacat logika (Ad Hominem, Straw Man, False Dilemma, Slippery Slope, Circular Reasoning, dll) serta teknik rekonstruksi argumen (steel-manning).
🗣️ "Bedah argumen ini apakah ada sesat pikirnya: 'Kamu masih bocah tahu apa tentang negara ini!'."
identify_cognitive_bias
Menganalisis distorsi pola pikir dan bias kognitif (Confirmation Bias, Sunk Cost Fallacy, Dunning-Kruger, Catastrophizing), dilengkapi pertanyaan sokratik refleksi dan teknik pembingkaian ulang (CBT Reframing).
🗣️ "Saya takut gagal terus sampai tidak mau mulai kerjaan baru, bias kognitif apa yang terjadi pada saya?"
it_code_and_architecture_helper
Panduan berstandar Senior Software Engineer untuk debugging kode (root cause & Big-O), GoF Design Patterns, arsitektur Clean/Microservices, optimasi database SQL/NoSQL, dan DevOps (Docker & Git CLI).
🗣️ "Kapan saya harus memakai Repository Pattern dibanding arsitektur MVC sederhana?"
🕊️ 3. Kitab Suci, Doa & Tata Cara Ibadah Lintas Agama
lookup_scripture_and_verse
Mencari nama surat, kitab suci, pasal, dan nomor ayat untuk 7 tradisi agama (Islam, Kristen, Katolik, Hindu, Buddha, Konghucu, Yahudi) lengkap dengan transliterasi fonetik latin, terjemahan Indonesia, dan hikmahnya.
🗣️ "Xiaozhi, bacakan surat Al-Ikhlas beserta arti dan transliterasinya", atau "Bacakan Mazmur 23".
get_prayer_and_worship_guide
Bimbingan doa harian dan tata cara ibadah langkah-demi-langkah (Sholat 5 waktu & wudhu, Doa Bapa Kami & Salam Maria, Liturgi Misa Katolik, Puja Tri Sandhya Hindu, Meditasi Metta Buddhis, Sembahyang Tian Konghucu, Doa Shabbat Yahudi).
🗣️ "Pandu saya tata cara Sholat Subuh lengkap dengan niat dan doanya", atau "Bagaimana lafal doa Bapa Kami?"
🌍 4. Realtime Cuaca, Gempa BMKG & Kurs
get_weather_bmkg BMKG Realtime
Mengecek kondisi cuaca, suhu (°C), kelembapan, dan prakiraan cuaca realtime untuk kota/kabupaten di seluruh Indonesia.
🗣️ "Xiaozhi, bagaimana cuaca di Jakarta hari ini?"
get_earthquake_info
Mengambil data resmi BMKG Indonesia tentang gempa bumi terkini (magnitudo, kedalaman, koordinat pusat gempa, potensi tsunami, dan daftar wilayah yang merasakan).
🗣️ "Apakah ada info gempa terkini dari BMKG hari ini?"
convert_currency
Mengonversi nilai tukar mata uang global (USD, IDR, EUR, JPY, SGD, MYR, dll) menggunakan kurs pasar terbaru.
🗣️ "Berapa rupiah untuk 50 dolar Amerika saat ini?"
📚 5. Knowledge Base Pribadi
search_course_materials
Mencari materi perkuliahan, catatan tugas, atau jadwal ujian di database materi akun kamu.
read_live_api_data
Membaca data API realtime dinamis yang dikonfigurasi di dashboard.
read_material_database
Membaca daftar seluruh materi kuliah/dokumen yang tersimpan di akun.
read_material_detail
Membaca satu materi secara mendalam berdasarkan ID atau judul materi.
scrape_webpage Web Scraper
Membaca, mengekstrak, dan meringkas isi artikel atau halaman web dari link internet secara realtime tanpa iklan atau elemen pengganggu.
🗣️ "Xiaozhi, baca dan rangkumkan artikel dari link https://..."
scrape_and_save_to_knowledge Scrape & RAG
Mengekstrak isi dari URL web dan langsung menyimpannya ke Knowledge Base (RAG) pengguna secara otomatis.
🗣️ "Simpan artikel dari link ini ke materi belajar saya"
delete_course_material Manajemen RAG
Menghapus materi dari database Knowledge Base pengguna melalui suara (misal jika salah website, salah artikel, atau ingin membatalkan materi yang baru saja di-scrape).
🗣️ "Xiaozhi, itu salah website tadi, tolong batalkan dan hapus dari materi saya"
🏠 6. Smart Home Virtual & Relay Fisik ESP32
control_relay
Mengontrol relay virtual berdasarkan nomor channel (1-8) atau nama ruangan (Ruang Tamu, Kamar Tidur, Dapur, dll).
🗣️ "Xiaozhi, nyalakan lampu ruang tamu."
control_smart_home_room
Mengontrol perangkat pintar rumah virtual berdasarkan nama ruangan langsung.
🗣️ "Xiaozhi, matikan semua lampu di kamar tidur."
get_relay_status
Membaca status semua saklar relay virtual (apakah sedang menyala atau mati).
🗣️ "Xiaozhi, cek status relay rumah."
all_relays_on
Menyalakan seluruh saklar relay virtual di seluruh ruangan secara serentak.
🗣️ "Xiaozhi, nyalakan semua saklar rumah."
all_relays_off
Mematikan seluruh saklar relay virtual di seluruh ruangan secara serentak.
🗣️ "Xiaozhi, matikan semua saklar sekarang."
get_registered_devices
Menampilkan daftar seluruh node mikrokontroler ESP32 dan modul relay yang terdaftar di jaringan lokal/cloud.
🗣️ "Xiaozhi, perangkat ESP32 apa saja yang terdaftar?"
control_real_relay_by_voice
Mengontrol modul relay fisik nyata yang terhubung ke pin GPIO mikrokontroler ESP32 via polling HTTP token perangkat.
🗣️ "Xiaozhi, aktifkan relay fisik pin 2."
get_real_relay_status
Membaca status real-time relay fisik pada hardware ESP32.
🗣️ "Xiaozhi, bagaimana status relay fisik saat ini?"
all_real_relays_on
Menyalakan seluruh saluran relay fisik nyata pada hardware ESP32 secara bersamaan.
🗣️ "Xiaozhi, nyalakan semua relay fisik."
all_real_relays_off
Mematikan seluruh saluran relay fisik nyata pada hardware ESP32 secara bersamaan.
🗣️ "Xiaozhi, matikan semua relay fisik."
set_smarthome_simulation_mode Mode Switch
Mengaktifkan atau menonaktifkan mode Simulasi Smart Home Virtual (beralih secara mulus antara simulator virtual dan relay fisik nyata).
🗣️ "Xiaozhi, aktifkan mode simulasi smart home." atau "Gunakan relay fisik nyata."
🌐 7. Riset Cerdas, Internet & Intelijen (Web Deep, Social & OSINT)
search_web_deep Deep Reader AI
Riset multi-sumber mendalam menggabungkan Wikipedia Ensiklopedia, Google News RSS, dan Automated Clean Article Scraper (ekstraksi hingga 1.500 karakter teks bersih per artikel). Menghasilkan analisis faktual yang kaya dan komprehensif.
Parameter: query (wajib), max_results (1-10), read_content (true/false)
🗣️ "XiaoZhi, lakukan riset mendalam tentang arsitektur komputer RISC-V dan rangkum intisarinya."
search_social_media Social Mining
Menelusuri opini publik, ulasan jujur komunitas, sentimen pengguna, dan topik viral di Reddit, X (Twitter), dan YouTube secara real-time tanpa batas kuota rate-limit.
Parameter: query (wajib), platform ('all' | 'reddit' | 'x' | 'youtube'), max_results
🗣️ "Apa kata orang di Reddit dan Twitter tentang performa ESP32-S3 vs ESP32-C3?"
osint_recon Passive OSINT
Investigasi intelijen sumber terbuka pasif (100% aman & legal):
  • Username: Pemindaian jejak digital paralel di 12+ platform (GitHub, Reddit, Twitter, Telegram, dll).
  • IP Address: Geolokasi (negara/kota), ISP, organisasi, nomor ASN, dan Reverse DNS PTR record.
  • Domain: Resolusi DNS A/AAAA, banner server HTTP, dan enumerasi subdomain via SSL Certificate Transparency (crt.sh).
Parameter: target (wajib), target_type ('auto' | 'username' | 'ip' | 'domain')
🗣️ "XiaoZhi, telusuri jejak digital username 'franklnir' di internet."
🗣️ "XiaoZhi, periksa alamat IP 8.8.8.8 siapa ISP dan lokasinya?"
search_web
Pencarian cepat mesin web untuk verifikasi fakta singkat, informasi umum, dan definisi istilah harian.
🗣️ "XiaoZhi, siapa penemu mikrokontroler pertama kali?"
search_news
Mencari tajuk berita terkini dari berbagai portal berita tepercaya di Indonesia maupun internasional.
🗣️ "XiaoZhi, ada berita terkini apa seputar teknologi hari ini?"
🎵 8. Multimedia YouTube & Streaming Musik
play_youtube_song
Mencari lagu di YouTube dan mengirimkan audio stream langsung ke speaker perangkat keras ESP32.
🗣️ "Xiaozhi, putar lagu Laskar Pelangi di YouTube."
inspect_youtube_video Video Inspect
Menginspeksi detail video YouTube (judul, channel, durasi, topik) dan menanyakan konfirmasi kepada pengguna sebelum memutar. Memastikan konten video sesuai sebelum dieksekusi.
🗣️ "Xiaozhi, cek video tutorial ESP32 di YouTube." atau "Tonton video podcast Deddy Corbuzier."
confirm_play_and_save_video Auto-Save
Mengeksekusi pemutaran video YouTube setelah konfirmasi pengguna disetujui, serta otomatis menyatukan materi hasil riset ke database memori pengguna.
🗣️ "Ya putar yang itu." atau "Lanjutkan putar videonya."
play_playlist_song Playlist
Memutar lagu dari daftar Playlist Musik YouTube pribadi pengguna berdasarkan nomor urut lagu (contoh: "1", "nomor 2") atau judul lagu.
🗣️ "Xiaozhi, putar playlist nomor 1." atau "Putar lagu Bohemian Rhapsody dari playlist."
list_user_playlist Playlist
Menampilkan seluruh daftar lagu yang tersimpan di Playlist Musik YouTube akun pengguna dari menu Playlist dashboard.
🗣️ "Xiaozhi, apa saja lagu yang tersimpan di playlist saya?"
get_playlist_top_played Top Tracks
Mengecek daftar lagu di Playlist pengguna yang paling sering diputar (Top Played Tracks / Lagu Terfavorit).
🗣️ "Xiaozhi, lagu apa yang paling sering saya putar?"
get_playlist_cache_status Audio Cache
Mengecek status unduhan cache audio playlist di harddisk server VPS: mengetahui lagu mana yang siap diputar lancar tanpa buffering, dan lagu mana yang masih diunduh atau berpotensi putus-putus.
🗣️ "Xiaozhi, cek status cache playlist saya." atau "Lagu playlist mana yang sudah siap diputar lancar?"
get_playback_status Context Aware
Mengecek status riwayat lagu terakhir, video YouTube terakhir yang dicek, atau pencarian/riset terakhir TANPA memutar audio (hanya mengecek info konteks kecuali disuruh putar lagi).
🗣️ "Xiaozhi, apa video yang tadi kita cek?" atau "Cek lagu terakhir yang tadi diputar."
stop_youtube_song
Menghentikan pemutaran audio musik streaming YouTube yang sedang berjalan di speaker ESP32.
🗣️ "Xiaozhi, hentikan musik."
⚙️ 9. Utilitas & Produktivitas Harian
calculate
Menghitung ekspresi matematika kompleks, rumus trigonometri, persentase, atau konversi satuan.
🗣️ "Berapa 15 persen dari 350 ribu ditambah akar 144?"
translate_text
Menerjemahkan teks atau percakapan antar berbagai bahasa asing dengan tata bahasa natural dan kontekstual.
🗣️ "Terjemahkan ke bahasa Jepang: 'Senang bertemu dengan Anda hari ini'."
set_reminder
Membuat pengingat agenda, alarm pengingat waktu, atau instruksi jadwal kegiatan tertentu.
🗣️ "Xiaozhi, ingatkan aku minum obat dalam 30 menit."
🧠 10. Memori Semantik Percakapan & Profil Pengguna
save_chat_history
Menyimpan catatan riwayat percakapan penting secara otomatis ke database PostgreSQL dan dashboard akun.
recall_chat_memory Semantic Vector AI
Mengingat kembali riwayat obrolan masa lalu (long-term memory) berbasis makna/semantik. Mampu menemukan percakapan meski menggunakan sinonim atau konsep serupa.
🗣️ "Xiaozhi, kemarin apa masalah keuanganku?", atau "Ingat nggak kita tadi bahas apa?"
remember_user_profile User Persona
Mencatat dan menyimpan preferensi pribadi, hobi, makanan favorit, cita-cita, nama panggilan, atau gaya bicara yang disukai pengguna ke profil jangka panjang.
🗣️ "Xiaozhi, panggil aku Kak Frank ya dan hobiku main catur."
get_user_profile Personalized
Mengambil profil dan preferensi pengguna yang tersimpan agar gaya bicara, pendekatan, dan jawaban Xiaozhi terasa sangat akrab dan personal.
🗣️ "Xiaozhi, sesuaikan jawaban dengan gaya favoritku."
express_emotion Ekspresi & Nada Suara
Mengekspresikan emosi vokal nyata dan animasi wajah layar ESP32: marah, senyum, bahagia, bingung, senang, teriak, ketawa (hahaha/wkwk), sedih menangis, kaget, bisik rahasia, sarkas, bangga, ngantuk, tenang, atau takut panik lengkap dengan seruan suara dan intonasi nada bicara.
🗣️ "Xiaozhi, coba kamu ketawa dong!", "Teriak sekencang-kencangnya!", atau "Senyum buat aku."
set_persona_mood Mood Persona AI
Mengatur suasana hati (mood) dasar dan gaya respon persona XiaoZhi secara konsisten: ceria_humoris, hangat_penyayang, santai_cuek, galak_tsundere, bijak_tenang, antusias_eksploratif, manja_akrab, atau tegas_profesional.
🗣️ "Xiaozhi, mulai sekarang jadilah asisten yang ceria dan suka ketawa ya!"
get_available_expressions Katalog Vokal
Melihat daftar seluruh 15+ emosi, contoh seruan suara (vocal cues), intonasi nada, dan mood kepribadian yang didukung oleh XiaoZhi.
🗣️ "Ekspresi apa saja yang bisa kamu lakukan?"
🌐 11. Web Scraping & Riset Akademis Mandiri
scrape_webpage Web Extractor
Membaca dan mengekstrak teks bersih dari halaman web, dokumentasi teknis, atau artikel tutorial online tanpa gangguan iklan atau markup berlebih.
🗣️ "Xiaozhi, tolong baca isi website https://docs.espressif.com dan jelaskan rangkumannya."
scrape_and_save_to_knowledge Auto Ingestion
Mengunduh konten halaman web publik, mengekstrak intisari secara cerdas, dan langsung menyimpannya ke Knowledge Base akun Anda sebagai materi belajar permanen.
🗣️ "Pelajari tutorial dari web https://id.wikipedia.org/wiki/ESP32 lalu simpan ke catatan belajarku."
search_academic_papers arXiv & Semantic Scholar
Mencari paper dan jurnal ilmiah internasional terindeks dari basis data arXiv dan Semantic Scholar lengkap dengan nama penulis, tahun rilis, sitasi, dan abstrak lengkap.
🗣️ "Carikan paper jurnal ilmiah terbaru tentang speech recognition pada mikrokontroler ESP32."
autonomous_deep_research Autonomous AI
Melakukan riset otonom multi-sumber secara otomatis tanpa perlu pengguna memasukkan URL. XiaoZhi menyusun kueri, menelusuri web dan jurnal, merangkum temuan, serta menyiapkan draf terstruktur untuk dikonfirmasi.
🗣️ "XiaoZhi, tolong riset mendalam tentang cara menghubungkan sensor termokopel MAX6675 ke ESP32 dan siapkan materinya."
confirm_and_save_research_material One-Click Save
Mengonfirmasi penyimpanan draf hasil riset mandiri ke Knowledge Base pengguna setelah pengguna memberikan persetujuan lisan atau teks.
🗣️ "Ya XiaoZhi, simpan draf riset termokopel tadi ke materi belajarku."
delete_course_material Storage Manager
Menghapus materi pembelajaran tertentu dari Knowledge Base akun pengguna berdasarkan ID materi atau pencarian judul yang cocok.
🗣️ "Xiaozhi, tolong hapus materi catatan ujian lama dari knowledge base akun saya."
🗣️ 12. Akademi Guru Bahasa Pintar & Interaktif (Language Tutor Suite)
explain_grammar_and_nuance Tata Bahasa & Nuansa
Menjelaskan tata bahasa (grammar/bunpou), rumus pola kalimat, perbedaan nuansa kontekstual antar kosakata sinonim, contoh kalimat bilingual, dan perangkap kesalahan umum.
🗣️ "Apa bedanya kata 'make' dan 'do' dalam bahasa Inggris?", atau "Jelaskan partikel 'wa' vs 'ga' dalam bahasa Jepang."
start_conversation_roleplay Interactive Roleplay
Memulai sesi simulasi percakapan interaktif dua arah (misal: memesan makanan di kafe Tokyo, check-in hotel di London, wawancara kerja), lengkap dengan kosakata kunci dan panduan situasi.
🗣️ "Ayo kita latihan percakapan bahasa Inggris, skenarionya kamu resepsionis hotel dan aku tamu yang mau check-in."
quiz_language_vocabulary Vocab Quiz
Membuat kuis latihan kosakata dan ekspresi bahasa asing interaktif (pilihan ganda atau tebak arti) yang disesuaikan dengan tingkatan kemampuan pengguna.
🗣️ "Beri aku 3 soal kuis kosakata bahasa Jepang level JLPT N5 tentang kehidupan sehari-hari."
save_vocabulary_flashcard Flashcard Bank
Menyimpan kata atau frasa baru beserta arti, jenis kata (noun/verb/adj), dan contoh kalimat sebagai kartu flashcard kosakata ke Knowledge Base pengguna.
🗣️ "Simpan kata 'serendipity' artinya keberuntungan tak terduga ke flashcard kosakataku."
test_user_knowledge_quiz Knowledge Evaluation
Menguji pemahaman pengguna secara komprehensif terhadap materi yang telah tersimpan di Knowledge Base dengan evaluasi skor dan penjelasan jawaban.
🗣️ "Uji pemahamanku tentang materi mikrokontroler yang sudah tersimpan di knowledge base."
📖 Apa itu Knowledge Base?

Knowledge Base adalah database materi yang bisa dibaca oleh XiaoZhi. Kamu bisa menyimpan materi perkuliahan, tugas, catatan, jadwal, dan data API realtime. Saat kamu bertanya ke XiaoZhi, dia akan mencari jawaban dari knowledge base ini.

📋 Jenis Materi
Materi Perkuliahan
Materi kuliah, modul, atau bahan belajar. Bisa berupa teks panjang yang dipecah per topik.
Tugas Mahasiswa
Daftar tugas, deadline, dan instruksi pengerjaan.
Catatan Dosen
Catatan penting dari dosen atau pengumuman resmi.
Jadwal Kuliah
Jadwal perkuliahan, ujian, atau kegiatan akademik.
Pengumuman & Info
Pengumuman umum, informasi penting, atau berita kampus.
Data dari API (Realtime)
Data yang diambil dari API eksternal seperti cuaca, suhu, harga, dll. Data ini bersifat realtime dan selalu diperbarui.
➕ Cara Menambah Materi
1
Buka Dashboard
Klik menu "Dashboard" di sidebar.
2
Klik "Tambah Materi"
Klik tombol "+ Tambah Materi" di bagian atas.
3
Isi Form
  • Judul: Nama materi
  • Kategori: Pilih kategori yang sesuai
  • Konten: Isi materi (bisa teks panjang)
  • Keywords: Kata kunci untuk pencarian
4
Simpan
Klik tombol "Simpan". Materi akan langsung tersedia untuk dibaca oleh XiaoZhi.
🔍 Cara XiaoZhi Membaca Materi

Saat kamu bertanya ke XiaoZhi, dia akan:

  1. Menerima pertanyaan dari kamu
  2. Memanggil tool search_course_materials atau read_material_database
  3. Mencari materi yang relevan di database
  4. Membaca isi materi yang ditemukan
  5. Menjawab pertanyaan berdasarkan isi materi
💡 Tips Menulis Materi
Agar XiaoZhi bisa menjawab dengan akurat:
  • Gunakan judul yang jelas dan deskriptif
  • Tambahkan keywords yang relevan
  • Gunakan format yang terstruktur (heading, list)
  • Pecah materi panjang menjadi beberapa bagian
  • Hindari singkatan yang tidak umum
🎵 Pemutar Musik YouTube & Preset Firmware
Q: Bagaimana cara agar perangkat ESP32 saya bisa memutar lagu YouTube?
A: Untuk dapat memutar musik YouTube secara langsung di speaker board ESP32, Anda wajib membeli dan menggunakan Preset Firmware resmi berlisensi (khususnya untuk varian ESP32-S3 atau ESP32-C3).

Firmware bawaan biasa/generic open-source belum dilengkapi arsitektur transcode audio Ogg/Opus hardware, sistem buffer adaptif anti-stuttering, serta integrasi endpoint streaming cloud real-time Xiaozhi Indonesia. Preset firmware resmi sudah diuji stabil dan otomatis terhubung ke sistem YouTube Music.

Q: Bagaimana cara membeli Preset Firmware YouTube tersebut?
A: Saat ini sistem pembelian / checkout mandiri langsung di website belum tersedia.

Untuk memesan lisensi preset firmware, silakan langsung chat Admin untuk pengecekan tipe board Anda (ESP32-S3 atau ESP32-C3), pengecekan ketersediaan slot lisensi, dan instruksi pembayaran.

Setelah pembayaran berhasil diverifikasi oleh admin, lisensi preset firmware akan langsung diaktifkan ke akun Anda dan otomatis muncul pada menu Web Flasher.

Q: Bagaimana cara melakukan flash Preset Firmware ke board ESP32?
A: Anda dapat melakukan flashing dengan sangat mudah dan instan langsung dari browser tanpa perlu menginstal Arduino IDE, VS Code, atau driver tambahan:
  1. Buka halaman menu Web Flasher menggunakan peramban Google Chrome atau Microsoft Edge di PC/Laptop.
  2. Hubungkan modul ESP32 Anda ke komputer PC/Laptop menggunakan kabel data USB Type-C yang berkualitas.
  3. Pada halaman Web Flasher, pilih tab "🎯 Preset Firmware (ESP32-S3 / C3)".
  4. Pilih preset firmware resmi yang telah dilisensikan oleh admin ke akun Anda (atau masukkan kode klaim lisensi jika ada).
  5. Klik tombol "Hubungkan Perangkat (Connect Device)", lalu pilih port serial COM board ESP32 Anda pada jendela pop-up browser.
  6. Klik tombol "Mulai Flash Firmware" dan tunggu hingga proses penulisan dan verifikasi mencapai 100% (Selesai).
  7. Setelah flash selesai, tekan tombol reset pada board ESP32, lalu hubungkan perangkat ke jaringan Wi-Fi Anda. Board otomatis terhubung ke server dan langsung siap memutar musik saat Anda berkata: "Putar lagu [Judul Lagu]"!
Q: Lagu YouTube tidak bisa diputar atau terputus di tengah jalan?
A: Jika mengalami kendala playback, periksa hal-hal berikut:
  • Preset Firmware: Pastikan board Anda telah di-flash menggunakan Preset Firmware resmi (bukan firmware generic).
  • Izin Fitur YouTube: Pastikan status fitur YouTube Music pada akun Anda berstatus aktif (hubungi admin jika dinonaktifkan).
  • Wiring DAC Amplifier: Pastikan kabel modul MAX98357A terhubung kencang ke pin I2S board (ESP32-S3 default: BCLK=GPIO 26, LRC=GPIO 25, DIN=GPIO 22).
  • Kualitas Sinyal Wi-Fi: Pastikan koneksi Wi-Fi ESP32 stabil dan status MCP di Dashboard berstatus Online.
⚡ Hardware, Flashing & Jaringan Wi-Fi
Q: Mengapa muncul galat "Failed to open serial port" atau "Port is already open"?
A: Galat ini terjadi karena port serial COM board ESP32 Anda sedang dikunci atau digunakan secara eksklusif oleh program lain. Cara mengatasinya:
  • Tutup aplikasi seperti Arduino IDE Serial Monitor, Ultimaker Cura, PuTTY, PrusaSlicer, atau aplikasi 3D printer lainnya.
  • Pastikan tidak ada tab peramban Chrome/Edge lain yang sedang membuka Web Flasher atau Web Serial.
  • Cabut kabel USB ESP32 dari PC, tunggu 3 detik, lalu colokkan kembali ke port USB yang berbeda.
  • Pastikan kabel USB yang digunakan adalah Kabel Data USB (memiliki 4 jalur kabel di dalamnya), bukan sekadar kabel charging murah yang hanya memiliki jalur daya tanpa jalur transfer data D+/D-.
Q: Mengapa ESP32 tidak bisa terhubung ke Wi-Fi rumah saya?
A: Chip ESP32 (S3, C3, maupun WROOM) hanya mendukung sinyal Wi-Fi 2.4 GHz dan tidak dapat membaca sinyal 5 GHz.
  • Pastikan router Wi-Fi Anda memancarkan frekuensi 2.4 GHz.
  • Jika router Anda menggunakan mode Dual-Band (Band Steering) di mana nama SSID 2.4 GHz dan 5 GHz disatukan, coba pisahkan nama SSID 2.4 GHz (misal: MyWiFi_2.4G) pada halaman setelan router Anda.
  • Pastikan sandi Wi-Fi tidak mengandung spasi di awal/akhir atau karakter non-ASCII yang tidak didukung.
Q: Apakah ESP32-S3 N16R8 saya membutuhkan modul baterai?
A: Modul baterai bersifat opsional. ESP32-S3 dapat menyala normal cukup menggunakan kabel daya USB Type-C 5V. Namun jika Anda ingin menjadikannya speaker pintar portabel tanpa kabel, Anda bisa memasang baterai Li-Ion / Li-Po 3.7V (1S) dan rangkaian resistor pembagi tegangan (voltage divider 2x 100kΩ) ke Pin ADC GPIO 3 untuk memonitor persentase baterai di layar peranti.
🔌 Integrasi MCP, Token & Slot Matrix
Q: Di mana saya menemukan URL / Token WebSocket MCP di dashboard xiaozhi.me?
A: Setelah mendaftarkan perangkat menggunakan 6 Digit Kode di xiaozhi.me:
  1. Klik kartu peranti Anda di dashboard.
  2. Klik tombol "Konfigurasikan" (Configure).
  3. Buka tab Integrasi / Pengaturan Lanjutan / MCP Endpoint (*Model Context Protocol* atau 模型上下文协议 jika bahasa Mandarin).
  4. Salin alamat URL berawalan wss://api.xiaozhi.me/v1/mcp/ws?token=... lalu tempelkan ke menu Slot MCP di server ini.
Q: Bagaimana cara kerja Isolasi Slot Matrix & Memori Percakapan?
A: Sistem kami menerapkan isolasi ketat antar slot (Multi-Tenant Slot Architecture). Setiap slot MCP memiliki session ID, memori semantik vektor percakapan, dan kredensial terenkripsi masing-masing. Riwayat percakapan tidak akan saling tertukar antar slot maupun antar pengguna lain.
Q: XiaoZhi tidak bisa membaca dokumen Knowledge Base saya?
A: Pastikan koneksi MCP berstatus Online (hijau) di Dashboard Slot MCP. Jika berstatus Terputus, klik tombol Reconnect atau perbarui token WebSocket MCP Anda dari xiaozhi.me.
🏠 Smart Home & Hardware Relay Nyata
Q: Apa perbedaan Smart Home Virtual dan Relay Nyata?
A:
  • Smart Home Virtual (/smarthome): Simulasi saklar software berbasis web. Digunakan untuk mencoba perintah suara AI tanpa membutuhkan kabel atau relay fisik.
  • Relay Nyata (/relay-nyata): Sistem IoT fisik menggunakan board ESP32 + modul relay optocoupler yang terhubung langsung ke saklar lampu rumah atau stopkontak PLN 220V dengan koneksi MQTT 24/7.
Q: Mengapa saklar relay tidak merespons perintah suara saya?
A: Periksa hal-hal berikut:
  • Pastikan status MCP Anda dalam kondisi Online.
  • Pastikan menyebutkan nama ruangan atau saklar yang terdaftar (contoh: "Nyalakan lampu ruang tamu", "Matikan kipas dapur").
  • Untuk Relay Nyata, pastikan status ruangan di halaman /relay-nyata berstatus 🟢 Online dan ESP32 relay terhubung ke Wi-Fi.
🔒 Tema Tampilan & Keamanan Akun
Q: Mengapa tema default tampilan sekarang menjadi Neo Brutalism dan bagaimana cara menggantinya?
A: Tema Neo Brutalism dijadikan tema default resmi sistem kami karena memiliki garis tepi tegas, kontras tinggi, dan estetika retro modern yang memudahkan navigasi panel IoT di berbagai kondisi layar.

Jika Anda lebih menyukai tema lain, Anda dapat menggantinya kapan saja melalui Menu Dropdown Tema di bagian bawah Sidebar. Tersedia 3 opsi tema: Neo Brutalism, Dark, dan Original. Pilihan tema Anda akan otomatis tersimpan di profil akun Anda.

Q: Apakah data percakapan dan token saya aman?
A: Ya! Semua data sensitif dienkripsi menggunakan standar kriptografi Fernet dan PostgreSQL Row-Level Security (RLS). Token MCP dan data rahasia disimpan dalam bentuk terenkripsi kuat di server.
Q: Bagaimana cara menghubungi admin resmi?
A: Hubungi admin melalui WhatsApp di nomor +62 895-3183-2365 atau melalui fitur Chat Komunitas di dashboard.
🌐 Mengenal Ekosistem: Apa Perbedaan xiaozhi.me & xiaozhiscig.biz.id?
Banyak pengguna baru yang merakit speaker pintar XiaoZhi bertanya: "Mengapa ada dua website yang berbeda?", "Apakah xiaozhiscig.biz.id sama dengan xiaozhi.me?", dan "Untuk apa fungsi masing-masing layanan ini?".
Singkatnya: xiaozhi.me adalah portal cloud resmi internasional (server Tiongkok/Global) untuk pendaftaran awal dan voice engine dasar. Sedangkan xiaozhiscig.biz.id adalah server backend independen di Indonesia yang menyediakan ekosistem fitur cerdas lengkap: pemutar lagu YouTube Music, 66 Tools MCP lokal (BMKG, Jadwal Sholat, Riset), Web Flasher instan, dan kontrol saklar listrik Smart Home 24/7.
💡
Analogi Sederhana Agar Mudah Dipahami:
Bayangkan board ESP32 Anda adalah sebuah Smartphone Baru:
• xiaozhi.me adalah seperti Kartu SIM & Registrasi IMEI: Memberikan identitas nomor unik pada perangkat Anda dan menyediakan jalur sambungan suara dasar.
• xiaozhiscig.biz.id adalah seperti Sistem Aplikasi Lengkap & Konten Hiburan: Mengisi smartphone tersebut dengan pemutar YouTube Music, saklar smart home rumah, ensiklopedia pengetahuan lokal Indonesia, dan asisten cerdas 66 tools.
👉 Keduanya saling melengkapi! Anda mendaftarkan peranti di xiaozhi.me untuk mendapatkan token MCP, lalu memasang token tersebut di xiaozhiscig.biz.id agar XiaoZhi Anda aktif 100%.
⚖️ Peran, Karakteristik & Fungsi Masing-Masing
Platform Upstream Global (Cina)

🇨🇳 xiaozhi.me

Layanan Dasar Gratis

Server cloud pusat open-source yang dikembangkan oleh tim inti pengembang XiaoZhi di Tiongkok untuk registrasi peranti secara global.

🎯 Fungsi Utama xiaozhi.me:
  • Pendaftaran Kode Pairing 6-Digit: Tempat resmi mendaftarkan board ESP32 Anda saat pertama kali menyala dan terhubung ke Wi-Fi.
  • Voice Engine Dasar (ASR & TTS): Menangani pengenalan suara mikrofon peranti dan model sintesis suara bawaan.
  • Penyedia Endpoint WebSocket MCP: Menghasilkan URL dan Token WebSocket resmi (contoh: wss://api.xiaozhi.me/v1/mcp/ws?token=...).
  • Akses Bebas Biaya: Disediakan secara gratis untuk komunitas global yang ingin mencoba percakapan AI dasar.
⚠️ Keterbatasan untuk Pengguna Indonesia:
  • Tidak mendukung pemutaran musik YouTube langsung di speaker ESP32.
  • Tidak memiliki server broker MQTT lokal untuk kontrol saklar relay rumah secara riil.
  • Database informasi berorientasi ke Tiongkok/global (tidak ada jadwal sholat lokal, gempa BMKG, cuaca kota Indonesia).
  • Dokumentasi resmi dominan berbahasa Mandarin.
Platform Server Lokal Indonesia

🇮🇩 xiaozhiscig.biz.id

Fitur Cerdas & Media Lokal

Server backend independen berlatensi rendah yang dibangun khusus untuk memberikan pengalaman terbaik pengguna XiaoZhi di Indonesia.

🚀 Keunggulan & Fitur Eksklusif di xiaozhiscig:
  • Preset Firmware YouTube Music: Firmware berlisensi resmi dengan audio Opus hardware decoding agar ESP32 bisa memutar musik YouTube jernih tanpa jeda.
  • Web Flasher 1-Klik di Browser: Cukup colok kabel USB, buka Google Chrome/Edge, dan flash board langsung dari website tanpa repot instalasi software.
  • 66 Tools MCP Cerdas Berbahasa Indonesia: Terkoneksi ke Jadwal Sholat Kemenag, radar gempa bumi & cuaca BMKG, kalkulator ilmiah/zakat, pencarian berita, dan analisis data.
  • Smart Home Relay Nyata 24/7: Server broker MQTT lokal mandiri (mqtt.xiaozhiscig.biz.id) untuk mengontrol lampu rumah dan stopkontak PLN nyata hingga 16 saklar.
  • Isolasi Matrix Slot & Memori Percakapan: Menyimpan memori percakapan multi-turn terenkripsi secara mandiri tanpa bocor antar pengguna.
  • Dukungan Admin & Komunitas Indonesia: Panduan berbahasa Indonesia dan layanan konsultasi langsung via WhatsApp.
📋 Tabel Perbandingan Lengkap Fitur & Kemampuan
Fitur / Aspek Teknis xiaozhi.me (Global / Cina) xiaozhiscig.biz.id (Indonesia)
Tujuan Utama Registrasi awal, binding hardware, dan voice recognition dasar. Ekosistem fitur cerdas: YouTube Music, 66 tools MCP, dan Smart Home nyata.
Biaya Layanan Gratis / Open Cloud Platform Gratis + Add-on Lisensi Preset Firmware YouTube.
Pairing 6-Digit ESP32 ✅ Wajib di sini (Portal resmi pengaktifan kode). ❌ Tidak memerlukan kode 6-digit; cukup masukkan Token MCP dari xiaozhi.me.
Pemutar Lagu YouTube di Board ❌ Tidak Didukung (Hanya percakapan suara biasa). ✅ Didukung Penuh (Preset Firmware resmi berlisensi + Opus decoder).
Tools Cerdas Lokal Indonesia ❌ Terbatas (Berorientasi Tiongkok & Global). ✅ 66 Tools Cerdas (BMKG Gempa/Cuaca, Jadwal Sholat, Zakat, Deep Search).
Kontrol Relay Nyata (PLN 220V) ❌ Tidak ada server broker lokal. ✅ Broker MQTT Mandiri (mqtt.xiaozhiscig.biz.id:1883) latensi rendah.
Web Flasher di Browser ❌ Pengguna harus menginstal tool sendiri. ✅ Web Flasher 1-Klik langsung di peramban Chrome/Edge.
Memori Percakapan Multi-Turn ⚠️ Tersimpan di cloud luar secara global. ✅ Terenkripsi Mandiri per pengguna dan terisolasi per slot.
Lokasi Server & Latensi Server Luar Negeri (Latensi routing internasional). Server Lokal Indonesia (Kecepatan respon kilat & stabil).
Bahasa & Dukungan Pengguna Bahasa Mandarin & Komunitas Global. 100% Bahasa Indonesia + Layanan Konsultasi Admin WhatsApp.
🔄 Diagram Alur Sinergi: Bagaimana Keduanya Bekerja Bersama?
Kedua sistem ini tidak saling bersaing, melainkan berkolaborasi menjadi satu kesatuan untuk menghasilkan asisten suara terbaik: 
 ┌─────────────────────────────────────────────────────────────┐
 │                 PERANGKAT ESP32-S3 / C3 ANDA                │
 └──────────────┬───────────────────────────────┬──────────────┘
                │ (1. Flash Firmware Resmi)     │ (2. Sambung ke Wi-Fi Rumah)
                ▼                               ▼
 ┌─────────────────────────────┐ ┌─────────────────────────────┐
 │    xiaozhiscig.biz.id       │ │        xiaozhi.me           │
 │  (Web Flasher & Lisensi)    │ │   (Cloud Upstream Resmi)    │
 └─────────────────────────────┘ └──────────────┬──────────────┘
                                                │ (3. Masukkan 6 Digit Pairing)
                                                ▼
                                 ┌─────────────────────────────┐
                                 │   Dapatkan URL / Token MCP  │
                                 │   wss://api.xiaozhi.me/...  │
                                 └──────────────┬──────────────┘
                                                │
                ┌───────────────────────────────┘ (4. Salin Token MCP ke Slot)
                ▼
 ┌─────────────────────────────────────────────────────────────┐
 │                  xiaozhiscig.biz.id                         │
 │               (SERVER MCP UTAMA ANDA)                       │
 │  • Transcode & Streaming YouTube Music ke Speaker Board     │
 │  • Eksekusi 66 Tools Cerdas (BMKG, Sholat, Riset Web)       │
 │  • Kontrol Saklar Lampu & Relay Nyata (MQTT Broker 24/7)    │
 │  • Memori Percakapan Multi-Turn Mandiri & Aman             │
 └──────────────────────────────┬──────────────────────────────┘
                                │
                                ▼ (5. Hasil Respons & Musik Kembali)
 ┌─────────────────────────────────────────────────────────────┐
 │  XiaoZhi Merespons Suara Anda & Memutar Musik Berkualitas!  │
 └─────────────────────────────────────────────────────────────┘
🚀 Kesimpulan & Langkah Selanjutnya
Sekarang Anda sudah memahami bahwa xiaozhi.me adalah portal registrasi peranti, sedangkan xiaozhiscig.biz.id adalah rumah server bagi seluruh fitur pintar dan hiburan speaker XiaoZhi Anda di Indonesia.
💬 Tanya Admin via WhatsApp