Editor

Editor kode dan kompilasi

Satu proyek per board, clang sungguhan berjalan di tab, dan diagnostik yang bisa kamu klik.

Satu proyek per board

Panel di sebelah kanan adalah stasiun kerja, bukan sekadar kotak teks. Setiap board dalam diagram diprogram terpisah dan punya file sendiri: sebuah sketch, plus header dan sumber tambahan yang kamu tambahkan, persis seperti proyek sungguhan. Pemilih board di bagian atas menentukan board mana yang kamu lihat; strip file di bawahnya berisi tab, dan tombol untuk menambah, mengganti nama, dan menghapus file.

File ikut bersama diagram. File disimpan di sampingnya dengan id board, diekspor dan diimpor bersamanya, dan dihapus bersama board.

Diagram tanpa board sama sekali tetap punya satu sketch, jadi kamu bisa menulis kode sebelum memutuskan apa yang akan menjalankannya. Nama file boleh berisi huruf, angka, _, . dan -, dan semua yang berakhiran .ino, .c, .cpp, .cc, .h, .hpp atau .hh mendapat penyorotan C++.

Menyembunyikan panel kode

Saat kanvas dan kode berdampingan, tombol di ujung kanan header panel kode melipat kode dan kanvas mengambil seluruh lebar. Bar Kode tipis tetap ada di tepi kanan kanvas: klik untuk mengembalikan kode pada lebar semula. Ctrl+\ (Cmd+\ di Mac) melakukan keduanya, di mana pun fokusnya, termasuk di kode.

Browser-mu mengingat pilihan itu, jadi kode tetap terlipat saat kamu membuka editor berikutnya. Pada jendela yang lebih sempit, saat kanvas dan kode ditumpuk, dan di HP, panel kode tetap di tempatnya.

Tab assembly

Tab yang berakhiran .S atau .s adalah assembly, dan tab itu dibangun serta di-link dengan tab .ino dan .cpp pada board yang sama, seperti Arduino IDE membangun satu di samping sketch. File .S melewati preprocessor C lebih dulu, jadi #include <avr/io.h> dan #define bisa dipakai di dalamnya; file .s dirakit apa adanya. C dan assembly saling memanggil lewat extern "C", dan tab assembly punya penyorotan sendiri serta gutter breakpoint yang sama seperti sketch.

Board juga bisa menjadi proyek assembly penuh tanpa core Arduino: pilih starter di bawah Assembly (tanpa Arduino) di bagian Firmware properti board, pada Uno, Nano, Pro Mini, Pico, atau STM32F411 Black Pill. Menulis assembly membahas keduanya, konvensi pemanggilan, avr/io.h dalam .S, asm volatile inline, dan arti error-errornya.

Writing code

Panel kode menyunting seperti editor kode desktop, khususnya Sublime Text, dan tombolnya adalah yang sudah dipakai penggunanya. Semuanya tercantum di Pintasan keyboard.

  • 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.
  • Hanya nama yang bisa dikompilasi. Daftarnya dibaca dari header yang benar-benar dipakai compiler untuk board itu, jadi ESP32 menawarkan ledcAttach sedangkan Uno tidak, dan class dari sebuah library muncul begitu file meng-include-nya. Setiap saran diuji kompilasi di setiap board.
  • 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.
  • Beberapa kursor. Ctrl/Cmd+D memilih kata itu lalu kecocokan berikutnya, Alt dan klik menambah kursor, serta Alt dan geser memilih satu kolom.
  • Cari dan ganti, dengan regular expression, go to line, pencocokan dan penutupan kurung, folding, toggle komentar, duplikasi dan memindahkan baris, serta Enter yang memberi indentasi pada baris berikutnya tanpa menyisakan spasi di akhir baris.
  • Auto Format. Ctrl/Cmd+T, seperti di Arduino IDE, atau Ctrl/Cmd+Shift+F memberi indentasi ulang file yang terbuka, dua spasi per level, tanpa mengubah string dan komentar. Di jendela browser biasa Ctrl/Cmd+T justru membuka tab baru, jadi Ctrl/Cmd+Shift+F yang perlu kamu hafal. Lihat detailnya di Pintasan keyboard.
  • Baris panjang terlipat di tepi panel, di bawah indentasinya sendiri, jadi komentar yang panjang tidak pernah mendorong awal kode sampai keluar dari pandangan. Alt+Z mematikan pelipatan, dan editor mengingatnya. Di HP, baris tetap utuh dan kode digeser menyamping dengan ukuran yang pas untuk file itu.
  • Error di kode. Setelah build, setiap error dan peringatan dari compiler diberi garis bawah di barisnya. Arahkan kursor untuk membaca pesannya, tekan F8 untuk menuju yang berikutnya, atau Ctrl/Cmd+Shift+M untuk melihat daftarnya. Build berikutnya menghapus semuanya.

