What causes the expected identifier before string constant error in ESP-IDF LVGL?

The error is caused by the macro CONFIG_LV_FONT_CUSTOM_DECLARE being set as an empty string in sdkconfig, which produces invalid C syntax during compilation.

How do I fix the CONFIG_LV_FONT_CUSTOM_DECLARE error in ESP-IDF?

You can fix it by running idf.py menuconfig via ESP-IDF PowerShell, navigating to Component config → LVGL configuration → Font usage, and disabling custom font support before rebuilding.

Can the error be resolved without editing source files?

Yes. The correct fix is at the configuration layer using menuconfig, not by modifying LVGL source files directly.

www.carapaklek.com

Sensor Arus SCT-013-030: Prinsip Kerja, Rangkaian, ADC ESP32, dan Pengujian

2026-10-02T22:52:58.263+07:00

SCT-013-030 merupakan sensor arus AC berbasis Current Transformer (CT) yang memungkinkan pengukuran arus listrik tanpa harus memutus kabel penghantar. Sensor ini banyak digunakan pada proyek mikrokontroler karena pemasangannya sederhana dan bagian sensor tidak memiliki hubungan listrik langsung dengan beban yang diukur.

Pada artikel ini kita akan membahas SCT-013-030 mulai dari prinsip kerja, karakteristik output, rangkaian antarmuka ke ESP32, tegangan bias ADC, cara pemasangan sensor, hingga metode pengujian dan kalibrasi menggunakan alat ukur pembanding.

Artikel ini juga sekaligus menjadi dokumentasi pengembangan rangkaian sensor agar setiap tahapan pengujian dapat dicatat dan digunakan kembali pada pengembangan berikutnya.

Daftar Isi

Apa Itu SCT-013?
SCT-013-030 yang Digunakan
Prinsip Kerja Current Transformer
Output Sensor SCT-013-030
Mengapa Output Sensor Tidak Bisa Langsung ke ADC?
Rangkaian Bias untuk ADC ESP32
Burden Resistor pada SCT-013
Menggunakan Jack Audio 3,5 mm
Rangkaian Dasar SCT-013 ke ESP32
Pengujian Menggunakan Beban AC
Hasil Pembacaan ADC
Mengapa Nilai ADC Belum Menunjukkan Ampere?
Perhitungan RMS
Kalibrasi Menggunakan Tang Ampere
Tahapan Pengembangan Rangkaian
Kesimpulan

#define ADC_PIN 4

void setup() {
  Serial.begin(115200);
  delay(1000);

  analogReadResolution(12);

  Serial.println("=== TEST SCT-013 ===");
}

void loop() {
  const int samples = 1000;

  long total = 0;
  float totalKuadrat = 0;

  int nilaiMin = 4095;
  int nilaiMax = 0;

  for (int i = 0; i < samples; i++) {

    int adc = analogRead(ADC_PIN);

    if (adc < nilaiMin) nilaiMin = adc;
    if (adc > nilaiMax) nilaiMax = adc;

    total += adc;
    totalKuadrat += (float)adc * adc;

    delayMicroseconds(200);
  }

  float rata = (float)total / samples;

  float rms = sqrt(
    (totalKuadrat / samples) -
    (rata * rata)
  );

  Serial.print("MIN: ");
  Serial.print(nilaiMin);

  Serial.print(" | MAX: ");
  Serial.print(nilaiMax);

  Serial.print(" | AVG: ");
  Serial.print(rata, 1);

  Serial.print(" | RMS: ");
  Serial.println(rms, 1);

  delay(500);
}

1. Apa Itu SCT-013?

SCT-013 adalah keluarga sensor arus AC yang menggunakan prinsip Current Transformer (CT).

Berbeda dengan sensor arus yang harus dipasang secara seri dengan beban, SCT-013 bekerja dengan mendeteksi medan magnet yang dihasilkan oleh arus yang mengalir pada kabel.

Karena bentuknya seperti penjepit, sensor dapat dipasang pada satu penghantar tanpa harus memutus kabel.

Secara sederhana:

      Kabel penghantar
             │
             │
        ┌────┴────┐
        │ SCT-013 │
        │    ○    │
        └─────────┘
             │
             │
          Output AC

Ketika arus mengalir pada kabel, medan magnet yang terbentuk akan menginduksi lilitan sekunder pada CT.

Induksi tersebut menghasilkan sinyal listrik yang dapat diukur oleh rangkaian elektronik.

2. SCT-013-030 yang Digunakan

Pada percobaan ini digunakan:

SCT-013-030

Salah satu hal yang harus diperhatikan ketika membeli SCT-013 adalah jenis outputnya.

Ada SCT-013 yang menghasilkan output arus, dan ada versi yang menghasilkan output tegangan.

SCT-013-030 yang digunakan pada percobaan ini merupakan tipe voltage-output.

Karakteristik yang menjadi acuan:

Parameter	Nilai
Tipe sensor	Current Transformer
Model	SCT-013-030
Jenis output	Voltage output
Rentang pengukuran	Hingga sekitar 30 A AC
Output nominal	Sekitar 0–1 V AC
Burden resistor	Terintegrasi
Jenis pengukuran	Arus AC

Karena burden resistor sudah terintegrasi pada versi ini, rangkaian tidak perlu menambahkan burden resistor eksternal.

Catatan: Pastikan tipe SCT-013 yang digunakan sebelum menentukan rangkaian. Jangan menyamakan rangkaian untuk SCT-013 voltage-output dengan SCT-013 current-output.

3. Prinsip Kerja Current Transformer

Current Transformer bekerja berdasarkan prinsip induksi elektromagnetik.

Ketika arus AC melewati penghantar utama, akan muncul medan magnet di sekeliling penghantar.

Medan magnet tersebut diteruskan melalui inti CT dan menginduksi tegangan pada lilitan sekunder.

Gambaran sederhananya:

             ARUS AC
                ↓
       ────────────────
             │
             │
        ┌───────────┐
        │    CT     │
        │           │
        │  Primary  │
        │    ↓      │
        │ Secondary │
        └─────┬─────┘
              │
              │
           Output AC

Semakin besar arus yang mengalir pada kabel, semakin besar pula sinyal yang dihasilkan sensor.

Inilah yang kemudian dibaca oleh mikrokontroler.

4. Output Sensor SCT-013-030

Output SCT-013-030 berupa sinyal AC, bukan tegangan DC.

Artinya tegangan output berubah terhadap waktu:

 Tegangan
    ↑
    │        /‾\        /‾\
    │       /   \      /   \
  0 ├─────/─────\───/─────\────→ waktu
    │    /       \ /       \
    │   /         \         \
    ↓

Sinyal tersebut mempunyai bagian positif dan negatif terhadap titik referensinya.

Hal ini menjadi masalah ketika sensor dihubungkan langsung ke ADC mikrokontroler yang tidak dirancang untuk menerima tegangan negatif.

Karena itu diperlukan rangkaian DC bias.

5. Mengapa Output Sensor Tidak Bisa Langsung ke ADC?

ADC ESP32 bekerja pada tegangan positif.

Sementara sinyal AC dari SCT-013 dapat bergerak ke arah positif dan negatif.

Misalnya sebuah sinyal AC mempunyai amplitudo:

       +1 V
         │
         │    /\
         │   /  \
    0 V ─┼──/────\──
         │ /      \
         │/
       -1 V

Jika sinyal seperti ini diberikan langsung ke ADC, bagian negatif tidak dapat dibaca sebagaimana mestinya.

Solusinya adalah menggeser seluruh sinyal ke atas menggunakan tegangan bias.

6. Rangkaian Bias untuk ADC ESP32

Karena ESP32 menggunakan logika 3,3 V, salah satu pendekatan sederhana adalah membuat tegangan tengah sekitar:

1,65 V

Tegangan tersebut dapat dibuat menggunakan dua resistor dengan nilai sama.

Pembagi tegangan

             3.3 V
               │
              10K
               │
               ├──────── VBIAS ≈ 1.65 V
               │
              10K
               │
              GND

Dengan dua resistor 10 kΩ:

VBIAS ≈ 3,3 V ÷ 2 = 1,65 V

Sinyal AC dari sensor kemudian ditumpangkan pada tegangan bias tersebut.

Hasilnya menjadi seperti:

3.3 V ─────────────────────

             /\        /\
            /  \      /  \
1.65 V ────/────\────/────\────
          /      \  /
         /        \/

0 V ──────────────────────────

Dengan demikian sinyal tidak lagi melewati daerah tegangan negatif.

7. Burden Resistor pada SCT-013

Burden resistor merupakan komponen penting pada Current Transformer.

Pada CT tipe tertentu, output sekundernya berupa arus sehingga diperlukan resistor burden untuk mengubah arus tersebut menjadi tegangan.

Namun pada SCT-013-030 voltage-output, burden resistor sudah terdapat di dalam sensor.

Karena itu:

Tidak perlu menambahkan burden resistor eksternal.

Ini merupakan perbedaan penting antara sensor voltage-output dan current-output.

Jika tipe sensor berbeda, rangkaiannya juga dapat berbeda.

8. Menggunakan Jack Audio 3,5 mm

Pada prototype digunakan konektor jack audio 3,5 mm untuk menghubungkan sensor ke rangkaian.

Secara umum jack 3,5 mm memiliki kontak:

        ┌─────────────┐
        │   TIP       │
        │   RING      │
        │   SLEEVE    │
        └─────────────┘

Namun konfigurasi kabel sensor harus dipastikan berdasarkan sensor yang digunakan.

Jangan hanya menentukan koneksi berdasarkan bentuk konektor.

Cara yang lebih aman adalah memeriksa:

datasheet sensor
kontinuitas dengan multimeter
konfigurasi kabel sensor
hasil pengukuran tegangan output

Untuk pengembangan PCB, konfigurasi pin harus dicatat dengan jelas agar tidak terjadi kesalahan ketika rangkaian dibuat dalam jumlah banyak.

9. Rangkaian Dasar SCT-013 ke ESP32

Konsep rangkaian yang digunakan:

                          3.3 V
                            │
                           10K
                            │
                            ├────────── VBIAS
                            │
                           10K
                            │
                           GND


SCT-013
   │
   │ Output AC
   │
 ─┴─ C coupling
   │
   ├───────────────────────┐
   │                       │
   │                     ADC ESP32
   │
  VBIAS

Pada implementasi nyata, nilai kapasitor coupling dan konfigurasi input dapat disesuaikan setelah melihat bentuk sinyal menggunakan alat ukur.

Hal terpenting pada tahap awal adalah memastikan:

sensor menghasilkan sinyal,
sinyal mempunyai bias yang benar,
tegangan tidak melebihi batas ADC,
pembacaan ADC berubah sesuai perubahan arus.

10. Pengujian Menggunakan Beban AC

Setelah rangkaian selesai, sensor diuji menggunakan beban listrik AC.

Pada percobaan awal digunakan bor listrik sebagai sumber beban.

Sensor dipasang dengan menjepit satu kabel penghantar.

Contoh:

FASE ────────────────[ BEBAN ]
          │
          │
       ┌──────┐
       │ SCT  │
       └──────┘

Jangan menjepit kabel fase dan netral secara bersamaan.

Jika kedua penghantar berada di dalam CT, medan magnet dari keduanya dapat saling mengurangi.

Akibatnya sensor dapat membaca nilai yang sangat kecil atau tidak sesuai.

11. Hasil Pembacaan ADC

Pengujian dilakukan dengan beberapa kondisi:

OFF
↓
ON
↓
OFF
↓
ON

Tujuan pengujian pertama bukan langsung mendapatkan angka Ampere.

Yang ingin dipastikan terlebih dahulu adalah:

Apakah perubahan arus pada beban menyebabkan perubahan sinyal pada ADC?

Jika kondisi OFF menghasilkan satu pola pembacaan dan kondisi ON menghasilkan pola berbeda, berarti sensor dan rangkaian input sudah memberikan respons terhadap perubahan arus.

Namun hal tersebut belum berarti angka yang dihasilkan sudah akurat dalam satuan Ampere.

12. Mengapa Nilai ADC Belum Menunjukkan Ampere?

ADC hanya menghasilkan nilai digital yang mewakili tegangan yang diterimanya.

Misalnya:

ADC = 2000

Angka tersebut belum bisa langsung diterjemahkan menjadi:

2000 = 2 Ampere

Karena hubungan antara nilai ADC dan arus dipengaruhi oleh:

karakteristik SCT-013
rangkaian bias
rangkaian input
tegangan referensi ADC
karakteristik ADC ESP32
metode sampling
perhitungan RMS
faktor kalibrasi

Oleh karena itu proses pengukuran perlu dilakukan secara bertahap.

13. Perhitungan RMS

Karena arus yang diukur adalah arus AC, nilai yang biasanya dibutuhkan adalah RMS (Root Mean Square).

ADC perlu melakukan sampling berkali-kali.

Secara sederhana:

Sinyal AC
    ↓
Sampling ADC
    ↓
ADC1 ADC2 ADC3 ADC4 ... ADCn
    ↓
Kurangi nilai bias
    ↓
Hitung kuadrat
    ↓
Rata-rata
    ↓
Akar kuadrat
    ↓
RMS

Secara matematis:

Vrms = √[(V1² + V2² + V3² + ... + Vn²) / n]

Setelah mendapatkan nilai tegangan RMS, nilai tersebut dapat dikonversi menjadi arus berdasarkan karakteristik sensor dan faktor kalibrasi.

14. Kalibrasi Menggunakan Tang Ampere

Setelah sistem mampu membaca sinyal dan menghitung RMS, tahap berikutnya adalah melakukan kalibrasi.

Untuk mendapatkan nilai referensi digunakan tang ampere.

Konsep pengujiannya:

            Kabel beban
                 │
                 │
           ┌─────┴─────┐
           │ SCT-013   │
           └───────────┘

                 +

           ┌───────────┐
           │ Tang      │
           │ Ampere    │
           └───────────┘

Kedua alat membaca arus pada penghantar yang sama.

Misalnya:

Tang ampere   : 5,20 A
SCT-013       : 4,80 A

Maka diperlukan faktor koreksi.

Secara sederhana:

Faktor kalibrasi = Arus referensi / Arus terbaca

Contoh:

5,20 / 4,80 = 1,083

Nilai tersebut kemudian dapat digunakan sebagai faktor koreksi dalam program.

Namun kalibrasi yang baik sebaiknya dilakukan pada beberapa titik pengukuran, bukan hanya satu titik.

15. Tahapan Pengembangan Rangkaian

Agar proses pengembangan lebih mudah ditelusuri, pengujian sebaiknya dilakukan secara bertahap.

Tahap 1 — Pastikan sensor menghasilkan sinyal

Ukur output SCT menggunakan multimeter atau oscilloscope jika tersedia.

Tahap 2 — Pastikan bias ADC benar

Ukur tegangan VBIAS.

Target awal:

≈ 1,65 V

untuk sistem 3,3 V.

Tahap 3 — Hubungkan ke ADC

Pastikan tegangan maksimum sinyal tetap berada dalam batas input ADC.

Tahap 4 — Buat program sampling

Jangan langsung menghitung Ampere.

Tampilkan terlebih dahulu:

ADC minimum
ADC maksimum
ADC rata-rata

Tahap 5 — Hitung RMS

Setelah pembacaan stabil, implementasikan perhitungan RMS.

Tahap 6 — Kalibrasi

Bandingkan dengan tang ampere.

Tahap 7 — Uji beberapa beban

Lakukan pengujian pada beberapa kondisi arus untuk melihat apakah hasil pembacaan tetap konsisten.

16. Kesimpulan

SCT-013-030 merupakan sensor arus AC berbasis Current Transformer yang dapat digunakan untuk mengukur arus tanpa memutus penghantar.

Dalam penggunaannya dengan ESP32, beberapa hal penting yang perlu diperhatikan adalah:

SCT-013 menghasilkan sinyal AC.
ADC ESP32 membutuhkan sinyal dalam rentang tegangan positif.
Sinyal AC perlu diberikan DC bias.
Untuk sistem 3,3 V, titik bias awal dapat dibuat sekitar 1,65 V.
SCT-013-030 voltage-output telah memiliki burden resistor internal.
Sensor harus menjepit satu penghantar saja.
Nilai ADC mentah belum dapat langsung dianggap sebagai nilai Ampere.
Pengukuran arus AC perlu dilakukan menggunakan sampling dan perhitungan RMS.
Hasil akhir perlu dikalibrasi menggunakan alat ukur referensi seperti tang ampere.

Alur keseluruhan sistem dapat diringkas sebagai berikut:

┌──────────────┐
│  SCT-013-030 │
└──────┬───────┘
       │
       ▼
┌──────────────┐
│ Rangkaian    │
│ Input + Bias │
└──────┬───────┘
       │
       ▼
┌──────────────┐
│ ADC ESP32    │
└──────┬───────┘
       │
       ▼
┌──────────────┐
│ Sampling     │
└──────┬───────┘
       │
       ▼
┌──────────────┐
│ Perhitungan  │
│ RMS          │
└──────┬───────┘
       │
       ▼
┌──────────────┐
│ Kalibrasi    │
└──────┬───────┘
       │
       ▼
┌──────────────┐
│ Nilai Arus A │
└──────────────┘

Percobaan awal menggunakan beban AC menunjukkan bahwa perubahan kondisi beban dapat menghasilkan perubahan pada pembacaan ADC. Tahap selanjutnya adalah melakukan pengukuran menggunakan tang ampere sebagai nilai referensi, kemudian menentukan faktor kalibrasi agar hasil pembacaan SCT-013 dapat mendekati nilai sebenarnya.

Dengan dokumentasi ini, pengembangan berikutnya dapat dilakukan dari tahap yang sudah teruji, bukan mengulang kembali seluruh proses dari awal.

CASING RELAY 8CH LOW/HIGH LEVEL TRIGGER Versi lengkap: 3D Viewer + Artikel + Premium STL

2026-09-09T21:13:09.580+07:00

Interactive 3D

Jelajahi Casing Relay 8CH Secara 3D

Geser untuk memutar · Scroll/pinch untuk zoom · Gunakan TOP, BOTTOM, Auto atau Fullscreen untuk melihat model dari berbagai sudut.

Casing Relay 8CH Low/High Level Trigger – Desain Enclosure 3D Printable

Casing ini dirancang khusus untuk modul Relay 8 Channel Low/High Level Trigger agar modul lebih terlindungi, lebih rapi, dan lebih mudah digunakan pada berbagai proyek elektronika.

Model Casing Relay 8CH

Kompatibilitas Relay 8 Channel

Metode 3D Printing

Download STL Premium

Tentang Desain Casing Relay 8CH

Modul relay 8 channel banyak digunakan sebagai bagian dari sistem kontrol elektronika untuk mengendalikan berbagai perangkat, seperti pompa, solenoid, kontaktor, lampu, motor, dan perangkat listrik lainnya.

Tanpa enclosure, bagian PCB dan komponen elektronik pada modul relay akan terbuka. Selain kurang rapi, kondisi tersebut juga membuat modul lebih mudah terkena debu atau tersentuh secara tidak sengaja ketika digunakan dalam sebuah proyek.

Karena itu dibuatlah casing khusus yang mengikuti bentuk dan kebutuhan modul Relay 8CH Low/High Level Trigger.

Modul Relay 8 Channel yang menjadi dasar perancangan casing.

Desain Bagian Bawah Casing

Bagian bawah casing menjadi tempat utama untuk memasang modul relay. Pada bagian dalam terdapat struktur dan dudukan yang digunakan untuk menjaga posisi PCB tetap stabil ketika casing digunakan.

Desain bagian bawah juga memperhitungkan ruang yang dibutuhkan oleh komponen PCB serta posisi terminal yang digunakan untuk menghubungkan kabel.

Tampilan bagian bawah casing dan ruang pemasangan modul relay.

Dudukan PCB Relay

Salah satu bagian penting dari desain enclosure adalah dudukan PCB. Dudukan dibuat agar modul relay dapat dipasang dengan posisi yang stabil dan tidak mudah bergeser di dalam casing.

Posisi dudukan mengikuti titik pemasangan pada modul sehingga pemasangan PCB dapat dilakukan menggunakan screw yang sesuai.

Detail dudukan PCB pada bagian dalam casing.

Desain Cover Atas

Casing terdiri dari dua bagian utama, yaitu bagian bawah dan cover atas. Cover berfungsi untuk menutup dan melindungi modul relay setelah PCB terpasang pada bagian bawah casing.

Bentuk cover dirancang agar dapat dipasang dengan posisi yang tepat terhadap bagian bawah casing.

Cover atas casing Relay 8CH dalam posisi terpisah.

Detail Lips dan Penyatuan Casing

Pada bagian pertemuan antara cover atas dan bagian bawah terdapat lips yang berfungsi membantu menjaga posisi kedua bagian casing ketika dirakit.

Detail ini juga dibuat agar cover dapat duduk dengan lebih rapi pada bagian bawah casing.

Detail lips pada pertemuan cover atas dan casing bawah.

Lubang Screw dan Pengikat Casing

Bagian casing juga dilengkapi titik pemasangan screw untuk menyatukan cover dengan bagian bawah.

Detail lubang screw dibuat mengikuti kebutuhan konstruksi casing sehingga kedua bagian dapat dipasang dengan lebih kuat dan tetap mudah dibongkar apabila diperlukan.

Detail lubang screw pada casing.

Jalur Kabel dan Akses Terminal

Dalam sebuah enclosure elektronik, posisi keluarnya kabel juga perlu diperhatikan. Karena itu desain casing memperhitungkan posisi terminal pada modul relay sehingga kabel dapat dipasang tanpa mengganggu konstruksi casing.

Jalur kabel ditempatkan sesuai kebutuhan modul dan penggunaannya dalam sistem kontrol.

Detail akses terminal dan jalur kabel pada casing.

Modul Relay Terpasang di Dalam Casing

Setelah PCB relay dipasang pada dudukan, posisi modul menjadi lebih rapi dan terlindungi di dalam enclosure.

Foto berikut memperlihatkan kondisi casing sebelum cover atas dipasang sehingga posisi PCB dan dudukannya dapat terlihat dengan jelas.

Modul Relay 8CH telah dipasang pada dudukan casing.

Hasil Akhir Casing Relay 8CH

Setelah cover dipasang, modul relay menjadi lebih terlindungi dan tampil lebih rapi. Desain enclosure ini dapat digunakan sebagai bagian dari berbagai proyek elektronika dan sistem kontrol.

Hasil akhir Casing Relay 8CH setelah dirakit.

Note : untuk Tulisan Tidak ada ya kami kirim dalam bentuk polos bagian atasnya

Tampilan Casing dari Berbagai Sisi

