Hesaplar ve planlar

mokxi komut satırı

Bir projeyi kendi klasöründe tut, Mokxi ile eşitle ve bir terminalden çalıştır.

mokxi, başka hiçbir bağımlılığı olmayan küçük bir komut satırı aracıdır. Node.js 18 veya daha yeni bir sürüm gerekir. npx @mokxi/cli ile çalıştır ya da npm install -g @mokxi/cli ile bir kez kur.

Giriş yap

npx @mokxi/cli login

It shows a short code and opens mokxi.com/device Orada onayla, araç kendi anahtarını alır. Şurada oluşturduğun bir anahtarı yapıştırmak için: Settings > Developer instead, run npx @mokxi/cli login --paste.

Anahtar, kullanıcının yapılandırma klasörüne kaydedilir (~/.config/mokxi/config.json ya da XDG_CONFIG_HOME altında), yalnızca sen okuyabilirsin. npx @mokxi/cli logout onu unutur; işin bittiğinde Settings > Developer altından iptal et.

Komutlar

Komut Ne yapar
mokxi list projeleriniz, kimlikleriyle birlikte
mokxi new <board> [dir] bir kart için proje başlatır, örneğin mokxi new uno blink
mokxi pull <id or link> [dir] projeyi dosyalar olarak yazar (aşağıya bak)
mokxi pull çekilmiş bir klasörün içinde: en son halini alır
mokxi push [dir] klasörü Mokxi'ye gönderir, ilk kez projeyi oluşturur
mokxi run [dir] [--timeout 10s] kendi makinen üzerinde derleyip çalıştırır ve seri çıkışı geldikçe yazdırır
mokxi test [dir] klasördeki mokxi.test.yaml senaryolarını çalıştırır ve her birini raporlar
mokxi run --cloud [dir] bunun yerine Mokxi'nin sunucularında çalıştırır
mokxi open [dir or id] projeyi tarayıcında açar
mokxi upload [dir] --firmware FILE bir derlemeyi (arduino-cli .elf) projeyle birlikte saklar
mokxi boards Mokxi'nin simüle ettiği kartlar

mokxi --help tüm seçenekleri listeler.

Dosyalar

mokxi pull, düzenleyicideki Save to GitHub ile aynı düzeni yazar: kod bir Arduino IDE klasörü olarak (Blink/Blink.ino ve sekmeleri), tüm proje diagram.mokxi.json olarak, Open in Mokxi rozeti olan bir README ve .vscode/ ayarları ve görevleri. Her dosyanın ne olduğunu Mokxi, VS Code ve GitHub sayfasında gör.

Yani tipik bir başlangıç şöyle:

npx @mokxi/cli pull https://mokxi.com/p/abc123 blink
cd blink
git init && git add . && git commit -m "From Mokxi"

Sonra düzenle, npx @mokxi/cli push ve her kodda yaptığın gibi commit at. Depoyu klonlayan kişi projesini .vscode/settings.json içinde bulur, dolayısıyla mokxi push orada da çalışır.

Güvenli eşitleme

.mokxi/project.json son eşitlemeyi hatırlar (.gitignore içindedir).

  • mokxi push, son çekme ya da göndermeden bu yana proje Mokxi'de değiştiyse reddedilir, böylece tarayıcıda yapılan işin üzerine asla yazmaz. --force yine de üzerine yazar.
  • mokxi pull, henüz göndermediğin dosyaları değiştirdiysen reddedilir. --force bunları değiştirir.
  • Mokxi'de silinen bir sekme, o dosyayı değiştirmediysen sonraki çekmede klasörden de silinir.

mokxi push --new, güncellemek yerine klasörden yeni bir proje oluşturur.

Çalıştırma

mokxi run, kodu düzenleyicinin kullandığı derleyiciyle derler ve aynı simülatörle kendi makinen üzerinde çalıştırır. Hesap gerektirmez ve ücretsizdir: derleyici bir kez indirilir (yaklaşık 80 MB) ve bir önbellek klasöründe tutulur. Klasör, çekilmiş bir Mokxi projesi, diagram.json ve wokwi.toml içeren bir Wokwi projesi ya da düz bir Arduino kodu olabilir.

npx @mokxi/cli run --timeout 10s --expect-serial "Ready" --fail-on "panic"

Kod Ready yazdırır yazdırmaz geçer, panic yazdığı an başarısız olur ve önce 10 saniyelik simülasyon süresi geçerse 1 ile çıkar; bir CI işinin istediği de budur. mokxi test, butonlara basan, sensörleri çeviren ve pinlerle LED'leri kontrol eden senaryo dosyalarını çalıştırır. Tümü, bir GitHub Action ile birlikte CI'da simülasyon testleri sayfasındadır.

mokxi run --cloud bunun yerine Mokxi'nin sunucularında çalışır ve planının API dakikalarından düşer. Klasör son eşitlemeyle eşleştiği sürece kayıtlı projeyi, Çalıştır'a bastıktan sonra düzenleyicinin sakladığı derleme dahil çalıştırır. Yerel değişiklikler varsa klasörün dosyalarını gönderir ve Mokxi'nin sunucuları derlemez: arduino-cli ile derleyip --firmware build/Blink/Blink.ino.elf parametresini ver, ya da push yapıp düzenleyicide bir kez Çalıştır'a bas. run --cloud, mokxi simulate ile aynı kontrolleri alır.

Plan sınırları

Yeni bir proje göndermek, diğer projeler gibi planının proje sınırından düşer. Sınırdayken mokxi push, düzenleyicinin gösterdiği aynı mesajı yazdırır ve 3 ile çıkar.

Çıkış kodları

Her şey yolunda gittiğinde 0, bir çalışma bir kontrolü geçemediğinde (ya da zaman aşımına uğradığında ya da derlenmediğinde) 1, komutta bir hata varsa 2 ve Mokxi reddettiğinde (çıkış yapılmış, bir plan sınırı, bir çakışma) ya da bir indirme başarısız olduğunda 3.