Apa yang terjadi saat kamu menekan Jalankan

Setiap board ditanya satu pertanyaan: apakah ini perlu dibuild? Ada tiga jawabannya.

  • Jalankan image apa adanya. ELF yang diunggah tidak dibuild dari file ini, dan contoh bawaan yang belum disentuh sudah dibuild.
  • Pakai build terakhir. Keputusannya berdasarkan hash dari setiap nama file dan setiap byte di dalamnya, jadi satu ketukan tombol dan satu pembatalan tetap menyimpanmu di posisi yang sama persis.
  • Lakukan build. Kompilasi, lalu jalankan hasilnya.

Build itu sendiri adalah clang sungguhan dan lld sungguhan, dikompilasi ke WebAssembly dan berjalan di Web Worker sehingga build pertama yang memakan empat detik tidak pernah membuat kanvas kehilangan satu frame pun. Tidak ada yang diunggah, tidak ada build server, tidak ada antrean, dan tidak ada hitungan menit build.

Build pertama, dan setiap build setelahnya

Toolchain-nya sekitar tujuh puluh megabita clang, di-stream sekali dari penyimpanan kami sendiri lalu disimpan di cache browser. Build pertama di browser yang baru butuh beberapa detik; kunjungan berikutnya sekitar satu setengah detik, dan setelah itu mengedit lalu menjalankan hanya sekitar dua per sepuluh detik.

Bersamanya datang runtime: C dan C++ freestanding buatan kami sendiri untuk keluarga board itu, dengan header, kode start-up, linker script, dan flag yang sama seperti yang dipakai script build resmi repositorinya. Itulah sebabnya sketch yang meng-include salah satu driver bersama bisa dikompilasi di board mana pun yang memilikinya.

Bahasa Arduino, di setiap board

Runtime-nya milik Mokxi sendiri, tapi mengikuti referensi bahasa Arduino: sketch yang kamu salin dari tutorial memakai panggilan yang sama di sini seperti di board sungguhan.

  • Titik mengambang. Aritmetika float dan double berfungsi di mana saja, dari library floating-point software di runtime, seperti di Uno sungguhan yang chip-nya juga tidak punya hardware floating-point. double berukuran 32 bit di board AVR (Uno, Nano, Mega, Leonardo, ATtiny85), persis seperti di Arduino AVR core, dan 64 bit di sisanya. Serial.print(x, 3) mencetak tiga angka desimal.
  • 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.
  • Membaca Serial. parseInt, parseFloat, readString, readStringUntil, readBytes, find dan setTimeout, serta fungsi serialEvent() yang dipanggil di antara loop() saat ada input masuk.
  • Mengukur durasi pulsa. pulseIn dan pulseInLong mengembalikan panjang pulsa dalam mikrodetik, 0 jika timeout, dan itulah cara membaca HC-SR04. shiftIn dan shiftOut mengeluarkan atau memasukkan satu byte dengan clock.
  • Bunyi. tone(pin, frequency) dan tone(pin, frequency, duration) memainkan gelombang kotak dari interrupt timer tanpa menghentikan sketch, dan noTone(pin) menghentikannya. Di Uno ini memakai timer 2, seperti Arduino core, jadi PWM di pin 3 dan 11 terjeda saat nada berbunyi. Di XIAO dan Uno R4, nada diputar di pin PWM. #include "pitches.h" memberikan nama-nama NOTE_.
  • Library C. sprintf, snprintf, atoi, atof, strtol, strcpy, strcmp, strtok, dtostrf, itoa, malloc dan sejenisnya. Seperti di Uno sungguhan, %f pada sprintf mencetak ? di board AVR; gunakan dtostrf di sana.
  • Karakter. isDigit, isAlpha, isSpace, isUpperCase dan lainnya.
  • std::atomic. #include <atomic> berfungsi di setiap board yang Arduino core aslinya memilikinya: board ESP32 dan ESP8266, board RP2040, board STM32, Uno R4, XIAO SAMD21, dan micro:bit. load, store, fetch_add, compare_exchange, atomic_flag dan semua fence berjalan. Core board AVR tidak punya <atomic>, jadi di Uno, Nano, Mega, Leonardo, atau ATtiny85 build berhenti, seperti di Arduino IDE, dengan baris yang memberi tahu apa yang harus dipakai sebagai gantinya: variabel volatile dengan noInterrupts() dan interrupts() di sekitar kode yang menyentuhnya. ATOMIC_BLOCK dari <util/atomic.h> juga berfungsi di board AVR.

ATtiny85 punya 8 KB flash dan panggilannya hanya menjangkau 4 KB, jadi sketch yang memakai library matematika atau banyak floating point sering kali terlalu besar untuknya, di sini sama seperti di meja kerja.

