Kenapa halaman ini penting

Halaman ini menjelaskan bagaimana Instalasi dan Setup Repo masuk ke model eksekusi ZeroKernel yang lebih besar, masalah apa yang sebenarnya diselesaikan, dan trade-off apa yang benar-benar Anda bayar saat fitur ini dipakai di firmware produksi. Tujuannya bukan melihat Instalasi dan Setup Repo sebagai satu API terpisah, tetapi memahami posisinya di dalam bounded scheduling, disiplin queue, visibilitas fault, dan pemilihan profile.

Baca topik ini sebagai kontrak operasional. Mulai dari jalur paling kecil yang benar-benar jalan, pasang dulu di profile lean, lalu baru naik ke routing, diagnostics, atau state transport yang lebih kaya setelah Anda bisa membuktikan hasil timing-nya tetap layak dibanding tambahan flash dan RAM. Pola pikir ini yang menjaga ZeroKernel tetap berguna di board kecil dan tidak berubah jadi abstraksi yang gemuk.

Pola paling aman selalu sama: tentukan batas runtime-nya, jaga hot path tetap pendek, ukur efeknya dengan compare script, lalu baru naikkan kompleksitas. Contoh di bawah bukan pemanis; itu adalah pola minimum yang bisa Anda ambil ke firmware nyata saat Anda butuh integrasi yang rapi, bukan loop manual yang sulit dipertahankan.

Tiga pola yang langsung bisa dipakai

Setup berbasis repo

Pakai ini saat Anda ingin source of truth lokal yang bersih dan kontrol update yang eksplisit.

    git clone git@github.com:ZeroBitsTech/ZeroKernel.git
cd ZeroKernel
bash scripts/run_desktop_tests.sh

Boot runtime paling minimum

Mulai dari satu task bounded dan clock board yang jelas sebelum menambah queue atau modul network.

    ZeroKernel.begin(boardMillis);
ZeroKernel.addTask("Sample", sampleTask, 100, 0, true);
ZeroKernel.tick();

Kunci profile di PlatformIO

Pasang profile di build flags agar drift footprint terjadi dengan sengaja, bukan tanpa sadar.

    [env:esp32]
platform = espressif32
board = esp32dev
framework = arduino
build_flags =
  -DZEROKERNEL_PROFILE_LEAN_NET

Apa yang perlu Anda cek saat memakainya

Validasi timing lebih dulu, baru bentuk API. API yang terlihat rapi bukan kemenangan kalau fast miss justru naik.
Pilih profile paling kecil yang masih cocok, lalu aktifkan modul opsional hanya saat payoff terukurnya benar-benar jelas.
Jaga callback dan langkah transport tetap bounded supaya watchdog, panic flow, dan batas queue tetap punya arti.

Kesalahan umum yang membuat hasil jadi menyesatkan

Jangan menyalin pola demo ke firmware produksi tanpa mengukurnya di board dan profile build yang benar-benar akan dipakai.
Jangan membaca angka sukses tanpa membaca queue depth, timing, dan label workload di sampingnya.
Jangan menyalakan diagnostics atau kompatibilitas berat di target lean hanya karena default-nya terasa nyaman.

Urutan kerja yang disarankan

Mulai dari jalur paling kecil yang valid

Boot runtime, daftar task minimum yang berguna, lalu buktikan baseline timing bersih sebelum menambah lapisan opsional.

Tambah satu lapisan, lalu ukur

Masukkan routing, diagnostics, atau transport satu lapisan demi satu agar biaya dan payoff-nya tetap jelas.

Publikasikan hanya hasil yang bisa diulang

Update docs, chart, atau klaim publik hanya setelah workload yang sama lolos jalur validasi yang sama lebih dari sekali.

Clone atau download repo

ZeroKernel dibagikan dari repository GitHub terlebih dulu. Dengan begitu contoh, script, manifest, dan docs tetap sinkron di revisi yang sama.

    git clone git@github.com:ZeroBitsTech/ZeroKernel.git
cd ZeroKernel

Layout Arduino IDE

Salin folder repo, atau isi release archive, ke direktori libraries milik sketchbook Anda.
Restart Arduino IDE agar index library diperbarui.
Buka salah satu contoh dulu, compile, lalu baru pindah ke firmware Anda sendiri.

Layout PlatformIO

Untuk PlatformIO, cara paling aman adalah me-link repo secara lokal dan mengatur profile eksplisit di build_flags.

    [env:esp32]
platform = espressif32
board = esp32dev
framework = arduino
lib_deps =
  symlink://../ZeroKernel
build_flags =
  -DZEROKERNEL_PROFILE_LEAN_NET

FAQ instalasi

Lebih baik pakai release atau clone repo?

Untuk development aktif, clone repo lebih enak. Untuk build firmware yang ingin dikunci, release bertag biasanya lebih aman dan lebih repeatable.

Bagaimana cara paling aman memvalidasi halaman ini di board nyata?

Mulai dari profile paling lean yang masih relevan, jalankan compare script yang paling sempit untuk topik ini, lalu baru lanjut ke workload yang lebih berat. Jangan lompat langsung ke build penuh kalau timing dasarnya belum jelas.

Kapan saya harus berhenti menambah abstraksi di topik ini?

Berhenti saat tambahan layer tidak lagi memberi payoff yang terukur. Jika RAM, flash, atau waktu eksekusi naik tetapi miss, throughput, atau recovery tidak membaik, berarti Anda sedang membayar kompleksitas tanpa hasil.