Khắc phục sự cố

Sketch không biên dịch được

Cách đọc tab Build, và năm nguyên nhân thường gặp.

Bạn thấy gì: tab Build

Nó nằm dưới dải tệp trong khung code. Tab liệt kê các bước kèm thời gian, sau đó là kết quả của chính trình biên dịch thành từng dòng có thể nhấp. Nhấp vào một dòng, trình soạn code sẽ nhảy tới tệp, dòng và cột đó.

Các chẩn đoán là chẩn đoán clang thật, không chỉnh sửa. Một vị trí trong sketch của bạn là một vị trí trong sketch của bạn: tệp được biên dịch dưới chính tên của nó, nên số dòng là của bạn chứ không phải của một lớp bọc nào.

Lỗi linker không có vị trí. ld.lld: error: undefined symbol: loop() hiện thành một dòng không nhảy được, vì chẳng có chỗ nào để nhảy tới.

1. Thiếu include

Lỗi phổ biến nhất, và nó có triệu chứng riêng: clang dừng hẳn khi thiếu header. Bảng biên dịch xem đó là biên dịch thất bại và hiển thị chẩn đoán thay vì báo crash, nên hãy tìm dòng file not found.

Chỉ có header của chính dự án, thư viện của nó và của runtime là có mặt. Bản thân quá trình biên dịch không có mạng: một thư viện phải nằm trong dự án trước khi biên dịch bắt đầu, nếu không thì hoàn toàn không có.

The runtime's own include the stock libraries tutorials use most, under their usual names: Servo.h, Wire.h, SPI.h, EEPROM.h, LiquidCrystal_I2C.h, Adafruit_GFX.h, Adafruit_SSD1306.h, Adafruit_NeoPixel.h, DHT.h, SoftwareSerial.h and TinyGPS++.h (danh sách, và mỗi thư viện bao gồm những gì). Một header viết sai hoa thường, như các sketch viết trên Windows hay Mac thường gặp (servo.h, liquidcrystal_i2c.h), is read as the one Mokxi has. For any other library the Build tab names the Mokxi header that does the same job, or offers Install with the library's name: one tap fetches it from the Arduino Library Manager, with the libraries it depends on, puts it in the project and builds again. The Arduino Library Manager search under the code finds any library in the official index by name, header or what it does. A library that does not list your board installs with a warning, and you can still try it. Your own files go in with Add library.

2. Một hàm không có trong runtime này

Runtime là của chúng tôi: C và C++ freestanding với API của tài liệu tham khảo ngôn ngữ Arduino. Nó có pinMode, digitalWrite, digitalRead, analogWrite, analogRead, millis, micros, delay, delayMicroseconds, pulseIn, shiftIn, shiftOut, tone, noTone, attachInterrupt, Serial bằng parseInt và readStringUntil, String, dấu phẩy động và thư viện toán, các hàm kiểm tra ký tự, và sprintf với phần còn lại mà các bài hướng dẫn về thư viện C dùng, cộng với các trình điều khiển dùng chung cho màn hình và dải WS2812 (danh sách).

Nó không phải là avr-libc, không phải Arduino core và cũng không phải ESP-IDF, và không cái nào trong số đó được tải về lúc biên dịch. Một lời gọi hàm chạy được trên Arduino thật vẫn có thể không tồn tại ở đây (analogRead trên một bo mạch mà bộ chuyển đổi của nó chưa được mô phỏng, chẳng hạn), và phần biên dịch sẽ nói rõ điều đó.

3. File sai là file main

Một dự án có nhiều file và một trong số đó là nơi trình biên dịch bắt đầu. Nếu bạn đã đổi tên sketch, hãy kiểm tra xem file mà bạn muốn làm điểm khởi đầu có còn là điểm khởi đầu không.

4. Biên dịch được rồi, nhưng nút Chạy lại chạy cái khác

