FluidNC error dapat terlihat sebagai pesan saat mesin menyala, alarm ketika gerak dimulai, perintah yang ditolak, atau antarmuka web yang gagal tersambung. Menyatukan semua gejala itu sebagai “firmware rusak” akan membuat diagnosis meleset. FluidNC mempunyai berkas konfigurasi mesin, pesan awal saat boot, daftar kode error dan alarm, serta beberapa saluran komunikasi. Setiap lapisan perlu diperiksa menurut urutan. Artikel ini memberi peta praktis untuk operator CNC yang memakai pengendali FluidNC berbasis ESP32 tanpa menyuruh mengubah pin atau rangkaian secara acak.

Panduan ini melengkapi arti kode alarm GRBL klasik, tetapi jangan memakai nomor GRBL sebagai satu-satunya rujukan untuk FluidNC. FluidNC menyediakan perintah untuk menampilkan arti kode pada firmware yang sedang terpasang. Jika Anda mengikuti seri secara urut, kembali ke halaman induk Troubleshooting: Topik FluidNC Error. Mulailah dengan mencatat versi firmware, model papan, nama berkas konfigurasi, dan teks pesan yang tampil.

Amankan mesin dan simpan bukti sebelum reset

Bila kesalahan muncul saat pemotongan, hentikan operasi melalui prosedur aman mesin. Tunggu spindle atau laser berhenti, jauhkan tangan dari area gerak, dan jangan langsung memulai berkas G-code dari awal. Pengendali mungkin telah mengeksekusi sebagian lintasan. Setelah reset atau alarm, posisi yang dilaporkan belum tentu sama dengan posisi fisik yang aman untuk melanjutkan. Catat lokasi gantry, penjepit, material, dan keadaan pahat. Jika terjadi benturan, periksa mekanik sebelum kembali ke layar pengaturan.

Simpan pesan lengkap dari konsol, termasuk awalan MSG:ERR, MSG:WARN, error:, atau ALARM:. Foto layar dapat membantu, tetapi salinan teks lebih mudah dicari. Jangan menekan tombol buka kunci berulang kali sebelum tahu pesan pertama. Perintah reset atau pergantian berkas konfigurasi dapat menghapus bukti yang paling berguna. Bila panel listrik perlu dibuka, hentikan pemeriksaan operator dan minta teknisi yang memahami papan serta catu daya mesin.

Empat lapisan masalah yang perlu dibedakan

Perbedaan ini penting karena tampilan web yang hilang tidak membuktikan ESP32 berhenti. Dokumentasi FluidNC menjelaskan bahwa antarmuka serial USB dapat tetap tersedia ketika firmware atau jaringan bermasalah, tergantung rancangan papan. Sebaliknya, kesalahan konfigurasi dapat membuat pengendali memakai keadaan aman terbatas. Jangan menjalankan mesin nyata hanya karena WebUI kembali terbuka. Periksa dahulu apakah konfigurasi yang benar benar-benar dimuat dan fitur pengaman bekerja.

Baca pesan startup melalui serial

Dokumentasi FluidNC menyarankan pemantau serial untuk melihat pesan awal dan jejak kerusakan. Hubungkan komputer ke port USB pengendali dengan kabel data yang baik, lalu gunakan aplikasi serial yang sesuai. Pada banyak papan, komunikasi boot dimulai pada 115200 baud, 8 data bit, tanpa paritas, satu stop bit, dan akhir baris CR; firmware dapat memakai kecepatan lain setelah boot. Tutup perangkat lunak pengirim lain agar port tidak berebut. Catat nomor port yang benar sebelum dan sesudah papan terhubung.

Jika proses boot sudah selesai sebelum pemantau serial dibuka, dokumentasi perintah FluidNC mencantumkan $SS untuk menampilkan pesan awal kembali. Gunakan hanya saat pengendali berada dalam keadaan yang mengizinkan perintah. Baca pesan dari atas, bukan hanya baris terakhir. Cari versi firmware, berkas konfigurasi yang dipilih, pesan peringatan, dan baris MSG:ERR. Potongan terakhir berupa restart tidak cukup untuk mengetahui penyebabnya. Simpan log lengkap saat meminta bantuan teknis.

Kenali berkas konfigurasi yang sedang dipakai

FluidNC menyesuaikan mesin melalui berkas konfigurasi pada penyimpanan lokal ESP32. Nama bawaan biasanya config.yaml, tetapi pengaturan $Config/Filename dapat menunjuk berkas lain. Karena itu, mengunggah berkas baru tidak otomatis berarti berkas tersebut yang dibaca saat boot. Periksa nama yang muncul pada pesan startup. Bila berkas atau nama pengaturan diubah, dokumentasi menyebut pengendali perlu dimulai ulang agar perubahan berlaku. Jangan melakukan restart ketika pahat masih berada dalam pekerjaan.

