Mỗi bo mạch một dự án
Khung bên phải là một trạm làm việc, không phải hộp nhập văn bản. Mỗi bo mạch trong sơ đồ được lập trình riêng và có file của chính nó: một sketch, cùng các header và mã nguồn thêm mà bạn đưa vào, đúng như một dự án thật. Ô chọn bo mạch ở trên cùng chọn bo mạch bạn đang xem; dải file bên dưới có các tab, cùng các nút thêm, đổi tên và xóa file.
File đi cùng sơ đồ. Chúng được lưu cạnh sơ đồ theo id của bo mạch, xuất và nhập cùng nó, và bị xóa cùng bo mạch.
Sơ đồ không có bo mạch nào vẫn có một sketch, để bạn viết code trước khi quyết định bo mạch nào sẽ chạy nó. Tên file có thể chứa chữ, số, _, . và -, và file nào kết thúc bằng .ino, .c, .cpp, .cc, .h, .hpp hoặc .hh đều được tô màu C++.
Ẩn khung code
Khi khung vẽ và code nằm cạnh nhau, nút ở đầu bên phải của thanh tiêu đề khung code sẽ gập code lại và khung vẽ chiếm toàn bộ chiều rộng. Một thanh Code mỏng vẫn nằm ở mép phải khung vẽ: nhấn vào để đưa code trở lại với chiều rộng cũ. Ctrl+\ (Cmd+\ trên Mac) làm cả hai việc, bất kể tiêu điểm ở đâu, kể cả trong code.
Trình duyệt ghi nhớ lựa chọn, nên code giữ nguyên trạng thái gập lần sau bạn mở trình soạn thảo. Trên cửa sổ hẹp hơn, khi khung vẽ và code xếp chồng nhau, và trên điện thoại, khung code giữ nguyên vị trí.
Tab hợp ngữ
Tab kết thúc bằng .S hoặc .s là hợp ngữ, và được biên dịch, liên kết cùng các tab .ino và .cpp của cùng bo mạch, như Arduino IDE biên dịch file nằm cạnh sketch. File .S đi qua bộ tiền xử lý C trước, nên #include <avr/io.h> và #define dùng được trong đó; file .s được hợp dịch đúng như viết. C và hợp ngữ gọi nhau qua extern "C", và tab hợp ngữ có tô màu riêng cùng đường breakpoint như sketch.
Một bo mạch cũng có thể là cả một dự án hợp ngữ thuần không dùng Arduino core: chọn bản khởi đầu dưới Assembly (no Arduino) trong mục Firmware của thuộc tính bo mạch, trên Uno, Nano, Pro Mini, Pico hoặc STM32F411 Black Pill. Viết hợp ngữ bao quát cả hai, quy ước gọi hàm, avr/io.h trong file .S, inline asm volatile và ý nghĩa của các lỗi.
Writing code
Khung code soạn thảo như một trình soạn code trên máy tính, đặc biệt là Sublime Text, và các phím chính là những phím người dùng đã quen dùng. Tất cả được liệt kê trong Phím tắt.
- 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. - Chỉ những tên biên dịch được. Danh sách được đọc từ chính các tệp header mà trình biên dịch dùng cho bo mạch đó, nên ESP32 có
ledcAttachcòn Uno thì không, và các lớp của một thư viện chỉ xuất hiện khi tệp đã include nó. Mỗi gợi ý đều được biên dịch thử trên mọi bo mạch. - Snippets.
setupwrites bothsetup()andloop();for,if,ifelse,else,switch,whileanddowrite the whole block.Tabmoves to the next blank to fill in. - Nhiều con trỏ cùng lúc.
Ctrl/Cmd+Dchọn từ đó rồi các từ giống tiếp theo, Alt cùng một cú nhấp chuột thêm một con trỏ, còn Alt cùng kéo chuột chọn cả một cột. - Tìm và thay thế, kèm biểu thức chính quy, nhảy tới dòng, khớp và đóng ngoặc, gập đoạn mã, bật tắt chú thích, nhân đôi và di chuyển dòng, và phím Enter tự thụt lề dòng tiếp theo mà không để lại dấu cách thừa ở cuối.
- Tự động định dạng.
Ctrl/Cmd+T, như trong Arduino IDE, hoặcCtrl/Cmd+Shift+Fthụt lề lại tệp đang mở, mỗi cấp hai dấu cách, và không đụng vào chuỗi cũng như chú thích. Trong cửa sổ trình duyệt thông thường,Ctrl/Cmd+Tmở tab mới thay vào đó, nênCtrl/Cmd+Shift+Fmới là phím nên nhớ. Xem chi tiết ở Phím tắt. - Dòng dài tự động ngắt xuống ở mép khung, thụt theo đúng lề của nó, nên một chú thích dài không bao giờ đẩy phần đầu code ra khỏi tầm mắt.
Alt+Ztắt tính năng ngắt dòng, và trình soạn code ghi nhớ lựa chọn đó. Trên điện thoại, dòng giữ nguyên vẹn và code trượt ngang ở cỡ vừa với tệp. - Lỗi trong code. Sau mỗi lần build, mọi lỗi và cảnh báo của trình biên dịch đều được gạch chân ngay trên dòng của nó. Di chuột lên để đọc thông báo, nhấn
F8để đi tới lỗi kế tiếp, hoặcCtrl/Cmd+Shift+Mđể xem danh sách. Lần build sau sẽ xóa chúng.
Điều gì xảy ra khi bạn nhấn Chạy
Mỗi bo mạch được hỏi một câu: cái này có cần build không? Có ba câu trả lời.
- Chạy luôn tệp ảnh. Một ELF đã tải lên không được build từ các tệp này, còn một ví dụ có sẵn chưa đụng đến thì đã build sẵn rồi.
- Dùng lại lần build trước. Quyết định dựa trên hash của mọi tên tệp và mọi byte trong đó, nên một phím gõ rồi một lần hoàn tác đưa bạn về đúng chỗ cũ.
- Build nó. Biên dịch, rồi chạy kết quả.
Bản thân lần build là một clang thật và một lld thật, biên dịch sang WebAssembly và chạy trong một Web Worker, nên lần build đầu tiên kéo dài bốn giây cũng không làm khung vẽ mất một khung hình nào. Không có gì được tải lên máy chủ, không có máy chủ build, không có hàng chờ và không tính phút build.
Lần build đầu tiên, và mọi lần sau đó
Bộ công cụ khoảng bảy mươi megabyte clang, được truyền về một lần từ kho của chúng tôi rồi giữ trong bộ nhớ đệm của trình duyệt. Lần build đầu trong một trình duyệt mới mất vài giây; quay lại lần sau khoảng một giây rưỡi, và sửa rồi chạy sau đó nữa thì khoảng hai phần mười giây.
Cùng với nó là phần chạy: C và C++ freestanding do chính chúng tôi viết cho dòng bo mạch đó, với cùng các tệp header, mã khởi động, linker script và cờ như script build của chính kho mã dùng. Đó là lý do một sketch include một trình điều khiển dùng chung thì biên dịch được trên bất kỳ bo mạch nào có nó.
Ngôn ngữ Arduino, trên mọi bo mạch
Phần chạy là của Mokxi, nhưng nó nói đúng ngôn ngữ trong tài liệu tham khảo Arduino: một sketch chép từ một bài hướng dẫn dùng y hệt các hàm ở đây như trên bo mạch thật.
- Số thực dấu phẩy động. Phép tính với
floatvàdoublehoạt động ở mọi nơi, nhờ một thư viện dấu phẩy động bằng phần mềm trong runtime, giống như trên Uno thật, vì chip đó cũng không có phần cứng dấu phẩy động.doubledài 32 bit trên các bo AVR (Uno, Nano, Mega, Leonardo, ATtiny85), y như trong Arduino AVR core, và 64 bit trên các bo còn lại.Serial.print(x, 3)in ba chữ số phần thập phân. - 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. - Đọc Serial.
parseInt,parseFloat,readString,readStringUntil,readBytes,findvàsetTimeout, và một hàmserialEvent()được gọi giữa hailoop()khi có dữ liệu vào. - Đo thời gian xung.
pulseInvàpulseInLongtrả về độ dài xung theo microgiây, 0 nếu hết thời gian chờ, đó là cách đọc một HC-SR04.shiftInvàshiftOuttruyền một byte vào hoặc ra theo xung clock. - Âm thanh.
tone(pin, frequency)vàtone(pin, frequency, duration)phát một sóng vuông từ ngắt timer mà không làm dừng sketch, cònnoTone(pin)dừng nó lại. Trên Uno nó chiếm timer 2, giống như Arduino core, nên PWM trên chân 3 và chân 11 tạm dừng khi một nốt đang phát. Trên XIAO và Uno R4, nốt nhạc phát trên các chân PWM.#include "pitches.h"cung cấp các tênNOTE_. - Thư viện C.
sprintf,snprintf,atoi,atof,strtol,strcpy,strcmp,strtok,dtostrf,itoa,mallocvà các hàm tương tự. Như trên một Uno thật,%ftrongsprintfin ra?trên các bo mạch AVR; hãy dùngdtostrfở đó. - Ký tự.
isDigit,isAlpha,isSpace,isUpperCasevà các hàm còn lại. std::atomic.#include <atomic>chạy được trên mọi bo mạch mà Arduino core thật của nó có: các bo mạch ESP32 và ESP8266, các bo mạch RP2040, các bo mạch STM32, Uno R4, XIAO SAMD21 và micro:bit.load,store,fetch_add,compare_exchange,atomic_flagvà các fence đều chạy. Core của các bo AVR không có<atomic>, nên trên Uno, Nano, Mega, Leonardo hay ATtiny85 thì lần biên dịch dừng lại, như trong Arduino IDE, kèm một dòng nói rõ dùng gì thay thế: một biếnvolatilevớinoInterrupts()vàinterrupts()bao quanh đoạn code chạm đến nó.ATOMIC_BLOCKtừ<util/atomic.h>cũng chạy được trên các bo AVR.
ATtiny85 có 8 KB flash và các lời gọi của nó chỉ với tới 4 KB, nên một sketch kéo theo thư viện toán học hay nhiều phép tính dấu phẩy động thường là quá tải cho nó, ở đây cũng như trên bàn thí nghiệm.
Arduino libraries that compile as they are
Dán vào một bài hướng dẫn là các include của nó chạy được ngay: phần mềm mô phỏng mang theo sẵn những thư viện thông dụng nhất, dưới đúng tên quen thuộc. Mỗi thư viện là header riêng của Mokxi, được viết trên các trình điều khiển của linh kiện trong hộp; không dùng code của thư viện gốc, và giữ nguyên các lệnh mà bài hướng dẫn hay dùng.
Bảng dưới đây chỉ liệt kê những thư viện được dùng nhiều nhất, không phải toàn bộ. Gõ #include < trong trình soạn code để xem mọi thư viện mà bo mạch bạn đang dùng có thể biên dịch.
| Header | Điều khiển gì | Bo mạch |
|---|---|---|
Servo.h, ESP32Servo.h |
một servo trên bất kỳ chân nào | mọi bo mạch đều biên dịch được |
Wire.h |
I2C ở chế độ master, trên các chân I2C sẵn có của bo mạch hoặc bất kỳ hai chân nào | mọi bo mạch đều biên dịch được |
SPI.h |
SPI trên các chân SPI sẵn có của bo mạch | mọi bo mạch đều biên dịch được |
EEPROM.h |
read, write, update, get, put, EEPROM[i] |
mọi bo mạch đều biên dịch được |
LiquidCrystal_I2C.h |
the 16x2 LCD behind its I2C backpack | mọi bo mạch đều biên dịch được |
Adafruit_GFX.h, Adafruit_SSD1306.h |
màn hình OLED I2C 128x64 | mọi bo mạch trừ ATtiny85 |
Adafruit_NeoPixel.h |
WS2812 strips and panels | các bo mạch AVR, họ ESP32, Pico, Uno R4 |
DHT.h |
DHT11 và DHT22 | mọi bo mạch đều biên dịch được |
OneWire.h, DallasTemperature.h |
các nhiệt kế DS18B20, số lượng bất kỳ trên một chân | mọi bo mạch trừ ATtiny85 |
Adafruit_BME280.h, Adafruit_BMP280.h, SparkFunBME280.h |
các cảm biến áp suất của Bosch | mọi bo mạch trừ ATtiny85 |
RTClib.h |
đồng hồ DS3231 và DS1307, DateTime và TimeSpan |
mọi bo mạch trừ ATtiny85 |
Adafruit_INA219.h |
bộ đo dòng INA219 | mọi bo mạch trừ ATtiny85 |
Adafruit_ADS1X15.h |
ADC 16 bit ADS1115 | mọi bo mạch trừ ATtiny85 |
Adafruit_MCP23X17.h |
bộ mở rộng cổng MCP23017 | mọi bo mạch trừ ATtiny85 |
SoftwareSerial.h |
một cổng serial trên hai chân thường, cho HC-05 hoặc một thiết bị GPS | Uno, Nano, Pro Mini, Mega, Leonardo, Pro Micro, ESP8266, ESP32, ESP32-S3 |
TinyGPS++.h |
NMEA từ GPS NEO-6M | đã thử trên Uno, Mega và NodeMCU |
Những chỗ khác với thư viện gốc, được nêu rõ trong trang hướng dẫn của từng linh kiện:
- Servo gửi một xung cho mỗi lần
write()thay vì tạo xung từ timer. Độ rộng xung giống thư viện gốc:attach(pin)là 544 đến 2400 microgiây,write(90)là 1472, vàattach(pin, min, max)đặt khoảng khác. Giá trị mặc định của linh kiện servo cũng là 544 đến 2400. - EEPROM là EEPROM sẵn của chip trên Uno, Nano, Mega, Leonardo và ATtiny85, và là 4 KB RAM trên mọi bo mạch khác, vốn không có vùng ghi được nào tồn tại qua lần reset. Bất kể thế nào, mỗi lần Run mới đều bắt đầu với dữ liệu bị xóa.
- Font hiển thị của các màn hình Adafruit GFX là font 5x8 riêng của Mokxi, có chữ thường, nằm trong ô 6x8 như thư viện gốc.
setFont()vẽ đúng y nguyên một font mà sketch mang theo, còn các header trongFonts/là các chữ cái của Mokxi với kích thước của từng font, không phải các phông GNU FreeFont. - DHT trả về các số float dựng từ từng phần mười của cảm biến. Chúng in ra được,
isnanvàcomputeHeatIndexchạy tốt, và bạn cũng có thể tự tính toán trên chúng. - Wire chỉ chạy ở chế độ master, và được mô phỏng bằng phần mềm, như mọi bus ở đây.
- SoftwareSerial trên các bo mạch AVR hoạt động như thư viện Arduino: ngắt thay đổi chân và vòng đếm, mỗi lần một cổng nghe, bán song công, bộ đệm 64 byte dùng chung. Nhận tín hiệu cần một chân có ngắt thay đổi chân, trên Mega là 10 đến 15, 50 đến 53 và A8 đến A15. Trên ESP8266, ESP32 và ESP32-S3 thì theo kiểu EspSoftwareSerial: các cạnh được đo bằng ngắt, nên nhiều cổng nhận cùng lúc. Chỉ hỗ trợ 8N1. Bo mạch nào khác sẽ báo ngay lúc biên dịch.
- Các thư viện cảm biến trả về số float giống DHT, dựng từ chính số đếm của chip.
DEVICE_DISCONNECTED_Cso sánh với một giá trị đo như các bài hướng dẫn vẫn làm, và cách viếtreadPressure() / 100.0Ftrong các bài về áp suất chạy đúng như vậy;readPressureHPa()cũng có sẵn.
Bài hướng dẫn của từng bo mạch ghi rõ Wire.begin() dùng những chân nào.
Thêm một thư viện
Ba dải bên dưới code lo việc thư viện, và thêm thư viện là miễn phí trên mọi gói:
- Libraries liệt kê các thư viện riêng của dự án, mỗi cái có nút xóa. + Add library nhận tệp
.ziptheo bố cục Arduino, hoặc các tệp.hvà.cpprời, và báo tệp nào được giữ, tệp nào bị bỏ, ví dụ như examples. - Arduino Library Manager: mọi thư viện, chỉ một lần chạm. Nhấn Search và gõ tên, tên header hoặc một từ liên quan. Mỗi kết quả có nút Install, sẽ tải về cả các thư viện mà nó phụ thuộc. Thư viện mà Mokxi đã xây sẵn ghi Built in, thư viện có trong dự án ghi Installed, thư viện không liệt kê bo mạch bạn đang soạn thảo sẽ cài kèm cảnh báo.
- Thư viện có sẵn. Bấm Duyệt để tìm trong các thư viện mà Mokxi mang theo, dùng Chỉ bo mạch này để chỉ giữ những thư viện dựng được trên bo bạn đang dùng. Thêm #include đặt header của thư viện lên đầu tệp đang mở (hoặc báo là đã có sẵn), còn Chi tiết hiển thị các header của nó và nút Mở ví dụ.
Một sketch include thư viện mà dự án chưa có sẽ dừng ở lỗi file not found của clang. Khi đó bảng Build nêu tên header của Mokxi làm cùng việc đó, hoặc đưa nút Install để cài thư viện từ Arduino Library Manager, thư viện sẽ vào dự án và biên dịch lại.
Python trên Pico, ESP32 và Raspberry Pi
Các bo mạch này có thể chạy Python thay cho sketch. Cách chọn nằm trong danh sách program ở phần Firmware của thuộc tính bo mạch:
- Raspberry Pi Pico. Chọn MicroPython (main.py) và viết
main.py. Run khởi động firmware MicroPython chính thức trên chip được mô phỏng và sao chép các tệp.pycủa bạn lên đó, giống cách Thonny làm.print()hiện trong Serial Monitor. Pico W cũng làm vậy với bản dựng riêng của nó, vớinetwork.WLANtrên mạng được mô phỏng. Xem Pico và Pico W. - các bo mạch ESP32. Cùng lựa chọn đó sẽ khởi động firmware MicroPython chính thức cho chip, kèm
network.WLANtrên mạng được mô phỏng, trên ESP32 kinh điển (DevKit V1, DevKitC, LOLIN32 Lite), ESP32-S3 (kèm XIAO ESP32-S3 và Nano ESP32), ESP32-C3 (kèm XIAO ESP32-C3 và SuperMini) và ESP32-C6 (kèm XIAO ESP32-C6). ESP8266 không có MicroPython ở đây. Xem MicroPython trên ESP32. - CircuitPython trên Pico, Pico W, Arduino Nano RP2040 Connect và ESP32-S3. Chọn CircuitPython (code.py) và viết
code.py. Chạy sẽ khởi động firmware CircuitPython chính thức và lưucode.pyvào ổ CIRCUITPY của bo mạch, kèm các thư viện Adafruit mà nó nhập vào. Xem CircuitPython trên Pico. - Raspberry Pi 4, Pi 5 và Zero 2 W. Bo mạch nhận một
main.py, và Chạy khởi động nó vớigpiozerovàRPi.GPIOđiều khiển header. Không có Linux bên dưới. Xem Raspberry Pi.
Tab Biên dịch
Nằm dưới dải tệp. Nó giữ mình khỏi lối đi cho tới khi có điều gì cần nói, rồi hiện ba thứ: các bước kèm thời gian, để lần biên dịch đầu chậm vẫn đọc như đang tiến triển chứ không phải bị treo; các chẩn đoán của trình biên dịch thành từng dòng bạn có thể bấm để nhảy tới tệp, dòng và cột mà nó đang than phiền; và một câu đơn giản ở cuối, ví dụ Built esp1.elf, 1.5 KB, 0.21 s.
Mọi bo mạch, một bộ công cụ
Mọi bo mạch đều biên dịch trong trình duyệt trên cùng bộ công cụ clang, mỗi bo cho chip riêng của nó: các Arduino AVR như Uno (avr -mmcu=atmega328p), các bo ESP32 RISC-V như ESP32-C3 (riscv32 -march=rv32imc), và các bo Arm như Pico (thumbv6m, Cortex-M0+) và STM32F411 (thumbv7em, Cortex-M4, soft float). Trang bo mạch liệt kê tất cả.
Chi tiết đầy đủ, đến mức danh sách lệnh và khóa bộ nhớ đệm, nằm trong biên dịch trong trình duyệt.
Nếu biên dịch thất bại, sketch không biên dịch được sẽ dắt bạn đi qua những gì tab Biên dịch đang nói.