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.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. - Hanya nama yang bisa dikompilasi. Daftarnya dibaca dari header yang benar-benar dipakai compiler untuk board itu, jadi ESP32 menawarkan
ledcAttachsedangkan Uno tidak, dan class dari sebuah library muncul begitu file meng-include-nya. Setiap saran diuji kompilasi di setiap board. - Snippets.
setupwrites bothsetup()andloop();for,if,ifelse,else,switch,whileanddowrite the whole block.Tabmoves to the next blank to fill in. - Beberapa kursor.
Ctrl/Cmd+Dmemilih 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, atauCtrl/Cmd+Shift+Fmemberi indentasi ulang file yang terbuka, dua spasi per level, tanpa mengubah string dan komentar. Di jendela browser biasaCtrl/Cmd+Tjustru membuka tab baru, jadiCtrl/Cmd+Shift+Fyang 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+Zmematikan 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
F8untuk menuju yang berikutnya, atauCtrl/Cmd+Shift+Muntuk 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
floatdandoubleberfungsi di mana saja, dari library floating-point software di runtime, seperti di Uno sungguhan yang chip-nya juga tidak punya hardware floating-point.doubleberukuran 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,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. - Membaca Serial.
parseInt,parseFloat,readString,readStringUntil,readBytes,finddansetTimeout, serta fungsiserialEvent()yang dipanggil di antaraloop()saat ada input masuk. - Mengukur durasi pulsa.
pulseIndanpulseInLongmengembalikan panjang pulsa dalam mikrodetik, 0 jika timeout, dan itulah cara membaca HC-SR04.shiftIndanshiftOutmengeluarkan atau memasukkan satu byte dengan clock. - Bunyi.
tone(pin, frequency)dantone(pin, frequency, duration)memainkan gelombang kotak dari interrupt timer tanpa menghentikan sketch, dannoTone(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-namaNOTE_. - Library C.
sprintf,snprintf,atoi,atof,strtol,strcpy,strcmp,strtok,dtostrf,itoa,mallocdan sejenisnya. Seperti di Uno sungguhan,%fpadasprintfmencetak?di board AVR; gunakandtostrfdi sana. - Karakter.
isDigit,isAlpha,isSpace,isUpperCasedan 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_flagdan 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: variabelvolatiledengannoInterrupts()daninterrupts()di sekitar kode yang menyentuhnya.ATOMIC_BLOCKdari<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, danattach(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 headerFonts/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,
isnandancomputeHeatIndexberfungsi, 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_Cbisa dibandingkan dengan hasil baca seperti di tutorial, danreadPressure() / 100.0Fdari 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
.zipdengan tata letak Arduino, atau file.hdan.cpplepas, 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.pymilikmu ke sana, seperti cara Thonny.print()tampil di Serial Monitor. Pico W melakukan hal yang sama dengan build-nya sendiri, dengannetwork.WLANdi jaringan simulasi. Lihat the Pico dan the Pico W. - board ESP32. Pilihan yang sama mem-boot firmware MicroPython resmi untuk chip tersebut, dengan
network.WLANdi 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 menyimpancode.pyke 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 dengangpiozerodanRPi.GPIOmenggerakkan 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.