Untuk melihat bentuk casing secara lebih detail, pengunjung dapat menggunakan 3D Viewer pada bagian atas artikel. Selain itu, beberapa tampilan fisik casing ditampilkan sebagai referensi.

Spesifikasi Desain

Spesifikasi	Keterangan
Model	Casing Relay 8 Channel
Jenis Trigger	Low Level / High Level
Konstruksi	Bagian bawah + cover atas
Metode Pembuatan	3D Printing
Format File	RAR (STL File)
Preview	Interactive 3D Viewer
Penggunaan	Enclosure modul Relay 8CH

Catatan: Pastikan ukuran modul relay yang digunakan sesuai dengan desain casing sebelum melakukan proses pencetakan.

Informasi File Premium

File desain casing tersedia dalam format 3D STL (dikemas dalam .rar) dan ditujukan untuk pengguna yang ingin mencetak casing sendiri menggunakan printer 3D.

File: Enclosure_Relay_8CH_full.rar
Format: RAR (Isi File STL)
Jenis: 3D Printable Enclosure
Preview: Tersedia melalui Interactive 3D Viewer
Akses file: Setelah pembayaran berhasil

File premium diproses melalui sistem download otomatis. Setelah pembayaran berhasil, sistem akan memberikan akses download sesuai transaksi.

Download File STL Casing Relay 8CH

Jika Anda memiliki printer 3D dan ingin membuat casing sendiri, file STL dapat diperoleh melalui download premium berikut.

File diberikan setelah pembayaran berhasil dan dapat digunakan untuk proses slicing serta pencetakan 3D.

PREMIUM DOWNLOAD

Dapatkan File STL Casing

File desain casing Relay 8CH untuk kebutuhan 3D printing.

◆

File RAR (STL) Siap digunakan untuk 3D printing

Download Instan Setelah pembayaran berhasil

Aman & Terjamin Transaksi dengan Midtrans

Dukungan Bantuan jika ada kendala

PREMIUM STL FILE ★★★★★

Harga Promo

Rp 35000

Sekali bayar, akses langsung

File: Enclosure_Relay_8CH_full.rar

Format: RAR / STL

Akses: Instan Setelah Bayar

Batas Download: 3x

BAYAR & DOWNLOAD STL Pembayaran aman dengan Midtrans

100% Aman & Terjamin Transaksi diproses melalui sistem pembayaran resmi.

Metode Pembayaran

Kendala saat download? WhatsApp

Ingin Casing yang Sudah Jadi?

Tidak memiliki printer 3D atau tidak ingin mencetak casing sendiri? Casing Relay 8CH ini juga dapat dipesan dalam bentuk casing yang sudah dicetak dan siap digunakan.

BELI DI PAKLEK STORE

Bagaimana File STL Didapatkan?

Proses download menggunakan sistem pembayaran yang terhubung dengan halaman transaksi. Setelah pembayaran dinyatakan berhasil, sistem akan memberikan akses ke file secara otomatis.

Untuk keamanan, file tidak diberikan melalui link file statis secara langsung. Akses download diproses oleh sistem berdasarkan transaksi yang telah berhasil.

Cara Menyalakan Pompa Air Menggunakan HP Android (Lengkap dengan Wiring Kontaktor & Blynk)

2026-07-31T09:20:58.229+07:00

Pendahuluan: Kenapa Perlu Otomasi Pompa Air?
Keuntungan Sistem Otomasi Berbasis Kontaktor
Daftar Komponen & Peralatan yang Dibutuhkan
Prinsip Kerja Rangkaian
Panduan Wiring Rangkaian (ESP32 + Kontaktor + Pompa)
Langkah Konfigurasi Aplikasi Blynk di HP Android
Prosedur Pengujian dan Tip Keamanan Listrik
Kesimpulan

1. Pendahuluan: Kenapa Perlu Otomasi Pompa Air?

Menyalakan dan mematikan pompa air secara manual sering kali merepotkan. Mulai dari harus berjalan ke sakelar/stop kontak saat malam hari, hingga risiko lupa mematikan pompa yang menyebabkan penampungan air tumpah dan pemborosan listrik.

Di era Smart Home saat ini, Anda bisa mengontrol pompa air langsung dari genggaman menggunakan HP Android melalui jaringan internet. Dengan bantuan mikrokontroler ESP32 dan platform Blynk, Anda tidak hanya bisa menyalakan pompa dari dalam rumah, tetapi juga dari mana saja selama HP Anda terhubung ke internet.

Artikel ini akan membahas panduan lengkap, aman, dan berstandar teknis untuk membuat kontrol pompa air pintar sendiri di rumah.

2. Keuntungan Sistem Otomasi Berbasis Kontaktor

Banyak tutorial DIY yang menyarankan menghubungkan langsung pompa air ke modul relay biru kecil (SRD-05VDC). Namun, metode tersebut SANGAT TIDAK DIREKOMENDASIKAN untuk jangka panjang!

Pompa air memiliki karakteristik beban induktif dengan lonjakan arus awal (inrush current) yang tinggi saat pertama kali dinyalakan. Jika hanya menggunakan relay kecil, kontak mekanis di dalamnya akan cepat aus, lengket, bahkan berisiko terbakar.

Keterangan Gambar: Ilustrasi modul ESP32, Modul Relay, dan Kontaktor AC Schneider.

Alt Text: Komponen smart home kontrol pompa air ESP32 Blynk dan kontaktor AC

Kelebihan Menggunakan Tambahan Kontaktor AC:

Keamanan Maksimal: Relay kecil pada board ESP32 hanya bertugas mengalirkan arus kecil untuk memicu koil kontaktor.
Daya Tahan Tinggi: Kontaktor AC (misalnya rating 25A) dirancang khusus untuk menangani lonjakan arus motor listrik/pompa air.
Isolasi Rangkaian: Rangkaian mikrokontroler aman dari balik lonjakan tegangan (flyback voltage) yang berasal dari motor pompa.

3. Daftar Komponen & Peralatan yang Dibutuhkan

Sebelum memulai proyek pembuatan sakelar pompa air berbasis HP Android ini, siapkan komponen-komponen berikut:

🛒 Komponen yang Dibutuhkan

ESP32 DevKit V4

Rp79.000

Lihat Shopee

IO Expansion Shield ESP32 WROOM DevkitC V4 38 Pin + Relay High Trigger

Rp 65.000

Lihat Shopee

Kontaktor LC1D09 M7 25A Kontaktor LC1D09M7 original body hitam 220V/380V/110V/24V VC1D09Q7 VC1D09M7

Rp 169.000

Lihat Shopee

Contactor Kontaktor LC1D25M7

Rp173.000

Lihat Shopee

4. Prinsip Kerja Rangkaian

Cara kerja sistem ini sangat sederhana namun mengutamakan keamanan:

Perintah dari HP: Anda menekan tombol ON/OFF pada aplikasi Blynk di HP Android.
ESP32 Menerima Sinyal: ESP32 yang terhubung ke jaringan Wi-Fi rumah menerima perintah dari cloud server Blynk.
Pemicuan Relay: Pin GPIO ESP32 memberikan sinyal logika untuk mengaktifkan modul relay (NO/COM menyambung).
Pemicuan Kontaktor: Listrik AC 220V dari jalur Fase mengalir melalui sakelar relay menuju ke terminal koil (A1) pada kontaktor.
Pompa Menyala: Koil kontaktor yang mendapat tegangan 220V akan menarik sakelar daya utama (1L1-2T1 dan 3L2-4T2), sehingga aliran listrik besar mengalir ke stop kontak dan menyalakan pompa air.

5. Panduan Wiring Rangkaian (ESP32 + Kontaktor + Pompa)

Pastikan instalasi listrik rumah Anda dalam keadaan padam (MCB dimatikan) saat melakukan proses pengkabelan!

Keterangan Gambar: Diagram jalur pengkabelan (Wiring Diagram) lengkap antara ESP32, Relay, Kontaktor AC 220V, PLN, Stop Kontak, dan Pompa Air.

Alt Text: Skema wiring diagram cara menyalakan pompa air dengan ESP32 blynk dan kontaktor AC

A. Rangkaian Kontrol (Pemicu Koil Kontaktor)

Hubungkan kabel Fase (F) dari PLN ke terminal NO (Normally Open) pada modul relay ESP32.
Sambungkan cabang kabel Fase (F) PLN yang sama ke terminal 1L1 (Input Daya Kontaktor).
Hubungkan kabel dari terminal COM relay ke terminal A1 (Koil Kontaktor).
Hubungkan kabel Netral (N) PLN ke terminal A2 (Koil Kontaktor) dan cabangkan ke terminal 3L2 (Input Daya Kontaktor).

B. Rangkaian Daya (Output ke Pompa Air)

Terminal 2T1 pada kontaktor dihubungkan ke salah satu pin pada Stop Kontak (Fase Pompa).
Terminal 4T2 pada kontaktor dihubungkan ke pin lainnya pada Stop Kontak (Netral Pompa).
Colokkan steker pompa air ke Stop Kontak tersebut.

6. Langkah Konfigurasi Aplikasi Blynk di HP Android

Setelah pengkabelan fisik selesai, langkah berikutnya adalah mengatur aplikasi di HP Android Anda.

Keterangan Gambar: Tampilan antarmuka Blynk IoT di HP Android dengan Button Widget.

Alt Text: Tampilan aplikasi Blynk IoT Android kontrol pompa air

Langkah-langkah Setting Blynk:

Unduh Aplikasi: Buka Google Play Store dan cari Blynk IoT, lalu install.
Buat Akun & Template:
- Mendaftar akun baru dan buat Template Baru di konsol Blynk (bisa via web browser atau aplikasi).
- Pilih tipe Hardware: ESP32, dan tipe koneksi: WiFi.
Buat Datastream:
- Tambahkan Datastream baru tipe Virtual Pin.
- Pilih misal V0, tipe data Integer (Min: 0, Max: 1).
Desain Dashboard di HP:
- Buka aplikasi Blynk di HP Android Anda.
- Masukkan widget Button (Tombol) ke dalam layar dashboard.
- Hubungkan widget Button tersebut ke Datastream V0 yang telah dibuat.
- Atur mode tombol menjadi Switch (Sakelar Latched).
- Namun jika kalian tidak mau repot membuat template sendiri kalian bisa gunakan quick start/ template bawaan dari blynk nya
Upload Kode ke ESP32:
- Buka Arduino IDE di komputer.
- Masukkan library BlynkSimpleEsp32.
- Masukkan Template ID, Device Name, dan Auth Token dari Blynk ke dalam skrip program, lalu atur SSID dan Password Wi-Fi rumah.
- Upload program ke board ESP32.

Kode Program ESP32 (Arduino IDE)

#define BLYNK_TEMPLATE_ID           "TMPL6e-S***" //ganti dengan id anda
#define BLYNK_TEMPLATE_NAME         "Quickstart Device"// ganti dengan nama template anda
#define BLYNK_AUTH_TOKEN            "4mfcMuXfNd6F9hixDEQLoOPKy*******" // ganti juga

#define BLYNK_PRINT Serial
#include <WiFi.h>
#include <WiFiClient.h>
#include <BlynkSimpleEsp32.h>
#include <WiFiManager.h> // Library untuk Hotspot & Captive Portal

// Pin GPIO ESP32 yang terhubung ke pin IN Modul Relay
#define RELAY_PIN 25 

// Logika Relay (High Level Trigger)
#define RELAY_ON   HIGH  
#define RELAY_OFF  LOW   

// Fungsi dipanggil saat tombol (V0) di Blynk ditekan
BLYNK_WRITE(V0)
{
  int value = param.asInt(); // Membaca status tombol (1 = ON, 0 = OFF)

  if (value == 1) {
    digitalWrite(RELAY_PIN, RELAY_ON);  // Relay Aktif -> Pompa Menyala
    Serial.println("Pompa: MENYALA (ON)");
  } else {
    digitalWrite(RELAY_PIN, RELAY_OFF); // Relay Mati -> Pompa Mati
    Serial.println("Pompa: MATI (OFF)");
  }
}

void setup() {
  Serial.begin(115200);

  // Inisialisasi pin relay
  pinMode(RELAY_PIN, OUTPUT);
  digitalWrite(RELAY_PIN, RELAY_OFF); // Pastikan pompa mati saat pertama kali dinyalakan

  // Inisialisasi WiFiManager
  WiFiManager wm;

  // Jika ingin menghapus histori Wi-Fi lama saat testing, hilangkan tanda // baris di bawah:
  // wm.resetSettings();

  // Membuat Hotspot bawaan bernama "ESP32-Pompa-Setup" jika belum terhubung Wi-Fi
  // Tampilan halaman config akan otomatis muncul di HP saat connect ke Hotspot ini
  bool res = wm.autoConnect("carapaklek.com"); 

  if (!res) {
    Serial.println("Gagal terhubung ke Wi-Fi atau Timeout");
    // ESP.restart(); // Opsional: restart jika gagal
  } else {
    Serial.println("Terhubung ke Wi-Fi!");
    
    // Setelah Wi-Fi terhubung via WiFiManager, hubungkan ke Blynk
    Blynk.config(BLYNK_AUTH_TOKEN);
    Blynk.connect();
  }
}

void loop() {
  // Jalankan Blynk hanya jika ESP32 terhubung ke internet
  if (WiFi.status() == WL_CONNECTED) {
    Blynk.run();
  }
}

7. Prosedur Pengujian dan Tip Keamanan Listrik

Sebelum sistem digunakan sehari-hari, lakukan pengujian bertahap berikut:

Uji Rangkaian Kontrol (Tanpa Beban Pompa):
Nyalakan ESP32 dan hubungkan ke internet. Buka aplikasi Blynk di Android, lalu tekan tombol ON. Dengarkan bunyi "KLIK" yang tegas dari kontaktor. Bunyi ini menandakan koil kontaktor berhasil teraliri listrik dan sakelar utama menarik dengan sempurna.
Uji Beban Pompa Air:
Setelah kontrol berjalan lancar, colokkan pompa air ke stop kontak keluaran kontaktor. Tekan tombol ON di Blynk → Pompa air harus langsung menyala dan mengalirkan air. Tekan tombol OFF di Blynk → Kontaktor terlepas dan pompa air mati seketika.

Tip Keamanan Penting:

Gunakan MCB Tambahan: Pasang MCB khusus (misal 6A) di jalur Fase sebelum masuk ke rangkaian ini sebagai pengaman dari hubungan arus pendek (short circuit).
Gunakan Box Panel (Enclosure): Masukkan board ESP32, relay, dan kontaktor ke dalam box panel plastik agar terhindar dari cipratan air dan jangkauan anak-anak.

8. Kesimpulan

Mengontrol pompa air menggunakan HP Android bukan lagi hal yang rumit dan mahal. Dengan mengombinasikan ESP32, Blynk, dan Kontaktor AC 220V, Anda mendapatkan sistem smart home yang tidak hanya canggih tetapi juga aman dan tahan lama dari risiko kerusakan akibat beban induktif motor listrik.

Sekarang Anda bisa menyalakan pompa air kapan saja dan di mana saja tanpa perlu beranjak dari tempat duduk Anda!

Tutorial Vidio yutube official kami :

Mengatasi RFID RC522 yang Error Setelah Relay Menyala dan Hanya Bisa Tap Sekali: Masalah yang Sering Saya Temui

2026-07-02T12:07:20.939+07:00

RFID RC522 merupakan salah satu modul yang paling sering digunakan dalam berbagai proyek Arduino, mulai dari sistem absensi, akses kontrol pintu, parkir otomatis, hingga mesin berbasis koin dan kartu. Harganya yang terjangkau serta kemudahan integrasinya membuat modul ini menjadi pilihan favorit para maker dan teknisi.

Namun, ada satu masalah yang cukup sering saya temui saat membantu teman, pelanggan, maupun subscriber, yaitu RFID RC522 hanya bisa membaca kartu sekali saja. Setelah relay aktif dan kembali mati, kartu tidak dapat dibaca lagi seolah-olah modul mengalami error atau hang.

Banyak orang langsung menyimpulkan bahwa modul RC522 rusak, catu daya kurang stabil, atau relay menyebabkan gangguan pada RFID. Padahal setelah melakukan berbagai pengujian, saya menemukan bahwa pada beberapa kasus penyebabnya justru berasal dari logika program yang digunakan.

Pada artikel ini saya akan membahas pengalaman tersebut secara lengkap agar Anda tidak perlu buru-buru mengganti modul RC522 yang sebenarnya masih dalam kondisi baik.

📚 Table of Contents

1️⃣ Mengenal Gejala yang Sering Terjadi
2️⃣ Dugaan Penyebab yang Biasanya Muncul
3️⃣ Pengujian Awal yang Saya Lakukan
4️⃣ Kenapa RC522 Terlihat Seperti Error?
5️⃣ Penyebab Sebenarnya yang Saya Temukan
6️⃣ Contoh Program yang Menyebabkan RFID Hanya Bisa Tap Sekali
7️⃣ Cara Memperbaikinya
8️⃣ Kapan Menggunakan Boolean dan Kapan Menggunakan State Machine
9️⃣ Tips Agar RC522 Tetap Stabil Saat Mengendalikan Relay
🏁 Kesimpulan

1. Mengenal Gejala yang Sering Terjadi

Biasanya rangkaian yang digunakan cukup sederhana:

Arduino Nano
RFID RC522
Modul Relay
Kartu atau Tag RFID

Alur kerja yang diinginkan:

Kartu ditempel.
RFID membaca UID kartu.
Relay aktif selama beberapa detik.
Relay mati kembali.
Sistem siap menerima kartu berikutnya.

Namun kenyataannya sering muncul gejala seperti berikut:

  Tap pertama -> Berhasil

  Relay ON

  Relay OFF

  Tap kedua -> Tidak terbaca

  Tap ketiga -> Tidak terbaca

  Tap berikutnya -> Tetap tidak terbaca

Pada kondisi ini banyak pengguna langsung mengatakan:

"RFID saya error setelah relay aktif."

atau

"RC522 hang setelah relay menyala."

Padahal belum tentu demikian.

2. Dugaan Penyebab yang Biasanya Muncul

Saat menghadapi masalah tersebut, biasanya ada beberapa dugaan yang langsung muncul.

1. Modul RC522 Rusak

Ini merupakan dugaan yang paling sering. Banyak pengguna langsung membeli modul RC522 baru karena mengira komponen sudah mengalami kerusakan. Padahal setelah modul diganti, masalah yang sama sering tetap muncul.

2. Tegangan Supply Tidak Stabil

Relay membutuhkan arus yang lebih besar dibanding RC522. Ketika relay aktif, tegangan dapat mengalami penurunan sesaat sehingga modul RFID menjadi tidak stabil. Pada beberapa kasus memang hal ini bisa terjadi.

3. Gangguan dari Relay

Relay menghasilkan medan elektromagnetik saat kontak berpindah. Jika rangkaian tidak dirancang dengan baik, gangguan ini dapat memengaruhi sistem secara keseluruhan.

4. Kesalahan Program

Inilah penyebab yang sering terlewat. Banyak pengguna fokus pada hardware dan lupa memeriksa logika program yang digunakan.

3. Pengujian Awal yang Saya Lakukan

Ketika pertama kali menemui kasus ini, saya melakukan beberapa langkah sederhana.

Mengganti Modul RFID

Saya mencoba mengganti RC522 dengan modul lain yang masih baru. Hasilnya sama. Masalah tetap muncul.

Mengganti Relay

Relay juga saya ganti untuk memastikan tidak ada kerusakan pada modul relay. Hasilnya tetap sama.

Mengganti Kabel dan Breadboard

Seluruh koneksi diperiksa ulang. Tidak ditemukan masalah berarti.

Memantau Serial Monitor

Di sinilah saya mulai menemukan petunjuk. Saat relay selesai bekerja, Arduino ternyata masih berjalan normal. Program tidak restart. Tidak ada tanda-tanda sistem mengalami crash. Artinya kemungkinan besar masalah bukan berasal dari hardware.

4. Kenapa RC522 Terlihat Seperti Error?

Dari sudut pandang pengguna, gejala yang muncul memang sangat mirip dengan kerusakan modul. Karena:

Tap pertama berhasil.
Relay bekerja normal.
Setelah itu kartu tidak bisa dibaca lagi.

Siapa pun yang melihatnya akan mengira RFID berhenti bekerja. Padahal sebenarnya program sudah masuk ke kondisi tertentu yang membuat proses pembacaan kartu tidak pernah dijalankan kembali. Akibatnya modul terlihat mati padahal sebenarnya masih aktif.

5. Penyebab Sebenarnya yang Saya Temukan

Setelah memeriksa kode program, saya menemukan bahwa terdapat sebuah variabel yang digunakan untuk mengunci proses pembacaan kartu. Contohnya seperti ini:

bool kartuSudahDipakai = false;

Ketika kartu berhasil dibaca:

kartuSudahDipakai = true;

Masalahnya variabel tersebut tidak pernah dikembangkan/dikembalikan menjadi:

kartuSudahDipakai = false;

Akibatnya program terus berada dalam kondisi terkunci. Setiap kali loop berjalan, sistem langsung keluar tanpa memproses RFID lagi. Inilah yang membuat pengguna mengira RC522 mengalami error.

6. Contoh Program yang Menyebabkan RFID Hanya Bisa Tap Sekali

Pada artikel ini saya sengaja membuat contoh program yang mengandung bug agar gejalanya mudah dipahami.

#include <SPI.h>
#include <MFRC522.h>

#define SS_PIN 10
#define RST_PIN 7
#define RELAY_PIN 8

MFRC522 rfid(SS_PIN, RST_PIN);

bool kartuSudahDipakai = false;

void setup() {
  Serial.begin(9600);
  SPI.begin();
  rfid.PCD_Init();

  pinMode(RELAY_PIN, OUTPUT);
  digitalWrite(RELAY_PIN, LOW);

  Serial.println("Siap membaca kartu");
}

void loop() {

  // BUG DISINI
  if (kartuSudahDipakai) {
    return;
  }

  if (!rfid.PICC_IsNewCardPresent())
    return;

  if (!rfid.PICC_ReadCardSerial())
    return;

  Serial.println("Kartu terbaca");

  digitalWrite(RELAY_PIN, HIGH);
  delay(3000);
  digitalWrite(RELAY_PIN, LOW);

  // Setelah sekali baca langsung dikunci
  kartuSudahDipakai = true;

  rfid.PICC_HaltA();
}

Gejala yang muncul:

  Tap pertama -> Berhasil

  Tap kedua -> Gagal

  Tap ketiga -> Gagal

Padahal relay dan RC522 sebenarnya masih berfungsi dengan baik.

7. Cara Memperbaikinya

Ada beberapa cara untuk mengatasi masalah ini.

