Bir projeyle tarayıcı dışında çalışmanın üç yolu var ve hepsi aynı dosyaları kullandığı için bunları karıştırabilirsin: düzenleyiciden GitHub'a kaydetmek, depoyu klonlayıp VS Code'da açmak, VS Code'dan veya terminalden eşitlemek ve sonra projeyi Mokxi'de yeniden açmak.
Kaydedilmiş bir proje nasıl görünür
GitHub'a yapılan her kayıt, her mokxi pull ve VS Code'un açtığı her proje aynı düzenindedir:
| Dosya | Nedir |
|---|---|
Blink/Blink.ino |
kod, Arduino IDE klasörü olarak, diğer sekmeleri yanında |
diagram.mokxi.json |
projenin tamamı: parçalar, kablolar, notlar ve kod. Mokxi onu olduğu gibi açar |
README.md |
projenin ne olduğu, üzerinde Mokxi'de Aç rozetiyle |
.vscode/extensions.json |
klasör VS Code'da açıldığında Mokxi uzantısını önerir |
.vscode/settings.json |
klasörün hangi Mokxi projesi olduğu |
.vscode/tasks.json |
push, pull, çalıştırma, derleme ve karta yüklemeyi VS Code görevleri olarak yapar |
.gitignore |
komut satırının eşitleme durumunu ve derleme çıktısını içermez |
Klasör, projenin adını alır, böylece Arduino IDE onu olduğu gibi açar (Dosya > Aç > Blink/Blink.ino). İki kartlı bir proje her kart için bir klasör alır, örneğin Traffic_Lights_uno1/ ve Traffic_Lights_esp1/.
Kodu klasörün içinde düzenle, diagram.mokxi.json dosyasının içinde değil: Mokxi depoyu geri okuduğunda klasör önceliklidir. Klasörden sildiğin bir sekme projeden de silinir ve klasöre eklediğin yeni bir dosya yeni bir sekme olur.
README, .gitignore ve .vscode dosyaları bir kez oluştuktan sonra senindir: Mokxi bunları ilk seferde yazar ve sonrasında düzenlemelerine dokunmaz.
Düzenleyiciden GitHub'a kaydet
- Düzenleyicinin üst kısmındaki Dışa Aktar'ı aç.
- GitHub altında GitHub'a Bağlan düğmesine bas. GitHub, Mokxi'nin herkese açık depolarına yazmasına izin vermeni ister. Gizli depoları da istiyorsan önce Gizli depoları dahil et seçeneğini işaretle.
- Düzenleyiciye geri dönüp Dışa Aktar'ı yeniden aç ve GitHub'a Kaydet düğmesine bas.
- Yeni depo seç (Mokxi ona projenin adını verir) ya da kendi depolarından birini seç, istersen bir işleme mesajı yaz ve GitHub'a Kaydet düğmesine bas.
GitHub'taki işlemeye giden bir bağlantı alırsın. Sonraki her kayıt aynı dalda yeni bir işlemedir. Kartın üstündeki satır nerede olduğunu söyler:
- ada/blink ile eşitlendi (main): GitHub'da tam olarak bu proje var.
- Değişiklikler henüz ada/blink'e kaydedilmedi: bu tarihten sonra projeyi değiştirdin.
- ada/blink'te daha yeni işlemeler var: biri depoya push yaptı. Bunları almak için GitHub'dan Aç'ı kullan.
GitHub'dan aç
Dışa Aktar'ı aç ve GitHub'dan aç'a bas, sonra depolarından birini seç ya da okuyabildiğin herhangi bir depoyu yapıştır (owner/name veya bir github.com bağlantısı).
- Mokxi'den kaydedilmiş bir depo, GitHub'da ya da VS Code'da kod klasöründe yapılan tüm düzenlemelerle birlikte kaydedildiği haliyle açılır.
- Düz bir Arduino kod deposu (
.inodosyası içeren bir klasör) de açılır. Mokxi onu bir Uno'ya yerleştirir, kod WiFi içeriyorsa bir ESP32'ye. Başka bir kart için hazırlanmışsa kartı değiştir.
Daha önce açık olan, JSON Aç'ta olduğu gibi önce rafa kaldırılır, böylece hiçbir şey kaybolmaz. Kaydedilmiş bir deponun README'sindeki Mokxi'de Aç rozeti projeyi hemen açar.
Bağlanma ve bağlantıyı kesme
Mokxi, depo erişimi için GitHub'a yalnızca GitHub'a Bağlan'a bastığında izin ister, asla giriş yaptığında değil. Bu, GitHub ile giriş yapmaktan ayrı bir izindir ve Google, Microsoft ya da e-posta ile giriş yapsan da aynı şekilde çalışır.
Erişim, hesabınla birlikte şifrelenmiş olarak saklanır ve yalnızca Kaydet veya Aç'a bastığında kullanılır. Mokxi'deki başka hiçbir şey onu okumaz ve asla tarayıcına gönderilmez.
Bağlantıyı kesmek için Ayarlar > Bağlı hesaplar'a git ve Bağlantıyı kes'e bas. Mokxi erişimi GitHub'da geri çekip siler. Hesabını kapatmak da aynısını yapar. GitHub'da da, Settings > Applications > Authorized OAuth Apps altından geri çekebilirsin.
GitHub eşitlemesi bir sınıftaki öğrencilere veya çocuk hesaplarına sunulmaz.
VS Code
Mokxi'yi VS Code Marketplace'ten kur (Uzantılar görünümünde Mokxi ara) ya da VSCodium ve Cursor'da Open VSX'ten kur. Mokxi'den kaydedilmiş bir klasör zaten onu önerir.
Devreyi VS Code'da çalıştır
Bir proje klasörü aç: Mokxi projesi, Wokwi projesi (wokwi.toml ve diagram.json) ya da bir kod. Simülatörü Başlat'a bas (bir kodda veya diyagramda oynat düğmesi). Devre, kodunun yanındaki bir panelde, Mokxi düzenleyicisiyle aynı motorda çalışır ve Mokxi Seri Monitör terminali kartların yazdırdıklarını gösterir; oraya bir satır yazıp Enter'a basarak gönder. Kodun ya da diyagramın kaydedilmesi veya derleme aracından yeni bir derleme, onu yeniden çalıştırır. Durdur ve Yeniden Başlat, panelin başlık çubuğunda ve durum çubuğundadır.
Bir derlemesi olan proje (firmware'in wokwi.toml'da adı geçtiği derleme, PlatformIO derlemesi veya arduino-cli derlemesi) o derlemeyi çalıştırır; aksi halde panel, kodu düzenleyicinin yaptığı gibi derler. Bunların hiçbiri hesap gerektirmez.
Testler, lint ve CI
- Senaryo dosyaları (
mokxi.test.yaml,*.test.yaml, Wokwi'nin*.scenario.yamldosyaları) VS Code'un Testing görünümünde görünür. Her senaryo, altında adımları olan bir testtir; bir hata, adımın satırını ve son seri satırlarını gösterir. - Mokxi: Devreyi Denetle (Lint) kablolama sorunlarını Problems paneline koyar. Diyagramı kaydettiğinde de çalışır.
- Mokxi: Ekran Görüntüsü Al, seçtiğin anda bir ekranı PNG olarak kaydeder.
- Mokxi: CI Kurulumu Yap (GitHub Actions veya GitLab) iş akışını, GitLab CI dosyasını ya da ikisini birden yazar ve projede yoksa ilk
mokxi.test.yaml. Şuraya bak: CI'da simülasyon testleri.
Mokxi projelerin
- Etkinlik Çubuğu'ndaki Mokxi simgesine tıkla ve Giriş Yap'a bas. Tarayıcında kısa kodu onayla ya da Ayarlar > Geliştirici'den bir API anahtarı yapıştır.
- Projelerin kenar çubuğunda listelenir. Birine tıklayarak klasör olarak aç.
- Kodu düzenle.
.inodosyaları Arduino renklendirmesi alır,sketch,blink,button,everygibi kod parçacıkları da var. - Mokxi'ye göndermek için düzenleyicinin başlık çubuğundaki bulut olan Sync'e bas.
- Open in Mokxi (durum çubuğundaki Mokxi öğesi) onu tarayıcındaki düzenleyicide açar.
Sync, son eşitlemenden beri tarayıcıda yapılan işin üzerine yazmayı reddeder; Pull ise eşitlemediğin düzenlemeleri çöpe atmayı reddeder. Her ikisi de nedenini söyler ve seçim yapmanı sağlar. Açma, eşitleme, çekme ve yükleme Pro'nun parçasıdır.
Derle ve yükle
Mokxi: Compile (arduino-cli), kuruluysa arduino-cli kullanır ve hatalar Sorunlar panelinde görünür; Mokxi: Compile and Upload to Mokxi eşitleyip derler ve derlemeyi projeyle saklar, böylece mokxi.com tam olarak derlediğin şeyi çalıştırır. Simülatör paneli için arduino-cli gerekmez, o kendi başına kodu derler.
Komut satırı
Aynı şeyler bir terminalden şu komutla çalışır: npx @mokxi/cli. Bkz.
mokxi komut satırı.
npx @mokxi/cli login
npx @mokxi/cli pull https://mokxi.com/p/abc123 blink
cd blink && git init
npx @mokxi/cli push
npx @mokxi/cli run --timeout 5s
Hangi planlar
GitHub sync and the command line are on every plan. mokxi run and mokxi test compile and simulate on your own machine, so they are free and need no
sign-in. In VS Code, the simulator panel, tests, lint, screenshots, Set Up CI
and Compile are free and need no account too. Your Mokxi projects in VS
Code (opening, Sync, Pull and Compile and Upload to Mokxi) are part of Pro
(and the student price and Classroom); without it, the extension says
so and offers the 7-day Pro trial where you can still start it. CI runs (the GitHub
Action, or the command line tool in a CI job) are free for public
repositories; for private ones, CI comes with Pro (and the student price,
Classroom, the trial, Lifetime, and Ultra for accounts that still have it); see CI'da simülasyon testleri. If you used either in the 60 days before
October 12, 2026, you keep it until December 11, 2026, and the tool tells you
so. mokxi run --cloud and mokxi simulate run on Mokxi's servers and use the
API minutes your plan includes; the developers page lists them.