Khắc phục sự cố

Nạp vào bo mạch thật bị lỗi

Ý nghĩa của từng thông báo trong thẻ Nạp vào bo mạch, và việc cần thử.

Những gì bạn thấy

Gửi vào bo mạch mở một thẻ cho bo mạch trong dự án của bạn. Thẻ nào tùy thuộc vào bo mạch:

  • Nạp vào bo mạch, với Uno, Nano, Pro Mini, Mega, Leonardo, Micro hoặc Pro Micro: bấm Nạp, chọn cổng, và Mokxi sẽ ghi sketch qua USB từ Chrome hoặc Edge.
  • Nạp vào bo mạch, với ESP32-C3 DevKitM-1, XIAO ESP32-C3 hoặc ESP32-C3 SuperMini: cũng tương tự, qua bộ nạp riêng của chip.
  • Tải xuống cho bo mạch của bạn, với Raspberry Pi Pico, Pico W, XIAO RP2040, RP2040-Zero, Nano RP2040 Connect, XIAO SAMD21 hoặc micro:bit V2: Mokxi biên dịch ra tệp .uf2 hoặc .hex, và bạn kéo nó vào ổ đĩa mà bo mạch hiển thị.
  • Đưa lên bo mạch của bạn, với mọi bo mạch khác: các bước dùng Arduino IDE. Với bo ESP32, ESP32-S3, ESP32-C6 hoặc ESP8266, nó còn có Kiểm tra kết nối, cho biết tên chip trên cổng.

Mọi thẻ có nút Nạp đều có Kiểm tra kết nối (không ghi gì), và sau mỗi lần thử có Log nạp thu gọn với mọi byte đã gửi và nhận. Sao chép log rồi dán vào báo cáo của bạn: nó nói rõ hơn thông báo lỗi.

While it works the card shows what it is doing, and a message in place of Done. Your sketch is running on the board. when it stops. Find it below. How the cards work is in gửi chương trình vào bo mạch thật. Nạp và các tệp tải xuống thuộc gói Pro; các bước dùng Arduino IDE vẫn miễn phí trên mọi gói.

Không có nút Nạp, hoặc thẻ chỉ cho tải xuống

Safari, Firefox, và mọi trình duyệt trên iPad hoặc iPhone không có cách nào kết nối bo mạch qua USB. Mở dự án trong Chrome hoặc Edge trên máy tính hoặc Chromebook, hoặc bấm Tải .hex (hoặc .bin) và hoàn tất bằng Arduino IDE hoặc lệnh avrdude hay esptool mà thẻ hiển thị.

"Trang này không được phép dùng cổng serial" nghĩa là trang nằm trong thứ gì đó chặn nó, ví dụ khung của trang web khác. Mở Mokxi trong tab Chrome hoặc Edge riêng của nó.

ATtiny85, hoặc ATmega328P trên breadboard, không có bộ nạp USB. Thẻ sẽ hướng dẫn cách ghi bằng thiết bị lập trình.

Bo mạch không có trong danh sách cổng

"Chưa chọn cổng nào" nghĩa là danh sách đã đóng mà không chọn gì. Mở Bo mạch không có trong danh sách? trong thẻ, kiểm tra các điều sau, rồi bấm Thử lại:

  • Thử dây cáp khác. Nhiều cáp chỉ sạc điện: bo mạch sáng đèn nhưng không có cổng nào xuất hiện.
  • Cài driver. Nhìn con chip nhỏ cạnh ổ cắm USB. Chip CH340 hoặc CH341 (đa số bản nhái) hoặc CP2102 cần driver trên Windows và macOS; thẻ có liên kết tới driver. Linux và ChromeOS đã có sẵn.
  • Đóng mọi thứ khác đang dùng cổng: Serial Monitor hoặc Serial Plotter của Arduino IDE, PlatformIO, hoặc tab Mokxi khác đang mở.
  • Trên Chromebook của trường, bộ phận CNTT có thể đã tắt USB cho các trang web. Nhờ họ cho phép với mokxi.com, hoặc dùng bản tải xuống.
  • Trên Leonardo, Micro hoặc Pro Micro, bấm reset hai lần liên tiếp (trên Pro Micro, chạm RST vào GND hai lần), rồi bấm Bo mạch của tôi đang chờ và chọn nó trong vài giây.
  • Trên ESP32-C3, giữ BOOT khi cắm vào. XIAO hoặc SuperMini hiển thị là "USB JTAG/serial debug unit" và không cần driver.

"Cổng này đang được dùng"

Chỉ một chương trình có thể giữ một cổng. Đóng serial monitor của Arduino IDE, và mọi thứ khác đang dùng bo mạch, rồi thử lại. Trên Linux, nếu không có gì khác mở cổng, tài khoản của bạn có thể cần thuộc nhóm dialout: thông báo có kèm lệnh.

"Không tìm thấy bo mạch" hoặc "Không bo mạch nào phản hồi trên cổng này"

Cổng đã mở, nhưng không có bootloader nào trả lời. Thông báo kết thúc bằng "Press Test connection to find out what is on this port." Hãy làm vậy: tính năng đó thử từng bootloader mà Mokxi hỗ trợ và cho biết cái nào trả lời. Nếu không, hãy kiểm tra rằng:

  • bo mạch bạn chọn trong Mokxi chính là bo mạch đang nối với dây cáp;
  • dây cáp truyền được dữ liệu;
  • bạn đã chọn đúng cổng.

Trên một bản Nano clone, chọn Arduino Nano (old bootloader) trong danh sách Bo mạch của thẻ và thử lại. Trên ESP32-C3, giữ BOOT, nhấn RESET, nhả BOOT ra, rồi bấm Nạp lại.