Có ba điều có thể xảy ra khi bạn nhấn Chạy, và chỉ một trong số đó là biên dịch:

  • bo mạch chạy một ví dụ có sẵn hoặc một ELF đã tải lên, và không có gì được biên dịch;
  • bo mạch dùng lại bản biên dịch gần nhất, vì không một byte nào của các file thay đổi;
  • bo mạch được biên dịch.

Một ELF bạn tải lên không được biên dịch từ các file này, nên nó được ưu tiên: mục program của bo mạch trong bảng thuộc tính hiển thị Uploaded ELF khi nó còn đó. Nếu trình mô phỏng từ chối nó, thông báo sẽ gợi ý Dùng code thay thế, đưa bo mạch quay lại dùng code trong trình soạn thảo.

5. Biên dịch được trong Arduino IDE, nhưng không ở đây

Hai điều Arduino IDE làm cho một sketch thì Mokxi cũng làm, nên sketch sao chép từ một bài hướng dẫn sẽ không vấp phải chúng.

  • Hàm có thể được gọi trước khi định nghĩa. Arduino IDE viết sẵn một nguyên mẫu (prototype) cho mọi hàm trong các tab .ino trước khi biên dịch, và Mokxi cũng vậy, nên loop() có thể gọi một hàm được định nghĩa ở dưới. Nhiều tab .ino được nối thành một file, tab chính đứng trước, giống như IDE nối chúng. Một hàm mẫu (template) có nguyên mẫu kèm dòng template <typename T> phía trước, như IDE vẫn viết. Một vài hàm không có nguyên mẫu: hàm nằm trong class hoặc namespace, template có đối số mẫu mặc định, và hàm có kiểu tham số được khai báo ở dưới trong sketch. Với những hàm đó, lời gọi ở trên phần định nghĩa sẽ bị lỗi use of undeclared identifier, và tab Build cho biết hàm nằm ở dòng nào: hãy di chuyển hàm, hoặc kiểu mà nó dùng, lên trên phần code gọi nó, hoặc đặt một nguyên mẫu một dòng như void blinkTwice(); ở đầu file.
  • Cảnh báo không làm dừng bản biên dịch. Các file của bạn được biên dịch với -Wall -Wextra, và tab Build liệt kê những gì chúng tìm thấy, nhưng sketch vẫn được biên dịch và chạy, như trong IDE. Một biến hoặc tham số không dùng đến, hay một phép so sánh signed với unsigned (int i < sizeof(pins)), có thể để sau. if (x = HIGH) thì đáng sửa: một dấu = duy nhất là gán giá trị, nên điều kiện luôn đúng, trong khi bạn muốn ==.

Phần còn lại thường là một thư viện mà Mokxi không có, hoặc một hàm bị runtime của bo mạch đó bỏ qua: xem mục 1 và 2 ở trên.

Lỗi biên dịch bằng lời đơn giản đi qua từng thông báo thường gặp, còn Giải thích lỗi biên dịch Arduino có chúng bằng cả lời của GCC lẫn clang.

Nếu lần biên dịch đầu tiên cứ giật mãi

Nó không bị treo, mà đang tải về. Bộ công cụ gồm khoảng bảy mươi megabyte clang và được tải về một lần, sau đó nằm trong bộ nhớ đệm của trình duyệt. Các bước trong tab Build cho biết nó đang ở đâu. Quay lại lần sau mất khoảng một giây rưỡi, còn chỉnh sửa rồi chạy sau đó chỉ mất một phần nhỏ giây. Nếu tải về thất bại, xem trình soạn thảo hoặc trình biên dịch sẽ không tải được.

Vẫn chưa giải quyết được

Biên dịch trong trình duyệt là bản mô tả đầy đủ: danh sách lệnh, khóa bộ nhớ đệm và cách runtime được ghép lại. Hoặc viết thư cho chúng tôi qua /support kèm thông tin chẩn đoán.