Editor

Chip kustom yang ditulis dalam C

Chip kustom adalah komponen yang perilakunya berupa kode: sensor yang belum ada komponennya di Mokxi, driver tampilan, atau memori. Chip Wokwi berjalan apa adanya.

These are different from the chip yang kamu buat dari komponen. Itu rangkaian yang terlipat jadi kotak. Chip kustom adalah program.

Bawa chip dari Wokwi

Chip datang bersama proyek tempatnya berada. Impor proyeknya seperti biasa dan chip-nya ikut sebagai komponen, beserta pin dan kabelnya:

  • Proyek Wokwi for VS Code atau Wokwi CLI sudah punya setiap chip dengan build-nya: file chip.wasm yang disebut wokwi.toml-nya, di samping sebuah chip.json. Mokxi menjalankan file itu.
  • Proyek dari wokwi.com punya setiap chip sebagai dua file, <name>.chip.json dan <name>.chip.c. Bawa keduanya. chip.json dan chip.c telanjang, chip dalam folder tersendiri, atau chip.json dan src/main.c dari proyek Wokwi for VS Code juga bisa, begitu juga header yang disertakan kode chip dari sebelahnya.
  • Chip yang disebut proyek di bawah dependencies dalam diagram.json-nya, seperti "chip-pwm": "github:Dlloydev/Wokwi-Chip-PWM@1.0.6", diunduh dari rilis tersebut di GitHub, seperti yang Wokwi lakukan.

Laporan impor menyebutkan chip mana yang berhasil dibawa, dan apa yang kurang dari chip yang tidak lengkap. Chip yang filenya tidak ada di unggahan menjadi catatan di kanvas di tempat chip itu berada.

Kode chip tidak pernah menjadi bagian dari sketch board. File .c yang menyertakan wokwi-api.h tapi datang tanpa .chip.json-nya disebutkan di laporan: tambahkan .chip.json-nya dan impor lagi untuk menjalankannya. Kode chip yang ditempel ke salah satu tab board tidak disertakan dalam build board, dengan peringatan di tab itu yang bilang ini chip kustom, jadi sketch tetap berjalan. Untuk menjalankannya, buat chip dengan Chip kustom baru dan tempel kodenya ke .chip.c-nya.

Tulis chip-mu sendiri

Buka menu Lainnya di toolbar kanvas dan pilih Chip kustom baru…. Beri nama, dan chip itu masuk ke kanvas, dimulai sebagai inverter. Chip itu juga ada di panel komponen di bawah Chip di proyek ini, jadi kamu bisa menempatkan sebanyak yang kamu butuh.

Dua file chip itu terbuka di panel kode, dipilih seperti file board dari daftar di bagian atasnya:

  • <name>.chip.json memberi nama pin-pinnya, berurutan dari pin 1, dan bisa menambah slider (controls) serta tampilan. Posisi pin dalam daftar menunjukkan posisinya di chip: turun di sisi kiri, lalu naik di sisi kanan.
  • <name>.chip.c adalah isi kerjanya, dalam bahasa C, memakai API chip milik Wokwi: pin_init, pin_watch, pin_write, timer_start, attr_read, i2c_init, spi_init, uart_init dan lainnya.

Tekan Jalankan dan Mokxi mengompilasi kode chip lebih dulu, di browser-mu. Kesalahan dalam kode muncul di baris build di atas kode, dan menekannya membawa kamu ke baris itu. Chip yang ditulis di Mokxi juga adalah chip Wokwi: dua file yang sama berfungsi di sana.

Jalankan

Tekan Jalankan. Setiap chip menjalankan kode miliknya sendiri di samping rangkaian, dengan kecepatan simulasi: timer chip satu milidetik berbunyi setelah satu milidetik tersimulasi.

  • Apa yang dicetak chip dengan printf muncul di Serial Monitor, di bawah id chip tersebut.
  • Chip dengan tampilan menggambar pada badannya.
  • Chip dengan kontrol (suhu, tingkat cahaya) punya slider untuk tiap kontrol di panelnya. Klik chip dan geser slider saat rangkaian berjalan; chip membaca nilai barunya langsung.

Pengaturan lain chip ada di propertinya, seperti di diagram.json Wokwi.

Aman untuk dijalankan

Kode chip berjalan di wadah tersendiri. Kode itu tidak bisa mengakses halaman, file-mu, jaringan, atau bagian rangkaian lain kecuali melalui pin-pinnya sendiri. Kode itu mendapat memori paling banyak 16 MB. Jika kodenya macet dalam loop yang tak berujung, Mokxi menghentikan chip itu saja, menyebutkannya di Serial Monitor, dan sisa rangkaian tetap berjalan.

Perbedaannya dengan Wokwi

Mokxi mensimulasikan tegangan sedangkan Wokwi tidak, jadi pin chip membaca tinggi di atas 2,5 V. Rangkaian yang hanya bekerja di Wokwi karena level di sana sempurna mungkin butuh resistor di sini, seperti di meja kerja sungguhan. Output chip mengeluarkan tegangan sesuai pin VCC-nya, jadi chip di board 3,3 V mengeluarkan 3,3 V.

Fungsi eksperimental Wokwi untuk membaca memori mikrokontroler berhasil dikompilasi tapi belum berfungsi di Mokxi: fungsi itu menjawab 0, dan chip yang memakainya menyebutkannya di Serial Monitor.

Chip yang ditulis dalam Rust berjalan seperti yang dirilis pembuatnya (chip.wasm-nya), dan apa yang dicetak dengan debugPrint juga muncul di Serial Monitor.