Düzenleyici

C ile yazılan özel çipler

Özel çip, davranışı kod olan bir parçadır: Mokxi'nin parçası olmadığı bir sensör, bir ekran sürücüsü veya bir bellek. Wokwi çipleri olduğu gibi çalışır.

These are different from the parçalardan yaptığın çipler. Onlar kutuya katlanmış bir devredir. Özel çip ise bir programdır.

Çipi Wokwi'den taşı

Çip, içinde bulunduğu projeyle birlikte gelir. Projeyi her zamanki gibi İçe aktar, çipleri de pinleri ve kablolarıyla birlikte parça olarak gelir:

  • Bir Wokwi for VS Code ya da Wokwi CLI projesinde her çip hazır derlenmiş olarak gelir: wokwi.toml dosyasının adını verdiği chip.wasm, yanında bir chip.json ile. Mokxi o dosyayı çalıştırır.
  • wokwi.com'dan gelen bir projede her çip iki dosya halindedir: <name>.chip.json ve <name>.chip.c. İkisini de içeri aktar. Tek başına bir chip.json ve chip.c, kendi klasöründeki bir çip ya da bir Wokwi for VS Code projesinin chip.json ve src/main.c dosyaları da olur; çip kodunun yanından eklediği başlık dosyaları da.
  • Projenin diagram.json dosyasında dependencies altında adı geçen bir çip, örneğin "chip-pwm": "github:Dlloydev/Wokwi-Chip-PWM@1.0.6", Wokwi'nin yaptığı gibi GitHub'daki o sürümden indirilir.

İçe aktarma raporu hangi çiplerin geldiğini ve gelmeyenlerde neyin eksik olduğunu söyler. Dosyaları yüklemeye dahil olmayan bir çip, tuvalde durduğu yerde bir not olarak gösterilir.

Bir çipin kodu hiçbir zaman kartın kodunun parçası değildir. wokwi-api.h dosyasını içeren ama .chip.json dosyası olmadan gelen bir .c dosyası raporda adıyla geçer: çalıştırmak için .chip.json dosyasını ekle ve yeniden içe aktar. Kartın sekmelerinden birine yapıştırılan çip kodu, kartın derlemesine alınmaz; o sekmede bunun bir özel çip olduğunu söyleyen bir uyarı gösterilir, böylece kod yine de çalışır. Çalıştırmak için Yeni özel çip ile bir çip oluştur ve kodu onun .chip.c dosyasına yapıştır.

Kendininkini yaz

Tuval araç çubuğundaki Daha fazla menüsünü aç ve Yeni özel çip… seçeneğini seç. Bir ad ver; çip, başlangıçta bir inverter olarak tuvale yerleşir. Ayrıca Bu projedeki çipler altında parça panelinde de görünür, böylece istediğin kadar yerleştirebilirsin.

Çipin iki dosyası kod panelinde açılır; kartın dosyaları gibi, panelin üstündeki listeden seçilir:

  • <name>.chip.json pinlerini, pin 1'den başlayarak sırayla adlandırır ve kaydırıcılar (controls) ile bir ekran ekleyebilir. Bir pinin listedeki yeri, çip üzerindeki yeridir: sol taraftan aşağı, sonra sağ taraftan yukarı.
  • <name>.chip.c çipin ne yaptığıdır; Wokwi'nin çip API'siyle C dilinde yazılır: pin_init, pin_watch, pin_write, timer_start, attr_read, i2c_init, spi_init, uart_init ve diğerleri.

Çalıştır'a bas; Mokxi önce çipin kodunu, tarayıcında derler. Koddaki bir hata, kodun üzerindeki derleme satırında görünür; ona basınca hatalı satıra gidilir. Mokxi'de yazılan bir çip aynı zamanda bir Wokwi çipidir: aynı iki dosya orada da çalışır.

Çalıştır

Çalıştır'a bas. Her çip, devrenin yanında kendi kodunu, simülasyonun hızında çalıştırır: bir milisaniyelik bir çip zamanlayıcısı, simüle edilmiş bir milisaniye sonra ateşlenir.

  • Çipin printf ile yazdırdıkları, seri monitörde çipin kimliği altında görünür.
  • Ekranlı bir çip, gövdesinin üzerine çizim yapar.
  • Kontrollü bir çipte (bir sıcaklık, bir ışık düzeyi) her kontrol için panelinde bir kaydırıcı vardır. Devre çalışırken çipe tıkla ve bir kaydırıcıyı hareket ettir; çip yeni değeri hemen okur.

Çipin diğer ayarları, Wokwi'nin diagram.json dosyasındaki gibi, onun özellikleridir.

Çalıştırmak güvenli

Bir çipin kodu kendi ayrı bir kutuda çalışır. Sayfaya, dosyalarına, ağa ya da devrenin başka hiçbir bölümüne, kendi pinleri dışında erişemez. En fazla 16 MB bellek alır. Kodun sonsuz bir döngüde takılması halinde Mokxi o tek çipi durdurur, bunu seri monitörde bildirir ve devrenin geri kalanı çalışmaya devam eder.

Wokwi'den farkları

Mokxi gerilimleri simüle eder, Wokwi etmez, bu yüzden bir çip pini 2,5 V üzerinde yüksek okur. Yalnızca Wokwi'de sinyal seviyeleri kusursuz olduğu için çalışan bir devre, burada gerçek bir tezgahta olacağı gibi bir dirence ihtiyaç duyabilir. Bir çipin çıkışları VCC pinindeki gerilimde sürer, yani 3,3 V'luk bir karttaki çip 3,3 V sürer.

Mikrodenetleyicinin belleğini okumak için Wokwi'nin deneysel işlevleri derlenir ama Mokxi'de henüz bir şey yapmaz: 0 yanıtını verirler ve bunları kullanan bir çip bunu seri monitörde belirtir.

Rust ile yazılmış çipler yazarlarının yayınladığı haliyle çalışır (onların chip.wasm dosyaları) ve debugPrint ile yazdırdıkları da seri monitörde görünür.