Menggunakan Reset Boolean

Cara paling sederhana adalah mengembalikan nilai boolean ke kondisi awal setelah proses selesai. Metode ini cocok untuk proyek sederhana. Misalnya:

RFID pintu
RFID akses sederhana
RFID untuk mengaktifkan relay

Menggunakan State Machine

Untuk proyek yang lebih kompleks saya lebih menyarankan menggunakan State Machine. Contoh alurnya:

MENUNGGU_KARTU → RELAY_AKTIF → MENUNGGU_KARTU_DILEPAS → MENUNGGU_KARTU

Dengan pendekatan ini program menjadi lebih mudah dikembangkan.

8. Kapan Menggunakan Boolean dan Kapan Menggunakan State Machine?

Pertanyaan ini cukup sering muncul.

Gunakan Boolean Jika

Program hanya memiliki dua kondisi. Contoh: ON / OFF, YA / TIDAK, TRUE / FALSE. Misalnya:

Lampu
Relay
Tombol
Anti double tap RFID

Gunakan State Machine Jika

Program memiliki beberapa tahapan proses. Contoh:

Menunggu Kartu → Kartu Valid → Relay Aktif → Waktu Habis → Menunggu Kartu Dilepas → Kembali Menunggu Kartu

Semakin kompleks proyek, semakin terasa manfaat State Machine.

9. Tips Agar RC522 Tetap Stabil Saat Mengendalikan Relay

Walaupun pada kasus saya penyebab utama berasal dari program, bukan berarti faktor hardware boleh diabaikan. Beberapa tips berikut tetap saya rekomendasikan:

Gunakan Supply yang Stabil

Pastikan adaptor mampu menyuplai arus yang cukup.

Tambahkan Kapasitor Elco

Kapasitor 470µF hingga 1000µF pada jalur 5V dapat membantu mengurangi penurunan tegangan saat relay aktif.

Tambahkan Kapasitor 100nF Dekat RC522

Kapasitor ini berfungsi sebagai bypass capacitor untuk mengurangi noise.

Gunakan Wiring yang Benar

Pastikan koneksi SPI sesuai standar:

SDA → D10
SCK → D13
MOSI → D11
MISO → D12
RST → D7

Periksa Ground

Pastikan seluruh modul menggunakan ground yang sama.

Kesimpulan

Ketika RFID RC522 hanya bisa membaca kartu sekali setelah relay aktif, jangan langsung menyimpulkan bahwa modul mengalami kerusakan.

Berdasarkan pengalaman yang sering saya temui, penyebabnya tidak selalu berasal dari hardware. Bahkan pada beberapa kasus, masalah utamanya justru berasal dari logika program yang mengunci proses pembacaan RFID setelah tap pertama berhasil.

Sebelum membeli modul baru, lakukan beberapa langkah pemeriksaan sederhana seperti memantau Serial Monitor, mengecek alur program, serta memastikan bahwa variabel dan state yang digunakan dapat kembali ke kondisi awal setelah proses selesai.

Dengan memahami penyebab sebenarnya, Anda tidak hanya dapat menghemat biaya penggantian komponen, tetapi juga menjadi lebih mudah dalam melakukan troubleshooting berbagai proyek RFID di masa mendatang.

Jika Anda pernah mengalami kasus serupa atau menemukan penyebab lain yang berbeda, silakan bagikan pengalaman Anda pada kolom komentar agar dapat menjadi referensi bagi pembaca lainnya.

Membuat Tombol Touchscreen ON/OFF ESP32 untuk Mengontrol Relay dan Lampu di TFT ILI9488

2026-05-13T22:15:04.888+07:00

1. Pendahuluan
2. Mengapa Menggunakan Tombol Touchscreen pada ESP32?
3. Persiapan Hardware
4. Konsep Cara Kerja Tombol Touchscreen
5. Persiapan Gambar Tombol
6. Upload Gambar ke SPIFFS
7. Menampilkan Tombol di TFT
8. Membaca Sentuhan pada Touchscreen
9. Membuat Logika Tombol ON/OFF
10. Mengontrol Relay dan Lampu
11. Pengembangan Proyek Selanjutnya
12. Contoh Program Dasar ESP32 TFT Touchscreen
13. Penutup

1. Pendahuluan

Pada artikel ini kita akan membahas bagaimana cara membuat tombol touchscreen ON/OFF pada layar TFT ILI9488 menggunakan ESP32.
Proyek ini sangat menarik karena kita tidak lagi menggunakan tombol fisik biasa, melainkan membuat tombol digital langsung di layar TFT touchscreen.
Dengan teknik ini, ESP32 dapat diubah menjadi panel kontrol modern untuk berbagai kebutuhan seperti smart home, kontrol relay, lampu, pompa air, kipas, hingga dashboard otomatisasi sederhana.

Selain belajar membuat tombol ON dan OFF, kita juga akan memahami bagaimana cara kerja touchscreen pada TFT, bagaimana membaca koordinat sentuhan,
bagaimana menampilkan gambar tombol dari SPIFFS, serta bagaimana mengontrol relay menggunakan tombol virtual yang dibuat di layar.

Artikel ini dibuat khusus untuk pemula maupun maker yang ingin memahami alur berpikir dalam membuat antarmuka touchscreen pada ESP32.

2. Mengapa Menggunakan Tombol Touchscreen pada ESP32?

Pada proyek ESP32 sederhana, kita biasanya menggunakan push button fisik untuk menyalakan LED atau relay.
Namun ketika proyek mulai berkembang, penggunaan tombol fisik akan membuat perangkat terlihat kurang rapi dan kurang fleksibel.
Dengan menggunakan layar touchscreen TFT, semua tombol dapat dibuat langsung di layar.

Keuntungan menggunakan tombol touchscreen antara lain:
- Tampilan lebih modern
- Jumlah tombol tidak terbatas
- Mudah diubah desainnya
- Dapat dibuat seperti panel HMI industri
- Cocok untuk smart home
- Bisa dikembangkan menjadi dashboard monitoring

Selain itu, tombol digital pada TFT juga memberikan pengalaman penggunaan yang jauh lebih menarik dibandingkan tombol biasa.

Dalam pengembangan proyek ESP32, memahami konsep jauh lebih penting dibandingkan hanya sekadar copy-paste kode.
Banyak pengguna mengalami masalah ketika layar tidak merespons sentuhan, koordinat terbalik, gambar tidak tampil, atau relay tidak bekerja dengan benar.
Masalah seperti ini biasanya terjadi karena pengguna belum memahami hubungan antara touchscreen, SPIFFS, GPIO, dan sistem tampilan TFT.

Karena itu pada artikel ini fokus utamanya bukan hanya menghasilkan proyek yang bekerja, tetapi juga memahami cara berpikir dalam membangun antarmuka touchscreen menggunakan ESP32.
Pendekatan seperti ini akan sangat membantu ketika nantinya ingin membuat proyek yang lebih kompleks seperti smart home, panel industri, atau dashboard IoT.

3. Persiapan Hardware

Sebelum mulai membuat proyek, siapkan beberapa komponen berikut:

1. ESP32
2. TFT 4 Inch ILI9488 Touchscreen
3. Modul Relay ataupun kitset modul juga lebih baik
4. LED untuk pengujian awal
5. Kabel jumper

6.Komputer dengan Arduino IDE

Sebaiknya pengujian pertama dilakukan menggunakan LED terlebih dahulu sebelum mencoba mengontrol relay AC.

4. Konsep Cara Kerja Tombol Touchscreen

Tombol touchscreen sebenarnya bukan tombol fisik.
Yang kita lihat di layar hanyalah gambar atau objek visual.
Ketika layar disentuh, touchscreen akan mengirimkan koordinat sentuhan berupa nilai X dan Y.

Program kemudian akan memeriksa apakah koordinat sentuhan berada di area tombol.
Jika iya, maka ESP32 menjalankan aksi tertentu seperti:
- Menyalakan LED
- Mematikan relay
- Mengubah gambar tombol
- Menjalankan animasi
- Mengirim data ke internet

Inilah dasar dari sistem HMI atau Human Machine Interface.

5. Persiapan Gambar Tombol

Pada proyek ini kita menggunakan gambar tombol ON dan OFF.
Gambar dapat dibuat menggunakan Photoshop, Canva, atau aplikasi desain lainnya.

Tips membuat gambar tombol:
- Gunakan warna hijau untuk ON
- Gunakan warna merah untuk OFF
- Buat ukuran tidak terlalu besar dalam hal ini saya pakai 200 x 200 px
- Simpan dalam format JPG

Contoh nama file:
- on.jpg
- off.jpg

Gambar nantinya disimpan ke SPIFFS agar dapat dibaca ESP32.

6. Upload Gambar ke SPIFFS

SPIFFS memungkinkan ESP32 menyimpan file seperti gambar, HTML, maupun konfigurasi.
Dengan SPIFFS, gambar tombol tidak perlu ditulis langsung di kode program.

Langkah upload SPIFFS:
1. Buat folder data
2. Masukkan file gambar
3. Gunakan plugin ESP32 Sketch Data Upload
4. Upload ke ESP32

Setelah upload berhasil, gambar dapat dipanggil langsung dari memori internal ESP32.

7. Menampilkan Tombol di TFT

Setelah gambar berhasil diupload, langkah berikutnya adalah menampilkan gambar tombol di layar TFT.

Biasanya library yang digunakan:
- TFT_eSPI
- TJpg_Decoder

Keuntungan menggunakan gambar JPG:
- Tampilan lebih menarik
- UI lebih profesional
- Mudah mengganti desain tombol

Pada tahap ini, kita akan menampilkan tombol OFF sebagai tampilan awal.

8. Membaca Sentuhan pada Touchscreen

Touchscreen bekerja dengan membaca koordinat sentuhan.
Ketika layar disentuh, program akan mendapatkan nilai:
- X
- Y

Contoh logika sederhana:

Jika X berada antara 50 sampai 150
dan Y berada antara 100 sampai 180,
maka tombol dianggap ditekan.

Inilah dasar utama pembuatan tombol touchscreen.

9. Membuat Logika Tombol ON/OFF

Logika tombol dibuat menggunakan variabel status.

Contoh:
- status = false → relay OFF
- status = true → relay ON

Ketika tombol disentuh:
1. Status dibalik
2. Gambar tombol diganti
3. GPIO relay diubah

Dengan cara ini, tombol dapat berubah dari ON ke OFF secara dinamis.

10. Mengontrol Relay dan Lampu

Setelah tombol berhasil bekerja, kita dapat menghubungkan relay.

Relay memungkinkan ESP32 mengontrol:
- Lampu rumah
- Pompa air
- Kipas
- Stop kontak
- Perangkat elektronik lainnya

Namun perlu diperhatikan bahwa listrik AC sangat berbahaya.
Gunakan relay dengan hati-hati dan lakukan pengujian awal menggunakan LED.

11. Pengembangan Proyek Selanjutnya

Setelah memahami dasar tombol touchscreen, proyek dapat dikembangkan menjadi:
- Smart home panel
- Dashboard monitoring
- Kontrol multi relay
- Kontrol via WiFi
- MQTT dashboard
- Sistem otomatisasi rumah
- HMI industri mini

Dengan kombinasi ESP32 dan TFT ILI9488, kemungkinan pengembangan sangat luas.

12. Contoh Program Untuk menampilkan Tombol ON/OFF



#include <TFT_eSPI.h>
#include <SPI.h>
#include <XPT2046_Touchscreen.h>
#include <SPIFFS.h>
#include <TJpg_Decoder.h>

// =====================================================
// PIN CONFIGURATION
// =====================================================
#define TOUCH_CS_PIN    15
#define RELAY_PIN       25  // HIGH level trigger

// =====================================================
// TOUCH SCREEN SETTINGS
// =====================================================
#define TOUCH_PRESSURE_THRESHOLD 1000
#define TOUCH_DEBOUNCE_DELAY     300

// =====================================================
// SCREEN RESOLUTION
// =====================================================
#define SCREEN_WIDTH  320
#define SCREEN_HEIGHT 480

// =====================================================
// OBJECTS
// =====================================================
TFT_eSPI tft = TFT_eSPI();
XPT2046_Touchscreen ts(TOUCH_CS_PIN);

// =====================================================
// TOUCH STATE VARIABLES
// =====================================================
bool touchEnabled = true;
bool isTouching = false;
unsigned long lastTouchTime = 0;

// =====================================================
// IMAGE BUTTON STRUCTURE
// =====================================================
struct ImageButton {
  String imageOffPath;
  String imageOnPath;
  bool state;
  int x, y;
  int w, h;
  uint8_t scale;
};

// =====================================================
// BUTTON INITIALIZATION
// =====================================================
ImageButton button1 = {
  "/off.jpg",      // Image when OFF
  "/on.jpg",       // Image when ON
  false,           // Initial state: OFF
  50,              // X position
  140,             // Y position
  0, 0,            // W, H (will be calculated)
  0                // Scale (will be calculated)
};

// =====================================================
// HELPER: Draw Bitmap 1-bit
// =====================================================
void drawBitmap1bit(int x, int y, const unsigned char *bitmap, 
                    int w, int h, uint16_t fgcolor, uint16_t bgcolor) {
  int byteWidth = (w + 7) / 8;
  for (int j = 0; j < h; j++) {
    for (int i = 0; i < w; i++) {
      uint8_t byte = pgm_read_byte(bitmap + j * byteWidth + i / 8);
      bool pixelOn = byte & (0x80 >> (i % 8));
      tft.drawPixel(x + i, y + j, pixelOn ? fgcolor : bgcolor);
    }
  }
}

// =====================================================
// JPG RENDER CALLBACK
// =====================================================
bool tft_jpg_render(int16_t x, int16_t y, uint16_t w, uint16_t h, uint16_t *bitmap) {
  if (y >= tft.height()) return false;
  tft.pushImage(x, y, w, h, bitmap);
  return true;
}

// =====================================================
// TOUCH MAPPING FUNCTIONS
// =====================================================
int mapX(int rawX) {
  return map(rawX, 3690, 470, 0, SCREEN_WIDTH);
}

int mapY(int rawY) {
  return map(rawY, 420, 3715, SCREEN_HEIGHT, 0);
}

// =====================================================
// BUZZER
// =====================================================
void beepBuzzer(int duration = 100) {
  // Optional: uncomment if you have buzzer connected
  // digitalWrite(BUZZER_PIN, HIGH);
  // delay(duration);
  // digitalWrite(BUZZER_PIN, LOW);
}

// =====================================================
// DISPLAY BOOT SCREEN
// =====================================================
void drawBootScreen() {
  tft.fillScreen(TFT_BLACK);
  tft.setTextColor(TFT_WHITE, TFT_BLACK);
  tft.setTextDatum(MC_DATUM);
  tft.setTextSize(1);
  
  tft.drawString("IMAGE BUTTON", SCREEN_WIDTH / 2, (int)(100 * 1.5), 4);
  tft.drawString("Relay HIGH Level Trigger", SCREEN_WIDTH / 2, (int)(150 * 1.5), 2);
  tft.drawString("Loading...", SCREEN_WIDTH / 2, (int)(200 * 1.5), 2);
  
  delay(2000);
}

// =====================================================
// DISPLAY BUTTON IMAGE & LABEL
// =====================================================
void displayButtonImage(ImageButton &btn) {
  String filename = btn.state ? btn.imageOnPath : btn.imageOffPath;

  Serial.println("\n--- Menampilkan Gambar ---");
  Serial.println("File: " + filename);
  Serial.println("State: " + String(btn.state ? "ON" : "OFF"));

  if (filename.isEmpty() || !SPIFFS.exists(filename)) {
    Serial.println("ERROR: File tidak ada: " + filename);
    return;
  }

  // =====================================================
  // SET JPG DECODER
  // =====================================================
  TJpgDec.setJpgScale(btn.scale);
  TJpgDec.setSwapBytes(true);
  TJpgDec.setCallback(tft_jpg_render);

  // =====================================================
  // CLEAR BUTTON AREA
  // =====================================================
  tft.fillRect(btn.x - 5, btn.y - 5, btn.w + 10, btn.h + 60, TFT_BLACK);

  // =====================================================
  // DISPLAY JPG IMAGE
  // =====================================================
  TJpgDec.drawFsJpg(btn.x, btn.y, filename.c_str());
  Serial.println("Gambar ditampilkan di: (" + String(btn.x) + ", " + String(btn.y) + ")");

  // =====================================================
  // DRAW LABEL (ON / OFF)
  // =====================================================
  int labelY = btn.y + btn.h + 15;
  
  tft.setTextDatum(MC_DATUM);
  tft.setTextSize(2);
  tft.setTextColor(btn.state ? TFT_GREEN : TFT_RED, TFT_BLACK);

  String labelText = btn.state ? "ON" : "OFF";
  int labelX = btn.x + btn.w / 2;

  tft.drawString(labelText, labelX, labelY, 2);
  Serial.println("Label: " + labelText);

  // =====================================================
  // RELAY CONTROL - HIGH LEVEL TRIGGER
  // =====================================================
  if (btn.state) {
    digitalWrite(RELAY_PIN, HIGH);  // ON - nyalakan relay
    Serial.println("Relay NYALA (HIGH) - Pin 25 = 3.3V");
  } else {
    digitalWrite(RELAY_PIN, LOW);   // OFF - matikan relay
    Serial.println("Relay MATI (LOW) - Pin 25 = 0V");
  }

  Serial.println("---");
}

// =====================================================
// LOAD IMAGE FROM SPIFFS
// =====================================================
void loadImageInfo(ImageButton &btn) {
  Serial.println("\n--- Loading Button Image ---");
  
  String filename = btn.imageOffPath;
  
  if (!SPIFFS.exists(filename)) {
    Serial.println("ERROR: File tidak ada: " + filename);
    return;
  }

  uint16_t w, h;
  if (TJpgDec.getFsJpgSize(&w, &h, filename.c_str()) != JDR_OK) {
    Serial.println("ERROR: Gagal membaca ukuran JPG");
    return;
  }

  Serial.println("Ukuran asli gambar: " + String(w) + " x " + String(h));

  // =====================================================
  // AUTO SCALE
  // =====================================================
  uint8_t scale = 0;
  while (scale < 3) {
    if ((w >> scale) <= 220 && (h >> scale) <= 200) {
      break;
    }
    scale++;
  }

  btn.scale = scale;
  btn.w = w >> scale;
  btn.h = h >> scale;

  Serial.println("Scale factor: " + String(scale));
  Serial.println("Ukuran akhir: " + String(btn.w) + " x " + String(btn.h));
  Serial.println("Posisi button: (" + String(btn.x) + ", " + String(btn.y) + ")");
}

// =====================================================
// CHECK IF TOUCH IS INSIDE BUTTON
// =====================================================
bool isTouchInsideButton(uint16_t touchX, uint16_t touchY, ImageButton &btn) {
  return (touchX >= btn.x && touchX <= (btn.x + btn.w) &&
          touchY >= btn.y && touchY <= (btn.y + btn.h));
}

// =====================================================
// HANDLE TOUCH
// =====================================================
void checkTouch() {
  if (!touchEnabled) return;

  if (ts.touched()) {
    TS_Point p = ts.getPoint();

    if (p.z > TOUCH_PRESSURE_THRESHOLD) {
      if (!isTouching && (millis() - lastTouchTime >= TOUCH_DEBOUNCE_DELAY)) {
        lastTouchTime = millis();
        isTouching = true;

        beepBuzzer();

        uint16_t touchX = mapX(p.x);
        uint16_t touchY = mapY(p.y);

        touchX = constrain(touchX, 0, SCREEN_WIDTH - 1);
        touchY = constrain(touchY, 0, SCREEN_HEIGHT - 1);

        Serial.println("\nTouch at: (" + String(touchX) + ", " + String(touchY) + ")");

        // =====================================================
        // CHECK IF TOUCH INSIDE BUTTON
        // =====================================================
        if (isTouchInsideButton(touchX, touchY, button1)) {
          Serial.println(">>> BUTTON DITEKAN!");
          button1.state = !button1.state;
          
          Serial.println("Button state berubah menjadi: " + String(button1.state ? "ON" : "OFF"));
          
          displayButtonImage(button1);
          
          // Debounce: wait for finger lift
          delay(500);
          while (ts.touched()) {
            delay(50);
          }
          delay(300);
        }
      }
    } else {
      isTouching = false;
    }
  } else {
    isTouching = false;
  }
}

// =====================================================
// DRAW HOME SCREEN
// =====================================================
void drawHomeScreen() {
  tft.fillScreen(TFT_BLACK);

  tft.setTextColor(TFT_WHITE, TFT_BLACK);
  tft.setTextDatum(MC_DATUM);
  tft.setTextSize(1);

  //tft.drawString("IMAGE BUTTON WITH RELAY", SCREEN_WIDTH / 2, 30, 4);
  //tft.drawString("PIN 25 - HIGH Level Trigger", SCREEN_WIDTH / 2, 70, 2);

  // Display button
  displayButtonImage(button1);

  // Instructions
  tft.setTextSize(1);
  tft.setTextColor(TFT_YELLOW, TFT_BLACK);
  //tft.drawString("Sentuh gambar untuk ON/OFF", SCREEN_WIDTH / 2, SCREEN_HEIGHT - 40, 1);

  tft.setTextDatum(TL_DATUM);
}

// =====================================================
// SETUP
// =====================================================
void setup() {
  Serial.begin(115200);
  delay(1000);

  Serial.println("\n\n=== IMAGE BUTTON PROGRAM START ===\n");

  // =====================================================
  // SPIFFS INITIALIZATION
  // =====================================================
  if (!SPIFFS.begin(true)) {
    Serial.println("ERROR: SPIFFS gagal mount");
    return;
  }
  Serial.println("✓ SPIFFS berhasil di-mount");

  // =====================================================
  // TFT INITIALIZATION
  // =====================================================
  tft.init();
  tft.setRotation(0);
  tft.fillScreen(TFT_BLACK);
  Serial.println("✓ TFT berhasil diinisialisasi");

  // =====================================================
  // JPG DECODER INITIALIZATION
  // =====================================================
  TJpgDec.setCallback(tft_jpg_render);
  TJpgDec.setSwapBytes(true);
  TJpgDec.setJpgScale(0);
  Serial.println("✓ JPG Decoder siap");

  // =====================================================
  // TOUCHSCREEN INITIALIZATION
  // =====================================================
  if (!ts.begin()) {
    touchEnabled = false;
    Serial.println("WARNING: Touchscreen tidak terdeteksi!");
  } else {
    ts.setRotation(0);
    Serial.println("✓ Touchscreen siap");
  }

  // =====================================================
  // RELAY PIN INITIALIZATION
  // =====================================================
  pinMode(RELAY_PIN, OUTPUT);
  digitalWrite(RELAY_PIN, LOW);  // Initial state: OFF
  Serial.println("✓ Relay di pin " + String(RELAY_PIN) + " siap (awal: LOW/OFF)");

  // =====================================================
  // SPI INITIALIZATION
  // =====================================================
  SPI.begin();
  Serial.println("✓ SPI berhasil diinisialisasi");

  // =====================================================
  // BOOT SCREEN
  // =====================================================
  drawBootScreen();

  // =====================================================
  // LOAD BUTTON IMAGE INFO
  // =====================================================
  loadImageInfo(button1);

  // =====================================================
  // DRAW HOME SCREEN
  // =====================================================
  drawHomeScreen();

  Serial.println("\n=== READY - SIAP SENTUH GAMBAR ===\n");
}