Pesan seperti “Cannot open config file” menunjukkan berkas yang diharapkan tidak ditemukan atau tidak dapat dibaca. Dokumentasi pemasangan FluidNC menjelaskan bahwa tanpa konfigurasi mesin yang sesuai, pengendali dapat berada dalam mode percobaan virtual. Mode itu tidak boleh dianggap mesin sudah siap untuk homing, probing, atau membaca perangkat nyata. Pastikan berkas yang diunggah memang sesuai papan, pin, motor, limit switch, spindle, dan rancangan mesin. Berkas contoh dari papan lain hanyalah titik belajar, bukan konfigurasi yang aman untuk langsung dipakai.

Kesalahan format YAML dan indentasi

Format konfigurasi FluidNC merupakan sebagian dari YAML, bukan seluruh fitur YAML umum. Indentasi menentukan hubungan induk dan anak. Satu kunci yang tampak benar tetapi berada di bagian salah dapat diabaikan. Dokumentasi proyek memberi contoh MSG:ERR: Ignored key saat nama kunci tidak dikenal atau diletakkan pada tingkat yang keliru. Bandingkan baris yang bermasalah dengan contoh resmi untuk versi yang dipakai. Jangan hanya menghapus pesan error dari log tanpa memastikan fitur yang diwakilinya bekerja.

Periksa spasi di ujung nilai, penulisan angka, dan pemisahan bagian. Dokumentasi menyebut nilai seperti angka yang disisipi teks dapat memicu kesalahan parse. Ia juga mengingatkan agar baris terakhir berakhir dengan baris baru. Salin berkas konfigurasi asli sebelum mengedit. Gunakan penyunting teks yang menunjukkan indentasi dan simpan sebagai teks biasa. Setelah satu perubahan, unggah berkas, mulai ulang secara aman, lalu baca ulang seluruh pesan startup. Jangan mengubah banyak pin atau nilai motor sekaligus.

Bedakan peringatan dari kesalahan fatal

Awalan MSG:WARN tidak selalu menghentikan boot, tetapi tetap perlu dibaca. Dokumentasi FluidNC memberi contoh nilai yang dipaksa masuk rentang yang diizinkan atau fitur yang dimatikan karena pin keluarannya tidak ditentukan. Mesin dapat tampak menyala sementara spindle, servo, atau fitur lain tidak bekerja sesuai niat. Karena itu, catat peringatan bersama hasil pengujian fungsi. Jangan menganggap semua pesan WARN aman untuk diabaikan pada mesin produksi.

Kesalahan kritis saat memproses konfigurasi dapat memicu restart dan keadaan konfigurasi aman terbatas. Pada layar, hal ini dapat terlihat sebagai konfigurasi tidak valid, fitur mesin hilang, atau perangkat tidak mau menerima perintah gerak tertentu. Baca pesan yang muncul sebelum restart untuk menemukan nilai atau bagian yang salah. Jangan memaksa alarm terbuka lalu menjalankan sumbu dengan konfigurasi yang belum diverifikasi. Kembalikan salinan berkas yang terakhir diketahui baik bila perubahan baru jelas menjadi pemicu.

Gunakan $E dan $A untuk membaca kode firmware saat ini

FluidNC menyediakan $E untuk melihat daftar arti kode error dan $A untuk daftar alarm. Dokumentasi perintah menunjukkan bentuk khusus seperti $E=5 dan $A=5 untuk meminta penjelasan satu nomor, jika didukung versi yang dipakai. Ini lebih tepat daripada mengambil tabel dari firmware lain. Jalankan perintah saat pengendali diam dan aman. Salin balasannya bersama versi firmware, karena makna angka dapat berubah pada rilis tertentu.

error: biasanya merupakan balasan terhadap satu perintah, sedangkan ALARM: berkaitan dengan keadaan pengaman. Jangan mencampur angka setelah kedua awalan itu. Jika aplikasi pengirim hanya menampilkan kalimat singkat, buka konsol atau log serial untuk melihat kode asli. Kemudian periksa perintah yang dikirim tepat sebelum error. Perintah yang tidak tersedia pada versi tertentu, dipanggil saat keadaan mesin salah, atau memiliki parameter keliru perlu diagnosis berbeda dari limit switch yang terpicu.

Periksa status mesin dan masukan limit

Protokol serial FluidNC mempertahankan laporan status yang mirip GRBL 1.1. Tanda ? meminta status segera tanpa perlu akhir baris biasa. Laporan dapat menunjukkan keadaan Idle, Alarm, atau keadaan lain, serta posisi dan pin yang aktif. Bacalah status sebelum mengirim gerak. Jika sensor limit diduga bermasalah, dokumentasi perintah mencantumkan $Limits untuk menampilkan keadaan masukan limit dalam mode pengujian. Ikuti petunjuk versi firmware untuk keluar dari mode tersebut.

