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.listsprint,println,availableand the rest, andlcd.lists what aLiquidCrystal_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
ledcAttachsunar, 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.
setupwrites bothsetup()andloop();for,if,ifelse,else,switch,whileanddowrite the whole block.Tabmoves to the next blank to fill in. - Birden fazla imleç.
Ctrl/Cmd+Dsö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+TveyaCtrl/Cmd+Shift+Façı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ı penceresindeCtrl/Cmd+Tyeni bir sekme açar, bu yüzden öğrenilecek olanCtrl/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+Zkı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çinCtrl/Cmd+Shift+Mtuş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.
floatvedoublearitmetiğ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,roundand the rest ofmath.h, plusPI,radians(),degrees(),map()andconstrain(). Include<math.h>or not; either works. - String. Arduino's
Stringclass:+and+=,indexOf,substring,toInt,toFloat,trim,replaceand 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,findvesetTimeoutdesteklenir; ayrıca girdi geldiğindeloop()aralarında birserialEvent()fonksiyonu çağrılır. - Darbe süresi ölçme.
pulseInvepulseInLongbir darbenin uzunluğunu mikrosaniye cinsinden döndürür, zaman aşımında 0 verir; HC-SR04 böyle okunur.shiftInveshiftOutbir baytı saat darbeleriyle içeri veya dışarı aktarır. - Ses.
tone(pin, frequency)vetone(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,mallocve arkadaşları. Gerçek bir Uno'da olduğu gibi, AVR kartlarındasprintfiçindeki%f?yazdırır; oradadtostrfkullan. - Karakterler.
isDigit,isAlpha,isSpace,isUpperCaseve 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_flagve ç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 çevresindevolatiledeğişkeni venoInterrupts()veinterrupts()olan birATOMIC_BLOCKile 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 veattach(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 veFonts/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,
isnanvecomputeHeatIndexç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ç öğreticilerindekireadPressure() / 100.0Fyazı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
.zipya da tek tek.hve.cppdosyaları 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.pydosyalarını Thonny'nin yaptığı gibi üzerine kopyalar.print()Seri monitörde gösterilir. Pico W, kendi derlemesiyle aynı şeyi yapar;network.WLANsimü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.WLANsimü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 savescode.pykartı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:gpiozeroveRPi.GPIOheader'ı 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.