// =====================================================
// MAIN LOOP
// =====================================================
void loop() {
  checkTouch();
  delay(10);
}

13. Penutup

Membuat tombol touchscreen ON/OFF pada TFT ILI9488 menggunakan ESP32 merupakan langkah awal yang sangat bagus untuk mempelajari sistem HMI modern.
Melalui proyek ini kita belajar banyak hal sekaligus mulai dari touchscreen, SPIFFS, tampilan grafis, hingga kontrol relay.

Setelah memahami dasar proyek ini, Anda dapat mengembangkan sistem menjadi jauh lebih kompleks seperti smart home berbasis WiFi, panel monitoring sensor, hingga dashboard IoT profesional.

Semoga artikel ini membantu dan dapat menjadi referensi untuk proyek ESP32 berikutnya.

Apa Itu SPIFFS di ESP32? (Penjelasan Lengkap + Studi Kasus TFT 4 Inch)

2026-05-08T17:22:00.000+07:00

📌 Pengertian SPIFFS

SPIFFS (SPI Flash File System) adalah sistem file yang digunakan di dalam flash memory internal ESP32 untuk menyimpan data seperti:

gambar (JPG, PNG)
file HTML (web server)
JSON/config
font UI
asset tampilan (ikon, background)

Berbeda dengan RAM:

RAM → hilang saat mati
SPIFFS → tetap tersimpan meskipun ESP32 dimatikan

⚙️ Cara Kerja SPIFFS di ESP32

ESP32 punya flash memory (biasanya 4MB atau lebih).

Memory ini dibagi jadi beberapa bagian:

program (firmware)
OTA update
SPIFFS (storage file)

👉 Jadi SPIFFS itu “harddisk kecil” di dalam ESP32

📁 Struktur SPIFFS (Sederhana)

Contoh isi SPIFFS:

/spiffs
  ├── bg.jpg
  ├── icon_start.jpg
  ├── config.json
  ├── data.txt

ESP32 bisa:

baca file
tulis file
hapus file

🖥️ Kenapa SPIFFS Penting untuk TFT 4 Inch?

Kalau kamu pakai LCD TFT 4 inch (ILI9488):

Tanpa SPIFFS:

gambar harus di-embed di kode ❌
program jadi berat ❌
susah update ❌

Dengan SPIFFS:

gambar disimpan di flash ✅
bisa load saat runtime ✅
bisa ganti tanpa ubah kode utama ✅

🔥 Contoh Use Case Nyata

1. Tampilan UI

background menu
tombol start/stop
logo brand

2. Gallery / Slideshow

baca semua file di SPIFFS
tampilkan satu per satu

3. Sistem Dashboard Lokal

HTML disimpan di SPIFFS
ESP32 jadi web server

⚠️ Kelemahan SPIFFS

SPIFFS itu bukan tanpa kekurangan:

❌ Tidak ada folder asli

Semua file dianggap satu level

❌ Tidak cocok untuk file besar

Contoh:

video ❌
image resolusi besar ❌

❌ Sudah mulai tergantikan

ESP-IDF terbaru mulai pakai:

LittleFS (lebih modern)

🔄 SPIFFS vs Alternatif

Sistem	Kelebihan	Kekurangan
SPIFFS	ringan, mudah	fitur terbatas
LittleFS	lebih stabil	setup sedikit lebih ribet
SD Card	kapasitas besar	butuh hardware tambahan

🧩 Kapan Harus Pakai SPIFFS?

Gunakan SPIFFS kalau:

butuh simpan gambar UI
butuh config file
project kecil-menengah

Jangan pakai kalau:

butuh banyak file besar
butuh struktur folder kompleks

🖼️ Cara Upload Gambar ke SPIFFS dan Tampilkan di TFT ESP32 (Step-by-Step)

Kalau kamu sudah sampai tahap pakai ESP32 + TFT 4 inch, biasanya masalah berikut pasti muncul:

❓ “Gimana cara nampilin gambar (logo, background UI) tanpa bikin program jadi berat?”

Jawabannya: pakai SPIFFS + file JPG.
Di artikel ini kamu akan belajar dari nol sampai tampil di layar.

🎯 Tujuan Tutorial

Setelah mengikuti ini, kamu bisa:

upload gambar ke SPIFFS
membaca file dari ESP32
menampilkan gambar ke TFT (ILI9488)
memahami alur kerja end-to-end

🧰 Persiapan

Hardware

ESP32
TFT 4 inch (ILI9488 / sejenis)

Software

Arduino IDE
Library:
- TFT_eSPI
- TJpg_Decoder
- SPIFFS (built-in)

📁 STEP 1 — Siapkan Gambar

Gunakan gambar dengan kriteria:

format: .jpg
resolusi kecil (misal: 320x240 atau 480x320)
ukuran < 100KB (biar cepat load)

👉 Kenapa JPG?

lebih ringan dibanding PNG
didukung langsung oleh TJpg_Decoder

Contoh nama file:

bg.jpg logo.jpg

Gunakan gambar dengan kriteria:

format: .jpg
resolusi kecil (misal: 320x240 atau 480x320)
ukuran < 100KB (biar cepat load)

👉 Kenapa JPG?

lebih ringan dibanding PNG
didukung langsung oleh TJpg_Decoder

Contoh nama file:

bg.jpg
logo.jpg 

📂 STEP 2 — Buat Folder Data

Di folder project Arduino kamu:

project_esp32/
  ├── project_esp32.ino
  └── data/
        └── bg.jpg

👉 Folder data/ ini WAJIB, karenasemua isi folder ini akan diupload ke SPIFFS

⬆️ STEP 3 — Upload ke SPIFFS

Install Plugin Upload SPIFFS

Di Arduino IDE, kamu butuh plugin:

👉 “ESP32 Sketch Data Upload”

Setelah install:

akan muncul menu:
Tools → ESP32 Sketch Data Upload

Upload

Pilih board ESP32
Klik:
Tools → ESP32 Sketch Data Upload
Tunggu sampai selesai

👉 Sekarang file kamu sudah masuk ke flash ESP32

🌐 Upload Gambar ke SPIFFS via Web (Tanpa USB)

🎯 Tujuan

Upload file JPG ke SPIFFS lewat browser
Melihat daftar file di ESP32
Menampilkan file ke TFT langsung

Gunakan program ini pastikan mengganti nama dan pasword wifi


#include 
#include 
#include 
#include 
#include 

// =====================================================
// WIFI ACCESS POINT
// =====================================================
const char* ssid = "carapaklek dot com";
const char* password = "12345678";

// =====================================================
// OBJECT
// =====================================================
WebServer server(80);
TFT_eSPI tft = TFT_eSPI();
File uploadFile;

// =====================================================
// HTML PAGE
// =====================================================
String uploadPage = R"rawliteral(






  ESP32 TFT Upload

  

  







ESP32 TFT Upload
















Lihat File SPIFFS






)rawliteral";

// =====================================================
// TFT JPG RENDER
// =====================================================
bool tft_jpg_render(int16_t x,
                    int16_t y,
                    uint16_t w,
                    uint16_t h,
                    uint16_t *bitmap)
{
  if (y >= tft.height()) return false;

  tft.pushImage(x, y, w, h, bitmap);

  return true;
}

// =====================================================
// TFT BOOT SCREEN
// =====================================================
void showBootScreen()
{
  tft.fillScreen(TFT_BLACK);

  tft.setTextColor(TFT_WHITE);
  tft.setTextSize(2);

  tft.setCursor(20, 40);
  tft.println("ESP32 TFT READY");

  tft.setCursor(20, 80);
  tft.println("Starting AP...");
}

// =====================================================
// TFT WIFI INFO
// =====================================================
void showWifiInfo()
{
  tft.fillScreen(TFT_BLACK);

  tft.setTextColor(TFT_GREEN);
  tft.setTextSize(2);

  tft.setCursor(20, 30);
  tft.println("WiFi AP Ready");

  tft.setTextColor(TFT_WHITE);

  tft.setCursor(20, 80);
  tft.println("SSID:");

  tft.setCursor(20, 110);
  tft.println(ssid);

  tft.setCursor(20, 160);
  tft.println("IP:");

  tft.setCursor(20, 190);
  tft.println(WiFi.softAPIP());
}

// =====================================================
// HANDLE UPLOAD
// =====================================================
void handleUpload()
{
  HTTPUpload& upload = server.upload();

  // =====================================================
  // START UPLOAD
  // =====================================================
  if (upload.status == UPLOAD_FILE_START)
  {
    String filename = upload.filename;

    // =====================================================
    // RAPIIKAN NAMA FILE
    // =====================================================
    filename.toLowerCase();

    filename.replace(" ", "_");
    filename.replace("(", "");
    filename.replace(")", "");

    filename = "/" + filename;

    Serial.println("Upload File: " + filename);

    uploadFile = SPIFFS.open(filename,
                             FILE_WRITE);
  }

  // =====================================================
  // WRITE FILE
  // =====================================================
  else if (upload.status == UPLOAD_FILE_WRITE)
  {
    if (uploadFile)
    {
      uploadFile.write(upload.buf,
                       upload.currentSize);
    }
  }

  // =====================================================
  // FINISH UPLOAD
  // =====================================================
  else if (upload.status == UPLOAD_FILE_END)
  {
    if (uploadFile)
    {
      uploadFile.close();
    }

    Serial.println("Upload selesai");
  }
}

// =====================================================
// LIST FILE
// =====================================================
void handleList()
{
  String html;

  html += "";

  html += "Daftar File SPIFFS";

  File root = SPIFFS.open("/");

  File file = root.openNextFile();

  while (file)
  {
    String name = file.name();

    html += "";

    html += "";
    html += name;
    html += "

";

    // =====================================================
    // BUTTON SHOW
    // =====================================================
    html += "Tampilkan";

    // =====================================================
    // BUTTON DELETE
    // =====================================================
    html += "Hapus";

    html += "";

    file.close();

    file = root.openNextFile();
  }

  root.close();

  html += "

";

  html += "Kembali";

  html += "";

  server.send(200,
              "text/html",
              html);
}

// =====================================================
// SHOW IMAGE TO TFT
// =====================================================
void handleShow()
{
  if (!server.hasArg("file"))
  {
    server.send(400,
                "text/plain",
                "File tidak ditemukan");

    return;
  }

  String filename = server.arg("file");

  // =====================================================
  // PASTIKAN ADA "/"
  // =====================================================
  if (!filename.startsWith("/"))
  {
    filename = "/" + filename;
  }

  Serial.println("Show: " + filename);

  // =====================================================
  // CEK FILE
  // =====================================================
  if (!SPIFFS.exists(filename))
  {
    server.send(404,
                "text/plain",
                "File tidak ada");

    return;
  }

  // =====================================================
  // BACA UKURAN JPG
  // =====================================================
  uint16_t w, h;

  if (TJpgDec.getFsJpgSize(&w,
                           &h,
                           filename.c_str()) != JDR_OK)
  {
    server.send(500,
                "text/plain",
                "Gagal membaca JPG");

    return;
  }

  // =====================================================
  // AUTO SCALE
  // =====================================================
  uint8_t scale = 0;

  while (scale < 3)
  {
    if ((w >> scale) <= 480 &&
        (h >> scale) <= 320)
    {
      break;
    }

    scale++;
  }

  // =====================================================
  // CLEAR TFT
  // =====================================================
  tft.fillScreen(TFT_BLACK);

  // =====================================================
  // SET DECODER
  // =====================================================
  TJpgDec.setJpgScale(scale);

  TJpgDec.setSwapBytes(true);

  TJpgDec.setCallback(tft_jpg_render);

  // =====================================================
  // AUTO CENTER
  // =====================================================
  int x = (480 - (w >> scale)) / 2;

  int y = (320 - (h >> scale)) / 2;

  // =====================================================
  // TAMPILKAN JPG
  // =====================================================
  TJpgDec.drawFsJpg(x,
                    y,
                    filename.c_str());

  server.send(200,
              "text/plain",
              "Gambar tampil di TFT");
}

// =====================================================
// DELETE FILE
// =====================================================
void handleDelete()
{
  if (!server.hasArg("file"))
  {
    server.send(400,
                "text/plain",
                "File tidak ditemukan");

    return;
  }

  String filename = server.arg("file");

  // =====================================================
  // PASTIKAN ADA "/"
  // =====================================================
  if (!filename.startsWith("/"))
  {
    filename = "/" + filename;
  }

  Serial.println("Hapus file: " + filename);

  // =====================================================
  // CEK FILE
  // =====================================================
  if (!SPIFFS.exists(filename))
  {
    Serial.println("File tidak ada");

    server.send(404,
                "text/plain",
                "File tidak ada");

    return;
  }

  // =====================================================
  // HAPUS FILE
  // =====================================================
  bool result = SPIFFS.remove(filename);

  if (result)
  {
    Serial.println("File berhasil dihapus");

    server.sendHeader("Location",
                      "/list");

    server.send(303);
  }
  else
  {
    Serial.println("Gagal menghapus file");

    server.send(500,
                "text/plain",
                "Gagal menghapus file");
  }
}

// =====================================================
// SETUP
// =====================================================
void setup()
{
  Serial.begin(115200);

  // =====================================================
  // SPIFFS
  // =====================================================
  if (!SPIFFS.begin(true))
  {
    Serial.println("SPIFFS gagal mount");

    return;
  }

  // =====================================================
  // TFT
  // =====================================================
  tft.begin();

  tft.setRotation(1);

  tft.fillScreen(TFT_BLACK);

  // =====================================================
  // JPG DECODER
  // =====================================================
  TJpgDec.setSwapBytes(true);

  TJpgDec.setCallback(tft_jpg_render);

  // =====================================================
  // BOOT SCREEN
  // =====================================================
  showBootScreen();

  // =====================================================
  // START ACCESS POINT
  // =====================================================
  WiFi.softAP(ssid,
              password);

  Serial.println();
  Serial.println("Access Point Started");

  Serial.print("IP Address: ");
  Serial.println(WiFi.softAPIP());

  // =====================================================
  // SHOW WIFI INFO TFT
  // =====================================================
  showWifiInfo();

  // =====================================================
  // HOME PAGE
  // =====================================================
  server.on("/",
            HTTP_GET,
            []()
            {
              server.send(200,
                          "text/html",
                          uploadPage);
            });

  // =====================================================
  // UPLOAD
  // =====================================================
  server.on("/upload",
            HTTP_POST,

            []()
            {
              server.sendHeader("Location",
                                "/list");

              server.send(303);
            },

            handleUpload);

  // =====================================================
  // LIST FILE
  // =====================================================
  server.on("/list",
            HTTP_GET,
            handleList);

  // =====================================================
  // SHOW IMAGE
  // =====================================================
  server.on("/show",
            HTTP_GET,
            handleShow);

  // =====================================================
  // DELETE FILE
  // =====================================================
  server.on("/delete",
            HTTP_GET,
            handleDelete);

  // =====================================================
  // START SERVER
  // =====================================================
  server.begin();

  Serial.println("Web Server Aktif");
}

// =====================================================
// LOOP
// =====================================================
void loop()
{
  server.handleClient();
}

🧪 Cara Pakai (Real Use Case)

Nyalakan ESP32
Lihat IP di Serial Monitor
koneksikan wifi dengan pc/komputer

Buka di browser:


http://192.168.xxx.xxx

Upload gambar
Klik “Lihat File”
Klik tampilkan → langsung tampil di TFT

🔥 Kelebihan Metode Ini

Tidak perlu upload ulang firmware
Bisa update UI dari HP/laptop
Cocok untuk:
- display menu
- dashboard

⚠️ Tips Penting

Batasi ukuran file (ideal <100KB)
Gunakan JPG, bukan PNG
Nama file tanpa spasi (biar aman)

Cara Kerja Laundry QRIS: Scan, Bayar, Mesin Jalan Otomatis (Video Demo)

2026-05-04T14:51:00.002+07:00

🔰 Cara Kerja Laundry QRIS (Penjelasan Lengkap)

Sistem laundry sekarang sudah mulai beralih dari koin ke sistem digital seperti QRIS.
Dengan sistem ini, pelanggan cukup melakukan pembayaran menggunakan QR code tanpa perlu uang koin.

Lalu, bagaimana sebenarnya cara kerja laundry QRIS?

⚙️ Proses Cara Kerja Laundry QRIS

Secara sederhana, alurnya seperti ini:

Pelanggan memilih mesin laundry
Sistem menampilkan kode QRIS
Pelanggan melakukan scan menggunakan e-wallet / mobile banking
Pembayaran dikonfirmasi otomatis
Mesin laundry langsung berjalan sesuai durasi

👉 Semua proses ini berlangsung dalam hitungan detik

📲 Contoh Penggunaan Nyata

Pada sistem Smart Laundry System, QRIS sudah terintegrasi langsung dengan mesin.

Jadi setelah pembayaran berhasil:
👉 mesin akan aktif otomatis tanpa perlu tombol tambahan

🎥 Lihat Demo Langsung

Untuk melihat bagaimana proses scan QRIS sampai mesin berjalan, kamu bisa tonton video berikut:

Sumber : channel yutube carapaklek dot com

💡 Kelebihan Laundry QRIS

Tidak perlu uang koin
Lebih praktis & cepat
Pembayaran fleksibel (semua e-wallet)
Lebih modern & profesional

⚠️ Perbedaan dengan Sistem Koin

Pada sistem koin:

harus pakai uang fisik
sering terjadi koin macet

Sedangkan QRIS:

semua serba digital
lebih minim masalah

🎯 Cocok Untuk Siapa?

Pemilik usaha laundryself service
Yang ingin upgrade dari koin
Yang ingin membuka laundry modern

🔥 Kesimpulan

Cara kerja laundry QRIS sangat sederhana dan efisien.
Dengan hanya scan QR, mesin bisa langsung berjalan otomatis.

Sistem ini menjadi solusi terbaik untuk membuat usaha laundry lebih modern, praktis, dan minim masalah.

Laundry Tanpa Koin: Mesin QRIS & RFID (Demo Lengkap)

2026-05-03T17:53:00.001+07:00

Di era digital seperti sekarang, sistem laundry juga mulai beralih dari yang sebelumnya menggunakan koin menjadi sistem pembayaran modern seperti QRIS dan RFID (tap card).

Dengan sistem ini, pelanggan tidak perlu lagi membawa uang koin.
Cukup scan QRIS atau tap kartu, dan mesin laundry langsung berjalan otomatis.

⚙️ Apa Itu Mesin Laundry QRIS & RFID?

Mesin laundry QRIS & RFID adalah alat kontrol yang memungkinkan pembayaran dilakukan secara digital tanpa koin.

Sistem ini biasanya digunakan pada laundry self service, di mana pelanggan dapat memilih mesin, melakukan pembayaran, lalu mesin akan aktif sesuai durasi yang ditentukan.

🚀 Cara Kerja Sistem

Secara sederhana, cara kerjanya seperti ini:

Pilih mesin laundry
Pilih metode pembayaran
Scan QRIS atau tap kartu RFID
Mesin langsung berjalan

Sistem ini sangat praktis dan mengurangi banyak masalah yang sering terjadi pada sistem koin.

Smart Laundry System dari Paklek Store adalah:

👉 alat kontrol mesin laundry berbasis digital (QRIS & RFID)
yang berfungsi untuk:

menerima pembayaran
mengontrol mesin cuci/dryer
dan mencatat transaksi otomatis

🔢 Kapasitas Smart Laundry System Paklek

Ini yang paling penting 👇

🧩 Kapasitas Mesin:

👉 1 – 16 Mesin (dalam 1 alat)

Pembagian umum:

1–8 = mesin cuci
9–16 = mesin dryer

🔌 Kapasitas Channel:

👉 16 Channel Relay

Artinya:

1 channel = 1 mesin
bisa kontrol:
- 16 mesin sekaligus
  ATAU
- kombinasi washer + dryer

💡 Keunggulan Dibanding Sistem Koin

Tidak ada koin macet
Lebih modern dan profesional
Pembayaran lebih fleksibel
Bisa dicatat dan dimonitor

🎥 Demo Lengkap

👉 Tonton langsung demo penggunaan di video berikut:

🎯 Cocok Untuk Siapa?

Pemilik usaha laundry
Yang ingin upgrade dari sistem koin
Yang ingin membuka laundry modern
Kos / apartemen dengan fasilitas laundry

🔥 Kesimpulan

Menggunakan sistem QRIS & RFID pada laundry bukan hanya soal teknologi, tapi juga meningkatkan kenyamanan pelanggan dan efisiensi usaha.

Jika kamu ingin membuat usaha laundry lebih modern dan praktis, sistem ini bisa menjadi solusi terbaik.

How to Create a WiFi Hotspot with ESP32 using Espressif IDE (ESP-IDF Guide)

2026-04-15T15:06:00.002+07:00

🚀 Introduction

The ESP32 DevKitC V4 is not only capable of connecting to WiFi — it can also create its own WiFi network.

This feature is called Access Point (AP) mode, where the ESP32 acts like a mini router.

In this tutorial, you will learn how to:

Create a WiFi hotspot using ESP32
Set your own SSID and password
Connect your phone directly to ESP32

We will use Espressif IDE (based on ESP-IDF), making it beginner-friendly.

Step 1: Create WiFi Hotspot Program

First, we write the code to make ESP32 broadcast its own WiFi.

#include "esp_wifi.h"
#include "esp_event.h"
#include "esp_netif.h"
#include "nvs_flash.h"
#include "esp_log.h"

#define WIFI_SSID      "ESP32_HOTSPOT"
#define WIFI_PASS      "12345678"
#define MAX_STA_CONN   4