Uji sensor hanya ketika mesin berhenti dan gerak tidak dapat dimulai secara tak sengaja. Bandingkan status sebelum dan sesudah sensor bekerja menurut prosedur papan. Bila status selalu aktif, periksa apakah sensor tertekan atau logika masukannya salah. Bila tidak pernah berubah, lihat aktuator, kabel luar, dan konektor. Pemeriksaan sambungan dalam panel dan pengukuran listrik harus dilakukan teknisi. Jangan mematikan hard limit hanya untuk menyembunyikan alarm; akar gangguan tetap ada.

Ketika WebUI atau Wi-Fi tidak dapat dibuka

Antarmuka web adalah salah satu cara berkomunikasi dengan FluidNC, bukan satu-satunya sumber keadaan mesin. Jika halaman tidak terbuka, cek apakah komputer masih tersambung ke jaringan yang benar dan apakah alamat pengendali berubah. Lihat pesan startup serial untuk mengetahui apakah firmware berhasil menyala dan konfigurasi jaringan dimuat. Gangguan Wi-Fi dapat membuat kontrol jarak jauh hilang sementara proses di pengendali mempunyai keadaan tersendiri. Perlakukan mesin sebagai aktif sampai geraknya benar-benar berhenti.

Jangan berulang kali mematikan daya ketika pekerjaan berjalan hanya untuk memunculkan halaman web. Catat dulu keadaan fisik dan, bila tersedia, baca serial USB. Jika WebUI hanya gagal setelah berkas konfigurasi baru diunggah, bandingkan bagian jaringan dengan salinan sebelumnya. Namun kesalahan konfigurasi mesin, Wi-Fi, dan perangkat lunak peramban harus diuji satu per satu. Mengubah nama jaringan, kata sandi, dan pin mesin sekaligus akan membuat hasil sulit ditafsirkan.

Hindari kebiasaan menyalin $$ dari GRBL klasik

FluidNC memiliki konsep konfigurasi yang berbeda dari GRBL Arduino klasik. Dokumentasi perintahnya menyatakan sebagian pengaturan mesin tidak dibuat dengan mengisi semua nomor $ seperti pada GRBL lama; konfigurasi utama berada pada berkas YAML. Perintah $$ tersedia untuk kompatibilitas tertentu, tetapi tidak boleh dipakai sebagai dasar untuk menyalin seluruh nilai dari mesin lain. Gunakan $CMD untuk melihat perintah yang tersedia dan $CD bila perlu melihat hasil konfigurasi yang dimuat, sesuai versi firmware.

Sebelum mengubah berkas, buat cadangan konfigurasi yang bekerja dan catat pengaturan lain yang telah disesuaikan. Bandingkan nama papan, pin GPIO, polaritas sinyal, jenis penggerak motor, dan susunan sumbu. Dua mesin dengan ukuran meja sama dapat memakai pin dan arah motor berbeda. Kesalahan pin dapat membuat sensor tidak terbaca atau fungsi keluaran salah, sehingga pengujian pertama harus dilakukan tanpa pemotongan material dan dengan akses penghentian darurat.

Urutan diagnosis yang dapat diulang

1. Amankan pekerjaan. Pastikan gerak serta spindle berhenti sebelum menyentuh kabel atau pengaturan.
2. Salin pesan lengkap. Catat versi firmware, awalan pesan, nomor, dan waktu kemunculan.
3. Kelompokkan gejala. Tentukan apakah masalah muncul saat boot, setelah perintah, ketika alarm, atau pada jaringan.
4. Baca startup. Gunakan serial atau $SS pada keadaan yang mengizinkan; cari pesan ERR dan WARN di atas baris terakhir.
5. Periksa config yang aktif. Cocokkan nama berkas yang dimuat dengan berkas yang sengaja diunggah.
6. Tafsirkan kode. Gunakan $E atau $A pada versi firmware itu, lalu hubungkan dengan keadaan fisik.
7. Uji satu faktor. Kembalikan konfigurasi terakhir yang baik atau ubah satu baris, kemudian boot dan catat hasil.
8. Verifikasi fungsi. Uji sensor, arah sumbu, homing, dan keluaran secara aman sebelum produksi.

Pengujian yang berhasil satu kali belum cukup. Ulangi dari keadaan boot, keadaan diam, dan gerak aman yang sesuai. Jika pesan hanya muncul ketika spindle dinyalakan, periksa catu daya dan gangguan listrik bersama teknisi. Bila hanya muncul setelah konfigurasi diubah, tinjau perubahan baris demi baris. Untuk nomor error yang tidak dapat dijelaskan oleh daftar firmware, simpan log lengkap bagi pengembang atau pemasok papan.

Tiga contoh kasus yang berbeda