Arduino libraries that compile as they are

Tempel tutorial dan include-nya langsung jalan: runtime membawa library bawaan yang paling sering dipakai orang, dengan nama yang biasa. Semuanya adalah header buatan Mokxi sendiri, ditulis di atas driver untuk komponen di kotak komponen; tidak ada kode dari library aslinya, dan tiap-tiapnya tetap mendukung pemanggilan yang dipakai tutorial.

Tabel ini hanya library yang paling sering dipakai tutorial, bukan seluruh daftarnya. Ketik #include < di editor untuk melihat semua library yang bisa dikompilasi board yang sedang kamu pakai.

Header Yang dikendalikan Board
Servo.h, ESP32Servo.h servo hobby di pin mana pun semua board yang bisa dikompilasi
Wire.h I2C sebagai master, di pin I2C milik board sendiri atau dua pin mana pun semua board yang bisa dikompilasi
SPI.h SPI di pin SPI milik board sendiri semua board yang bisa dikompilasi
EEPROM.h read, write, update, get, put, EEPROM[i] semua board yang bisa dikompilasi
LiquidCrystal_I2C.h the 16x2 LCD behind its I2C backpack semua board yang bisa dikompilasi
Adafruit_GFX.h, Adafruit_SSD1306.h OLED I2C 128x64 semua kecuali ATtiny85
Adafruit_NeoPixel.h WS2812 strips and panels board AVR, keluarga ESP32, Pico, Uno R4
DHT.h DHT11 dan DHT22 semua board yang bisa dikompilasi
OneWire.h, DallasTemperature.h termometer DS18B20, berapa pun jumlahnya di satu pin semua kecuali ATtiny85
Adafruit_BME280.h, Adafruit_BMP280.h, SparkFunBME280.h sensor tekanan buatan Bosch semua kecuali ATtiny85
RTClib.h jam DS3231 dan DS1307, DateTime dan TimeSpan semua kecuali ATtiny85
Adafruit_INA219.h monitor arus INA219 semua kecuali ATtiny85
Adafruit_ADS1X15.h ADC ADS1115 enam belas bit semua kecuali ATtiny85
Adafruit_MCP23X17.h port expander MCP23017 semua kecuali ATtiny85
SoftwareSerial.h port serial di dua pin biasa, untuk HC-05 atau GPS Uno, Nano, Pro Mini, Mega, Leonardo, Pro Micro, ESP8266, ESP32, ESP32-S3
TinyGPS++.h NMEA dari GPS NEO-6M diuji di Uno, Mega dan NodeMCU

Ketika berbeda dari library aslinya, yang dijelaskan di halaman bantuan tiap komponen:

  • Servo mengirim satu pulsa per write() alih-alih memulsa dari timer. Lebarnya sama dengan library aslinya: attach(pin) adalah 544 sampai 2400 mikrodetik, write(90) adalah 1472, dan attach(pin, min, max) mengatur jendela lain. Default komponen servo sama, 544 sampai 2400.
  • EEPROM adalah EEPROM milik chip sendiri di Uno, Nano, Mega, Leonardo dan ATtiny85, dan 4 KB RAM di board lainnya, yang modelnya tidak punya memori yang bisa ditulis dan bertahan dari reset. Run yang baru selalu mulai dengan isi terhapus, apa pun boardnya.
  • Font tampilan pada display Adafruit GFX adalah font 5x8 buatan Mokxi sendiri, dengan huruf kecil, di sel 6x8 milik library aslinya. setFont() menggambar font yang dibawa sketch apa adanya, dan header Fonts/ adalah huruf buatan Mokxi pada ukuran tiap font, bukan huruf GNU FreeFont.
  • DHT mengembalikan float yang dibangun dari per sepuluh penuh milik sensor. Angkanya bisa dicetak, isnan dan computeHeatIndex berfungsi, begitu juga aritmetika buatanmu sendiri padanya.
  • Wire hanya sebagai master, dan bit-banged, seperti semua bus di sini.
  • SoftwareSerial di board AVR bekerja seperti library Arduino: interupsi perubahan pin dan loop terhitung, satu port mendengarkan pada satu waktu, half duplex, buffer bersama 64 byte. Untuk menerima perlu pin dengan interupsi perubahan pin, yang di Mega adalah 10 sampai 15, 50 sampai 53 dan A8 sampai A15. Di ESP8266, ESP32 dan ESP32-S3 caranya seperti EspSoftwareSerial: tepi sinyal dihitung waktunya lewat interupsi, jadi beberapa port bisa menerima sekaligus. Hanya 8N1. Board lain akan memberi tahu saat kompilasi.
  • Library sensor mengembalikan float dengan cara yang sama seperti DHT, dibangun dari hitungan chip itu sendiri. DEVICE_DISCONNECTED_C bisa dibandingkan dengan hasil baca seperti di tutorial, dan readPressure() / 100.0F dari tutorial tekanan bekerja apa adanya; readPressureHPa() juga tersedia.

