Düzenleyici

Kod düzenleyici ve derleme

Her kart için bir proje, sekmede çalışan gerçek bir clang ve tıklayabileceğin teşhisler.

Kart başına bir proje

Sağdaki panel bir iş istasyonudur, bir metin kutusu değil. Şemadaki her kart ayrı ayrı programlanır ve kendi dosyalarına sahiptir: bir kod dosyası, ayrıca eklediğin başlık dosyaları ve diğer kaynaklar, tıpkı gerçek bir proje gibi. Üstteki kart seçici hangi karta baktığını seçer; altındaki dosya şeridinde sekmeler ve dosya eklemek, yeniden adlandırmak ve silmek için düğmeler bulunur.

Dosyalar şemayla birlikte taşınır. Kartın kimliğine göre onun yanına kaydedilir, onunla birlikte dışa ve içe aktarılır ve kartla birlikte silinir.

Hiç kartı olmayan bir şemada bile bir kod dosyası vardır, böylece neyin çalıştıracağına karar vermeden önce kod yazabilirsin. Dosya adları harf, rakam, _, . ve - içerebilir ve .ino, .c, .cpp, .cc, .h, .hpp veya .hh ile biten her şey C++ vurgulaması alır.

Kod panelini gizleme

Tuval ve kod yan yana dururken, kod panelinin başlığının sağ ucundaki düğme kodu katlar ve tuval tüm genişliği kaplar. Sağ kenarda ince bir Kod çubuğu kalır: ona tıklayınca kod önceki genişliğiyle geri gelir. Ctrl+\ (Mac'te Cmd+\) odak nerede olursa olsun, kod dahil, ikisini de yapar.

Tarayıcın bu seçimi hatırlar, bu yüzden düzenleyiciyi bir dahaki açışında kod katlanmış kalır. Tuvalin ve kodun alt alta dizildiği daha dar bir pencerede ve telefonda kod paneli yerinde kalır.

Assembly sekmeleri

.S veya .s ile biten bir sekme assembly'dir ve Arduino IDE'nin bir kod dosyasının yanını derlediği gibi, aynı kartın .ino ve .cpp sekmeleriyle birlikte derlenir ve bağlanır. .S önce C ön işlemcisinden geçer, yani #include <avr/io.h> ve #define içinde çalışır; .s yazıldığı gibi assemble edilir. C ve assembly extern "C" ile birbirini çağırır ve assembly sekmeleri kendi vurgulamasını ve bir kod dosyasıyla aynı kesme noktası cebini alır.

Bir kart ayrıca Arduino çekirdeği olmayan tam bir assembly projesi de olabilir: Uno, Nano, Pro Mini, Pico veya STM32F411 Black Pill üzerinde, kartın özelliklerinin Firmware bölümündeki Assembly (no Arduino) altından bir başlangıç seç. Assembly yazma ikisini de kapsar: çağırma kuralları, bir .S içinde avr/io.h, satır içi asm volatile ve hataların anlamı.

Writing code

Kod paneli bir masaüstü kod düzenleyicisi gibi, özellikle Sublime Text gibi düzenlenir ve tuşlar kullanıcılarının zaten uzandığı tuşlardır. Hepsinin listesi şurada: Klavye kısayolları.

  • Completion as you type. The list offers the Arduino calls of the board the files belong to (pinMode, digitalWrite, analogRead, millis, the pin names), the C and C++ keywords, and the names the project already uses. After a dot it offers the object's methods: Serial. lists print, println, available and the rest, and lcd. lists what a LiquidCrystal_I2C lcd(...) declared in the file can do. After #include < it lists the libraries the board can compile.
  • Sadece derlenebilen adlar. Liste, derleyicinin o kart için bizzat kullandığı başlık dosyalarından okunur; bu yüzden bir ESP32 ledcAttach sunar, bir Uno sunmaz, ve bir kütüphanenin sınıfları dosya onu içine aldığında belirir. Her öneri her kartta derlenerek test edilir.
  • Snippets. setup writes both setup() and loop(); for, if, ifelse, else, switch, while and do write the whole block. Tab moves to the next blank to fill in.
  • Birden fazla imleç. Ctrl/Cmd+D sözcüğü ve ardından bir sonraki eşleşmesini seçer, Alt ve tıklama bir imleç ekler, Alt ve sürükleme bir sütun seçer.
  • Bul ve değiştir, düzenli ifadelerle birlikte, satıra git, parantez eşleştirme ve kapatma, katlama, yorum aç kapa, satırı çoğalt ve taşı, ve bir sonraki satırı girintileyip arkada boşluk bırakmayan bir Enter.
  • Otomatik Biçimlendir. Arduino IDE'deki gibi Ctrl/Cmd+T veya Ctrl/Cmd+Shift+F açık dosyayı yeniden girintiler, seviye başına iki boşlukla, ve dizileri ile yorumları olduğu gibi bırakır. Sıradan bir tarayıcı penceresinde Ctrl/Cmd+T yeni bir sekme açar, bu yüzden öğrenilecek olan Ctrl/Cmd+Shift+F. Ayrıntılar Klavye kısayolları sayfasında.
  • Uzun satırlar panelin kenarında, kendi girintilerinin altında kırılır, böylece uzun bir yorum kodun başını gözden uzaklaştırmaz. Alt+Z kırpmayı kapatır ve düzenleyici bunu hatırlar. Telefonda satırlar bütün kalır ve kod, dosyaya uyan boyutta yana kaydırılır.
  • Koddaki hatalar. Bir derlemeden sonra, derleyicinin verdiği her hata ve uyarı kendi satırında altı çizili görünür. Mesajı okumak için üzerine gel, bir sonrakine gitmek için F8, liste için Ctrl/Cmd+Shift+M tuşuna bas. Sonraki derleme hepsini temizler.

Çalıştır'a bastığında ne olur

Her karta tek bir soru sorulur: bu derleme gerektiriyor mu? Üç cevap var.

  • İmajı olduğu gibi çalıştır. Yüklenmiş bir ELF bu dosyalardan derlenmemiştir ve dokunulmamış bir hazır örnek zaten derlidir.
  • Son derlemeyi yeniden kullan. Karar, her dosya adının ve içindeki her baytın karmasıdır, yani bir tuş vuruşu ve bir geri alma seni tam kaldığın yerde bırakır.
  • Derle. Önce derle, sonra sonucu çalıştır.

Derlemenin kendisi gerçek bir clang ve gerçek bir lld'dir, WebAssembly'e derlenmiş ve bir Web Worker içinde çalışır, böylece dört saniyelik ilk derleme tuvalden tek kare bile götürmez. Hiçbir şey yüklenmez; derleme sunucusu, kuyruk veya derleme dakikası yoktur.

İlk derleme ve ondan sonraki her biri

Araç zinciri yaklaşık yetmiş megabaytlık bir clang'dır, bir kez kendi depomuzdan akıtılır ve sonra tarayıcının önbelleğinde tutulur. Yeni bir tarayıcıdaki ilk derleme birkaç saniye sürer; yeniden bir ziyaret yaklaşık bir buçuk saniye, ondan sonraki bir düzenleme ve çalıştırma ise kabaca saniyenin iki onda biri kadardır.

Yanında çalışma zamanı gelir: o kart ailesi için kendi bağımsız C ve C++ kodumuz, deponun kendi derleme betiğinin kullandığı başlık dosyaları, başlangıç kodu, bağlayıcı betiği ve bayraklarla birlikte. Paylaşılan sürücülerden birini içine alan bir kod, bu yüzden onlara sahip her kartta derlenir.

Arduino dili, her kartta

Çalışma zamanı Mokxi'nin kendisine aittir ama Arduino dil referansını konuşur: bir eğitimden kopyalanan bir kod burada gerçek bir karttakiyle aynı çağrıları kullanır.

  • Kayan nokta. float ve double aritmetiği her yerde çalışır, çalışma zamanındaki bir yazılım kayan nokta kütüphanesinden, tıpkı gerçek bir Uno'da olduğu gibi; o çipte de kayan nokta donanımı yoktur. double, AVR kartlarında (Uno, Nano, Mega, Leonardo, ATtiny85) 32 bittir, tam Arduino AVR çekirdeğindeki gibi, diğerlerinde 64 bit. Serial.print(x, 3) üç basamak yazdırır.
  • The math library. sqrt, pow, sin, cos, tan, atan2, log, exp, floor, round and the rest of math.h, plus PI, radians(), degrees(), map() and constrain(). Include <math.h> or not; either works.
  • String. Arduino's String class: + and +=, indexOf, substring, toInt, toFloat, trim, replace and the rest. Its text lives on the heap, which on an Uno is whatever of its 2 KB the sketch leaves free, so building long Strings in a loop runs out here as it does on the bench.
  • Seri okuma. parseInt, parseFloat, readString, readStringUntil, readBytes, find ve setTimeout desteklenir; ayrıca girdi geldiğinde loop() aralarında bir serialEvent() fonksiyonu çağrılır.
  • Darbe süresi ölçme. pulseIn ve pulseInLong bir darbenin uzunluğunu mikrosaniye cinsinden döndürür, zaman aşımında 0 verir; HC-SR04 böyle okunur. shiftIn ve shiftOut bir baytı saat darbeleriyle içeri veya dışarı aktarır.
  • Ses. tone(pin, frequency) ve tone(pin, frequency, duration), kodu durdurmadan bir zamanlayıcı kesmesi aracılığıyla kare dalga çalar; noTone(pin) ise durdurur. Uno'da Arduino çekirdeğinde olduğu gibi zamanlayıcı 2'yi kullanır, bu yüzden bir nota çalarken pin 3 ve 11'deki PWM duraklar. XIAO ve Uno R4'te nota PWM pinlerinde çalınır. #include "pitches.h", NOTE_ isimlerini sağlar.
  • C kütüphanesi. sprintf, snprintf, atoi, atof, strtol, strcpy, strcmp, strtok, dtostrf, itoa, malloc ve arkadaşları. Gerçek bir Uno'da olduğu gibi, AVR kartlarında sprintf içindeki %f ? yazdırır; orada dtostrf kullan.
  • Karakterler. isDigit, isAlpha, isSpace, isUpperCase ve diğerleri.
  • std::atomic. #include <atomic> gerçek Arduino çekirdeğinde olan her kartta çalışır: ESP32 ve ESP8266 kartları, RP2040 kartları, STM32 kartları, Uno R4, XIAO SAMD21 ve micro:bit. load, store, fetch_add, compare_exchange, atomic_flag ve çitlerin tamamı çalışır. AVR kartlarının çekirdeğinde <atomic>yoktur, yani bir Uno, Nano, Mega, Leonardo veya ATtiny85 üzerinde derleme, Arduino IDE'de olduğu gibi durur ve hangisinin kullanılacağını söyleyen bir satır gösterir: onu kullanan kodun çevresinde volatile değişkeni ve noInterrupts() ve interrupts() olan bir ATOMIC_BLOCK ile birlikte. <util/atomic.h> biçimi de AVR kartlarında çalışır.

ATtiny85'in 8 KB flash'ı vardır ve çağrıları yalnızca 4 KB'a ulaşır, yani matematik kütüphanesini ya da çok kayan nokta çeken bir kod çoğu zaman ona sığmaz, burada da tezgah üzerinde olduğu gibi.

Arduino libraries that compile as they are

Bir öğretici yapıştır, include'ları çalışır: çalışma zamanı, insanların en çok kullandığı hazır kütüphaneleri her zamanki adlarıyla taşır. Her biri, parça kutusundaki parçaların sürücüleri üzerine yazılmış Mokxi'nin kendi başlık dosyasıdır; hiçbiri orijinal kütüphanenin kodu değildir ve her biri öğreticilerin kullandığı çağrıları destekler.

Tablo, öğreticilerin en çok başvurduğu birkaç kütüphaneyi listeler, tüm listeyi değil. Düzenleyicide #include < yaz, bulunduğun kartın derleyebildiği tüm kütüphaneleri gör.

Başlık dosyası Ne çalıştırır Kartlar
Servo.h, ESP32Servo.h herhangi bir pine bağlı hobi servosu derlenebilen her kart
Wire.h ana birim (master) olarak I2C, kartın kendi I2C pinlerinde ya da herhangi iki pinden derlenebilen her kart
SPI.h kartın kendi SPI pinlerinden SPI derlenebilen her kart
EEPROM.h read, write, update, get, put, EEPROM[i] derlenebilen her kart
LiquidCrystal_I2C.h the 16x2 LCD behind its I2C backpack derlenebilen her kart
Adafruit_GFX.h, Adafruit_SSD1306.h 128x64 I2C OLED ATtiny85 hariç hepsi
Adafruit_NeoPixel.h WS2812 strips and panels AVR kartları, ESP32 ailesi, Pico, Uno R4
DHT.h DHT11 ve DHT22 derlenebilen her kart
OneWire.h, DallasTemperature.h DS18B20 termometreler, tek pinde istediğin kadar ATtiny85 hariç hepsi
Adafruit_BME280.h, Adafruit_BMP280.h, SparkFunBME280.h Bosch basınç sensörleri ATtiny85 hariç hepsi
RTClib.h DS3231 ve DS1307 saatleri, DateTime ve TimeSpan ATtiny85 hariç hepsi
Adafruit_INA219.h INA219 akım izleyici ATtiny85 hariç hepsi
Adafruit_ADS1X15.h ADS1115 on altı bitlik ADC ATtiny85 hariç hepsi
Adafruit_MCP23X17.h MCP23017 port genişleticisi ATtiny85 hariç hepsi
SoftwareSerial.h HC-05 ya da bir GPS için, iki sıradan pinden seri port Uno, Nano, Pro Mini, Mega, Leonardo, Pro Micro, ESP8266, ESP32, ESP32-S3
TinyGPS++.h NEO-6M GPS'ten NMEA Uno, Mega ve NodeMCU üzerinde test edildi

Orijinal kütüphanelerden farklı oldukları yerler, her parçanın yardım sayfasında ayrıntılı olarak açıklanır:

  • Servo, bir zamanlayıcıdan sinyal göndermek yerine her write() çağrısında bir sinyal gönderir. Sinyal genişlikleri orijinal kütüphaneninkilerle aynıdır: attach(pin) 544 ile 2400 mikrosaniye arasıdır, write(90) 1472'dir ve attach(pin, min, max) başka bir aralık ayarlar. Servo parçasının varsayılanları da aynı 544 ile 2400 arasıdır.
  • EEPROM, Uno, Nano, Mega, Leonardo ve ATtiny85 üzerinde çipin kendi EEPROM'udur; diğer tüm kartlarda 4 KB RAM'dir, çünkü modellerinde sıfırlamadan sonra veriyi saklayabilen bir bölüm yoktur. Yeni bir Çalıştır, her durumda silinmiş olarak başlar.
  • Adafruit GFX ekranlarının yazı tipi, Mokxi'nin kendi 5x8 yazı tipidir; küçük harfleri de içerir ve orijinaldeki 6x8 hücreye yerleşir. setFont(), kodun taşıdığı bir yazı tipini birebir çizer ve Fonts/ başlıkları, GNU FreeFont yazı tipleri değil, her boyut için Mokxi'nin harfleridir.
  • DHT, sensörün tam onda birlik değerlerinden oluşturulan ondalıklı sayılar döndürür. Bunlar yazdırılabilir, isnan ve computeHeatIndex çalışır ve bunlarla kendi aritmetiğini de yapabilirsin.
  • Wire yalnızca ana birim (master) olarak çalışır ve buradaki tüm veri yolları gibi yazılım ile üretilmiştir.
  • AVR kartlarındaki SoftwareSerial, Arduino kütüphanesi gibi çalışır: pin değişim kesmesi ve sayılmış döngüler, aynı anda tek port dinleme, yarım çift yönlü, paylaşılan 64 baytlık tampon. Alım için pin değişim kesmesi olan bir pin gerekir; Mega'da bu 10 ile 15, 50 ile 53 ve A8 ile A15'tir. ESP8266, ESP32 ve ESP32-S3'te ise EspSoftwareSerial yöntemidir: kenarlar bir kesmede ölçülür, böylece birkaç port aynı anda alabilir. Yalnızca 8N1. Diğer kartlar bunu derleme sırasında bildirir.
  • Sensör kütüphaneleri, DHT gibi ondalıklı sayılar döndürür; bunlar çiplerin kendi sayımlarından oluşturulur. DEVICE_DISCONNECTED_C, öğreticilerin yaptığı gibi bir okumayla karşılaştırılabilir ve basınç öğreticilerindeki readPressure() / 100.0F yazıldığı gibi çalışır; readPressureHPa() da vardır.

Her kartın yardım yazısı, Wire.begin() çağrısının o kartta hangi pinleri kullandığını belirtir.

Kütüphane eklemek

Kodun altındaki üç şerit kütüphaneleri yönetir ve eklemek her planda ücretsizdir:

  • Libraries, projenin kendi kütüphanelerini listeler ve her birinin yanında bir kaldırma düğmesi vardır. + Add library, Arduino düzeninde bir .zip ya da tek tek .h ve .cpp dosyaları alır ve hangi dosyaları tuttuğunu, examples gibi hangilerini atladığını söyler.
  • Arduino Kütüphane Yöneticisi: her kütüphane, tek dokunuşta. Search düğmesine bas ve bir ad, başlık dosyası ya da konuyla ilgili bir kelime yaz. Her sonucun yanında Install vardır; kütüphaneyi bağımlı olduğu kütüphanelerle birlikte indirir. Mokxi'nin zaten hazır olarak derlediği bir kütüphane Built in, projede olan bir kütüphane Installed der; düzenlediğin kartı listelemeyen bir kütüphane ise bir uyarıyla kurulur.
  • Hazır kütüphaneler. Browse düğmesine basarak Mokxi'nin taşıdığı kütüphanelerde ara; This board only seçeneği, yalnızca bulunduğun kartta derlenenleri gösterir. Add #include, kütüphanenin başlık dosyasını açık dosyanın en üstüne ekler (ya da zaten orada olduğunu söyler) ve Details, başlık dosyalarını ve Open example seçeneğini gösterir.

Projenin sahip olmadığı bir kütüphaneyi içeren bir kod, clang'ın file not found hatasında durur. Derleme sekmesi daha sonra aynı işi yapan Mokxi başlık dosyasını adlandırır ya da Arduino Kütüphane Yöneticisi'ndeki kütüphane için Kur seçeneğini sunar; bu, kütüphaneyi projeye ekler ve yeniden derler.

Pico, ESP32 ve Raspberry Pi üzerinde Python

Bu kartlar kod yerine Python çalıştırabilir. Seçim, kartın özelliklerindeki Firmware bölümündeki program listesinden yapılır:

  • Raspberry Pi Pico. Seç MicroPython (main.py) ve şunu yaz main.py. Çalıştır, benzetilen çipte resmi MicroPython firmware'ini başlatır ve .py dosyalarını Thonny'nin yaptığı gibi üzerine kopyalar. print() Seri monitörde gösterilir. Pico W, kendi derlemesiyle aynı şeyi yapar; network.WLAN simüle edilen ağda. Bak: Pico ve Pico W.
  • ESP32 kartları. Aynı seçim, çip için resmi MicroPython firmware'ini başlatır: network.WLAN simüle edilen ağda, klasik ESP32'de (DevKit V1, DevKitC, LOLIN32 Lite), ESP32-S3'te (XIAO ESP32-S3 ve Nano ESP32 ile), ESP32-C3'te (XIAO ESP32-C3 ve SuperMini ile) ve ESP32-C6'da (XIAO ESP32-C6 ile). ESP8266'da burada MicroPython yok. Bak: ESP32 üzerinde MicroPython.
  • CircuitPython Pico, Pico W, Arduino Nano RP2040 Connect ve ESP32-S3'te. Şunu seç: CircuitPython (code.py) ve şunu yaz code.py. Run boots the official CircuitPython firmware and saves code.py kartın CIRCUITPY sürücüsüne, içe aktardığı Adafruit kütüphaneleriyle birlikte. Bak: Pico üzerinde CircuitPython.
  • Raspberry Pi 4, Pi 5 ve Zero 2 W. Kart şunu alır: main.py, ve Çalıştır şununla başlatır: gpiozero ve RPi.GPIO header'ı yönetir. Altında Linux yoktur. Bak: Raspberry Pi.

Derleme sekmesi

Dosya şeridinin altında. Söyleyecek bir şey olana kadar yolundan çekilir, sonra üç şey gösterir: zamanlamalarıyla birlikte adımlar, böylece yavaş bir ilk derleme takılma değil ilerleme olarak okunur; derleyicinin tanılamaları, şikayet ettiği dosyanın, satırın ve sütunun üzerine götüren tıklanabilir satırlar olarak; ve sonda Built esp1.elf, 1.5 KB, 0.21 s gibi düz bir cümle.

Her kart, tek bir araç zinciri

Her kart tarayıcıda aynı clang araç zinciriyle derlenir, her biri kendi çipi için: Uno gibi AVR Arduinolar (avr -mmcu=atmega328p), ESP32-C3 gibi RISC-V ESP32 kartları (riscv32 -march=rv32imc) ve Pico (thumbv6m, Cortex-M0+) ile STM32F411 (thumbv7em, Cortex-M4, soft float) gibi Arm kartları. Kartlar sayfası hepsini listeler.

Komut listesine ve önbellek anahtarlarına kadar tüm ayrıntı şu sayfada: tarayıcıda derleme.

Bir derleme başarısız olursa, kod derlenmiyor sayfası Derleme sekmesinin sana ne söylediğini adım adım anlatır.