"Không có bootloader nào trả lời trên cổng này, ở mọi tốc độ"

Test connection đã hỏi mọi bootloader mà không cái nào trả lời. Hãy kiểm tra dây cáp (một số loại chỉ sạc được), cổng, và xem có chương trình nào khác đang giữ cổng không. Trên bo mạch ESP, giữ BOOT, nhấn RESET, nhả BOOT ra rồi kiểm tra lại. Một Leonardo, Micro hoặc Pro Micro cần được nhấn nút reset hai lần trước, sau đó bấm Bo mạch của tôi đang chờ.

"Found ..., but the project is for ..."

Test connection đã tìm thấy một bo mạch, nhưng đó không phải bo mạch trong dự án của bạn. Thông báo nêu rõ nó tìm thấy gì (chip, chữ ký hoặc chip id của nó, và bootloader của nó) và bo mạch cần chọn trong Mokxi: "Found an ATmega2560 (signature 1E 98 01), the chip in the Arduino Mega 2560, ... but the project is for the Arduino Uno, which has an ATmega328P. Pick the Arduino Mega 2560 in Mokxi, or plug in the Arduino Uno." Hãy chọn bo mạch đó, hoặc cắm đúng bo mạch, rồi kiểm tra lại.

"The chip is right, but its bootloader answers at 57600 baud, not 115200" nghĩa là một bản Nano clone với bootloader cũ: thẻ sẽ tự chuyển danh sách Bo mạch của nó sang Arduino Nano (old bootloader) cho bạn. Bấm Nạp.

"This board has an ..., not the ..." hoặc "This is an ..., but the project is for an ..."

Việc nạp đã đến được bootloader, nhưng chip không phải loại mà sketch được biên dịch cho: "This board has an ATmega2560 (signature 1E 98 01), the chip in the Arduino Mega 2560, not the ATmega328P an Uno or a Nano has. Pick the Arduino Mega 2560 in Mokxi and try again." hoặc "This is an ESP32-S3, but the project is for an ESP32-C3. Pick an ESP32-S3 board (...) in Mokxi and try again, or plug in the ESP32-C3." Chưa có gì được ghi cả. Hãy chọn đúng bo mạch bạn đang có trong Mokxi, rồi nạp lại.

"Test stopped. Nothing was written to the board."

Bạn đã bấm Dừng trong lúc Test connection đang chạy. Bo mạch không thay đổi gì.

Quá trình dừng giữa chừng

"The board stopped answering partway through", "answered something unexpected", "answered once and then went quiet", "Writing stopped at byte ...", "The board stopped taking data" và "The board was disconnected" đều có nghĩa là cuộc giao tiếp bị đứt quãng. Rút bo mạch ra, cắm lại, rồi thử lại. Nguyên nhân thường gặp là dây cáp lỏng hoặc đang dùng USB hub. Trên ESP32-C3, giữ BOOT, nhấn RESET và nhả BOOT ra trước.

"The board read back something different"

Những gì bo mạch đọc lại không khớp với những gì đã gửi. Hãy thử lại, và nếu vẫn tiếp diễn, thử dây cáp khác. Trên bo mạch AVR cũ, flash của chip có thể đã bị mòn.

"Upload stopped"

Bạn đã bấm Dừng. Bootloader của bo mạch vẫn an toàn, nhưng nó có thể chưa chạy được sketch nào cho đến khi có sketch được ghi vào, nên hãy bấm Nạp lại.

"This sketch does not build yet"

There is nothing to send until the code builds. Fix the error the card names (see lỗi biên dịch diễn đạt bằng lời thông thường), rồi bấm Nạp lại.

"This sketch uses WiFi, which Mokxi simulates"

WiFi trong Mokxi là mô phỏng, nên một sketch dùng WiFi chưa thể được nạp hoặc tải về từ Mokxi. Hãy nạp một sketch không dùng WiFi, hoặc tự biên dịch sketch này trong Arduino IDE với tên mạng và mật khẩu của bạn. Xem WiFi.

Ổ đĩa không xuất hiện, hoặc sketch không chạy

Với các bo mạch tải về, thẻ liệt kê các bước:

  • Pico và Pico W: giữ BOOTSEL trong lúc cắm, rồi nhả ra. Một ổ đĩa tên RPI-RP2 sẽ mở ra. Kéo thả tệp .uf2 vào đó.
  • XIAO RP2040 và RP2040-Zero: giữ BOOT (ký hiệu B trên XIAO) trong lúc cắm. Ổ đĩa RPI-RP2 sẽ mở ra.
  • Nano RP2040 Connect: nối chân REC với GND trong lúc cắm, rồi rút dây ra. Ổ đĩa RPI-RP2 sẽ mở ra.
  • XIAO SAMD21: chạm hai chân RST vào nhau hai lần, thật nhanh. Một ổ đĩa sẽ mở ra. Kéo thả tệp .uf2 vào đó.
  • micro:bit V2: một ổ đĩa tên MICROBIT mở ra khi bạn cắm nó. Kéo thả tệp .hex vào đó.

Ổ đĩa tự đóng lại và sketch bắt đầu chạy. Trên các bo mạch RP2040 và XIAO SAMD21, Serial xuất ra ở hai chân, không đi qua dây cáp USB: thẻ sẽ nêu tên các chân đó. Hãy dùng bộ chuyển đổi USB serial 3.3V để đọc. Trên Pico W, LED trên bo mạch không sáng với kiểu tải về này: hãy dùng một LED nối vào chân GP.

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

Hãy viết thư cho chúng tôi từ trang /support, kèm bo mạch, thông báo chính xác, trình duyệt bạn dùng, và Log nạp từ thẻ (mở nó ngay dưới thông báo và bấm Sao chép log).