Artikel bantuan tiap board menyebutkan pin mana yang dipakai Wire.begin() di board itu.

Menambahkan library

Tiga strip di bawah kode mengurus library, dan menambahkannya gratis di semua paket:

  • Libraries menampilkan library milik project, masing-masing dengan tombol hapus. + Add library menerima .zip dengan tata letak Arduino, atau file .h dan .cpp lepas, dan memberi tahu file mana yang disimpan dan mana yang dilewati, misalnya examples.
  • Arduino Library Manager: semua library, satu ketukan. Tekan Search dan ketik nama, header, atau kata tentangnya. Tiap hasil punya Pasang, yang mengambil library bersama library yang jadi dependensinya. Library yang sudah dibangun Mokxi tertulis Built in, yang sudah ada di project tertulis Terpasang, dan yang tidak mencantumkan board yang sedang kamu sunting akan terpasang dengan peringatan.
  • Library bawaan. Tekan Browse untuk mencari library yang dibawa Mokxi, dengan This board only agar hanya yang bisa dibangun di board-mu. Add #include menaruh header library di bagian atas file yang terbuka (atau memberi tahu kalau sudah ada), dan Details menampilkan header-nya serta Open example.

Sketch yang menyertakan library yang tidak dimiliki project akan berhenti di file not found dari clang. Tab Build lalu menyebutkan header Mokxi yang tugasnya sama, atau menawarkan Pasang untuk library dari Arduino Library Manager, yang memasukkannya ke project lalu membangun ulang.

Python di Pico, ESP32 dan Raspberry Pi

Board-board ini bisa menjalankan Python alih-alih sketch. Pilihannya ada di daftar program di bagian Firmware pada properti board:

  • Raspberry Pi Pico. Pilih MicroPython (main.py) dan tulis main.py. Run menyalakan firmware MicroPython resmi di chip simulasi dan menyalin file .py milikmu ke sana, seperti cara Thonny. print() tampil di Serial Monitor. Pico W melakukan hal yang sama dengan build-nya sendiri, dengan network.WLAN di jaringan simulasi. Lihat the Pico dan the Pico W.
  • board ESP32. Pilihan yang sama mem-boot firmware MicroPython resmi untuk chip tersebut, dengan network.WLAN di jaringan simulasi, di ESP32 klasik (DevKit V1, DevKitC, LOLIN32 Lite), ESP32-S3 (dengan XIAO ESP32-S3 dan Nano ESP32), ESP32-C3 (dengan XIAO ESP32-C3 dan SuperMini) dan ESP32-C6 (dengan XIAO ESP32-C6). ESP8266 tidak punya MicroPython di sini. Lihat MicroPython di ESP32.
  • CircuitPython di Pico, Pico W, Arduino Nano RP2040 Connect dan ESP32-S3. Pilih CircuitPython (code.py) dan tulis code.py. Jalankan mem-boot firmware CircuitPython resmi dan menyimpan code.py ke drive CIRCUITPY di board, bersama library Adafruit yang diimpornya. Lihat CircuitPython di Pico.
  • Raspberry Pi 4, Pi 5 dan Zero 2 W. Board mendapat sebuah main.py, dan Jalankan menjalankannya dengan gpiozero dan RPi.GPIO menggerakkan header. Tidak ada Linux di bawahnya. Lihat the Raspberry Pi.

Tab Build

Di bawah strip file. Ia tidak mengganggu sampai ada sesuatu untuk disampaikan, lalu menampilkan tiga hal: langkah-langkah beserta waktunya, jadi build pertama yang lambat terbaca sebagai kemajuan, bukan macet; diagnostik compiler sebagai baris yang bisa kamu klik untuk langsung menuju file, baris dan kolom yang dikeluhkannya; dan satu kalimat sederhana di akhir, seperti Built esp1.elf, 1.5 KB, 0.21 s.

Satu toolchain untuk semua board

Setiap board dikompilasi di browser dengan toolchain clang yang sama, masing-masing untuk chipnya sendiri: Arduino AVR seperti Uno (avr -mmcu=atmega328p), board ESP32 RISC-V seperti ESP32-C3 (riscv32 -march=rv32imc), dan board Arm seperti Pico (thumbv6m, Cortex-M0+) serta STM32F411 (thumbv7em, Cortex-M4, soft float). Halaman board mendaftar semuanya.

Detail lengkapnya, sampai ke daftar perintah dan cache key, ada di mengompilasi di browser.

Jika build gagal, sketch tidak mau dikompilasi memandu kamu memahami apa yang disampaikan tab Build.