void wifi_init_softap(void)
{
    esp_netif_init();
    esp_event_loop_create_default();
    esp_netif_create_default_wifi_ap();

    wifi_init_config_t cfg = WIFI_INIT_CONFIG_DEFAULT();
    esp_wifi_init(&cfg);

    wifi_config_t wifi_config = {
        .ap = {
            .ssid = WIFI_SSID,
            .ssid_len = strlen(WIFI_SSID),
            .channel = 1,
            .password = WIFI_PASS,
            .max_connection = MAX_STA_CONN,
            .authmode = WIFI_AUTH_WPA_WPA2_PSK
        },
    };

    if (strlen(WIFI_PASS) == 0)
    {
        wifi_config.ap.authmode = WIFI_AUTH_OPEN;
    }

    esp_wifi_set_mode(WIFI_MODE_AP);
    esp_wifi_set_config(WIFI_IF_AP, &wifi_config);
    esp_wifi_start();
}

void app_main(void)
{
    nvs_flash_init();
    wifi_init_softap();
}

👉 This code will:

Create a WiFi network named ESP32_HOTSPOT
Set password 12345678
Allow up to 4 connected devices

🔌 Step 2: Build and Flash using Espressif IDE

Open your project in Espressif IDE or klik new project in ess[ressif IDE and than

Click Build Project
Click Flash Device
Open Serial Monitor

👉 Wait until flashing is complete

dont forget to make name your proect

Please paste the program code above

📡 Step 3: ESP32 Starts Broadcasting WiFi

Once powered on, ESP32 will automatically:

Start AP mode
Broadcast WiFi signal
Wait for devices to connect

📱 Step 4: Connect Your Phone to ESP32

On your phone:

Open WiFi settings
Look for: ESP32_HOTSPOT
Enter password: 12345678
Connect

👉 If successful, your phone is now connected to ESP32

📊 Step 5: Verify Connection

Check Serial Monitor logs:

I (1234) wifi: AP started
I (1235) wifi: station connected

🛒 Komponen yang Dibutuhkan

ESP32 DevKit V4

Rp79.000

Lihat Shopee

Kabel JST

Rp 2.500

Lihat Shopee

ESP32 DevKitC V4 WROOM-32D vs WROOM-32U: What’s the Difference? (Complete Guide)

2026-04-15T09:53:00.001+07:00

🚀 Introduction

If you're working with the ESP32 DevKitC V4, you might notice there are two popular module variants:

ESP32-WROOM-32D
ESP32-WROOM-32U

At first glance, they look identical. Same chip, same performance, same GPIO.

But there is one critical difference that can affect your entire project.

👉 The antenna.

📡 The Core Difference: Antenna Type

🔹 ESP32-WROOM-32U (External Antenna)

Uses external antenna (IPEX / U.FL connector)
Requires antenna cable
Better signal range

👉 Designed for long-distance or industrial use

🔹 ESP32-WROOM-32D (PCB Antenna)

Built-in PCB antenna (onboard)
No need external antenna
Plug and play

👉 This is the most common version used by beginners.

📶 Which One Has Better Signal?

👉 Short answer: ESP32-WROOM-32U wins

Why?

Because external antennas:

Can be positioned freely
Have better gain
Less interference from PCB

Real-world example:

Inside a box → signal drops (32D)
With external antenna → stable (32U)

🧠 When Should You Use Each?

✅ Use WROOM-32D if:

Project indoor
Distance < 10–20 meters
Simple IoT project
Prototype / learning

✅ Use WROOM-32U if:

Device inside metal enclosure
Need long range WiFi
Industrial project
Outdoor installation

⚠️ Important Design Considerations

🔴 For WROOM-32D:

Don’t cover antenna area with metal
Keep space around antenna

🔴 For WROOM-32U:

Must attach antenna (or signal will be very weak!)
Use quality antenna cable

🔧 Performance: Are They Different?

No.

Both use the same chip:

👉 ESP32

So:

CPU = same
RAM = same
Bluetooth = same
WiFi speed = same

👉 Only antenna design is different

💡 Real Insight (Important)

Many beginners think:

“32U pasti lebih bagus”

❌ Not always.

If your project is:

Small
Indoor
Close to router

👉 32D is already perfect

🔚 Conclusion

The difference between:

ESP32-WROOM-32D
ESP32-WROOM-32U

👉 Comes down to antenna design

Choose based on your use case:

Simplicity → 32D
Range & flexibility → 32U

💡 Final Thoughts

Choosing the right ESP32 module can save you from:

Weak signal issues
Redesigning hardware
Deployment problems

Understanding this small difference can make a big impact on your IoT project success.

Read Also : 🔧 How to Change UART0 to UART1 on Waveshare ESP32-S3 Touch 7B (ESP-IDF Guide)

🔧 How to Change UART0 to UART1 on Waveshare ESP32-S3 Touch 7B (ESP-IDF Guide)

2026-04-11T21:36:00.001+07:00

By default, the Waveshare ESP32-S3 Touch 7B uses UART0 for serial communication (logging and monitoring).

However, in many real-world projects, you may need to:

Free UART0 for USB debugging
Use another UART for external devices (sensors, modules, etc.)
Avoid conflicts with flashing and logs

In this guide, you will learn how to switch from UART0 to UART1 using ESP-IDF.

🧠 Understanding UART on ESP32-S3 Touch 7B waveshare

The ESP32-S3 provides multiple UART interfaces:

UART0 → Default (used for flashing and logs)
UART1 → Available for custom use
UART2 → Optional (depending on configuration)

👉 UART signals can be routed to different GPIOs, making it very flexible.

⚙️ Step 1: Change Console Output to UART1

before you change UART 0 to UART1 you must change selector to UART selected

Open your project in ESP-IDF and run:

idf.py menuconfig

Navigate to:

Component config → ESP System Settings → Channel for console output

Change:

UART0

To:

UART1

🔌 Step 2: Configure UART1 Pins

Add this code in your main.c:

#include "driver/uart.h"

#define UART_PORT UART_NUM_1
#define TXD_PIN 17
#define RXD_PIN 18

void app_main(void)
{
    uart_config_t uart_config = {
        .baud_rate = 115200,
        .data_bits = UART_DATA_8_BITS,
        .parity    = UART_PARITY_DISABLE,
        .stop_bits = UART_STOP_BITS_1,
        .flow_ctrl = UART_HW_FLOWCTRL_DISABLE
    };

    uart_driver_install(UART_PORT, 1024, 0, 0, NULL, 0);
    uart_param_config(UART_PORT, &uart_config);
    uart_set_pin(UART_PORT, TXD_PIN, RXD_PIN, UART_PIN_NO_CHANGE, UART_PIN_NO_CHANGE);
}

🔨 Step 3: Build and Flash

idf.py build
idf.py flash

📟 Step 4: Monitor UART1 Output

Since logs are now on UART1:

Use a USB-to-TTL converter
Connect:
- TX → RX
- RX → TX

Then open a serial monitor (PuTTY, Arduino Serial Monitor, etc.)

⚠️ Important Notes

Avoid GPIO pins used by the LCD (Waveshare display)
Make sure selected pins are free
UART0 is still used during flashing (unless using USB CDC)

🎯 Conclusion

Switching from UART0 to UART1 allows you to:

Separate debugging and communication
Improve system flexibility
Build more advanced ESP32-S3 projects

With ESP-IDF, you have full control over UART configuration.

🚀 Next Topics

ESP32 UART Communication Example
ESP32-S3 USB CDC vs UART
LVGL + UART Data Integration
Read also : 🚀 Getting Started ESP-IDF with PowerShell & Espressif IDE (Beginner Guide)

🚀 Getting Started ESP-IDF with PowerShell & Espressif IDE (Beginner Guide)

2026-04-11T18:42:00.001+07:00

Belajar ESP-IDF di Windows sering bikin bingung—terutama saat harus memilih terminal yang tepat dan memahami alur build sampai flash ke ESP32.

Kalau kamu sudah berhasil install ESP-IDF tapi masih bingung langkah selanjutnya, artikel ini akan jadi panduan lengkap dari nol sampai jalan.

Di tutorial ini kamu akan belajar:

Setup ESP-IDF menggunakan PowerShell
Membuat project pertama (Hello World)
Build & flash ke ESP32
Menggunakan Espressif IDE (mode GUI)

🧠 Apa itu ESP-IDF & Espressif IDE?

🔹 ESP-IDF

ESP-IDF adalah framework resmi dari Espressif untuk mengembangkan firmware ESP32.

Kelebihannya:

Kontrol penuh terhadap hardware
Lebih stabil untuk project besar
Digunakan di industri profesional

🔹 Espressif IDE

Espressif IDE adalah tools berbasis GUI yang mempermudah:

Build project
Flash firmware
Monitoring serial output

👉 Cocok untuk yang tidak ingin terlalu banyak bermain di terminal

⚙️ Kenapa Pakai PowerShell?

Menggunakan PowerShell punya banyak keuntungan:

Lebih modern dibanding CMD
Mendukung script (.ps1)
Direkomendasikan oleh dokumentasi ESP-IDF
Lebih stabil untuk setup environment

👉 Intinya: PowerShell = pilihan terbaik untuk ESP-IDF di Windows

🧱 Persiapan Sebelum Mulai

Pastikan kamu sudah memiliki:

ESP-IDF terinstall
Python (biasanya otomatis)
Git
Driver USB ESP32

💡 Tips: Gunakan kabel data (bukan kabel charger)

🖥️ Setup ESP-IDF di PowerShell

Buka PowerShell, lalu jalankan:

cd C:\esp\esp-idf
.\export.ps1

Jika berhasil:

Tidak ada error
Command idf.py bisa digunakan

Cek dengan:

idf.py --version

🚀 Cara Membuat Project Baru ESP-IDF di Espressif IDE + Build & Flash

Buat kamu yang baru belajar ESP-IDF, sekarang kamu bisa langsung membuat project tanpa perlu command line, cukup menggunakan Espressif IDE.

Tutorial ini akan memandu kamu dari:

Membuat project baru
Konfigurasi project
Build program
Flash ke ESP32

🖥️ 1. Membuat Project Baru

Langkah-langkah:

Klik menu File
Pilih New
Klik Espressif IDF Project

📌 Keterangan gambar:

1 = Menu File
2 = Pilih Espressif IDF Project

⚙️ 2. Konfigurasi Project

Isi konfigurasi sebagai berikut:

🧾 (1) Project Name

Isi nama project, contoh:

hello_world

🔧 (2) Target Chip

Pilih sesuai board:

ESP32
ESP32-S3

📦 (3) Template

Centang:

Create project using one of the templates

Pilih:

hello_world

✅ (4) Finish

Klik tombol Finish

📁 3. Struktur Project & Build

Setelah project dibuat:

📌 (1) Struktur Project

Project muncul di panel kiri

🔨 (2) Build

Klik tombol Build (🔨) untuk compile

🔌 4. Flash ke ESP32

Setelah build berhasil:

Hubungkan ESP32 ke komputer
Klik tombol Flash (⚡)

💡 Tips:

Tekan tombol BOOT jika gagal
Pastikan port COM benar

📟 5. Monitor Output

Klik tombol Monitor

Jika berhasil:

Hello world!

🎯 Kesimpulan

Menggunakan Espressif IDE membuat proses development ESP32 jadi:

Lebih mudah
Tanpa command line
Cocok untuk pemula

🚀 Artikel Selanjutnya

ESP-IDF Error Fix
ESP-IDF vs Arduino
ESP32 GUI dengan LVGL

How to Install ESP-IDF 5.3 on Windows (PowerShell & CMD) – Complete Beginner Guide

2026-04-10T19:18:00.002+07:00

How to Install ESP-IDF 5.3 on Windows (PowerShell & CMD Guide)

If you're serious about building professional IoT products using ESP32, then ESP-IDF is the official framework you need to learn.

Unlike Arduino IDE, ESP-IDF gives you full control over hardware, performance, and memory optimization — making it the preferred choice for commercial and production-grade projects.

In this step-by-step guide, you'll learn how to install ESP-IDF 5.3 on Windows using PowerShell and Command Prompt (CMD).

🚀 What is ESP-IDF?

ESP-IDF (Espressif IoT Development Framework) is the official development framework from Espressif for:

ESP32
ESP32-S2
ESP32-S3
ESP32-C3

It includes:

FreeRTOS-based system
Built-in WiFi & Bluetooth stack
Peripheral drivers (GPIO, UART, SPI, I2C, etc.)
CMake-based build system

👉 Perfect for real-world IoT projects like smart laundry systems, automation, and payment devices.

🧰 System Requirements

Before installing ESP-IDF 5.3, make sure your system meets these requirements:

Windows 10 / 11 (64-bit)
Stable internet connection
Minimum 10 GB free storage
Python (installed automatically)

📥 Step 1 — Download ESP-IDF Installer

Go to the official Espressif website and download:

👉 ESP-IDF Tools Installer for Windows

Example file:

esp-idf-tools-setup-2.x.exe

⚙️ Step 2 — Run the Installer

Double-click the installer
Select:
- ✔ ESP-IDF version: v5.3
- ✔ Install Tools
- ✔ Install Python environment
Click Next → Install

⏳ Installation may take 10–30 minutes depending on your internet speed.

💻 Step 3 — Open ESP-IDF Environment

After installation, you will find:

Option 1 — ESP-IDF PowerShell (Recommended)

Option 2 — ESP-IDF Command Prompt (CMD)

Open from Start Menu:

ESP-IDF 5.3 PowerShell

ESP-IDF 5.3 CMD

🔍 Step 4 — Verify Installation

Run this command:

idf.py --version

If successful, output should be:

ESP-IDF v5.3

⚠️ Common Beginner Mistakes

❌ Running in Normal CMD / PowerShell

ESP-IDF will NOT work in standard terminal.

✔ Always use:

ESP-IDF PowerShell
ESP-IDF CMD

❌ 'idf.py not recognized' Error

This happens when environment variables are not loaded.

✔ Fix:

export.bat

❌ Python Conflict

ESP-IDF uses its own Python environment.

✔ Avoid mixing with:

System Python
Anaconda

🧠 PowerShell vs CMD (Which One Should You Use?)

Feature	PowerShell	CMD
Modern shell	✅ Yes	❌ No
Compatibility	✅ High	✅ High
Recommended	⭐ Yes	✔ Optional

👉 Recommendation: Use PowerShell

🔥 Pro Tips

Stick to one ESP-IDF version per project
Avoid random updates
Use stable version like v5.3

📌 Conclusion

Installing ESP-IDF 5.3 on Windows is straightforward if you follow the correct steps.

Once installed, you’re ready to build powerful and scalable IoT applications using ESP32.

Next step: Learn how to create your first ESP-IDF project 🚀

Cara Mengaktifkan Bluetooth ESP32 dengan ESP-IDF (Lengkap untuk Pemula)

2026-03-20T06:00:00.001+07:00

Bluetooth pada ESP32 merupakan salah satu fitur unggulan yang sangat powerful untuk berbagai kebutuhan proyek IoT, termasuk sistem kontrol, monitoring, hingga integrasi dengan smartphone. Jika kamu sedang belajar menggunakan ESP-IDF, memahami cara mengaktifkan Bluetooth adalah langkah penting yang wajib dikuasai.

Pada artikel ini, kita akan membahas secara lengkap dan mendalam tentang cara mengaktifkan Bluetooth ESP32 menggunakan ESP-IDF, mulai dari konsep dasar hingga implementasi langsung. Artikel ini dibuat khusus untuk pemula, jadi kamu tidak perlu khawatir jika belum pernah menggunakan ESP-IDF sebelumnya.

1. Pengertian Bluetooth pada ESP32
2. Jenis Bluetooth di ESP32
3. Kelebihan Bluetooth ESP32
4. Persiapan Sebelum Memulai
5. Instalasi ESP-IDF
6. Struktur Project ESP-IDF
7. Cara Mengaktifkan Bluetooth
8. Penjelasan Kode Program
9. Contoh Program BLE
10. Build & Upload Program
11. Testing Bluetooth
12. Studi Kasus
13. Tips Optimasi
14. Troubleshooting
15. Kesimpulan

1. Pengertian Bluetooth pada ESP32

ESP32 adalah mikrokontroler yang sudah dilengkapi dengan fitur WiFi dan Bluetooth dalam satu chip. Dengan adanya fitur ini, kamu tidak perlu lagi menambahkan modul tambahan untuk komunikasi nirkabel.

Bluetooth memungkinkan ESP32 berkomunikasi langsung dengan smartphone atau perangkat lain tanpa internet. Ini sangat cocok untuk sistem offline seperti kontrol alat, monitoring, dan automation.

2. Jenis Bluetooth di ESP32

🔵 Bluetooth Classic

Digunakan untuk transfer data besar dan komunikasi serial (SPP).

🟢 Bluetooth Low Energy (BLE)

BLE lebih hemat daya dan cocok untuk IoT seperti sensor dan monitoring.

Tips: Gunakan BLE untuk project modern karena lebih efisien.

3. Kelebihan Bluetooth ESP32

Tidak membutuhkan internet
Hemat daya (BLE)
Stabil dan cepat
Mudah terhubung ke smartphone
Tidak perlu modul tambahan

4. Persiapan Sebelum Memulai

Board ESP32
Kabel USB
PC/Laptop
ESP-IDF sudah terinstall

5. Instalasi ESP-IDF

git clone https://github.com/espressif/esp-idf.git
cd esp-idf
install.bat

export.bat

6. Struktur Project ESP-IDF

project/
├── main/
│   └── main.c
├── CMakeLists.txt
└── sdkconfig

7. Cara Mengaktifkan Bluetooth ESP32

Step 1: Menuconfig

idf.py menuconfig

Masuk ke: Component config → Bluetooth

Step 2: Inisialisasi

#include "esp_bt.h"
#include "esp_bt_main.h"

void app_main(void)
{
    esp_bt_controller_config_t bt_cfg = BT_CONTROLLER_INIT_CONFIG_DEFAULT();

    esp_bt_controller_init(&bt_cfg);
    esp_bt_controller_enable(ESP_BT_MODE_BLE);

    esp_bluedroid_init();
    esp_bluedroid_enable();
}

8. Penjelasan Kode Program

esp_bt_controller_init() → Inisialisasi controller
esp_bt_controller_enable() → Aktifkan BLE
esp_bluedroid_init() → Init stack
esp_bluedroid_enable() → Aktifkan Bluetooth

9. Contoh Program BLE

#include 
#include "esp_bt.h"
#include "esp_bt_main.h"

void app_main(void)
{
    esp_bt_controller_config_t bt_cfg = BT_CONTROLLER_INIT_CONFIG_DEFAULT();

    esp_bt_controller_init(&bt_cfg);
    esp_bt_controller_enable(ESP_BT_MODE_BLE);

    esp_bluedroid_init();
    esp_bluedroid_enable();

    printf("Bluetooth BLE Aktif!\n");
}

10. Build & Upload Program

idf.py build
idf.py flash
idf.py monitor

11. Testing Bluetooth

Gunakan aplikasi seperti nRF Connect atau LightBlue untuk scan device ESP32.

12. Studi Kasus

Kontrol relay via HP
Monitoring sensor
Sistem laundry coin

13. Tips Optimasi

Gunakan BLE untuk hemat daya
Matikan jika tidak digunakan
Gunakan deep sleep

14. Troubleshooting

Bluetooth tidak muncul: cek menuconfig

ESP32 restart: cek power supply

15. Kesimpulan

Mengaktifkan Bluetooth ESP32 dengan ESP-IDF cukup mudah jika mengikuti langkah yang benar. Dengan dasar ini, kamu bisa membuat berbagai proyek IoT lanjutan seperti smart home, monitoring, dan sistem otomatis lainnya.

🎯 Penutup

Semoga tutorial ini membantu kamu memahami dasar Bluetooth ESP32. Jangan ragu untuk mencoba dan eksplorasi lebih lanjut.

ESP-IDF LVGL Error: build/config/sdkconfig.h:939:39 expected identifier before string constant (CONFIG_LV_FONT_CUSTOM_DECLARE)

2026-02-14T21:31:00.008+07:00

If you are seeing this error after exporting your UI from SquareLine Studio and rebuilding your project in ESP-IDF v5.x, you are not alone.

The build suddenly fails with something like:

build/config/sdkconfig.h:939:39: error: expected identifier or '(' before string constant
#define CONFIG_LV_FONT_CUSTOM_DECLARE ""

Sometimes the error trace continues into internal LVGL files such as:

lv_disp.c

The confusing part? You never modified those files.

Why This Error Is So Confusing

The compiler points to:

build/config/sdkconfig.h

Or even deeper inside:

components/lvgl__lvgl/src/core/lv_disp.c

But remember:

Error location does not always mean root cause.

Understanding LVGL Configuration in ESP-IDF v5.x

When LVGL is integrated as a component in ESP-IDF, configuration is handled via Kconfig.

You configure it using:

idf.py menuconfig

The settings are stored in:

sdkconfig

And macros are auto-generated into:

sdkconfig.h

In ESP-IDF integration, Kconfig overrides lv_conf.h.

Root Cause Analysis

This is the problematic macro:

#define CONFIG_LV_FONT_CUSTOM_DECLARE ""

Inside LVGL internal config:

#define LV_FONT_CUSTOM_DECLARE CONFIG_LV_FONT_CUSTOM_DECLARE

After macro expansion, the compiler effectively sees:

#define LV_FONT_CUSTOM_DECLARE ""

But LVGL expects something like:

extern lv_font_t ui_font_MyFont;

A string literal is not a valid C declaration — therefore the compiler throws the error.

Proper Fix (Recommended)

Run:

idf.py menuconfig

Navigate to:

Component config
→ LVGL configuration
→ Custom font declaration

If unused, disable it.

Then clean and rebuild:

idf.py fullclean
idf.py build

Quick Debug Fix (Temporary)

Edit:

sdkconfig

Change:

CONFIG_LV_FONT_CUSTOM_DECLARE=""

To:

# CONFIG_LV_FONT_CUSTOM_DECLARE is not set

Then rebuild.

Key Takeaway

ESP-IDF is not Arduino.

Configuration is controlled by Kconfig.

Understanding how sdkconfig generates macros can save hours of debugging.

In embedded systems, fixing the error is easy. Understanding why it happens is what makes you an engineer.

Fix CONFIG_LV_FONT_CUSTOM_DECLARE Error via ESP-IDF PowerShell (Step-by-Step)

If you are seeing this error:

build/config/sdkconfig.h:939:39: error: expected identifier or '(' before string constant
#define CONFIG_LV_FONT_CUSTOM_DECLARE ""

The safest and most reliable way to fix it is through ESP-IDF PowerShell using menuconfig.

Step 1 — Open ESP-IDF PowerShell

Click the Start Menu and open:

ESP-IDF 5.3 PowerShell

Step 2 — Navigate to Project Directory

Use the cd command to open your project folder:

cd C:\Users\arto\Desktop\keyboard_test\keyboard_test

Step 3 — Run menuconfig

Type the following command:

idf.py menuconfig

This will open the ESP-IDF configuration interface.

Step 4 — Enter Component Config

Inside the menu, select:

Component config

Step 5 — Open LVGL Configuration

Scroll down and choose:

LVGL configuration

Step 6 — Go to Font Usage

Select:

Font usage

Step 7 — Disable Custom Font

Scroll down until you find:

Enable the custom font

Make sure it is unchecked.

If this option is enabled, ESP-IDF generates:

CONFIG_LV_FONT_CUSTOM_DECLARE=""

disable like this :

Step 8 — Save Configuration

Press:

To save the configuration.

Then exit menuconfig.

Step 9 — Clean and Rebuild

Run the following commands:

idf.py fullclean
idf.py build

Why This Works

This error is caused by a Kconfig-generated macro:

#define CONFIG_LV_FONT_CUSTOM_DECLARE ""

By disabling custom font support, ESP-IDF stops generating the invalid macro, and the build system regenerates a valid sdkconfig.h.

Always fix configuration-layer errors at the configuration layer — not inside source files.

How to add / register Waveshare ESP32-S3 7-inch board into SquareLine Studio as a custom board configuration

2026-02-14T01:42:00.003+07:00

The Waveshare ESP32-S3 7-inch series is a family of all-in-one development boards that combine:

ESP32-S3 microcontroller
7-inch TFT LCD (RGB parallel interface)
Optional capacitive touch panel
Onboard PSRAM (required for large framebuffers)
USB-C for power and programming

These boards are designed for:

Human-Machine Interface (HMI)
Smart home control panels
Industrial control systems
IoT dashboards
Embedded GUI applications using LVGL

Two commonly found product names are:

Waveshare ESP32-S3-Touch-LCD-7B
Waveshare ESP32-S3-LCD-7

Now let’s clarify the differences between the variants available on the market.

1️⃣ “7” vs “7B” – What Does It Mean?

This is one of the most common points of confusion.

🔹 ESP32-S3-LCD-7

This usually refers to:

A 7-inch RGB LCD board
May come in touch or non-touch versions
Earlier hardware revision in some cases
Basic display-focused configuration

It typically includes:

ESP32-S3-WROOM or similar module
RGB LCD interface
External PSRAM
Standard power and USB interface

🔹 ESP32-S3-Touch-LCD-7B

The “B” generally indicates a board revision.

In most cases, the 7B version includes:

Improved PCB layout
Better power regulation stability
Refined RGB signal routing
Integrated capacitive touch controller (commonly GT911 over I2C)

The “Touch” label explicitly confirms the presence of a capacitive touch panel.

Important note:
Not all “7” versions include touch. The word “Touch” in the product name is what guarantees it.

2️⃣ Touch vs Without Touch Versions

Another major difference in the lineup is the presence of a touch panel.

🔹 Touch Version

Features:

Capacitive touch panel
Typically uses GT911 touch controller (I2C interface)
Multi-touch support
Requires I2C initialization in firmware

These versions are ideal for:

Interactive UI
Control panels
Kiosk-style interfaces
LVGL-based applications

🔹 Without Touch Version

Features:

Display only
No touch controller
Lower complexity in firmware
No I2C touch driver needed

These are suitable for:

Information display panels
Monitoring dashboards
Applications using external input (buttons, encoder, etc.)

3️⃣ Resolution Variants: 800×480 vs 1024×600

Although both are 7-inch panels, different versions may use different native resolutions:

🔹 800 × 480

Lower framebuffer requirement
More forgiving for PSRAM usage
Common in embedded HMI projects

🔹 1024 × 600

Higher pixel density
Larger framebuffer (≈1.2MB at RGB565)
Higher PSRAM bandwidth requirement
More demanding RGB timing configuration

Resolution directly impacts:

Framebuffer size
DMA performance
Pixel clock configuration
LVGL buffer strategy

4️⃣ Common Hardware Characteristics

Across most 7-inch ESP32-S3 Waveshare boards, you will typically find:

ESP32-S3 with dual-core Xtensa
External PSRAM (often 8MB)
RGB parallel LCD interface (not SPI)
USB-C programming port
Backlight control circuit
Optional microSD slot (in some variants)

The RGB interface means:

High pin count usage
Precise timing configuration required
Much higher performance than SPI displays

SquareLine Studio Overview

SquareLine Studio is a professional UI design tool built specifically for:

LVGL (Light and Versatile Graphics Library)

It allows developers to design graphical user interfaces visually, instead of manually writing LVGL C code for every widget.

SquareLine Studio does not replace firmware development.
It generates LVGL-compatible UI source code that must be integrated into a microcontroller project.

What SquareLine Studio Actually Is

SquareLine Studio is:

A drag-and-drop UI builder
A code generator for LVGL
A layout designer for embedded displays
A project-based UI development environment

It generates:

ui.c
ui.h
ui_events.c
Font files
Image assets
Screen definitions
Object hierarchies

It does not generate:

Display drivers
Touch drivers
RGB timing configuration
Hardware initialization code
ESP-IDF project setup

Relationship with LVGL

SquareLine Studio is built around:

LVGL

LVGL is the graphics library that runs on the microcontroller.

The workflow is:

Design UI in SquareLine
Export LVGL-compatible code
Integrate exported files into firmware
Compile using framework (e.g., ESP-IDF)

SquareLine only creates the top-layer UI objects.
LVGL handles rendering and object management at runtime.

Supported Frameworks

SquareLine can export projects for:

Generic LVGL
Arduino
ESP-IDF
STM32 HAL
Other supported MCU environments

For ESP32-S3 development, the common backend is:

ESP-IDF

However, SquareLine does not configure ESP-IDF internally.
It only generates compatible UI code.

Project Structure in SquareLine

When creating a new project, you define:

Display resolution (e.g., 800×480 or 1024×600)
Color depth (typically 16-bit RGB565)
LVGL version
Target export type

SquareLine does not require you to select a specific hardware board.
It only needs display parameters.

This is important:

SquareLine operates at the LVGL layer, not at the hardware driver layer.

Core Features

SquareLine Studio provides:

Visual screen editor
Widget library (buttons, labels, sliders, keyboard, etc.)
Style editor
Animation builder
Event editor (callback configuration)
Font converter
Image converter

It significantly reduces development time compared to writing LVGL code manually.

What SquareLine Studio Is NOT

To avoid misunderstanding:

SquareLine Studio is not:

An IDE like Visual Studio Code
A firmware compiler
A hardware configuration tool
A board manager
A driver installer

It does not “install” ESP32 boards.

It does not detect display hardware.

It does not manage PSRAM or RGB timing.

All hardware-level configuration must be done in the firmware project.

Where SquareLine Fits in the System

In an ESP32-S3 7-inch project, the stack typically looks like this:

Layer 1 → Hardware (RGB LCD + Touch Controller)
Layer 2 → ESP-IDF Drivers (esp_lcd, I2C, PSRAM)
Layer 3 → LVGL
Layer 4 → SquareLine-generated UI

SquareLine only operates at Layer 4.

That is its scope.

ESP32-S3 7-Inch Waveshare Is NOT Built-In in SquareLine Studio

SquareLine Studio does not include a built-in board profile for the Waveshare ESP32-S3 7-inch series.

That includes:

Waveshare ESP32-S3-Touch-LCD-7B
Waveshare ESP32-S3-LCD-7

When you create a new project in SquareLine Studio:

You will not find “ESP32-S3 7-inch Waveshare” in the board list.
There is no official preset for 800×480 or 1024×600 specifically labeled for this hardware.
There is no automatic driver configuration.

This is intentional — not an omission.

Why It Is Not Included (Technical Reality)

SquareLine Studio is built for:

LVGL UI generation

It is not a hardware configuration environment.

Board profiles inside SquareLine are simply:

Resolution presets
Color depth presets
Export configuration templates

They are not hardware drivers.

Since the Waveshare ESP32-S3 7-inch boards use:

RGB parallel interface
Custom timing configuration
PSRAM framebuffer allocation
I2C touch controller (in touch versions)

All of that belongs to firmware level (e.g., ESP-IDF), not to SquareLine.

SquareLine has no mechanism to install RGB timing or PSRAM settings.

What This Means Practically

You cannot:

“Install” the Waveshare ESP32-S3 board into SquareLine
Download a board package
Enable it from a board manager
Select it from a built-in dropdown list

Instead, you must:

Manually configure display resolution
Match LVGL version
Export UI
Integrate it into your ESP-IDF project

SquareLine works generically with LVGL, not with specific RGB hardware boards.

How to Install a Custom ESP32-S3 7-Inch Waveshare Board in SquareLine Studio

STEP 1- Close Squareline Studio

STEP 2- Download the Official ESP32-S3 Waveshare Board Resources

Before integrating the board into SquareLine Studio, you must first download the official resources provided by Waveshare for the ESP32-S3 7-inch series.

link :

👉Klik di sini untuk download

after download extrak file to folder and copy to location squareline studio :

Navigate to the SquareLine installation directory.

Typical Windows locations:

C:\Users\<username>\AppData\Local\Programs\SquareLine Studio\

Inside the installation folder, look for:

  SquareLine Studio/

   └── resources/

       └── boards/
         |-- Dekstop

           ├── arduino

           ├── esp32

           └── stm32
         |-- Espressif
            |-- copy file download here 

after copy open squareline studio, select esspressif ,

Panduan Lengkap LCD 7 Inch ESP32-S3 Waveshare: Soket, Pin, dan Kesalahan Umum

2026-02-08T11:35:00.002+07:00

LCD 7 inch ESP32-S3 dari Waveshare merupakan board all-in-one yang banyak dipakai untuk HMI, kiosk, dan proyek IoT display.
Namun karena fiturnya lengkap, banyak pengguna pemula salah memahami fungsi soket dan pin, yang berujung layar nyala tapi touch tidak jalan, atau GPIO terasa “habis”.

Artikel ini membahas fungsi setiap soket dan pin secara konseptual, bukan sekadar sebutan nama.

Gambaran Umum Board LCD 7 Inch ESP32-S3

Board ini bukan sekadar modul LCD, melainkan satu sistem lengkap yang berisi:

ESP32-S3 sebagai mikrokontroler utama
Panel LCD 7 inch resolusi tinggi (RGB)
Touch controller terpisah
Power regulator onboard
Header GPIO & I2C

📌 Tujuan gambar:
Memberi konteks visual awal agar pembaca tahu “ini papan yang sedang kita bahas” sebelum masuk teknis.

Soket Power (Bagian Paling Krusial)

LCD 7 inch membutuhkan arus yang jauh lebih besar dibanding LCD kecil.
Karena itu, soket power menjadi bagian paling krusial.

Hal yang perlu dipahami:

Tegangan kerja utama: 5V
Board sudah memiliki regulator internal
USB laptop tidak selalu cukup stabil

⚠️ Kesalahan umum:
LCD nyala sebentar lalu restart → masalah supply, bukan firmware.

📌 Tujuan gambar:
Menunjukkan lokasi fisik soket power agar pembaca tidak salah colok.

Soket LCD RGB (Jantung Sistem)

Panel LCD terhubung ke ESP32-S3 melalui interface RGB (parallel), bukan SPI.

Ciri khas interface RGB:

Jumlah pin sangat banyak
Terdiri dari:
- HSYNC, VSYNC
- DE, PCLK
- Data RGB (R, G, B)

📌 Poin penting yang sering disalahpahami:

Banyak GPIO “habis” bukan karena salah desain, tapi karena RGB memang butuh banyak pin.

📌 Tujuan gambar:
Menunjukkan bahwa konektor LCD memang besar dan kompleks → membantu pembaca menerima konsep ini.

Soket Touch Panel (GT911 – I2C)

Touch panel tidak berhubungan langsung dengan soket RGB.
Touch menggunakan controller terpisah, umumnya GT911, yang berkomunikasi via I2C.

Pin yang terlibat:

📌 Kesalahan umum:

LCD sudah tampil → diasumsikan touch pasti aktif
Padahal touch harus di-init via I2C di firmware

📌 Tujuan gambar:
Memisahkan secara visual konsep LCD ≠ Touch, ini sangat penting untuk pemula.

Header I2C (Sering Disalahpahami)

Board menyediakan header I2C tambahan untuk ekspansi.

Hal paling penting yang wajib dipahami:

I2C touch dan I2C header adalah satu jalur yang sama

Artinya, dalam satu bus I2C bisa dipakai:

Touch GT911
PN532 NFC
IO Expander (PCF8574 / MCP23017)
Sensor lain

Selama:

Alamat I2C tidak bentrok
Pull-up sesuai

📌 Tujuan gambar:
Menunjukkan lokasi header I2C agar pembaca paham bahwa ini bukan I2C terpisah.

Header GPIO ESP32-S3

[GAMBAR 6 – GPIO header dengan anotasi]

GPIO digunakan untuk:

Relay
Tombol
LED
Buzzer

Namun karena:

Banyak GPIO sudah dipakai LCD RGB
maka GPIO tersisa terbatas.

📌 Solusi terbaik (disarankan):

Gunakan I2C expander
Jangan memaksakan semua fitur ke GPIO langsung

📌 Tujuan gambar:
Membantu pembaca mengidentifikasi pin mana yang benar-benar tersedia.

Kesalahan Umum yang Sering Terjadi

Kesalahan yang paling sering dialami pemula:

Mengira I2C touch terpisah dari I2C header
Supply arus tidak mencukupi
Salah asumsi semua GPIO bebas
Salah versi ESP-IDF
Touch tidak di-init di firmware

📌 Catatan penting:
Sebagian besar masalah bukan hardware rusak, tapi salah pemahaman konsep.

Kesimpulan

LCD 7 inch ESP32-S3 Waveshare adalah board yang sangat powerful, tapi wajib dipahami strukturnya.

Ringkasan konsep:

LCD → RGB parallel
Touch → I2C
I2C → bisa sharing
GPIO → terbatas
Power → harus kuat & stabil

Jika konsep ini sudah benar, proses development akan jauh lebih lancar.

berikut gambar lengkap yang bisa anda gunakan untuk mengakses soket-soket LCD ESP32_S3_Touch_7B waveshare

Cara Upload Program ke ESP32-S3 7 Inch LCD Waveshare (Anti Gagal & Anti Salah Port)

2026-02-01T19:47:00.003+07:00

Banyak pengguna ESP32-S3 7 inch LCD Waveshare mengalami masalah yang sama:

Dicolok ke laptop ada bunyi
Tapi tidak muncul COM port
Atau muncul sebentar lalu hilang seperti eject
Sudah ganti kabel, ganti laptop, tetap gagal

Padahal board tidak rusak.
Masalahnya hampir selalu salah port USB dan salah cara masuk download mode.

Artikel ini membahas cara upload program yang BENAR, berdasarkan pengalaman nyata, bukan teori datasheet.

Kenali Dulu: ESP32-S3 Waveshare Punya 2 Port USB

Pada board ini terdapat dua konektor USB:

1️⃣ Port USB

Ini adalah USB native / OTG ESP32-S3
BUKAN untuk upload firmware
Biasanya hanya bunyi “ting” di Windows
Kadang muncul seperti flash disk atau langsung eject
TIDAK muncul COM port

👉 Port ini dipakai untuk:

USB HID
Touch
USB MSC
Fitur USB lanjutan (jika firmware mendukung)

2️⃣ Port UART1 (INI YANG BENAR)

Terhubung ke chip USB-to-Serial (CH343 / CP210x)
Digunakan untuk:
- Upload program
- Serial monitor
- Debug dasar

📌 Semua proses upload WAJIB lewat UART1

Ciri ESP32-S3 Waveshare Sudah Terdeteksi dengan Benar

Jika colok ke UART1 dan driver sudah benar, di Device Manager Windows akan muncul:


Ports (COM & LPT)
 └─ USB-Enhanced-SERIAL CH343 (COMx)

Jika COM port sudah muncul:
✅ Board aman
✅ USB aman
✅ Tinggal masalah software / mode upload

Cara Masuk Download Mode (WAJIB TAHU)

Board Waveshare cukup bandel, jadi jangan asal klik upload.

Urutan yang BENAR:

Colok kabel USB ke UART1
Tekan & tahan tombol BOOT
Tekan tombol RESET satu kali
Lepaskan tombol BOOT
Baru lakukan upload

📌 Kalau upload mentok di:


Connecting.........

👉 tekan RESET sekali.

Upload Program Menggunakan ESP-IDF

Setting awal:


idf.py set-target esp32s3
idf.py menuconfig

Pastikan di menu:


Serial flasher config
 ├─ Flash UART port : COMx
 └─ Flash baud rate : 460800

Lalu:


idf.py build
idf.py flash monitor

Upload Program Menggunakan Arduino IDE

Setting yang aman:

Board : ESP32S3 Dev Module
Port : COMx
USB CDC on boot : Enabled
Upload Speed : 460800

Klik Upload
Jika gagal → tekan RESET sekali

Kesalahan Paling Sering (dan Penyebab Gagal Upload)

❌ Upload lewat port USB, bukan UART1
❌ Mengira board rusak karena COM tidak muncul
❌ Tidak masuk download mode
❌ Kabel USB hanya untuk charging
❌ Langsung upload program LVGL berat

Tips Aman untuk Pertama Kali

✔ Selalu tes upload program sederhana dulu
✔ Jangan langsung pakai LVGL / SquareLine
✔ Pastikan COM port stabil
✔ Gunakan kabel USB data berkualitas

Jika program sederhana berhasil di-flash:
👉 board dipastikan sehat

Penutup

ESP32-S3 7 inch LCD Waveshare bukan board rusak, tapi board yang mudah bikin salah paham.

Kalau:

Salah port → COM tidak muncul
Salah mode → upload gagal
Salah asumsi → dikira board mati

Dengan memahami fungsi dua port USB dan cara masuk download mode, proses upload akan normal dan stabil.

Unboxing ESP32-S3 7 Inch Touchscreen Waveshare: Fungsi USB dan Skema Port Lengkap

2026-02-01T16:56:00.002+07:00

ESP32-S3 7 Inch Touchscreen dari Waveshare cukup populer digunakan untuk HMI, dashboard IoT, hingga panel kontrol industri. Namun pada penggunaan awal, banyak pengguna mengalami kebingungan, terutama terkait dua port USB Type-C yang terlihat sama tetapi memiliki fungsi berbeda.

Artikel ini dibuat sebagai pelengkap video YouTube, dengan fokus pada penjelasan skema, fungsi port, dan jalur komunikasi agar tidak salah sambung sejak awal.

Sekilas Spesifikasi ESP32-S3 Touch LCD 7 Inch

Modul ini menggabungkan mikrokontroler ESP32-S3 dengan layar LCD touchscreen berukuran 7 inch (resolusi 800×480). Beberapa poin penting:

ESP32-S3 dengan WiFi & Bluetooth
PSRAM dan Flash onboard
Layar LCD 7 inch + touch panel
Mendukung USB to UART, CAN, RS485, dan I2C
Cocok untuk LVGL dan SquareLine Studio

Gambar berikut menunjukkan penamaan komponen dan konektor utama pada board:

Fungsi Dua Port USB Type-C (Paling Sering Membingungkan)

Pada board ESP32-S3 Touch LCD 7 Inch terdapat dua port USB Type-C yang secara fisik terlihat mirip. Inilah sumber kesalahan paling umum.

USB Type-C No. 5 – USB untuk Power & Upload Program

Port USB Type-C nomor 5 digunakan untuk:

Memberikan catu daya ke board
Upload firmware (ESP-IDF / Arduino)
Serial monitor utama

Port inilah yang wajib digunakan saat flashing program. Jika tujuan Anda adalah upload firmware, selalu gunakan port ini.

Kesalahan umum: menggunakan port USB yang salah sehingga upload gagal meskipun COM port terdeteksi.

USB Type-C No. 6 – USB to UART Tambahan

Port USB Type-C nomor 6 juga merupakan USB to UART, namun fungsinya berbeda:

Digunakan untuk komunikasi UART tambahan
Terhubung ke UART1 atau UART2
Cocok untuk debugging atau komunikasi serial eksternal

Port ini bukan port utama untuk upload firmware.

Jika port ini digunakan untuk flashing, biasanya akan muncul gejala:

COM port terdeteksi
Proses upload timeout atau gagal

UART1 dan UART2: Jalur yang Sama, Dipilih dengan Switch

ESP32-S3 Touch LCD 7 Inch memiliki UART1 dan UART2 yang sebenarnya adalah jalur UART yang sama, dan pemilihannya dilakukan menggunakan switch di board.

Hal yang perlu diperhatikan:

Posisi switch menentukan jalur UART aktif
Salah posisi switch dapat menyebabkan kegagalan komunikasi
UART ini umumnya digunakan untuk modul eksternal seperti RS485 atau perangkat serial lain

Antarmuka Lain yang Tersedia

Selain USB dan UART, board ini juga menyediakan beberapa antarmuka lain:

Sensor Interface

Digunakan untuk berbagai modul sensor eksternal.

I2C Interface

Mendukung koneksi perangkat I2C dengan level tegangan yang dapat dipilih (3.3V / 5V).

CAN Interface

Tersedia header CAN lengkap dengan opsi resistor terminasi.

RS485 Interface

Mendukung komunikasi RS485 untuk aplikasi industri.

Semua antarmuka ini sudah ditandai dengan jelas pada silkscreen board.

Tips Aman Penggunaan Awal

Agar tidak mengalami masalah saat pertama kali mencoba board ini:

Gunakan USB Type-C No.5 untuk upload program
Periksa posisi switch UART sebelum debugging
Jangan menyimpulkan board rusak hanya karena upload gagal
Pastikan driver USB to UART sudah terpasang dengan benar

Penutup

ESP32-S3 7 Inch Touchscreen Waveshare bukanlah board yang rumit, tetapi membutuhkan pemahaman dasar tentang fungsi port dan jalur komunikasi. Dengan mengetahui perbedaan dua USB Type-C dan fungsi UART, proses pengembangan akan jauh lebih lancar.

Artikel ini melengkapi pembahasan video unboxing, khusus untuk pembaca yang membutuhkan skema dan penjelasan teknis lebih detail.

Semoga membantu, dan semoga tidak salah colok USB lagi 😊

Setup TFT 4 Inch yang Benar (Tanpa Trial Error)

2026-01-31T10:34:00.001+07:00

Pakai TFT 4 inch itu kelihatannya sederhana: colok, upload sketch, selesai.
Tapi kenyataannya? Banyak yang habis waktu berjam-jam cuma buat layar nyala normal.

Masalahnya bukan karena TFT itu “rewel”, tapi karena urutan setup yang sering salah.
Artikel ini membahas cara setup TFT 4 inch dengan benar sejak awal, tanpa trial error, tanpa gonta-ganti library, dan tanpa nebak-nebak.

Cocok untuk:

Pemula yang baru pertama pakai TFT besar
Praktisi yang capek debugging hal sepele
Siapa pun yang ingin layar langsung jalan stabil

1. Cara Identifikasi Controller TFT (Tanpa Buka Datasheet)

Ini langkah paling penting, tapi juga paling sering dilewati.

Kenapa Ini Krusial?

TFT 4 inch bisa terlihat sama, tapi:

controllernya beda
protokolnya beda
setting library-nya beda total

Kalau controller salah → setup berikutnya pasti gagal, mau kalibrasi sebagus apa pun.

Cara Praktis Identifikasi Controller:

✔ Lihat tulisan di PCB belakang modul
Biasanya ada kode kecil seperti:

ILI9486
ILI9488
ST7796

✔ Cek jalur pin

Banyak pin data (D0–D7)? → kemungkinan mode paralel
Pin sedikit (MOSI, SCK, CS)? → SPI

✔ Gunakan sketch baca ID
Beberapa library menyediakan contoh sketch untuk membaca ID controller langsung dari hardware.

📌 Tips penting:

Jangan percaya judul produk di marketplace. Percaya hardware-nya.

2. Menentukan Mode Komunikasi yang Benar (SPI vs Parallel)

Salah mode = layar putih.

Umumnya:

ILI9486 → 8-bit parallel
ILI9488 → SPI (lebih umum di ESP32)

Cara Cek Cepat:

Kalau TFT punya lebih dari 20 pin data, hampir pasti parallel
Kalau cuma ±10 pin, kemungkinan SPI

⚠️ Jangan pakai library SPI untuk TFT parallel (atau sebaliknya).

3. Cara Cek & Menentukan Orientasi Layar

Layar nyala tapi:

kebalik
mirror
atau posisinya aneh

Ini bukan error, tapi belum disetel.

Langkah Aman:

✔ Jalankan contoh sketch dasar (fillScreen, drawLine)
✔ Ubah setRotation(0–3)
✔ Tentukan orientasi yang paling natural sesuai posisi fisik layar

📌 Catatan penting:

Orientasi layar HARUS benar dulu sebelum kalibrasi touch.

4. Pastikan Touchscreen Terbaca dengan Benar

Banyak yang langsung menyimpulkan:

“Touchscreen-nya rusak”

Padahal belum tentu.

Cara Cek Touch Masih Normal:

✔ Jalankan sketch Touch Test / Touch Raw Data
✔ Sentuh layar dan lihat nilai X & Y di Serial Monitor

Kalau nilai berubah saat disentuh → touch masih sehat

Masalah biasanya:

mapping salah
rotasi belum sesuai
belum dikalibrasi

5. Urutan Kalibrasi Touch yang Benar

Kalibrasi itu langkah terakhir, bukan pertama.

Urutan Aman:

1️⃣ Controller sudah benar
2️⃣ Mode komunikasi sesuai
3️⃣ Orientasi layar sudah fix
4️⃣ Baru jalankan Touch Calibration

Hasil Kalibrasi:

Biasanya berupa 4 nilai koordinat:


X_MIN, X_MAX, Y_MIN, Y_MAX

Nilai ini spesifik untuk layar tersebut, bahkan antar TFT dengan tipe sama bisa berbeda.

📌 Jangan copy hasil kalibrasi orang lain mentah-mentah.

6. Library yang Paling Stabil (Bukan Paling Populer)

Banyak tutorial pakai library A karena “terkenal”, bukan karena stabil.

Rekomendasi Umum:

Untuk ESP32
✔ TFT_eSPI → cepat, fleksibel, stabil
Untuk Arduino klasik
✔ Adafruit_GFX + driver spesifik (dengan catatan hardware mendukung)

Kenapa TFT_eSPI Unggul?

Setup jelas lewat file konfigurasi
Mendukung banyak controller
Performa tinggi
Dokumentasi rapi

⚠️ Tapi:
Library ini wajib dikonfigurasi manual, tidak plug-and-play.

7. Kenapa Banyak Orang Terjebak Trial Error?

Karena urutannya kebalik:
❌ langsung kalibrasi
❌ gonta-ganti library
❌ ganti sketch tanpa tahu masalahnya

Padahal urutan benar itu:

Controller → Mode → Orientasi → Touch → Kalibrasi

Kalau urutan ini diikuti, 90% masalah TFT 4 inch selesai lebih cepat.

8. Tentang File Setup & Preset Kalibrasi (Opsional, Time Saver)

Artikel ini cukup untuk bikin TFT jalan.
Tapi kalau kamu:

sering ganti proyek
sering setup TFT baru
tidak mau buang waktu ulang-ulang

Maka:
🔒 File setup.h + preset kalibrasi itu bukan keharusan, tapi penghemat waktu.

Isinya biasanya:

driver sudah ditentukan
pin mapping rapi
orientasi fix
nilai kalibrasi siap pakai

📌 Cocok dijadikan konten premium, karena:

bukan “ilmu rahasia”
tapi praktis & efisien

Kesimpulan

Setup TFT 4 inch tidak serumit yang dibayangkan, asalkan:

tidak lompat langkah
tidak asal ikut tutorial
dan paham urutan dasarnya

Kalau TFT kamu:

nyala normal
orientasi benar
touch akurat

Artinya 90% setup sudah selesai. Sisanya tinggal desain UI dan logika program.

Kesalahan Paling Umum Pakai TFT 4 Inch (dan Cara Benerinnya)

2026-01-31T10:23:00.001+07:00

Pernahkah Anda membeli layar TFT 4 inch, sudah membayangkan bakal punya dashboard keren ala futuristik, tapi saat dicolok ke Arduino atau ESP32, layarnya cuma putih nge-blank?
Atau yang lebih horor: muncul asap tipis dari arah regulator?

Tenang, Anda tidak sendirian.

Menggunakan layar TFT (Thin-Film Transistor) ukuran 4 inch—terutama yang berbasis driver ILI9486, ILI9488, atau ST7796—memang punya tingkat kesulitan satu level di atas layar OLED 0.96 inch yang mungil itu.
Ukurannya besar, jumlah piksel banyak, dan kebutuhan dayanya tidak bisa disepelekan.

Di artikel ini, kita akan membedah kesalahan paling umum saat memakai TFT 4 inch, lengkap dengan penjelasan teknis dan cara memperbaikinya secara realistis, bukan sekadar “coba ganti library”.

1. Masalah Power: Mengandalkan Pin 5V dari Board

❌ Ini kesalahan nomor satu. Paling sering. Paling mematikan.

Layar TFT 4 inch memiliki backlight besar yang mengonsumsi arus jauh lebih tinggi dibanding TFT 2.4 inch.

Gejala:

Layar berkedip (flicker) saat tampilan cerah
Mikrokontroler restart sendiri (brownout)
Gambar pudar atau muncul garis

Penjelasan Teknis:

Backlight TFT 4 inch bisa menarik 150–300 mA hanya untuk lampu latarnya.
Jika Anda mengambil daya dari pin 5V Arduino Nano / ESP32 yang bersumber dari USB laptop, regulator onboard akan kepanasan.

Saat tegangan drop:

Komunikasi SPI / paralel jadi tidak stabil
Data ke layar korup
Sistem reset sendiri

Cara Benerinnya:

✔ Gunakan sumber daya eksternal 5V (minimal 1A)
✔ Pisahkan VCC layar dari VCC mikrokontroler
✔ GND wajib common ground
✔ Kendalikan backlight via PWM + transistor (misal 2N2222)
→ lebih adem, lebih awet, bisa atur brightness

2. Salah Level Logika (3.3V vs 5V)

⚠️ Banyak modul TFT mati perlahan gara-gara ini.

Gejala:

Layar putih total (White Screen of Death)
IC driver panas tidak normal
Awalnya hidup, lalu mati permanen

Penjelasan Teknis:

Sebagian besar IC TFT modern (ILI9488, ST7796) berjalan di level logika 3.3V.
Jika pin CS, DC, RST, MOSI diberi 5V langsung dari Arduino Uno/Mega, gerbang logika IC akan rusak.

Masalahnya:

Banyak modul TFT murah tidak punya level shifter, meskipun bentuknya “shield”.

Cara Benerinnya:

✔ Gunakan Logic Level Shifter 8-channel
✔ Alternatif darurat: resistor divider (1k–2k)
✔ Cara paling waras: pakai ESP32 / STM32 (native 3.3V)

3. Salah Identifikasi Controller TFT

❌ Label toko sering menipu.

Gejala:

Layar putih
Warna kacau
Gambar mirror / terbalik

Penjelasan Teknis:

Fisik TFT bisa sama, tapi:

ILI9486 → 8-bit paralel
ILI9488 → SPI
ST7796 → SPI / paralel

Kalau driver di library tidak cocok, kalibrasi atau wiring sebagus apa pun tidak akan nolong.

Cara Benerinnya:

✔ Cek tulisan di PCB belakang
✔ Baca ID controller via sketch
✔ Jangan samakan setup ILI9341 dengan ILI9488

📌 Kalibrasi tidak berguna kalau driver salah.

4. Salah Pilih Driver di Library (Driver Jungle)

Banyak yang pakai library tapi lupa satu hal penting: setup-nya manual.

Gejala:

Layar tetap putih
Warna tertukar (biru jadi merah)
Tampilan mirror

Solusi Teknis:

✔ Gunakan TFT_eSPI (sangat direkomendasikan untuk ESP32)
✔ Edit User_Setup.h, jangan copy-paste
✔ Pastikan hanya satu driver yang di-enable

Contoh:


#define ILI9488_DRIVER

5. Kecepatan SPI Terlalu Tinggi

TFT 4 inch = 153.600 piksel (320×480).
Data besar = sinyal sensitif.

Gejala:

Gambar setengah lalu freeze
Noise / bintik acak
Touch tidak responsif saat refresh

Penjelasan Teknis:

SPI 80 MHz memang cepat, tapi:

Kabel jumper panjang
PCB murah
Ground jelek

→ sinyal terdistorsi sebelum sampai IC

Cara Benerinnya:

✔ Mulai dari 20–27 MHz, naikkan pelan
✔ Pendekkan kabel
✔ Hindari breadboard
✔ Solder langsung jika proyek permanen

6. Mengabaikan RAM Mikrokontroler

Ini jebakan klasik buat yang suka animasi.

Gejala:

Program crash
Out of memory
Refresh lambat

Penjelasan Teknis:

Arduino Uno cuma punya 2 KB RAM.
Satu buffer layar saja sudah bikin ngos-ngosan.

Cara Benerinnya:

✔ Gunakan ESP32 + DMA
✔ Aktifkan sprite hanya seperlunya
✔ Simpan gambar di Flash (PROGMEM)
✔ Hindari JPG, pakai BMP mentah

7. Masalah Kalibrasi Touchscreen

Banyak yang nyerah di sini, padahal solusinya jelas.

Gejala:

Titik sentuh melenceng
Sentuhan kebalik
Tidak akurat di pinggir

Cara Benerinnya:

✔ Jalankan Touch_Calibrate
✔ Catat nilai X/Y
✔ Simpan manual di kode
✔ Kalibrasi setelah rotasi layar benar

8. Kabel Terlalu Panjang & Layout Berantakan

TFT tidak ramah kabel panjang.

Dampak:

Flicker
Touch loncat
Data korup

Solusi:

✔ Kabel sependek mungkin
✔ Jalur data sejajar & rapi
✔ Pisahkan jalur power & data

Kesimpulan

Memakai TFT 4 inch memang memuaskan secara visual, tapi menuntut ketelitian lebih.

Kunci suksesnya cuma tiga:
1️⃣ Daya yang cukup
2️⃣ Level logika yang benar
3️⃣ Konfigurasi library yang tepat

Urutan aman:

Controller → Power → Wiring → Orientasi → Baru Kalibrasi

Jangan langsung menyalahkan modul.
Sering kali masalahnya cuma satu baris di User_Setup.h atau satu kabel terlalu panjang.

Arduino Nano Reset Sendiri Saat Relay Aktif? Ini Penyebab Teknis dan Solusi Paling Aman

2026-01-29T22:53:00.005+07:00

Masalah yang Sering Dialami Pengguna Arduino Nano

Salah satu masalah paling sering dialami pengguna Arduino Nano adalah board tiba-tiba reset atau restart sendiri saat relay aktif.
Masalah ini sering bikin bingung karena:

Program sudah benar
Kode sederhana
Tidak ada error di Arduino IDE
Tapi setiap relay ON → Arduino restart

Gejala yang umum terjadi di lapangan antara lain:

Program mengulang dari awal
LCD 16x2 mati sesaat lalu hidup lagi
Relay hanya aktif sebentar
Serial Monitor kembali ke baris awal
Arduino terasa hangat atau panas

Banyak pemula mengira ini bug sketch atau delay yang salah, padahal 99% kasus disebabkan oleh masalah kelistrikan, bukan software.

Kenapa Relay Bisa Membuat Arduino Nano Reset?

Relay bukan sekadar saklar biasa. Relay adalah beban induktif yang bisa menimbulkan gangguan serius jika sistem catu daya tidak dirancang dengan benar.

Berikut penyebab teknis yang paling sering terjadi.

Penyebab Arduino Nano Reset Saat Relay Aktif

1. Tegangan Drop Saat Relay Menyala

Relay membutuhkan arus cukup besar pada saat pertama kali aktif (inrush current).
Jika Arduino dan relay menggunakan supply yang sama, maka saat relay ON:

Tegangan 5V bisa turun sesaat
Regulator Arduino tidak mampu mempertahankan tegangan
Mikrokontroler langsung reset

Masalah ini sering muncul pada kondisi:

Menggunakan adaptor murah
Supply USB laptop
Powerbank
Mengambil 5V relay langsung dari pin Arduino

Drop tegangan sesaat saja sudah cukup membuat ATmega328P restart.

2. Noise dan Lonjakan Tegangan dari Coil Relay

Relay memiliki coil induktif.
Saat relay OFF, terjadi lonjakan tegangan balik (back EMF) yang bisa merambat ke jalur VCC dan GND.

Jika:

Tidak ada diode flyback
Modul relay tidak punya proteksi
Jalur kabel panjang

Maka noise ini bisa:

Mengganggu kerja mikrokontroler
Membuat logika reset aktif
Menyebabkan sistem tidak stabil

3. Regulator Onboard Arduino Nano Tidak Kuat

Regulator bawaan Arduino Nano sangat kecil dan tidak didesain untuk beban berat.

Masalah makin parah jika:

Input 9V–12V
Arduino menyalakan relay
Ditambah LCD, sensor, atau modul lain

Regulator akan:

Panas
Drop tegangan
Memicu reset otomatis

Terutama pada Arduino Nano versi clone, kualitas regulator sering lebih buruk.

4. Ground Tidak Disatukan dengan Benar

Kesalahan wiring klasik yang sering diremehkan:

Ground relay terpisah dari ground Arduino
Jalur GND terlalu panjang
Ground bercabang tanpa titik referensi yang jelas

Akibatnya:

Referensi logika kacau
Arduino membaca noise sebagai sinyal reset
Sistem jadi tidak konsisten

5. Modul Relay Murahan Tanpa Isolasi

Beberapa modul relay murah:

Tidak punya optocoupler
Diode flyback abal-abal
Layout PCB jelek

Modul seperti ini sangat mudah menyuntikkan noise ke Arduino.

Solusi Arduino Nano Reset Saat Relay Aktif (Terbukti di Lapangan)

✅ 1. Pisahkan Supply Arduino dan Relay

Solusi paling aman:

Arduino disupply 5V stabil
Relay menggunakan supply terpisah

Jika hanya ada satu adaptor:

Gunakan modul step-down (buck converter) untuk Arduino

Jangan pernah:

Mengambil daya relay dari pin 5V Arduino

✅ 2. Gunakan Regulator Eksternal (LM2596)

LM2596 jauh lebih kuat dibanding regulator onboard Arduino.

Konfigurasi aman:

Input: 7–24V
Output: 5V stabil
Arus besar
Tidak cepat panas

Arduino jadi:

Lebih dingin
Lebih stabil
Tidak mudah reset

✅ 3. Tambahkan Kapasitor Filter

Pasang kapasitor:

Elco 470µF – 1000µF di jalur 5V Arduino
Kapasitor keramik 100nF dekat pin VCC

Fungsi:

Menahan drop tegangan sesaat
Meredam noise dari relay

Ini solusi murah tapi sangat efektif.

✅ 4. Gunakan Modul Relay dengan Optocoupler

Pastikan modul relay:

Memiliki optocoupler
Sudah ada diode flyback
Input jelas (LOW atau HIGH trigger)

Optocoupler membantu:

Memisahkan noise relay
Melindungi Arduino

✅ 5. Rapikan Jalur Ground (Common Ground)

Aturan dasar:

Semua GND disatukan
Gunakan kabel pendek dan tebal
Pisahkan jalur arus besar dan sinyal

Idealnya gunakan star ground.

✅ 6. Hindari Supply USB untuk Sistem dengan Relay

USB laptop:

Arus terbatas
Mudah drop
Tidak stabil untuk relay

Gunakan adaptor DC yang layak.

Alat dan Komponen yang Direkomendasikan

Arduino Nano
Modul relay optocoupler
Modul step-down LM2596
Elco 470µF / 1000µF
Kapasitor keramik 100nF
Adaptor DC 9V–12V
Multimeter

Komponen ini murah, tapi menentukan kestabilan sistem.

Kesimpulan

Arduino Nano reset sendiri saat relay aktif bukan disebabkan oleh kesalahan program, melainkan oleh:

Tegangan drop
Noise dari relay
Regulator onboard yang tidak kuat
Wiring ground yang salah

Dengan:

Supply yang benar
Regulator eksternal
Proteksi relay
Ground yang rapi

Masalah ini bisa dihilangkan 100% dan sistem akan jauh lebih awet serta stabil.

Download HP ZBook 17 G5 DA0XW3MBAG0 REV G Boardview (BDV) File (.CAD)

2026-01-29T18:23:00.001+07:00

If you are working on motherboard-level laptop repair, having access to the correct boardview file can save hours of troubleshooting. In this article, we will discuss how to download and use the HP ZBook 17 G5 DA0XW3MBAG0 REV G Boardview (BDV) file in .CAD format, and why this file is essential for professional diagnostics.

Whether you are an electronics technician, laptop repair engineer, or advanced hobbyist, this guide will help you understand the value of boardview files and how to use them effectively.

What Is a Boardview (BDV) File?

A boardview file is a digital representation of a motherboard that shows the physical layout of components, signal names, net connections, and test points. Unlike schematics, boardview files allow you to visually locate components directly on the board.

Key benefits of using a boardview file:

Identify component locations quickly
Trace signal paths and power rails
Locate missing or damaged components
Speed up motherboard troubleshooting

Boardview files are especially useful when schematics are incomplete or unavailable.

About HP ZBook 17 G5 Motherboard DA0XW3MBAG0 REV G

The HP ZBook 17 G5 is a high-performance mobile workstation designed for professional workloads such as engineering, 3D modeling, and video production. Due to its complex motherboard design, board-level repairs require accurate technical reference files.

The motherboard code DA0XW3MBAG0 REV G identifies a specific board revision. Using the wrong boardview revision can lead to incorrect measurements or misidentified components, so it is important to match the exact model and revision.

Why You Need the HP ZBook 17 G5 Boardview File

When repairing modern laptops like the HP ZBook series, visual references are critical. The DA0XW3MBAG0 REV G boardview file helps you:

Locate power coils, MOSFETs, and regulators
Identify CPU, GPU, and RAM signal paths
Find BIOS, EC, and charging circuit components
Diagnose short circuits and missing voltages

For technicians working without this file, troubleshooting often becomes trial-and-error, which increases repair time and risk.

File Format: Boardview (.CAD)

The boardview file for HP ZBook 17 G5 is typically provided in .CAD format, which is supported by popular boardview software tools such as:

OpenBoardView
FlexBV
BoardView Viewer

These tools allow you to load the file, search for net names, and click directly on components to see their connections.

👉Klik di sini untuk download

How to Download HP ZBook 17 G5 DA0XW3MBAG0 REV G Boardview

You can download the HP ZBook 17 G5 DA0XW3MBAG0 REV G Boardview (BDV) (.CAD) file from trusted technical resource websites or repair communities that share verified boardview files.

Before downloading, always ensure:

The file matches DA0XW3MBAG0
The revision is REV G
The format is .CAD
The source is reliable and malware-free

Avoid suspicious download sites that bundle unnecessary installers or password-protected archives.

How to Open and Use the Boardview File

After downloading the boardview file, follow these steps:

Install a compatible boardview viewer (e.g., OpenBoardView)
Open the software and load the .CAD file
Use the search function to find net names (VIN, VCORE, +3VALW, etc.)
Click components to view pin connections and signals
Cross-check measurements on the physical motherboard

This workflow significantly improves repair accuracy.

Boardview vs Schematic: What’s the Difference?

While schematics show circuit logic, boardview files focus on physical placement.

Feature	Boardview	Schematic
Component location	Yes	No
Signal names	Yes	Yes
Circuit logic	Limited	Full
Repair speed	Very fast	Medium

For best results, technicians often use both files together.

Common Repair Scenarios Using This Boardview

The HP ZBook 17 G5 boardview is especially useful for:

No power or no charging issues
Short circuit troubleshooting
BIOS and EC diagnostics
GPU or CPU power rail analysis
Post-liquid-damage repairs

Having the correct boardview file reduces guesswork and improves success rates.

Tips for Safe and Effective Use

Always verify board revision before probing
Use a current-limited power supply when diagnosing shorts
Label test points during complex repairs
Keep backup copies of your boardview files

These habits help avoid accidental damage during board-level work.

Legal and Ethical Notice

Boardview files are intended for educational and repair purposes only. Always respect intellectual property rights and local regulations when using technical files.

Conclusion

The HP ZBook 17 G5 DA0XW3MBAG0 REV G Boardview (BDV) (.CAD) file is an essential resource for anyone performing motherboard-level repairs on this workstation. With the correct boardview, diagnostics become faster, more accurate, and far less frustrating.

If you regularly work on professional laptops, keeping an organized library of boardview files like this one is a smart investment in your repair workflow.

Espressif IDE Download Guide (Official ESP-IDF IDE for Windows, macOS, and Linux)

2026-01-29T17:44:00.003+07:00

Introduction

Espressif IDE, officially known as the ESP-IDF IDE, is the recommended development environment provided by Espressif Systems for building applications on ESP32, ESP32-S, ESP32-C, and ESP8266 series microcontrollers. This IDE is built on top of Eclipse and tightly integrated with ESP-IDF (Espressif IoT Development Framework), making it the most stable and feature-complete option for professional ESP development.

This article provides a complete, step-by-step guide to downloading, installing, and configuring Espressif IDE on Windows, macOS, and Linux. It is written for beginners and intermediate developers who want a reliable setup for ESP32 development. By the end of this guide, you will have a fully working Espressif IDE environment and understand how each component works.

What Is Espressif IDE?

Espressif IDE is an official integrated development environment designed specifically for ESP-IDF. Unlike Arduino IDE, which abstracts many low-level details, Espressif IDE gives developers full access to:

Native ESP-IDF APIs
FreeRTOS-based multitasking
Advanced debugging features
Serial monitor and logging tools
Menuconfig system for firmware configuration

The IDE is based on Eclipse CDT and comes bundled with tools such as:

ESP-IDF framework
Cross-compilers (Xtensa and RISC-V)
CMake and Ninja build system
Python environment and IDF tools

This makes Espressif IDE ideal for production-level projects and complex embedded systems.

Supported Operating Systems

Espressif IDE officially supports the following platforms:

Windows 10 and Windows 11 (64-bit)
macOS (Intel and Apple Silicon)
Linux (Ubuntu, Debian, Fedora, Arch, and similar distributions)

Each operating system has a slightly different installation process, which will be explained in detail below.

System Requirements

Before downloading Espressif IDE, ensure your system meets the minimum requirements:

Hardware Requirements

8 GB RAM (minimum 4 GB)
At least 10 GB of free disk space
Internet connection for toolchain downloads

Software Requirements

Administrator access (Windows/macOS)
Terminal or command-line access
USB driver support for ESP boards

Downloading Espressif IDE (Official Source)

Step 1: Visit the Official Espressif Website

Always download Espressif IDE from the official Espressif website to avoid corrupted or outdated installers.

Look for the ESP-IDF IDE section and select the installer that matches your operating system.

You can download the official Espressif IDE directly from the official Espressif Systems website, which provides the latest and most stable ESP-IDF IDE releases for all supported operating systems.

Step 2: Choose the Correct Installer

Espressif provides separate installers for:

Windows (.exe installer)
macOS (.dmg package)
Linux (.tar.gz archive)

Download the latest stable version for best compatibility and bug fixes.

Installing Espressif IDE on Windows

Step 1: Run the Installer

Double-click the downloaded .exe file.
Allow the installer to make changes to your system.
Choose the installation directory (default is recommended).

Step 2: Select Components

During installation, make sure the following components are selected:

ESP-IDF Framework
ESP Toolchain
Python Environment
OpenOCD (for debugging)

These components are required for a complete development setup.

Step 3: Install USB Drivers

If prompted, install the USB drivers for ESP32 and ESP8266 boards. This ensures your board is detected correctly by Windows.

Step 4: Finish Installation

Once installation is complete:

Launch Espressif IDE
Allow the IDE to complete initial setup
Wait for background tool configuration to finish

This process may take several minutes on first launch.

Installing Espressif IDE on macOS

Step 1: Open the DMG File

Double-click the downloaded .dmg file.
Drag Espressif IDE into the Applications folder.

Step 2: Grant Permissions

macOS may block the app on first launch:

Open System Settings
Go to Privacy & Security
Allow Espressif IDE to run

Step 3: First Launch Setup

When you open Espressif IDE for the first time:

The IDE will download ESP-IDF tools
Python environment will be configured automatically
Toolchains for ESP32 and RISC-V will be installed

Ensure your internet connection is stable during this process.

Installing Espressif IDE on Linux

Step 1: Extract the Archive

Open a terminal
Navigate to the download directory
Extract the archive using:

tar -xvf esp-idf-ide-linux.tar.gz

Step 2: Run the IDE

Navigate to the extracted folder and run:

./esp-idf-ide

Step 3: Install Dependencies

Depending on your distribution, you may need to install additional packages such as:

libusb
python3
gcc
cmake

Most modern Linux distributions already include these dependencies.

Setting Up ESP-IDF Inside Espressif IDE

Step 1: Select ESP-IDF Version

On first launch, the IDE will ask you to select an ESP-IDF version. It is recommended to use the latest stable release.

Step 2: Configure Tools Path

Espressif IDE automatically manages tool paths, but you can verify them under:

Window → Preferences → ESP-IDF

Ensure all tools show a valid status.

Creating Your First ESP-IDF Project

Step 1: Create a New Project

Click File → New → ESP-IDF Project
Choose a project template (e.g., Hello World)
Select target chip (ESP32, ESP32-S3, etc.)

Step 2: Build the Project

Click the Build button or run:

idf.py build

Step 3: Flash to Board

Connect your ESP board via USB and run:

idf.py flash

Step 4: Monitor Output

Use the serial monitor to view logs:

idf.py monitor

Common Installation Issues and Solutions

Python Not Found

Ensure the bundled Python environment is selected in IDE settings.

USB Port Not Detected

Install correct USB drivers and check cable quality.

Build Errors

Run toolchain update and clean the project:

idf.py fullclean

Espressif IDE vs Arduino IDE

Feature	Espressif IDE	Arduino IDE
Official Support	Yes	Partial
FreeRTOS Access	Full	Limited
Debugging	Advanced	Basic
Learning Curve	Steep	Easy

Espressif IDE is recommended for serious and scalable projects.

Best Practices for ESP-IDF Development

Use version control (Git)
Keep ESP-IDF updated
Read official documentation
Modularize your code

Advanced ESP-IDF Development Best Practices

Once you are comfortable building and flashing basic ESP-IDF projects, the next step is adopting professional development practices. These practices help ensure your firmware remains stable, scalable, and maintainable as your project grows.

Using Version Control with ESP-IDF Projects

Every serious ESP-IDF project should use a version control system such as Git. ESP-IDF projects naturally fit well with Git because the framework clearly separates source files from build artifacts.

Recommended Git workflow:

Initialize Git in the project root directory
Commit only source files (main/, components/, CMakeLists.txt)
Ignore generated folders such as build/, .vscode/, and temporary tool files
Use branches for experimental features

This approach allows you to safely experiment without breaking your main firmware.

Locking ESP-IDF Versions per Project

ESP-IDF evolves quickly. While updates bring improvements, they can also introduce breaking changes.

Best practice:

Select a stable ESP-IDF release
Keep that version fixed for the entire project lifecycle
Upgrade only after thorough testing

Professional teams often maintain different projects on different ESP-IDF versions for stability reasons.

Modular Code Architecture

Avoid writing all logic inside main.c. Instead, structure your firmware into reusable components.

Example component structure:

components/wifi_manager
components/display_driver
components/storage_manager
components/input_handler

This modular approach makes debugging easier and allows components to be reused across multiple projects.

Understanding ESP-IDF Project Structure in Depth

A standard ESP-IDF project follows a predictable and powerful directory layout. Understanding this structure is essential for advanced customization and troubleshooting.

Root Directory Files

Key files in the project root include:

CMakeLists.txt – Defines project-level build rules
sdkconfig – Stores configuration options generated by menuconfig
sdkconfig.defaults – Optional default configuration values

The sdkconfig file should never be edited manually. Always use menuconfig to modify system settings.

The `main` Directory Explained

The main directory contains the application entry point, usually a file called main.c.

Important details:

The app_main() function replaces the traditional main() function
app_main() runs as a FreeRTOS task
Blocking delays should use FreeRTOS APIs, not busy loops

Understanding this execution model is crucial for real-time applications.

ESP-IDF Components System

Components are the backbone of ESP-IDF’s modular design. Each component includes:

Header files
Source files
A CMakeLists.txt file

Components can depend on other components, allowing clean separation of responsibilities while maintaining flexibility.

Deep Dive: ESP-IDF Build System (CMake and Ninja)

ESP-IDF uses CMake for configuration and Ninja for fast builds. While beginners rarely need to touch CMake, understanding it helps solve complex build errors.

How ESP-IDF Uses CMake

CMake determines:

Which source files are compiled
Include directories
Compiler flags
Component dependencies

Each component must call idf_component_register() to be included in the build process.

Common CMake Pitfalls

Frequent mistakes include:

Forgetting to declare header directories
Incorrect component dependency order
Editing generated build files

Always modify only source CMakeLists.txt files, never files inside the build/ directory.

Advanced Installation Notes (Windows, macOS, Linux)

Windows Path Length Limitations

Windows has a path length limitation that can cause cryptic build errors.

To avoid issues:

Install Espressif IDE in a short directory (for example C:\Espressif)
Avoid deeply nested project folders
Keep workspace paths short

These steps prevent many unexplained compilation failures.

macOS Security and Gatekeeper

macOS may block Espressif IDE because it is not distributed through the App Store.

If blocked:

Open System Settings → Privacy & Security
Allow the application manually
Restart the IDE

This behavior is normal for developer tools.

Linux USB Permission Configuration

On Linux, ESP boards may not be detected due to permission restrictions.

Best practice:

Create udev rules for USB serial devices
Add your user to the dialout group
Reboot after changes

This allows flashing and monitoring without root privileges.

Debugging ESP32 with Espressif IDE

One of the most powerful features of Espressif IDE is integrated debugging support.

OpenOCD and JTAG Debugging

Espressif IDE includes OpenOCD, enabling:

Hardware breakpoints
Step-by-step code execution
Variable inspection
Stack trace analysis

This requires compatible ESP32 boards with JTAG support.

Typical Debugging Workflow

Build the firmware
Start a debug configuration
Set breakpoints
Flash and attach debugger
Inspect runtime behavior

This workflow dramatically reduces development time for complex applications.

Logging, Monitoring, and Diagnostics

ESP-IDF provides a flexible logging system that supports multiple verbosity levels.

ESP-IDF Log Levels

Available log levels include:

ERROR
WARN
INFO
DEBUG
VERBOSE

Use lower log levels in production firmware to reduce performance overhead.

Serial Monitor Best Practices

For reliable monitoring:

Ensure the correct baud rate
Close other serial applications
Filter logs when debugging complex systems

Effective logging is essential for diagnosing real-world issues.

Performance Optimization Techniques in ESP-IDF

Optimizing performance is critical for embedded systems with limited resources.

Key optimization strategies:

Minimize dynamic memory allocation
Monitor heap and stack usage
Optimize FreeRTOS task priorities
Avoid blocking delays
Use DMA for data-intensive operations

Profiling and optimization should be done iteratively during development.

Memory Management and FreeRTOS Considerations

ESP-IDF applications rely heavily on FreeRTOS. Poor task design can lead to instability.

Best practices:

Assign appropriate stack sizes to tasks
Avoid unnecessary task creation
Monitor stack usage during runtime
Use queues and semaphores correctly

Proper FreeRTOS design improves reliability and responsiveness.

Security Features in ESP-IDF

ESP-IDF includes enterprise-grade security features suitable for commercial products.

Key Security Capabilities

Secure boot
Flash encryption
TLS and HTTPS support
Hardware-based random number generation

These features protect firmware integrity and user data.

When to Enable Security

Security features should be enabled early in development, not as an afterthought. Retrofitting security into finished firmware is significantly harder.

ESP-IDF vs Arduino IDE vs PlatformIO (In-Depth Comparison)

ESP-IDF

Official framework
Maximum hardware control
Best performance
Steeper learning curve

Arduino IDE

Very beginner-friendly
Fast prototyping
Limited access to low-level features

PlatformIO

Supports multiple frameworks
Powerful project management
Requires additional configuration

For production-grade ESP32 applications, ESP-IDF with Espressif IDE remains the most robust solution.

Long-Term Maintenance and Firmware Updates

Maintaining ESP32 firmware after deployment requires careful planning.

Recommended practices:

Use OTA update mechanisms
Maintain backward compatibility
Log firmware version information
Test updates extensively before release

These practices ensure smooth updates and reduce field failures.

Scaling ESP-IDF Projects for Commercial Use

When projects grow from prototypes into products, scalability becomes critical.

Important considerations:

Code modularity
Documentation
Automated builds
Continuous integration

ESP-IDF supports professional workflows suitable for commercial and industrial applications.

SEO FAQ Section

Is Espressif IDE free?

Yes, Espressif IDE is completely free and open-source.

Can I use Espressif IDE for ESP8266?

Yes, but ESP32 is more actively supported.

Which OS is best for ESP-IDF?

Linux and macOS offer the most stable experience, but Windows works well.

Conclusion

Espressif IDE is the official and most powerful development environment for ESP32 and ESP-IDF projects. With proper installation and configuration, it provides a professional-grade workflow suitable for both beginners and advanced developers.

By following this step-by-step Espressif IDE download and installation guide, you can confidently start building reliable and scalable ESP-based applications on Windows, macOS, or Linux.

🔎 Read also:

How to Fix LVGL Font Errors in ESP32-S3 Projects SquareLine Studio Export Guide with ESP-IDF (LVGL v8.3.11)

How to Fix LVGL Font Errors in ESP32-S3 Projects SquareLine Studio Export Guide with ESP-IDF (LVGL v8.3.11)

2026-01-28T09:29:00.000+07:00

Introduction: The “Undeclared Font” Nightmare

In embedded GUI development, the combination of ESP32-S3, LVGL, and SquareLine Studio has become a practical industry standard. This toolchain enables developers to build smartphone-like user interfaces for industrial controllers, IoT dashboards, and smart appliances such as a Smart Laundry Controller.

However, many developers encounter a critical roadblock during compilation.

You design a clean screen, select a large bold font—such as Montserrat 46 for displaying prices—export the UI from SquareLine Studio, press Build, and suddenly face this fatal error:


error: 'lv_font_montserrat_46' undeclared (first use in this function)

The font clearly exists in SquareLine Studio, so why does the compiler fail?

The answer lies in the interaction between LVGL’s modular design, ESP-IDF’s component-based build system, and how LVGL configuration headers are resolved at compile time.
This article explains the root cause and provides a reliable, production-ready solution.

1. Core Concepts: Why This Error Occurs

The Modular Nature of LVGL

LVGL is designed to be lightweight and memory-efficient. To minimize Flash and RAM usage, every font size is conditionally compiled using C preprocessor macros.

By default, LVGL enables only a small set of fonts (typically Montserrat 14).

When SquareLine Studio generates code such as:


lv_obj_set_style_text_font(ui_Label, &lv_font_montserrat_46, 0);

it assumes that the corresponding font has already been enabled inside lv_conf.h.

If the font macro is disabled, the symbol lv_font_montserrat_46 is never compiled, resulting in an “undeclared” error.

The ESP-IDF Component System

ESP-IDF treats every directory inside components/ as an independent module.
Each component must explicitly declare:

Source files
Include paths
Dependencies

If LVGL, the UI component, or lv_conf.h are placed incorrectly, ESP-IDF may compile LVGL without your configuration, even if you edited the correct file.

2. The Perfect Folder Structure (ESP-IDF v5.x Standard)


smart_project/
├── CMakeLists.txt
├── main/
│   ├── CMakeLists.txt
│   └── main.c
├── components/
│   ├── lvgl/
│   │   ├── src/
│   │   ├── env_support/
│   │   └── CMakeLists.txt
│   ├── ui/
│   │   ├── components/
│   │   ├── fonts/
│   │   ├── images/
│   │   ├── screens/
│   │   ├── ui.c
│   │   ├── ui.h
│   │   └── CMakeLists.txt
│   └── lv_conf.h
└── build/

Why This Structure Matters

Single global lv_conf.h
Placing it under components/ ensures it is visible to both LVGL and SquareLine-generated UI code.
Separated UI component
Makes LVGL upgrades safe and avoids mixing library code with generated UI logic.

3. CMakeLists.txt Configuration (Mandatory)

A. Root CMakeLists.txt


cmake_minimum_required(VERSION 3.16)
include($ENV{IDF_PATH}/tools/cmake/project.cmake)
project(smart_laundry)

B. LVGL Component CMakeLists.txt


set(LVGL_ROOT_DIR ${CMAKE_CURRENT_LIST_DIR})

if(ESP_PLATFORM)
    include(${CMAKE_CURRENT_LIST_DIR}/env_support/cmake/esp.cmake)
endif()

C. UI Component CMakeLists.txt


file(GLOB_RECURSE SOURCES *.c)

idf_component_register(
    SRCS ${SOURCES}
    INCLUDE_DIRS .
    PRIV_REQUIRES lvgl
)

4. Choosing the Correct LVGL Version (Critical for SquareLine)

Why LVGL v8.3.11 Is Recommended

SquareLine Studio (current stable releases) is designed around LVGL 8.x, and v8.3.11 is the most stable and widely tested version for ESP32-S3.

Benefits:

Fully compatible with SquareLine exports
Stable font subsystem
Mature ESP-IDF integration
No breaking API changes

⚠ Using LVGL 9.x will cause font symbols, styles, and APIs to break unless SquareLine explicitly supports it.

Recommendation:
✔ Lock LVGL to v8.3.11
✔ Match SquareLine project LVGL version exactly

5. Mastering `lv_conf.h`: Enabling Fonts Correctly

Step 1: Enable the Configuration File


#if 1 /* Set this to "1" to enable content */

If this is set to 0, LVGL ignores everything below it.

Step 2: Enable Required Built-In Fonts


#define LV_FONT_MONTSERRAT_12 1
#define LV_FONT_MONTSERRAT_14 1
#define LV_FONT_MONTSERRAT_24 1
#define LV_FONT_MONTSERRAT_44 1
#define LV_FONT_MONTSERRAT_46 1
#define LV_FONT_MONTSERRAT_48 1

LVGL will now compile the corresponding font data and expose the symbols.

Step 3: Custom Fonts Exported by SquareLine

If SquareLine exports fonts into components/ui/fonts/:

Ensure .c files exist
Ensure they are included by file(GLOB_RECURSE *.c)
No additional #define is required

6. Ensuring UI Sees the Correct Configuration

Force the configuration include in ui.h:


#define LV_CONF_INCLUDE_SIMPLE 1
#include "lv_conf.h"
#include "lvgl.h"

This guarantees consistent font availability across all UI files.

7. The Build Cache Trap (Why Errors Persist)

ESP-IDF uses Ninja, which aggressively caches results.

Font macro changes often do not trigger recompilation automatically.

Always Run:


idf.py fullclean
idf.py build

Or delete the build/ directory manually.

8. Conclusion: From Font Errors to a Working UI

To successfully use large fonts in SquareLine-generated LVGL projects:

Use LVGL v8.3.11
Place lv_conf.h correctly
Enable fonts explicitly
Configure CMake properly
Always fullclean after font changes

Once these steps are followed, SquareLine Studio exports compile cleanly and run reliably on ESP32-S3.

Next Steps

Verify your display driver (RGB LCD, ST7789, ILI9341)
Match SquareLine resolution with hardware
Implement ui_event callbacks to control real laundry hardware

www.carapaklek.com

Sensor Arus SCT-013-030: Prinsip Kerja, Rangkaian, ADC ESP32, dan Pengujian

Daftar Isi

1. Apa Itu SCT-013?

2. SCT-013-030 yang Digunakan

3. Prinsip Kerja Current Transformer

4. Output Sensor SCT-013-030

5. Mengapa Output Sensor Tidak Bisa Langsung ke ADC?

6. Rangkaian Bias untuk ADC ESP32

Pembagi tegangan

7. Burden Resistor pada SCT-013

8. Menggunakan Jack Audio 3,5 mm

9. Rangkaian Dasar SCT-013 ke ESP32

10. Pengujian Menggunakan Beban AC

11. Hasil Pembacaan ADC

12. Mengapa Nilai ADC Belum Menunjukkan Ampere?

13. Perhitungan RMS

14. Kalibrasi Menggunakan Tang Ampere

15. Tahapan Pengembangan Rangkaian

Tahap 1 — Pastikan sensor menghasilkan sinyal

Tahap 2 — Pastikan bias ADC benar

Tahap 3 — Hubungkan ke ADC

Tahap 4 — Buat program sampling

Tahap 5 — Hitung RMS

Tahap 6 — Kalibrasi

Tahap 7 — Uji beberapa beban

16. Kesimpulan

CASING RELAY 8CH LOW/HIGH LEVEL TRIGGER Versi lengkap: 3D Viewer + Artikel + Premium STL

Jelajahi Casing Relay 8CH Secara 3D

Casing Relay 8CH Low/High Level Trigger – Desain Enclosure 3D Printable

Tentang Desain Casing Relay 8CH

Desain Bagian Bawah Casing

Dudukan PCB Relay

Desain Cover Atas

Detail Lips dan Penyatuan Casing

Lubang Screw dan Pengikat Casing

Jalur Kabel dan Akses Terminal

Modul Relay Terpasang di Dalam Casing

Hasil Akhir Casing Relay 8CH

Tampilan Casing dari Berbagai Sisi

Spesifikasi Desain

Informasi File Premium

Download File STL Casing Relay 8CH

Dapatkan File STL Casing

Ingin Casing yang Sudah Jadi?

Bagaimana File STL Didapatkan?

Artikel Terkait

Cara Menyalakan Pompa Air Menggunakan HP Android (Lengkap dengan Wiring Kontaktor & Blynk)

Table of Contents

1. Pendahuluan: Kenapa Perlu Otomasi Pompa Air?

2. Keuntungan Sistem Otomasi Berbasis Kontaktor

Kelebihan Menggunakan Tambahan Kontaktor AC:

3. Daftar Komponen & Peralatan yang Dibutuhkan

4. Prinsip Kerja Rangkaian

5. Panduan Wiring Rangkaian (ESP32 + Kontaktor + Pompa)

A. Rangkaian Kontrol (Pemicu Koil Kontaktor)

B. Rangkaian Daya (Output ke Pompa Air)

6. Langkah Konfigurasi Aplikasi Blynk di HP Android

Langkah-langkah Setting Blynk:

7. Prosedur Pengujian dan Tip Keamanan Listrik

Tip Keamanan Penting:

8. Kesimpulan

Mengatasi RFID RC522 yang Error Setelah Relay Menyala dan Hanya Bisa Tap Sekali: Masalah yang Sering Saya Temui

📚 Table of Contents

1. Mengenal Gejala yang Sering Terjadi

2. Dugaan Penyebab yang Biasanya Muncul

1. Modul RC522 Rusak

2. Tegangan Supply Tidak Stabil

3. Gangguan dari Relay

4. Kesalahan Program

3. Pengujian Awal yang Saya Lakukan

Mengganti Modul RFID

Mengganti Relay

Mengganti Kabel dan Breadboard

Memantau Serial Monitor

4. Kenapa RC522 Terlihat Seperti Error?

5. Penyebab Sebenarnya yang Saya Temukan

6. Contoh Program yang Menyebabkan RFID Hanya Bisa Tap Sekali

7. Cara Memperbaikinya

Menggunakan Reset Boolean