Kasus pertama: setelah berkas baru diunggah, FluidNC menampilkan MSG:ERR: Ignored key. Mesin masih dapat tersambung, tetapi fitur yang diharapkan tidak aktif. Operator membandingkan indentasi dan nama kunci dengan dokumentasi versi firmware, memperbaiki satu baris, lalu membaca ulang startup. Hasilnya dinilai dari fungsi nyata, bukan hanya dari hilangnya pesan. Berkas lama tetap disimpan sebagai cadangan.

Kasus kedua: WebUI tiba-tiba hilang ketika komputer berpindah jaringan, tetapi serial USB tetap menampilkan status Idle. Masalah awal berada pada sambungan jaringan atau alamat, bukan bukti bahwa firmware berhenti. Operator tidak memulai ulang pengendali saat pekerjaan berjalan. Setelah mesin aman, jaringan diperiksa terpisah dari konfigurasi motor dan sensor.

Kasus ketiga: alarm muncul saat homing dan pengirim G-code memberi uraian singkat yang tidak jelas. Operator membuka konsol, mencatat nomor alarm, meminta penjelasan dengan $A setelah keadaan aman, lalu membandingkan status limit dengan posisi fisik. Sensor yang selalu aktif ditemukan pada dudukan yang bergeser. Mengganti berkas YAML seluruhnya tidak diperlukan karena masalah utamanya mekanik.

Kesalahan yang perlu dihindari

Jangan menganggap semua error FluidNC sama dengan GRBL 1.1, meskipun keduanya dapat memakai format pesan yang mirip. Jangan menekan $X berulang kali pada konfigurasi invalid tanpa mengetahui mengapa mesin masuk alarm. Hindari mengunggah contoh YAML dari papan lain langsung ke mesin produksi. Jangan menghapus penyimpanan atau melakukan instal ulang firmware sebagai langkah pertama untuk satu kesalahan indentasi. Tindakan besar dapat menghilangkan cadangan konfigurasi dan memperpanjang waktu pemulihan.

Jangan membagikan log secara sembarang bila di dalamnya ada nama jaringan, kata sandi, atau rincian pribadi. Saat meminta bantuan, sertakan versi, pesan relevan, dan konfigurasi yang sudah dibersihkan dari rahasia. Hindari mengubah pin dalam keadaan daya aktif. Penanganan catu daya, pembumian, VFD, dan rangkaian pengaman harus mengikuti manual papan dan dikerjakan oleh teknisi kompeten. Tujuan diagnosis adalah menemukan penyebab, bukan sekadar membuat layar kembali hijau.

Pertanyaan yang sering diajukan

Apa bedanya $E dan $A?

$E menampilkan arti kode error, sedangkan $A menampilkan arti kode alarm pada FluidNC. Periksa awalan pesan yang terlihat sebelum memilih perintah. Gunakan daftar dari firmware yang sedang berjalan agar tafsirnya sesuai versi.

Mengapa mesin masuk konfigurasi aman?

Dokumentasi FluidNC menjelaskan bahwa kesalahan kritis saat membaca konfigurasi dapat membuat pengendali memulai ulang dengan konfigurasi terbatas agar masalah dapat diperbaiki. Cari pesan sebelum restart, bandingkan nilai yang salah, dan pulihkan berkas yang terakhir diketahui baik.

Apakah berkas config.yaml harus selalu bernama begitu?

Tidak selalu. Itu nama bawaan yang umum. Pengaturan $Config/Filename dapat menunjuk nama lain. Pesan startup menunjukkan berkas yang benar-benar dicoba dimuat. Setelah mengganti nama atau isi berkas, mulai ulang pengendali pada keadaan aman.

WebUI tidak terbuka, apakah firmware rusak?

Belum tentu. Jaringan, alamat, atau peramban dapat bermasalah sementara serial USB masih berfungsi. Baca pesan startup dan status pengendali melalui jalur yang tersedia. Jangan menilai keadaan gerak mesin hanya dari halaman web yang tidak dapat dibuka.

Penutup dan navigasi

FluidNC error paling cepat ditangani dengan membaca lapisan yang benar: startup dan YAML, balasan perintah, alarm mesin, atau antarmuka jaringan. Simpan pesan lengkap, pastikan konfigurasi yang aktif, minta arti kode dari firmware, lalu ubah satu hal dan uji ulang secara aman. Untuk melanjutkan urutan semi-wiki, kembali ke halaman induk Troubleshooting Urban Creator.

Rujukan teknis

• Dokumentasi resmi FluidNC: struktur dan kesalahan berkas konfigurasi.
• Dokumentasi resmi FluidNC: $SS, $E, $A, $Limits, dan perintah lain.
• Dokumentasi resmi FluidNC: pembacaan pesan melalui serial.
• Dokumentasi pemasangan FluidNC: berkas konfigurasi awal.